ModifyMountTargetSecurityGroups - Amazon Elastic File System

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ModifyMountTargetSecurityGroups

Modifie l’ensemble de groupes de sécurité en vigueur pour une cible de montage.

Lorsque vous créez une cible de montage, Amazon crée EFS également une nouvelle interface réseau. Pour plus d’informations, consultez CreateMountTarget. Cette opération remplace les groupes de sécurité en vigueur pour l’interface réseau associée à une cible de montage avec les SecurityGroups fournis dans la demande. Cette opération nécessite que l’interface réseau de la cible de montage ait été créée et que l’état du cycle de vie de la cible de montage ne soit pas deleted.

L’opération nécessite des autorisations pour les actions suivantes :

  • Action elasticfilesystem:ModifyMountTargetSecurityGroups sur le système de fichiers de la cible de montage.

  • action ec2:ModifyNetworkInterfaceAttribute sur l’interface réseau de la cible de montage.

Syntaxe de la requête

PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1 Content-type: application/json { "SecurityGroups": [ "string" ] }

URIParamètres de demande

La demande utilise les URI paramètres suivants.

MountTargetId

ID de la cible de montage dont vous souhaitez modifier les groupes de sécurité.

Contraintes de longueur : longueur minimale de 13. Longueur maximale de 45.

Modèle : ^fsmt-[0-9a-f]{8,40}$

Obligatoire : oui

Corps de la demande

La demande accepte les données suivantes au JSON format suivant.

SecurityGroups

Un ensemble comprenant jusqu'à cinq groupes VPC de sécuritéIDs.

Type : tableau de chaînes

Membres du tableau : nombre maximum de 100 éléments.

Contraintes de longueur : longueur minimale de 11. Longueur maximale de 43.

Modèle : ^sg-[0-9a-f]{8,40}

Obligatoire : non

Syntaxe de la réponse

HTTP/1.1 204

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 204 avec un HTTP corps vide.

Erreurs

BadRequest

Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.

HTTPCode de statut : 400

IncorrectMountTargetState

Renvoyé si l’état de la cible de montage n’est pas correct pour l’opération.

HTTPCode de statut : 409

InternalServerError

Renvoyé si une erreur s’est produite côté serveur.

HTTPCode de statut : 500

MountTargetNotFound

Renvoyé s’il n’y a aucune cible de montage avec l’identifiant spécifié dans celui de l’appelant Compte AWS.

HTTPCode de statut : 404

SecurityGroupLimitExceeded

Renvoyé si la taille de SecurityGroups spécifiée dans la demande est supérieure à cinq.

HTTPCode de statut : 400

SecurityGroupNotFound

Renvoie si l'un des groupes de sécurité spécifiés n'existe pas dans le cloud privé virtuel du sous-réseau (VPC).

HTTPCode de statut : 400

Exemples

Remplacer les groupes de sécurité d’une cible de montage

L’exemple suivant remplace les groupes de sécurité en vigueur pour l’interface réseau associée à une cible de montage.

Exemple de demande

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" ] }

Exemple de réponse

HTTP/1.1 204 No Content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :