DescribeMountTargetSecurityGroups - Amazon Elastic File System

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DescribeMountTargetSecurityGroups

Devuelve los grupos de seguridad actualmente en vigor de un destino de montaje. Esta operación requiere que se haya creado la interfaz de red del objetivo de montaje y que no el estado del ciclo de vida del destino de montaje no sea deleted.

Esta operación necesita permisos para las siguientes acciones:

  • Acción de elasticfilesystem:DescribeMountTargetSecurityGroups en el sistema de archivos del objetivo de montaje.

  • Acción de ec2:DescribeNetworkInterfaceAttribute en la interfaz de red del objetivo de montaje.

Sintaxis de la solicitud

GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

MountTargetId

El ID del objetivo de montaje cuyos grupos de seguridad desea recuperar.

Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.

Patrón: ^fsmt-[0-9a-f]{8,40}$

Obligatorio: sí

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "SecurityGroups": [ "string" ] }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

SecurityGroups

Un conjunto de grupos de seguridad

Tipo: matriz de cadenas

Miembros de la matriz: número máximo de 100 elementos.

Limitaciones de longitud: longitud mínima de 11. Longitud máxima de 43.

Patrón: ^sg-[0-9a-f]{8,40}

Errores

BadRequest

Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio.

ErrorCode

El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.

Message

El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.

Código de estado HTTP: 400

IncorrectMountTargetState

Se devuelve si el objetivo de montaje no tiene el estado correcto para la operación.

ErrorCode

El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.

Message

El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.

Código de estado HTTP: 409

InternalServerError

Se devuelve si se ha producido un error en el servidor.

ErrorCode

El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.

Message

El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.

Código de estado HTTP: 500

MountTargetNotFound

Se devuelve si no hay un objetivo de montaje con el ID especificado que se encoentró en la Cuenta de AWS de la persona que llama.

ErrorCode

El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.

Message

El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.

Código de estado HTTP: 404

Ejemplos

Recuperar grupos de seguridad en vigor de un sistema de archivos

El siguiente ejemplo recupera los grupos de seguridad vigentes para la interfaz de red asociada a un objetivo de montaje.

Solicitud de muestra

GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T223513Z Authorization: <...>

Respuesta de ejemplo

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Length: 57 { "SecurityGroups" : [ "sg-188d9f74" ] }

Véase también

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: