ModifyMountTargetSecurityGroups
Modifica el conjunto de grupos de seguridad en vigor de un destino de montaje.
Al crear un destino de montaje, Amazon EFS también crea una nueva interfaz de red. Para obtener más información, consulte CreateMountTarget. Esta operación reemplaza los grupos de seguridad vigentes para la interfaz de red asociada a un destino de montaje, por los SecurityGroups proporcionados en la solicitud. Esta operación requiere que se haya creado la interfaz de red del destino de montaje y que no el estado del ciclo de vida del destino de montaje no sea deleted.
La operación necesita permisos para las siguientes acciones:
-
Acción de
elasticfilesystem:ModifyMountTargetSecurityGroupsen el sistema de archivos del objetivo de montaje. -
Acción de
ec2:ModifyNetworkInterfaceAttributeen la interfaz de red del objetivo de montaje.
Sintaxis de la solicitud
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}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 modificar.
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 acepta los siguientes datos en formato JSON.
- SecurityGroups
-
Un conjunto de hasta cinco ID de grupo de seguridad de la VPC.
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}Obligatorio: no
Sintaxis de la respuesta
HTTP/1.1 204
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
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.
Código de estado HTTP: 400
- IncorrectMountTargetState
-
Se devuelve si el objetivo de montaje no tiene el estado correcto para la operación.
Código de estado HTTP: 409
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
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.
Código de estado HTTP: 404
- SecurityGroupLimitExceeded
-
Se devuelve si el tamaño de
SecurityGroupsespecificado en la solicitud es superior a cinco.Código de estado HTTP: 400
- SecurityGroupNotFound
-
Se devuelve si uno de los grupos de seguridad especificados no existe en la nube privada virtual (VPC) de la subred.
Código de estado HTTP: 400
Ejemplos
Sustituya los grupos de seguridad de un objetivo de montaje
El siguiente ejemplo sustituye los grupos de seguridad vigentes para la interfaz de red asociada a un destino de montaje.
Solicitud de muestra
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}Respuesta de ejemplo
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdefVéase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
