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.

# API Amazon EFS
<a name="api-reference"></a>

L’API Amazon EFS est un protocole réseau basé sur [HTTP (RFC 2616)](https://www.ietf.org/rfc/rfc2616.txt). Pour chaque appel d'API, vous envoyez une requête HTTP au point de terminaison d'API Amazon EFS spécifique à la région pour savoir Région AWS où vous souhaitez gérer les systèmes de fichiers. L’API utilise des documents JSON (RFC 4627) pour les corps de requête/réponse HTTP.

L’API Amazon EFS est un modèle RPC. Dans ce modèle, il existe un ensemble fixe d’opérations et la syntaxe de chaque opération est connue des clients sans aucune interaction préalable. Dans la section suivante, vous pouvez trouver une description de chaque opération d’API à l’aide d’une notation RPC abstraite. Chacune a un nom d’opération qui n’apparaît pas dans le transfert. Pour chaque opération, la rubrique spécifie le mapping d’éléments de requête HTTP. 

L’opération Amazon EFS spécifique à laquelle est mappée une requête donnée est déterminée par une combinaison de la méthode de la demande (GET, PUT, POST ou DELETE) et de la correspondance de Request-URI avec l’un des différents modèles. Si l’opération est PUT ou POST, Amazon EFS extrait les arguments d’appel du segment de chemin Request-URI, les paramètres de requête, ainsi que l’objet JSON dans le corps de la requête.

**Note**  
Bien que les noms des opérations`CreateFileSystem`, tels que, n'apparaissent pas sur le fil, ils ont une signification dans les politiques Gestion des identités et des accès AWS (IAM). Pour de plus amples informations, veuillez consulter [Gestion des identités et des accès pour Amazon EFS](security-iam.md).   
Le nom de l'opération est également utilisé pour nommer les commandes dans les outils de ligne de commande et les éléments du AWS SDK. APIs Par exemple, il existe une AWS CLI commande nommée `create-file-system` qui correspond à l'`CreateFileSystem`opération.   
Le nom de l'opération apparaît également dans AWS CloudTrail les journaux des appels d'API Amazon EFS.

## Points de terminaison d'API
<a name="api-reference-endpoint"></a>

Un point de terminaison est une URL qui sert de point d'entrée à un service AWS Web. Amazon EFS prend en charge les types de terminaux suivants :
+ IPv4 points de terminaison
+ Points de terminaison à double pile (à IPv4 la fois IPv6)
+ [Points de terminaison FIPS](https://docs.aws.amazon.com/general/latest/gr/rande.html#FIPS-endpoints)

Lorsque vous faites une demande, vous pouvez spécifier le point de terminaison à utiliser. Si vous ne spécifiez aucun point de IPv4 terminaison, celui-ci est utilisé par défaut. Pour utiliser un autre type de point de terminaison, vous devez le spécifier dans votre demande. Pour obtenir un exemple de la façon de procéder, consultez [Spécification des points de terminaison](#endpoints-specifying). Pour un tableau des points de terminaison disponibles, consultez la section Points de [terminaison et quotas Amazon EFS](https://docs.aws.amazon.com/general/latest/gr/elasticfilesystem.html). 

### IPv4 points de terminaison
<a name="ipv4-endpoints"></a>

IPv4 les terminaux ne prennent en charge que IPv4 le trafic. IPv4 les points de terminaison sont disponibles pour toutes les régions. Le format du IPv4 point de terminaison dépend de la région.
+ Pour les IPv4 terminaux situés dans les régions AWS commerciales, le format est`elasticfilesystem.region.amazonaws.com`.

  Par exemple, si vous le spécifiez `elasticfilesystem.us-west-2.amazonaws.com` comme point de terminaison, nous dirigeons votre demande vers le point de terminaison de la région USA Ouest (Oregon) (us-west-2).
+ Pour les IPv4 points de terminaison situés dans les régions de Chine, le format est`elasticfilesystem---region.amazonaws.com.rproxy.goskope.com.cn`.

  Par exemple, le point de terminaison de l'API Amazon EFS pour la région de Chine (Pékin) est`elasticfilesystem---cn-north-1.amazonaws.com.rproxy.goskope.com.cn`.

### Points de terminaison à double pile (IPv4 et IPv6)
<a name="dualstack-endpoints"></a>

Les terminaux à double pile prennent en charge à la fois le trafic IPv4 et IPv6 le trafic. Lorsque vous envoyez une demande à un point de terminaison à double pile, l'URL du point de terminaison correspond à une IPv4 adresse IPv6 ou à une adresse, selon le protocole utilisé par votre réseau et votre client. Le format du point de terminaison à double pile dépend de la région.
+ Pour les points de terminaison à double pile dans les régions AWS commerciales, le format est. `efs.aws-region.api.aws`

  Par exemple, le point de terminaison à double pile pour la région USA Ouest (Oregon) (us-west-2) est. `efs.eu-west-2.api.aws`
+ Pour les points de terminaison à double pile dans les régions de Chine, le format est. `efs---region---api.amazonwebservices.com.rproxy.goskope.com.cn`

  Par exemple, le point de terminaison à double pile pour la région de Chine (Pékin) est`efs---cn-north-1---api.amazonwebservices.com.rproxy.goskope.com.cn`.

### Spécification des points de terminaison
<a name="endpoints-specifying"></a>

Les exemples suivants montrent comment spécifier un point de terminaison pour la région USA Ouest (Californie du Nord) (us-west-1) à l'aide du pour Amazon EFS. AWS CLI 

IPv4

```
aws efs get-rest-apis --region us-west-1 --endpoint-url https://elasticfilesystem.us-west-1.amazonaws.com
```

Double pile

```
aws efs get-rest-apis --region us-west-1 --endpoint-url https://efs.us-west-1.api.aws
```

## Version de l’API
<a name="api-reference-version"></a>

La version de l’API utilisée pour un appel est identifiée par le premier segment de chemin de l’URI de la demande, et sa forme est une date ISO 8601. Pour obtenir un exemple, consultez [CreateFileSystem](API_CreateFileSystem.md). 

La documentation décrit l’API version 2015-02-01.

## Rubriques en relation
<a name="api-reference-related-topics"></a>

Les sections suivantes fournissent des descriptions d’opérations d’API, indiquent comment créer une signature pour l’authentification de la requête et comment accorder des autorisations pour ces opérations d’API à l’aide de stratégies IAM.
+ [Gestion des identités et des accès pour Amazon EFS](security-iam.md)
+ [Actions](API_Operations.md)
+ [Types de données](API_Types.md)

## Utilisation du débit de demandes d’API de requête pour Amazon EFS
<a name="api-throttling"></a>

Les demandes d'API Amazon EFS sont limitées pour chaque Compte AWS région afin d'améliorer les performances du service. Tous les appels d'API Amazon EFS effectués ensemble, qu'ils proviennent d'une application, de la AWS CLI console Amazon EFS ou de la console Amazon EFS, ne doivent pas dépasser le taux de demandes d'API maximal autorisé. Le taux maximal de demandes d'API peut varier d'un pays à l'autre Régions AWS. Les demandes d'API effectuées sont attribuées au sous-jacent Compte AWS.

Si une demande d’API dépasse le taux de demandes d’API pour sa catégorie, la demande renvoie le code d’erreur `ThrottlingException`. Pour éviter cette erreur, assurez-vous que votre application n’effectue pas de nouvelles tentatives de demandes d’API à un taux élevé. Vous pouvez le faire en utilisant l’interrogation avec soin et en utilisant les tentatives d’interruption exponentielle.

### Interrogation
<a name="efs-polling"></a>

Votre application peut avoir besoin d’appeler une opération d’API de façon répétée pour vérifier une mise à jour du statut. Avant de démarrer l’interrogation, indiquez la durée potentielle de la demande. Lorsque vous commencez l’interrogation, utilisez un intervalle de veille approprié entre les demandes successives. Pour obtenir de meilleurs résultats, utilisez un intervalle de veille croissant.

### Nouvelles tentatives ou traitement par lots
<a name="efs-retries"></a>

Votre application peut avoir besoin de relancer une demande d’API après un échec ou de traiter plusieurs ressources (par exemple, l’ensemble de vos systèmes de fichiers Amazon EFS). Pour réduire le taux de demandes d’API, utilisez un intervalle de veille approprié entre les demandes successives. Pour obtenir de meilleurs résultats, utilisez un intervalle de veille croissant ou variable.

### Calcul de l’intervalle de veille
<a name="efs-sleep-interval-calculation"></a>

Lorsque vous devez interroger ou relancer une demande d’API, nous vous recommandons d’utiliser un algorithme d’interruption exponentielle pour calculer l’intervalle de sommeil entre les appels d’API. L’idée sous-jacente consiste à utiliser des temps d’attente progressivement plus longs entre les tentatives en cas de réponses d’erreur consécutives. *Pour plus d'informations et des exemples d'implémentation de cet algorithme, consultez la section [Comportement de la nouvelle tentative](https://docs.aws.amazon.com/general/latest/gr/api-retries.html) dans le Référence générale d'Amazon Web Services.*

# Actions
<a name="API_Operations"></a>

Les actions suivantes sont prises en charge :
+  [CreateAccessPoint](API_CreateAccessPoint.md) 
+  [CreateFileSystem](API_CreateFileSystem.md) 
+  [CreateMountTarget](API_CreateMountTarget.md) 
+  [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md) 
+  [CreateTags](API_CreateTags.md) 
+  [DeleteAccessPoint](API_DeleteAccessPoint.md) 
+  [DeleteFileSystem](API_DeleteFileSystem.md) 
+  [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md) 
+  [DeleteMountTarget](API_DeleteMountTarget.md) 
+  [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md) 
+  [DeleteTags](API_DeleteTags.md) 
+  [DescribeAccessPoints](API_DescribeAccessPoints.md) 
+  [DescribeAccountPreferences](API_DescribeAccountPreferences.md) 
+  [DescribeBackupPolicy](API_DescribeBackupPolicy.md) 
+  [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md) 
+  [DescribeFileSystems](API_DescribeFileSystems.md) 
+  [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md) 
+  [DescribeMountTargets](API_DescribeMountTargets.md) 
+  [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md) 
+  [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md) 
+  [DescribeTags](API_DescribeTags.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md) 
+  [PutAccountPreferences](API_PutAccountPreferences.md) 
+  [PutBackupPolicy](API_PutBackupPolicy.md) 
+  [PutFileSystemPolicy](API_PutFileSystemPolicy.md) 
+  [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateFileSystem](API_UpdateFileSystem.md) 
+  [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md) 

# CreateAccessPoint
<a name="API_CreateAccessPoint"></a>

Crée un point d’accès EFS. Un point d’accès est une vue spécifique à l’application dans un système de fichiers EFS qui applique un utilisateur et un groupe de système d’exploitation, ainsi qu’un chemin d’accès au système de fichiers, à toute demande de système de fichiers effectuée via le point d’accès. L’utilisateur et le groupe du système d’exploitation remplacent toutes les informations d’identité fournies par le client NFS. Le chemin d’accès du système de fichiers est exposé en tant que répertoire racine du point d’accès. Les applications qui utilisent le point d’accès ne peuvent accéder qu’aux données de leur propre répertoire et de leurs éventuels sous-répertoires. Un système de fichiers peut avoir un maximum de 10 000 points d'accès, sauf si vous demandez une augmentation. Pour plus d’informations, veuillez consulter la rubrique Mo[ntage d’un système de fichiers à l’aide de points d’accès EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html).

**Note**  
Si plusieurs demandes de création de points d'accès sur le même système de fichiers sont envoyées en succession rapide et que le système de fichiers est proche de la limite des points d'accès, il est possible que la réponse à ces demandes soit limitée. Cela permet de garantir que le système de fichiers ne dépasse pas le quota de points d’accès indiqué.

Cette opération exige des autorisations pour l’action `elasticfilesystem:CreateAccessPoint`.

Les points d’accès peuvent être balisés lors de leur création. Si les balises sont spécifiées dans l’action de création d’action, IAM effectue une autorisation supplémentaire sur l’action `elasticfilesystem:TagResource` pour vérifier si les utilisateurs sont autorisés à créer des balises. Par conséquent, vous devez octroyer des autorisations explicites d’utiliser l’action `elasticfilesystem:TagResource`. Pour plus d’informations, consultez [Octroi d’autorisations pour baliser les ressources lors de la création](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).

## Syntaxe de la demande
<a name="API_CreateAccessPoint_RequestSyntax"></a>

```
POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "FileSystemId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_CreateAccessPoint_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_CreateAccessPoint_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [ClientToken](#API_CreateAccessPoint_RequestSyntax) **   <a name="efs-CreateAccessPoint-request-ClientToken"></a>
Chaîne de 64 caractères ASCII maximum utilisée par Amazon EFS pour garantir une création idempotente.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+`   
Obligatoire : oui

 ** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) **   <a name="efs-CreateAccessPoint-request-FileSystemId"></a>
ID du système de fichiers EFS auquel le point d’accès donne un accès.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** [PosixUser](#API_CreateAccessPoint_RequestSyntax) **   <a name="efs-CreateAccessPoint-request-PosixUser"></a>
L’utilisateur et le groupe du système d’exploitation appliqués à toutes les demandes de système de fichiers effectuées via le point d’accès.  
Type : objet [PosixUser](API_PosixUser.md)  
Obligatoire : non

 ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) **   <a name="efs-CreateAccessPoint-request-RootDirectory"></a>
Détermine le répertoire du système de fichiers EFS que le point d’accès expose en tant que répertoire racine de votre système de fichiers aux clients NFS utilisant le point d’accès. Les clients utilisant le point d’accès peuvent uniquement accéder au répertoire racine et en dessous. Si le `RootDirectory` > `Path` spécifié n’existe pas, Amazon EFS le crée et applique les paramètres `CreationInfo` lorsqu’un client se connecte à un point d’accès. Lorsque vous spécifiez un `RootDirectory`, vous devez fournir le `Path`, et le`CreationInfo`.  
Amazon EFS crée un répertoire racine uniquement si vous avez fourni le CreationInfo : OwnUid, le OwnGid et les autorisations pour le répertoire. Si vous ne fournissez pas ces informations, Amazon EFS ne crée pas le répertoire racine. Si le répertoire racine n’existe pas, les tentatives de Montage au Moyen du point d’accès échoueront.  
Type : objet [RootDirectory](API_RootDirectory.md)  
Obligatoire : non

 ** [Tags](#API_CreateAccessPoint_RequestSyntax) **   <a name="efs-CreateAccessPoint-request-Tags"></a>
Crée des balises associées au point d’accès. Chaque balise est une paire clé-valeur, chaque clé doit être unique. Pour plus d'informations, consultez la section [AWS Ressources relatives au balisage](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) dans le *Guide de référence AWS général*.  
Type : tableau d’objets [Tag](API_Tag.md)  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateAccessPoint_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccessPointArn": "string",
   "AccessPointId": "string",
   "ClientToken": "string",
   "FileSystemId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "OwnerId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_CreateAccessPoint_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-AccessPointArn"></a>
Le Amazon Resource Name (ARN) unique associé au point d’accès.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$` 

 ** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-AccessPointId"></a>
L’ID du point d’accès, attribué par Amazon EFS.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` 

 ** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-ClientToken"></a>
Chaîne opaque spécifiée dans la demande pour garantir la création idempotente.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+` 

 ** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-FileSystemId"></a>
ID du système de fichiers EFS auquel le point d’accès s’applique.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-LifeCycleState"></a>
Identifie la phase du cycle de vie du point d’accès.  
Type : Chaîne  
Valeurs valides : `creating | available | updating | deleting | deleted | error` 

 ** [Name](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-Name"></a>
Nom de ce point d’accès. Il s’agit de la valeur de la balise `Name`.  
Type : Chaîne

 ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-OwnerId"></a>
Identifie Compte AWS le propriétaire de la ressource du point d'accès.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$` 

 ** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-PosixUser"></a>
L'identité POSIX complète, y compris l'ID utilisateur, l'ID de groupe et le groupe secondaire IDs sur le point d'accès utilisé pour toutes les opérations sur les fichiers par les clients NFS utilisant le point d'accès.  
Type : objet [PosixUser](API_PosixUser.md)

 ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-RootDirectory"></a>
Répertoire du système de fichiers Amazon EFS que le point d’accès expose en tant que répertoire racine aux clients NFS utilisant le point d’accès.  
Type : objet [RootDirectory](API_RootDirectory.md)

 ** [Tags](#API_CreateAccessPoint_ResponseSyntax) **   <a name="efs-CreateAccessPoint-response-Tags"></a>
Les balises associées au point d’accès, présentées sous la forme d’un tableau d’objets Tag.  
Type : tableau d’objets [Tag](API_Tag.md)

## Erreurs
<a name="API_CreateAccessPoint_Errors"></a>

 ** AccessPointAlreadyExists **   
Renvoyé si le point d’accès que vous essayez de créer existe déjà, avec le jeton de création que vous avez fourni dans la demande.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** AccessPointLimitExceeded **   
Renvoyé si le Compte AWS nombre maximum de points d'accès autorisés par système de fichiers a déjà été créé. Pour en savoir plus, consultez[https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region).    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 403

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ThrottlingException **   
Renvoyé lorsque l’action `CreateAccessPoint` API est appelée trop rapidement et que le nombre de points d’accès sur le système de fichiers approche de la [limite de 120](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region).    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 429

## Voir aussi
<a name="API_CreateAccessPoint_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint) 

# CreateFileSystem
<a name="API_CreateFileSystem"></a>

Crée un nouveau système de fichiers vide. L’opération exige un jeton de création dans la demande qui est utilisé par Amazon EFS pour garantir la création idempotente (appeler l’opération avec le même jeton de création n’a aucun effet). S'il n'existe pas actuellement de système de fichiers appartenant à l'appelant Compte AWS avec le jeton de création spécifié, cette opération effectue les opérations suivantes :
+ Crée un nouveau système de fichiers vide. Le système de fichiers possède un ID attribué par Amazon EFS ainsi qu’un état du cycle de vie initial `creating`.
+ Retourne avec la description du système de fichiers créé.

Sinon, cette opération retourne une erreur `FileSystemAlreadyExists` avec l’ID du système de fichiers existant.

**Note**  
Pour les cas d’utilisation de base, vous pouvez utiliser un UUID généré de façon aléatoire pour le jeton de création.

L’opération idempotente vous permet de relancer un appel `CreateFileSystem` sans risque de créer un système de fichiers supplémentaire. Cela peut se produire lorsqu’un appel initial échoue sans que vous puissiez savoir si un système de fichiers a été créé ou non. Par exemple, un délai d’attente au niveau du transport ou la réinitialisation de votre connexion. Tant que vous utilisez le même jeton de création, si l’appel initial a réussi à créer un système de fichiers, le client peut découvrir de son existence à partir de l’erreur `FileSystemAlreadyExists`.

Pour plus d’informations, consultez [Création d’un système de fichiers](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1) dans le *Guide de l’utilisateur Amazon EFS*.

**Note**  
L’appel `CreateFileSystem` se termine, tandis que l’état du cycle de vie du système de fichiers est toujours au statut `creating`. Vous pouvez vérifier le statut de création du système de fichiers en appelant l’opération [DescribeFileSystems](API_DescribeFileSystems.md) qui retourne l’état du système de fichiers, entre autres.

Cette opération accepte également un paramètre `PerformanceMode` facultatif que vous choisissez pour votre système de fichiers. Nous le recommandons `generalPurpose` `PerformanceMode` pour tous les systèmes de fichiers. Le `maxIO` mode est un type de performance de génération précédente conçu pour les charges de travail hautement parallélisées qui peuvent tolérer des latences plus élevées que le mode. `generalPurpose` `MaxIO`le mode n'est pas pris en charge pour les systèmes de fichiers One Zone ou les systèmes de fichiers qui utilisent le débit élastique.

Il ne `PerformanceMode` peut pas être modifié une fois le système de fichiers créé. Pour plus d’informations, consultez [Amazon EFS : modes de performances](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html).

Vous pouvez définir le mode de débit du système de fichiers à l’aide du paramètre `ThroughputMode`.

Une fois le système de fichiers entièrement créé, Amazon EFS définit son état du un cycle de vie `available`, après quoi vous pouvez créer une ou plusieurs cibles de Montage pour le système de fichiers de votre VPC. Pour de plus amples informations, veuillez consulter [CreateMountTarget](API_CreateMountTarget.md). Vous montez votre système de fichiers Amazon EFS sur une EC2 instance de votre VPC à l'aide de la cible de montage. Pour plus d’informations, consultez [Fonctionnement d’Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html). 

Cette opération exige des autorisations pour l’action `elasticfilesystem:CreateFileSystem`. 

Les systèmes de fichiers peuvent être étiquetés lors de leur création. Si les balises sont spécifiées dans l’action de création d’action, IAM effectue une autorisation supplémentaire sur l’action `elasticfilesystem:TagResource` pour vérifier si les utilisateurs sont autorisés à créer des balises. Par conséquent, vous devez octroyer des autorisations explicites d’utiliser l’action `elasticfilesystem:TagResource`. Pour plus d’informations, consultez [Octroi d’autorisations pour baliser les ressources lors de la création](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).

## Syntaxe de la demande
<a name="API_CreateFileSystem_RequestSyntax"></a>

```
POST /2015-02-01/file-systems HTTP/1.1
Content-type: application/json

{
   "AvailabilityZoneName": "string",
   "Backup": boolean,
   "CreationToken": "string",
   "Encrypted": boolean,
   "KmsKeyId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}
```

## Paramètres de demande URI
<a name="API_CreateFileSystem_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_CreateFileSystem_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-AvailabilityZoneName"></a>
Pour les systèmes de fichiers One Zone, spécifiez la zone de AWS disponibilité dans laquelle créer le système de fichiers. Utilisez le format `us-east-1a` pour spécifier la Zone de disponibilité. Pour plus d'informations sur les systèmes de fichiers One Zone, consultez la section [Types de systèmes de fichiers EFS](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) dans le *guide de l'utilisateur Amazon EFS*.  
Les systèmes de fichiers One Zone ne sont pas disponibles dans toutes les zones de disponibilité dans Régions AWS lesquelles Amazon EFS est disponible.
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+`   
Obligatoire : non

 ** [Backup](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-Backup"></a>
Spécifie si les sauvegardes automatiques sont activées sur le système de fichiers que vous créez. Définissez la valeur sur `true` pour activer les sauvegardes automatiques. Si vous créez un système de fichiers Zone unique, les sauvegardes automatiques sont activées par défaut. Pour plus d’informations, consultez [Sauvegardes automatiques](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) dans le *Guide de l’utilisateur Amazon EFS*.  
La valeur par défaut est `false`. Toutefois, si vous spécifiez un `AvailabilityZoneName`, la valeur par défaut est `true`.  
 AWS Backup n'est pas disponible dans tous les Régions AWS pays où Amazon EFS est disponible.
Type : booléen  
Obligatoire : non

 ** [CreationToken](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-CreationToken"></a>
Chaîne de maximum 64 caractères ASCII. Amazon EFS l’utilise pour garantir la création idempotente.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+`   
Obligatoire : oui

 ** [Encrypted](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-Encrypted"></a>
Une valeur booléenne qui, si elle est vraie, crée un système de fichiers chiffré. Lorsque vous créez un système de fichiers chiffré, vous avez la possibilité de spécifier une AWS Key Management Service clé existante (clé KMS). Si vous ne spécifiez pas de clé KMS, la clé KMS par défaut pour Amazon EFS, `/aws/elasticfilesystem`, est utilisée pour protéger le système de fichiers chiffré.   
Type : booléen  
Obligatoire : non

 ** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-KmsKeyId"></a>
L’ID de la clé KMS que vous souhaitez utiliser pour protéger le système de fichiers crypté. Ce paramètre est obligatoire uniquement si vous souhaitez utiliser une clé KMS personnalisée. Si ce paramètre n’est pas spécifié, la clé KMS par défaut pour Amazon EFS est utilisée. Vous pouvez spécifier un ID de clé KMS en utilisant les formats suivants :  
+ ID de clé - Identifiant unique de la clé, par exemple `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ ARN - Amazon Resource Name (ARN) pour la clé, par exemple `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ Alias de clé - Un nom d’affichage précédemment créé pour une clé, par exemple `alias/projectKey1`.
+ ARN d’alias de clé - ARN pour un alias de clé, par exemple `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
Si vous l'utilisez`KmsKeyId`, vous devez définir le paramètre:Encrypted sur [CreateFileSystemtrue](#efs-CreateFileSystem-request-Encrypted).  
EFS n’accepte que les clés KMS symétriques. Vous ne pouvez pas utiliser de clés KMS asymétriques avec les systèmes de fichiers Amazon EFS.
Type : Chaîne  
Contraintes de longueur : longueur maximale de 2048.  
Modèle : `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`   
Obligatoire : non

 ** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-PerformanceMode"></a>
Mode de performances du système de fichiers. Nous recommandons le mode performance `generalPurpose` pour tous les systèmes de fichiers. Les systèmes de fichiers utilisant le mode de performance `maxIO` peuvent évoluer vers des niveaux plus élevés de débit cumulé et d’opérations par seconde avec comme contrepartie des latences légèrement plus élevées pour la plupart des opérations de fichier. Le mode de performances ne peut pas être Modifié une fois que le système de fichiers a été créé. Le mode `maxIO` n’est pas pris en charge sur les systèmes de fichiers utilisant des classes de stockage Zone unique.  
En raison des latences par opération plus élevées avec Max E/S, nous recommandons d’utiliser le mode de performance Usage général pour tous les systèmes de fichiers.
La valeur par défaut est `generalPurpose`.  
Type : Chaîne  
Valeurs valides : `generalPurpose | maxIO`   
Obligatoire : non

 ** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-ProvisionedThroughputInMibps"></a>
Débit, mesuré en mébioctets par seconde (MiBps), que vous souhaitez allouer au système de fichiers que vous créez. Obligatoire si `ThroughputMode` est défini sur `provisioned`. Les valeurs valides sont comprises entre 1 et 3414 MiBps, la limite supérieure dépendant de la région. Pour augmenter cette limite, contactez Support. Pour plus d’informations, consultez [Quotas Amazon EFS que vous pouvez augmenter](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) dans le *Guide de l’utilisateur Amazon EFS.*  
Type : double  
Plage valide : valeur minimum de 1,0.  
Obligatoire : non

 ** [Tags](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-Tags"></a>
Utilisez cette valeur pour créer une ou plusieurs balises associées au système de fichiers. Chaque balise est une paire clé-valeur définie par l’utilisateur. Nommez votre système de fichiers au moment de la création en incluant une paire clé-valeur `"Key":"Name","Value":"{value}"`. Chaque clé doit être unique. Pour plus d'informations, consultez la section [AWS Ressources relatives au balisage](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) dans le *Guide de référence AWS général*.  
Type : tableau d’objets [Tag](API_Tag.md)  
Obligatoire : non

 ** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) **   <a name="efs-CreateFileSystem-request-ThroughputMode"></a>
Spécifie le mode de débit du système de fichiers. Il peut s’agir du mode `bursting`, `provisioned` ou `elastic`. Si vous définissez `ThroughputMode` sur `provisioned`, vous devez également définir une valeur pour `ProvisionedThroughputInMibps`. Après avoir créé le système de fichiers, vous pouvez réduire son débit en mode Débit alloué ou passer d’un mode de débit à l’autre, avec certaines restrictions de temps. Pour de plus amples informations, consultez [Spécification du débit avec le mode alloué](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput) dans le *Guide de l’utilisateur Amazon EFS*.   
La valeur par défaut est `bursting`.  
Type : Chaîne  
Valeurs valides : `bursting | provisioned | elastic`   
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateFileSystem_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "CreationTime": number,
   "CreationToken": "string",
   "Encrypted": boolean,
   "FileSystemArn": "string",
   "FileSystemId": "string",
   "FileSystemProtection": { 
      "ReplicationOverwriteProtection": "string"
   },
   "KmsKeyId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "NumberOfMountTargets": number,
   "OwnerId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "SizeInBytes": { 
      "Timestamp": number,
      "Value": number,
      "ValueInArchive": number,
      "ValueInIA": number,
      "ValueInStandard": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}
```

## Eléments de réponse
<a name="API_CreateFileSystem_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-AvailabilityZoneId"></a>
Identifiant unique et cohérent de la Zone de disponibilité dans laquelle se trouve le système de fichiers, valide uniquement pour les systèmes de fichiers Zone unique. Par exemple, `use1-az1` il s'agit d'un identifiant de zone de disponibilité pour le Région AWS us-east-1, qui possède le même emplacement dans chaque cas. Compte AWS  
Type : Chaîne

 ** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-AvailabilityZoneName"></a>
Décrit la zone de AWS disponibilité dans laquelle se trouve le système de fichiers et n'est valide que pour les systèmes de fichiers One Zone. Pour de plus amples informations, consultez [Utilisation de classes de stockage EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) dans le *Guide de l’utilisateur Amazon EFS*.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+` 

 ** [CreationTime](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-CreationTime"></a>
Heure de création du système de fichiers, en secondes (depuis 1970-01-01T 00:00:00 Z).  
Type : Timestamp

 ** [CreationToken](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-CreationToken"></a>
Chaîne opaque spécifiée dans la demande.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+` 

 ** [Encrypted](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-Encrypted"></a>
Valeur booléenne qui, si la valeur est true, indique que le système de fichiers est chiffré.  
Type : Boolean

 ** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-FileSystemArn"></a>
Le nom de ressource Amazon Resource Name (ARN) pour le système de fichiers EFS, au format `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Exemple avec des exemples de données : `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`   
Type : Chaîne

 ** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-FileSystemId"></a>
ID du système de fichiers, attribué par Amazon EFS.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [FileSystemProtection](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-FileSystemProtection"></a>
Décrit la protection du système de fichiers.   
Type : objet [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)

 ** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-KmsKeyId"></a>
Identifiant AWS KMS key utilisé pour protéger le système de fichiers chiffré.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 2048.  
Modèle : `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$` 

 ** [LifeCycleState](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-LifeCycleState"></a>
Phase du cycle de vie du système de fichiers.  
Type : Chaîne  
Valeurs valides : `creating | available | updating | deleting | deleted | error` 

 ** [Name](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-Name"></a>
Vous pouvez ajouter des balises à un système de fichiers, y compris une balise `Name`. Pour de plus amples informations, veuillez consulter [CreateFileSystem](#API_CreateFileSystem). Si le système de fichiers possède une balise `Name`, Amazon EFS renvoie la valeur dans ce champ.   
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 

 ** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-NumberOfMountTargets"></a>
Le nombre actuel de cibles de Montage du système de fichiers. Pour de plus amples informations, veuillez consulter [CreateMountTarget](API_CreateMountTarget.md).  
Type : Integer  
Plage valide : Valeur minimum de 0.

 ** [OwnerId](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-OwnerId"></a>
Celui Compte AWS qui a créé le système de fichiers.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$` 

 ** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-PerformanceMode"></a>
Mode de performances du système de fichiers.  
Type : Chaîne  
Valeurs valides : `generalPurpose | maxIO` 

 ** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-ProvisionedThroughputInMibps"></a>
Quantité de débit allouée, mesurée en MiBps, pour le système de fichiers. Valable pour les systèmes de fichiers utilisant `ThroughputMode` définit sur `provisioned`.  
Type : double  
Plage valide : Valeur minimum de 1,0.

 ** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-SizeInBytes"></a>
La dernière taille mesurée connue (en octets) des données stockées dans le système de fichiers, dans son champ `Value`, et l’heure à laquelle cette taille a été déterminée dans son champ `Timestamp`. La valeur `Timestamp` est le nombre entier de secondes écoulées depuis 1970-01-01T 00:00:00 Z. La valeur `SizeInBytes` ne représente pas la taille d’un instantané cohérent du système de fichiers, mais elle est finalement cohérente lorsqu’aucune écriture n’est effectuée dans le système de fichiers. Cela signifie que `SizeInBytes` représente la taille réelle uniquement si le système de fichiers n’est pas Modifié pendant une période supérieure à deux heures. Dans le cas contraire, la valeur ne correspond pas exactement à la taille du système de fichiers à un Moment donné.   
Type : objet [FileSystemSize](API_FileSystemSize.md)

 ** [Tags](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-Tags"></a>
Tags associés au système de fichiers, présentés sous forme de tableau des objets `Tag`.  
Type : tableau d’objets [Tag](API_Tag.md)

 ** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) **   <a name="efs-CreateFileSystem-response-ThroughputMode"></a>
Affiche le mode de débit du système de fichiers. Pour plus d’informations, consultez les [Modes de débit](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) dans le *Guide de l’utilisateur Amazon EFS*.   
Type : Chaîne  
Valeurs valides : `bursting | provisioned | elastic` 

## Erreurs
<a name="API_CreateFileSystem_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemAlreadyExists **   
Renvoyé si le système de fichiers que vous essayez de créer existe déjà, avec le jeton de création que vous avez fourni.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** FileSystemLimitExceeded **   
Renvoie si le nombre maximum de systèmes de fichiers autorisés par compte Compte AWS a déjà été créé.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 403

 ** InsufficientThroughputCapacity **   
Renvoyé si la capacité est insuffisante pour fournir un débit supplémentaire. Cette valeur peut être renvoyée lorsque vous essayez de créer un système de fichiers en mode débit alloué, lorsque vous essayez d’augmenter le débit alloué d’un système de fichiers existant ou lorsque vous essayez de faire passer un système de fichiers existant du mode débit en rafale au mode débit alloué. Réessayez ultérieurement.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
HTTP Status Code: 503

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ThroughputLimitExceeded **   
Renvoie si le mode de débit ou la quantité de débit provisionné ne peuvent pas être modifiés car la limite de débit de 1024 MiB/s a été atteinte.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** UnsupportedAvailabilityZone **   
Renvoyé si la fonctionnalité Amazon EFS demandée n’est pas disponible dans la Zone de disponibilité spécifiée.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Exemples
<a name="API_CreateFileSystem_Examples"></a>

### Créez d’un système de fichiers EFS
<a name="API_CreateFileSystem_Example_1"></a>

L’exemple suivant envoie une requête POST pour créer un système de fichiers dans la région `us-west-2` avec les sauvegardes automatiques activées. La demande est spécifiée `myFileSystem1` comme jeton de création pour l’idempotencie.

#### Exemple de demande
<a name="API_CreateFileSystem_Example_1_Request"></a>

```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem1",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "Encrypted": true,
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}
```

#### Exemple de réponse
<a name="API_CreateFileSystem_Example_1_Response"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}
```

### Créer un système de fichiers EFS chiffré avec disponibilité de Zone unique
<a name="API_CreateFileSystem_Example_2"></a>

 L’exemple suivant envoie une requête POST pour créer un système de fichiers dans la région `us-west-2` avec les sauvegardes automatiques activées. Le système de fichiers disposera d’un espace de stockage Zone unique dans la zone de `us-west-2b` disponibilité .

#### Exemple de demande
<a name="API_CreateFileSystem_Example_2_Request"></a>

```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem2",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "AvailabilityZoneName": "us-west-2b",
  "Encrypted": true,
  "ThroughputMode": "elastic",
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}
```

#### Exemple de réponse
<a name="API_CreateFileSystem_Example_2_Response"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "AvailabilityZoneId": "usew2-az2", 
   "AvailabilityZoneName": "us-west-2b",
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}
```

## consultez aussi
<a name="API_CreateFileSystem_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem) 

# CreateMountTarget
<a name="API_CreateMountTarget"></a>

Crée une cible de montage pour un système de fichiers. Vous pouvez ensuite monter le système de fichiers sur des EC2 instances à l'aide de la cible de montage. Pour plus d'informations sur les cibles de montage, consultez [la section Gestion des cibles de montage](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html). 

Pour créer une cible de montage pour un système de fichiers EFS, l'état du cycle de vie du système de fichiers doit être`available`. Pour de plus amples informations, veuillez consulter [DescribeFileSystems](API_DescribeFileSystems.md).

Après avoir créé la cible de montage, Amazon EFS renvoie une réponse comprenant une `MountTargetId` et une adresse IP (`IpAddress`ou`Ipv6Address`). Vous utilisez cette adresse IP lors du montage du système de fichiers dans une EC2 instance. Vous pouvez également utiliser le nom DNS de la cible de montage lors du montage du système de fichiers. L' EC2 instance sur laquelle vous montez le système de fichiers à l'aide de la cible de montage peut convertir le nom DNS de la cible de montage en adresse IP. Pour plus d'informations, consultez [Comment fonctionne Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html). 

Notez que vous pouvez créer des cibles de montage pour un système de fichiers dans un seul VPC, et qu’il ne peut y avoir qu’une seule cible de montage par Zone de disponibilité. Pour plus d'informations, consultez la section [Création de cibles de montage](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html).

Si la demande répond aux exigences, Amazon EFS procède comme suit :
+ Il crée une cible de montage dans le sous-réseau spécifié.
+ Crée une nouvelle interface réseau dans le sous-réseau avec les éléments suivants :
  + Description `Mount target fsmt-id for file system fs-id ` où se ` fsmt-id ` trouve l'ID de la cible de montage, et où ` fs-id ` est le`FileSystemId`.
  + `requesterManaged`Propriété de l'interface réseau définie sur `true` et `requesterId` valeur définie sur`EFS`.

  Chaque cible de montage possède une interface EC2 réseau gérée par le demandeur correspondante. Une fois l'interface réseau créée, Amazon EFS définit le `NetworkInterfaceId` champ de la description de la cible de montage sur l'ID de l'interface réseau et son adresse IP sur son adresse. En cas d’échec de la création de l’interface réseau, l’opération `CreateMountTarget` entière échoue.

**Note**  
L’appel `CreateMountTarget` se termine seulement après la création de l’interface réseau, mais tant que l’état de la cible de montage est `creating`, vous pouvez vérifier le statut de création de la cible de montage en appelant l’opération [DescribeMountTargets](API_DescribeMountTargets.md), ce qui retourne l’état de la cible de montage, entre autres.

Cette opération exige des autorisations pour l’action suivante sur le système de fichiers :
+  `elasticfilesystem:CreateMountTarget` 

Cette opération nécessite également des autorisations pour les EC2 actions Amazon suivantes :
+  `ec2:DescribeSubnets` 
+  `ec2:DescribeNetworkInterfaces` 
+  `ec2:CreateNetworkInterface` 

## Syntaxe de la demande
<a name="API_CreateMountTarget_RequestSyntax"></a>

```
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json

{
   "FileSystemId": "string",
   "IpAddress": "string",
   "IpAddressType": "string",
   "Ipv6Address": "string",
   "SecurityGroups": [ "string" ],
   "SubnetId": "string"
}
```

## Paramètres de demande URI
<a name="API_CreateMountTarget_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_CreateMountTarget_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **   <a name="efs-CreateMountTarget-request-FileSystemId"></a>
ID du système de fichiers pour lequel créer la cible de montage.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** [IpAddress](#API_CreateMountTarget_RequestSyntax) **   <a name="efs-CreateMountTarget-request-IpAddress"></a>
Si la cible `IpAddressType` de montage est IPv4 (`IPV4_ONLY`ou`DUAL_STACK`), spécifiez l' IPv4 adresse à utiliser. Si vous ne spécifiez pas de`IpAddress`, Amazon EFS sélectionne une adresse IP non utilisée dans le sous-réseau spécifié pour`SubnetId`.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 7. Longueur maximale de 15.  
Modèle : `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`   
Obligatoire : non

 ** [IpAddressType](#API_CreateMountTarget_RequestSyntax) **   <a name="efs-CreateMountTarget-request-IpAddressType"></a>
Type d'adresse IP de la cible de montage. Les valeurs possibles sont `IPV4_ONLY` ( IPv4 adresses uniquement), `IPV6_ONLY` ( IPv6 adresses uniquement) et `DUAL_STACK` (double pile, à la fois IPv4 et IPv6 adresses). Si vous ne spécifiez pas de`IpAddressType`, alors `IPV4_ONLY` est utilisé.  
Le `IPAddressType` doit correspondre au type d'IP du sous-réseau. En outre, le `IPAddressType` paramètre remplace la valeur définie comme adresse IP par défaut pour le sous-réseau du VPC. Par exemple, si le `IPAddressType` is `IPV4_ONLY` et le `AssignIpv6AddressOnCreation` is sont`true`, ils IPv4 sont utilisés pour la cible de montage. Pour plus d'informations, consultez [Modifier les attributs d'adressage IP de votre sous-réseau](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html).
Type : Chaîne  
Valeurs valides : `IPV4_ONLY | IPV6_ONLY | DUAL_STACK`   
Obligatoire : non

 ** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) **   <a name="efs-CreateMountTarget-request-Ipv6Address"></a>
Si la cible `IPAddressType` de montage est IPv6 (`IPV6_ONLY`ou`DUAL_STACK`), spécifiez l' IPv6 adresse à utiliser. Si vous ne spécifiez pas de`Ipv6Address`, Amazon EFS sélectionne une adresse IP non utilisée dans le sous-réseau spécifié pour`SubnetId`.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 39.  
Obligatoire : non

 ** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) **   <a name="efs-CreateMountTarget-request-SecurityGroups"></a>
Groupe de sécurité VPC IDs, du format. `sg-xxxxxxxx` Ils doivent être destinés au même VPC que le sous-réseau spécifié. Le nombre maximum de groupes de sécurité dépend du quota du compte. Pour plus d'informations, consultez [Amazon VPC Quotas](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) dans le *guide de l'utilisateur Amazon VPC* (voir le tableau des groupes de **sécurité**). Si vous ne spécifiez aucun groupe de sécurité, Amazon EFS utilise le groupe de sécurité par défaut pour le VPC du sous-réseau.  
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

 ** [SubnetId](#API_CreateMountTarget_RequestSyntax) **   <a name="efs-CreateMountTarget-request-SubnetId"></a>
ID du sous-réseau dans lequel ajouter la cible de montage. Pour les systèmes de fichiers Zone unique, utilisez le sous-réseau associé à la Zone de disponibilité du système de fichiers. Le type de sous-réseau doit être le même que le`IpAddressType`.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 15. Longueur maximale de 47.  
Modèle : `^subnet-[0-9a-f]{8,40}$`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_CreateMountTarget_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "FileSystemId": "string",
   "IpAddress": "string",
   "Ipv6Address": "string",
   "LifeCycleState": "string",
   "MountTargetId": "string",
   "NetworkInterfaceId": "string",
   "OwnerId": "string",
   "SubnetId": "string",
   "VpcId": "string"
}
```

## Eléments de réponse
<a name="API_CreateMountTarget_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-AvailabilityZoneId"></a>
Identifiant unique et cohérent de la Zone de disponibilité dans laquelle réside la cible de montage. Par exemple, `use1-az1` il s'agit d'un ID AZ pour la région us-east-1 et il a le même emplacement dans chaque région. Compte AWS  
Type : Chaîne

 ** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-AvailabilityZoneName"></a>
Nom de la Zone de disponibilité dans laquelle se trouve la cible de montage. Les zones de disponibilité sont associées indépendamment aux noms de chacune d'entre elles Compte AWS. Par exemple, il se Compte AWS peut que votre zone `us-east-1a` de disponibilité ne soit pas la même que celle `us-east-1a` d'une autre Compte AWS.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+` 

 ** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-FileSystemId"></a>
L’ID du système de fichiers pour lequel la cible de montage est destinée.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [IpAddress](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-IpAddress"></a>
 IPv4 Adresse de la cible de montage.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 7. Longueur maximale de 15.  
Modèle : `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$` 

 ** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-Ipv6Address"></a>
 IPv6 Adresse de la cible de montage.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 39.

 ** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-LifeCycleState"></a>
État du cycle de vie de la cible de montage.  
Type : Chaîne  
Valeurs valides : `creating | available | updating | deleting | deleted | error` 

 ** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-MountTargetId"></a>
ID de cible de montage attribué par le système.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 13. Longueur maximale de 45.  
Modèle : `^fsmt-[0-9a-f]{8,40}$` 

 ** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-NetworkInterfaceId"></a>
ID de l’interface réseau créée par Amazon EFS lors de la création de la cible de montage.  
Type : Chaîne

 ** [OwnerId](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-OwnerId"></a>
 Compte AWS ID propriétaire de la ressource.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$` 

 ** [SubnetId](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-SubnetId"></a>
ID du sous-réseau de la cible de montage.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 15. Longueur maximale de 47.  
Modèle : `^subnet-[0-9a-f]{8,40}$` 

 ** [VpcId](#API_CreateMountTarget_ResponseSyntax) **   <a name="efs-CreateMountTarget-response-VpcId"></a>
ID du cloud privé virtuel (VPC) dans lequel la cible de montage est configurée.  
Type : Chaîne

## Erreurs
<a name="API_CreateMountTarget_Errors"></a>

 ** AvailabilityZonesMismatch **   
Renvoie si la zone de disponibilité spécifiée pour la cible de montage est différente de la zone de disponibilité du système de fichiers. Pour plus d’informations, reportez-vous à la section [Redondance du stockage régional et à une zone](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs).    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** IpAddressInUse **   
Renvoyé si la demande a spécifié une adresse IP (`IpAddress`ou`Ipv6Address`) déjà utilisée dans le sous-réseau.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** MountTargetConflict **   
Renvoie si la cible de montage enfreint l’une des restrictions spécifiées en fonction des cibles de montage existantes du système de fichiers.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** NetworkInterfaceLimitExceeded **   
Le compte appelant a atteint la limite d’interfaces réseau élastiques pour le compte en question Région AWS. Supprimez certaines interfaces réseau ou demandez que le quota de comptes soit augmenté. Pour plus d’informations, consultez les [Quotas Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) dans le *Guide de l’utilisateur Amazon VPC* (consultez l’entrée **Interfaces réseau par région dans le tableau des interfaces** **réseau**).     
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** NoFreeAddressesInSubnet **   
Non renvoyé `IpAddress` ou `Ipv6Address` a été fourni dans la demande et il n'y a aucune adresse IP libre dans le sous-réseau spécifié.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** SecurityGroupLimitExceeded **   
Renvoyé si le nombre `SecurityGroups` spécifié dans la demande est supérieur à la limite, qui est basée sur le quota du compte. Supprimez certains groupes de sécurité ou demandez que le quota de comptes soit augmenté. Pour plus d'informations, consultez [Amazon VPC Quotas](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) dans le *guide de l'utilisateur Amazon VPC* (voir le tableau des groupes de **sécurité**).     
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** SecurityGroupNotFound **   
Renvoyé si l’un des groupes de sécurité spécifiés n’existe pas dans le cloud privé virtuel (VPC) du sous-réseau.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** SubnetNotFound **   
Renvoyé s’il n’y a aucun sous-réseau dont l’ID est `SubnetId` fourni dans la demande.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** UnsupportedAvailabilityZone **   
Renvoyé si la fonctionnalité Amazon EFS demandée n’est pas disponible dans la Zone de disponibilité spécifiée.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Exemples
<a name="API_CreateMountTarget_Examples"></a>

### Création d'une cible de montage à une IPv4 adresse disponible sur un sous-réseau
<a name="API_CreateMountTarget_Example_1"></a>

La demande suivante spécifie uniquement le système de fichiers et le sous-réseau de la cible de montage. La cible est créée à une IPv4 adresse disponible sur le sous-réseau spécifié, avec le groupe de sécurité par défaut associé au VPC.

#### Exemple de demande
<a name="API_CreateMountTarget_Example_1_Request"></a>

```
POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```

#### Exemple de réponse
<a name="API_CreateMountTarget_Example_1_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "NetworkInterfaceId":"eni-1bcb7772"
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}
```

### Création d'une cible de montage à une IPv4 adresse spécifique
<a name="API_CreateMountTarget_Example_2"></a>

La demande suivante indique le système de fichiers, le sous-réseau, le groupe de sécurité et l' IPv4adresse à utiliser pour la cible de montage.

#### Exemple de demande
<a name="API_CreateMountTarget_Example_2_Request"></a>

```
POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-01234567",
   "IpAddress":"10.0.2.42",
   "SecurityGroups":[
      "sg-01234567"
   ]
}
```

#### Exemple de réponse
<a name="API_CreateMountTarget_Example_2_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
   "OwnerId":"251839141158",
   "MountTargetId":"fsmt-9a13661e",
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-fd04ff94",
   "LifeCycleState":"available",
   "IpAddress":"10.0.2.42",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}
```

### Création d'une cible de montage à une IPv6 adresse spécifique
<a name="API_CreateMountTarget_Example_3"></a>

La demande suivante indique le système de fichiers, le sous-réseau, le groupe de sécurité et l' IPv6adresse à utiliser pour la cible de montage. 

#### Exemple de demande
<a name="API_CreateMountTarget_Example_3_Request"></a>

```
POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-01234567",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "IpAddressType": "IPV6_ONLY",
   "SecurityGroups":[
      "sg-01234567"
   ]
}
```

#### Exemple de réponse
<a name="API_CreateMountTarget_Example_3_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
   "OwnerId":"251839141158",
   "MountTargetId":"fsmt-9a13661e",
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-fd04ff94",
   "LifeCycleState":"available",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}
```

### Création d'une cible de montage à une IPv4 adresse disponible sur un sous-réseau à double pile
<a name="API_CreateMountTarget_Example_4"></a>

La demande suivante spécifie le système de fichiers, le sous-réseau et le type d'adresse de la cible de montage. La cible est créée à une IPv4 adresse disponible sur le sous-réseau à double pile spécifié, le groupe de sécurité par défaut étant associé au VPC.

#### Exemple de demande
<a name="API_CreateMountTarget_Example_4_Request"></a>

```
POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```

#### Exemple de réponse
<a name="API_CreateMountTarget_Example_4_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
    "OwnerId": "251839141158",
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId":"subnet-fd04ff94",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}
```

### Créez une cible de montage sur des adresses IPv4 et des IPv6 adresses spécifiques sur un sous-réseau à double pile
<a name="API_CreateMountTarget_Example_5"></a>

La demande suivante indique le système de fichiers, le sous-réseau, le groupe de sécurité, l' IPv4 adresse et l' IPv6 adresse de la cible de montage. La cible est créée aux IPv6 adresses IPv4 et adresses spécifiées sur un sous-réseau à double pile.

#### Exemple de demande
<a name="API_CreateMountTarget_Example_5_Request"></a>

```
POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-01234567",
   "IpAddressType": "DUAL_STACK",
   "IpAddress": "10.0.1.25",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "SecurityGroups":[
      "sg-01234567"
   ]
}
```

#### Exemple de réponse
<a name="API_CreateMountTarget_Example_5_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "10.0.1.25",
    "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}
```

## consultez aussi
<a name="API_CreateMountTarget_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget) 

# CreateReplicationConfiguration
<a name="API_CreateReplicationConfiguration"></a>

Crée une configuration de réplication vers un système de fichiers EFS nouveau ou existant. Pour plus d’informations, consultez la [Réplication Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) dans le *Guide de l’utilisateur Amazon EFS*. La configuration de la réplication spécifie les éléments suivants :
+  **Système de fichiers source : système** de fichiers EFS que vous souhaitez répliquer. 
+  **Système de fichiers de destination : système** de fichiers de destination sur lequel le système de fichiers source est répliqué. Il ne peut y avoir qu’un seul système de fichiers de destination dans une configuration de réplication. 
**Note**  
Un système de fichiers ne peut faire partie que d’une seule configuration de réplication. 

  Les paramètres de destination pour la configuration de réplication varient selon que vous effectuez une réplication vers un nouveau système de fichiers ou vers un système de fichiers existant, et si vous effectuez une réplication entre plusieurs systèmes. Comptes AWS Pour plus d’informations, consultez [DestinationToCreate](API_DestinationToCreate.md).

Cette opération exige des autorisations pour l’action `elasticfilesystem:CreateReplicationConfiguration`. En outre, d'autres autorisations sont requises en fonction de la manière dont vous répliquez les systèmes de fichiers. Pour plus d'informations, consultez la section [Autorisations requises pour la réplication](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions) dans le *guide de l'utilisateur Amazon EFS*.

## Syntaxe de la demande
<a name="API_CreateReplicationConfiguration_RequestSyntax"></a>

```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json

{
   "Destinations": [ 
      { 
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "KmsKeyId": "string",
         "Region": "string",
         "RoleArn": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_CreateReplicationConfiguration_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **   <a name="efs-CreateReplicationConfiguration-request-uri-SourceFileSystemId"></a>
Spécifie le système de fichiers Amazon EFS que vous souhaitez répliquer. Ce système de fichiers ne peut pas déjà être un système de fichiers source ou de destination dans une autre configuration de réplication.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_CreateReplicationConfiguration_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **   <a name="efs-CreateReplicationConfiguration-request-Destinations"></a>
Un tableau d’objets de configuration de destination. Un seul objet de configuration de destination est pris en charge.  
Type : tableau d’objets [DestinationToCreate](API_DestinationToCreate.md)  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_CreateReplicationConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "Destinations": [ 
      { 
         "FileSystemId": "string",
         "LastReplicatedTimestamp": number,
         "OwnerId": "string",
         "Region": "string",
         "RoleArn": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ],
   "OriginalSourceFileSystemArn": "string",
   "SourceFileSystemArn": "string",
   "SourceFileSystemId": "string",
   "SourceFileSystemOwnerId": "string",
   "SourceFileSystemRegion": "string"
}
```

## Eléments de réponse
<a name="API_CreateReplicationConfiguration_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-CreationTime"></a>
Décrit le moment où la configuration de réplication a été créée.  
Type : Timestamp

 ** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-Destinations"></a>
Tableau d’objets de destination. Un seul objet de destination est pris en charge.  
Type : tableau d’objets [Destination](API_Destination.md)

 ** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-OriginalSourceFileSystemArn"></a>
Amazon Resource Name (ARN) du système de fichiers EFS source d’origine dans la configuration de réplication.  
Type : Chaîne

 ** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemArn"></a>
Amazon Resource Name (ARN) du système de fichiers source actuel dans la configuration de réplication.  
Type : Chaîne

 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemId"></a>
ID du système de fichiers Amazon EFS source qui est répliqué.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemOwnerId"></a>
ID du système de fichiers source Compte AWS dans lequel réside le système de fichiers.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$` 

 ** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemRegion"></a>
Le système de fichiers EFS source Région AWS dans lequel se trouve le système de fichiers EFS.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$` 

## Erreurs
<a name="API_CreateReplicationConfiguration_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** ConflictException **   
Renvoie si le système de fichiers source d’une réplication est chiffré mais que le système de fichiers de destination n’est pas chiffré.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** FileSystemLimitExceeded **   
Renvoyé si le nombre maximum de systèmes de fichiers autorisés par compte Compte AWS a déjà été créé.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 403

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InsufficientThroughputCapacity **   
Renvoyé si la capacité est insuffisante pour fournir un débit supplémentaire. Cette valeur peut être renvoyée lorsque vous essayez de créer un système de fichiers en mode débit alloué, lorsque vous essayez d’augmenter le débit alloué d’un système de fichiers existant ou lorsque vous essayez de faire passer un système de fichiers existant du mode débit en rafale au mode débit alloué. Réessayez ultérieurement.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
HTTP Status Code: 503

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ReplicationNotFound **   
Renvoyé si le système de fichiers spécifié ne possède pas de configuration de réplication.    
 ** ErrorCode **   
ReplicationNotFound  
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** ThroughputLimitExceeded **   
Renvoyé si le mode de débit ou la quantité de débit provisionné ne peuvent pas être modifiés car la limite de débit de 1024 MiB/s a été atteinte.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** UnsupportedAvailabilityZone **   
Renvoyé si la fonctionnalité Amazon EFS demandée n’est pas disponible dans la Zone de disponibilité spécifiée.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** ValidationException **   
Renvoyé si le AWS Backup service n'est pas disponible dans le Région AWS pays dans lequel la demande a été faite.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Voir aussi
<a name="API_CreateReplicationConfiguration_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 

# CreateTags
<a name="API_CreateTags"></a>

**Note**  
OBSOLÈTE - `CreateTags` est obsolète et n’est pas maintenu. Pour créer des balises pour les ressources EFS, utilisez l’action API [TagResource](API_TagResource.md).

Crée ou remplace des balises associées à un système de fichiers. Chaque balise est une paire clés-valeurs. Si une clé de balise spécifiée dans la demande existe déjà dans le système de fichiers, cette opération remplace sa valeur par la valeur fournie dans la demande. Si vous ajoutez la balise `Name` à votre système de fichiers, Amazon EFS la renvoie en réponse à l’opération [DescribeFileSystems](API_DescribeFileSystems.md). 

Cette opération nécessite une autorisation pour l’action `elasticfilesystem:CreateTags`.

## Syntaxe de la demande
<a name="API_CreateTags_RequestSyntax"></a>

```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_CreateTags_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_CreateTags_RequestSyntax) **   <a name="efs-CreateTags-request-uri-FileSystemId"></a>
L’ID du système de fichiers dont vous souhaitez modifier les balises (chaîne). Cette opération modifie uniquement les balises, pas le système de fichiers.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_CreateTags_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Tags](#API_CreateTags_RequestSyntax) **   <a name="efs-CreateTags-request-Tags"></a>
Un tableau des objets`Tag` à ajouter. Chaque objet `Tag` est une paire clé-valeur.   
Type : tableau d’objets [Tag](API_Tag.md)  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_CreateTags_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_CreateTags_ResponseElements"></a>

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

## Erreurs
<a name="API_CreateTags_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_CreateTags_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags) 

# DeleteAccessPoint
<a name="API_DeleteAccessPoint"></a>

Supprime le point d’accès spécifié. Une fois la suppression terminée, les nouveaux clients ne peuvent plus se connecter aux points d’accès. Les clients connectés au point d’accès au moment de la suppression continueront de fonctionner jusqu’à ce qu’ils mettent fin à leur connexion.

Cette opération exige des autorisations pour l’action `elasticfilesystem:DeleteAccessPoint`.

## Syntaxe de la demande
<a name="API_DeleteAccessPoint_RequestSyntax"></a>

```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteAccessPoint_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **   <a name="efs-DeleteAccessPoint-request-uri-AccessPointId"></a>
ID du point d’accès à supprimer.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteAccessPoint_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteAccessPoint_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteAccessPoint_ResponseElements"></a>

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

## Erreurs
<a name="API_DeleteAccessPoint_Errors"></a>

 ** AccessPointNotFound **   
Renvoyé si la `AccessPointId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_DeleteAccessPoint_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint) 

# DeleteFileSystem
<a name="API_DeleteFileSystem"></a>

Supprime un système de fichiers, ce qui coupe définitivement l’accès à son contenu. Au retour, le système de fichiers n’existe plus et vous ne pouvez accéder à aucun contenu du système de fichiers supprimé.

Vous devez supprimer manuellement les cibles de montage associées à un système de fichiers avant de pouvoir supprimer un système de fichiers EFS. Cette étape est exécutée pour vous lorsque vous utilisez la AWS console pour supprimer un système de fichiers.

**Note**  
Vous ne pouvez pas supprimer un système de fichiers faisant partie d'une configuration de réplication EFS. Vous devez d’abord supprimer la configuration de réplication.

 Vous ne pouvez pas supprimer un système de fichiers qui est en cours d’utilisation. En d’autres termes, si le système de fichiers possède des cibles de montage, vous devez d’abord les supprimer. Pour plus d’informations, consultez [DescribeMountTargets](API_DescribeMountTargets.md) et [DeleteMountTarget](API_DeleteMountTarget.md). 

**Note**  
L’appel `DeleteFileSystem` est renvoyé alors que l’état du système de fichiers est toujours `deleting`. Vous pouvez vérifier l’état de suppression du système de fichiers en appelant l’opération [DescribeFileSystems](API_DescribeFileSystems.md), qui renvoie la liste des systèmes de fichiers de votre compte. Si vous transmettez un ID de système de fichiers ou un jeton de création pour le système de fichiers supprimé, le [DescribeFileSystems](API_DescribeFileSystems.md) retourne une erreur `404 FileSystemNotFound`.

Cette opération exige des autorisations pour l’action `elasticfilesystem:DeleteFileSystem`.

## Syntaxe de la demande
<a name="API_DeleteFileSystem_RequestSyntax"></a>

```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteFileSystem_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **   <a name="efs-DeleteFileSystem-request-uri-FileSystemId"></a>
ID du système de fichiers que vous souhaitez supprimer.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteFileSystem_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteFileSystem_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteFileSystem_ResponseElements"></a>

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

## Erreurs
<a name="API_DeleteFileSystem_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemInUse **   
Renvoie si un système de fichiers possède des cibles de montage.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Exemples
<a name="API_DeleteFileSystem_Examples"></a>

### Supprimer un système de fichiers
<a name="API_DeleteFileSystem_Example_1"></a>

L’exemple suivant envoie une demande DELETE au point de terminaison `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`) pour supprimer un système de fichiers dont l’ID est `fs-01234567`. 

#### Exemple de demande
<a name="API_DeleteFileSystem_Example_1_Request"></a>

```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```

#### Exemple de réponse
<a name="API_DeleteFileSystem_Example_1_Response"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```

## consultez aussi
<a name="API_DeleteFileSystem_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 

# DeleteFileSystemPolicy
<a name="API_DeleteFileSystemPolicy"></a>

Supprime le `FileSystemPolicy` pour le système de fichiers spécifié. La valeur par défaut `FileSystemPolicy` entre en vigueur une fois que la politique existante est supprimée. Pour plus d’informations sur la politique de système de fichiers par défaut, consultez [Utilisation de politiques basées sur les ressources avec EFS](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html).

Cette opération exige des autorisations pour l’action `elasticfilesystem:DeleteFileSystemPolicy`.

## Syntaxe de la demande
<a name="API_DeleteFileSystemPolicy_RequestSyntax"></a>

```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteFileSystemPolicy_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **   <a name="efs-DeleteFileSystemPolicy-request-uri-FileSystemId"></a>
Spécifie le système de fichiers EFS pour lequel vous souhaitez supprimer le`FileSystemPolicy`.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteFileSystemPolicy_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteFileSystemPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Eléments de réponse
<a name="API_DeleteFileSystemPolicy_ResponseElements"></a>

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

## Erreurs
<a name="API_DeleteFileSystemPolicy_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_DeleteFileSystemPolicy_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) 

# DeleteMountTarget
<a name="API_DeleteMountTarget"></a>

Supprime la cible de montage spécifiée.

Cette opération interrompt de force tous les montages du système de fichiers en utilisant la cible de montage qui est supprimée, ce qui peut perturber les instances ou les applications qui utilisent ces montages. Pour éviter que les applications ne soient interrompues brusquement, vous pouvez envisager de démonter tous les supports de la cible de montage, si possible. L’opération supprime également l’interface réseau associée. Les écritures non validées peuvent être perdues, mais le fait de casser une cible de montage à l’aide de cette opération ne corrompt pas le système de fichiers lui-même. Le système de fichiers que vous avez créé est conservé. Vous pouvez monter une EC2 instance dans votre VPC en utilisant une autre cible de montage.

Cette opération exige des autorisations pour l’action suivante sur le système de fichiers :
+  `elasticfilesystem:DeleteMountTarget` 

**Note**  
L’appel `DeleteMountTarget` est renvoyé alors que l’état de la cible de montage est toujours actif`deleting`. Vous pouvez vérifier la suppression de la cible de montage en appelant l’opération [DescribeMountTargets](API_DescribeMountTargets.md), qui renvoie une liste des descriptions des cibles de montage pour le système de fichiers donné. 

L'opération nécessite également des autorisations pour l' EC2 action Amazon suivante sur l'interface réseau de la cible de montage :
+  `ec2:DeleteNetworkInterface` 

## Syntaxe de la demande
<a name="API_DeleteMountTarget_RequestSyntax"></a>

```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteMountTarget_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **   <a name="efs-DeleteMountTarget-request-uri-MountTargetId"></a>
ID de la cible de montage à supprimer (chaîne).  
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
<a name="API_DeleteMountTarget_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteMountTarget_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteMountTarget_ResponseElements"></a>

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

## Erreurs
<a name="API_DeleteMountTarget_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** DependencyTimeout **   
Le délai imparti pour répondre à la demande a expiré et le client doit réessayer l’appel.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 504

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** MountTargetNotFound **   
Renvoyé s’il n’y a aucune cible de montage avec l’identifiant spécifié dans celui de l’appelant Compte AWS.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

## Exemples
<a name="API_DeleteMountTarget_Examples"></a>

### Supprimer la cible de montage d’un système de fichiers
<a name="API_DeleteMountTarget_Example_1"></a>

L’exemple suivant envoie une demande DELETE pour supprimer une cible de montage spécifique. 

#### Exemple de demande
<a name="API_DeleteMountTarget_Example_1_Request"></a>

```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```

#### Exemple de réponse
<a name="API_DeleteMountTarget_Example_1_Response"></a>

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

## consultez aussi
<a name="API_DeleteMountTarget_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget) 

# DeleteReplicationConfiguration
<a name="API_DeleteReplicationConfiguration"></a>

Supprimer une configuration de réplication La suppression d’une configuration de réplication met fin au processus de réplication. Après la suppression d’une configuration de réplication, le système de fichiers de destination devient `Writeable` et sa protection contre le remplacement de la réplication est réactivée. Pour plus d’informations, consultez [Supprimer une configuration de réplication](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html).

Cette opération exige des autorisations pour l’action `elasticfilesystem:DeleteReplicationConfiguration`. 

## Syntaxe de la demande
<a name="API_DeleteReplicationConfiguration_RequestSyntax"></a>

```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteReplicationConfiguration_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **   <a name="efs-DeleteReplicationConfiguration-request-uri-DeletionMode"></a>
Lors de la réplication croisée Comptes AWS ou croisée Régions AWS, Amazon EFS supprime la configuration de réplication à la fois du compte source et de destination ou de la région (`ALL_CONFIGURATIONS`) par défaut. Si un problème de configuration ou d'autorisation empêche Amazon EFS de supprimer la configuration de réplication des deux côtés, vous pouvez utiliser ce `LOCAL_CONFIGURATION_ONLY` mode pour supprimer la configuration de réplication uniquement du côté local (le compte ou la région à partir duquel la suppression est effectuée).   
Utilisez ce `LOCAL_CONFIGURATION_ONLY` mode uniquement dans le cas où Amazon EFS ne parvient pas à supprimer la configuration de réplication dans le compte ou la région source et de destination. La suppression de la configuration locale rend la configuration de l'autre compte ou de l'autre région irrécupérable.  
En outre, n'utilisez pas ce mode pour la réplication entre le même compte et la même région, car cela entraîne une erreur d'exception. BadRequest 
Valeurs valides : `ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY` 

 ** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) **   <a name="efs-DeleteReplicationConfiguration-request-uri-SourceFileSystemId"></a>
ID du système de fichiers source dans la configuration de réplication.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteReplicationConfiguration_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteReplicationConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteReplicationConfiguration_ResponseElements"></a>

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

## Erreurs
<a name="API_DeleteReplicationConfiguration_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ReplicationNotFound **   
Renvoyé si le système de fichiers spécifié ne possède pas de configuration de réplication.    
 ** ErrorCode **   
ReplicationNotFound  
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

## Voir aussi
<a name="API_DeleteReplicationConfiguration_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) 

# DeleteTags
<a name="API_DeleteTags"></a>

**Note**  
OBSOLÈTE - `DeleteTags` est obsolète et n’est pas maintenu. Pour supprimer les balises des ressources EFS, utilisez l’action API [UntagResource](API_UntagResource.md).

Supprime les balises spécifiées à partir d’un système de fichiers. Si la demande `DeleteTags` inclut une clé de balise qui n’existe pas, Amazon EFS l’ignore et ne provoque aucune erreur. Pour plus d'informations sur les balises et les restrictions associées, consultez la section [Restrictions relatives aux balises](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dans le *guide de AWS Billing and Cost Management l'utilisateur*.

Cette opération exige des autorisations pour l’action `elasticfilesystem:DeleteTags`.

## Syntaxe de la demande
<a name="API_DeleteTags_RequestSyntax"></a>

```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json

{
   "TagKeys": [ "string" ]
}
```

## Paramètres de demande URI
<a name="API_DeleteTags_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DeleteTags_RequestSyntax) **   <a name="efs-DeleteTags-request-uri-FileSystemId"></a>
L’ID du système de fichiers dont vous souhaitez supprimer les balises (chaîne).  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteTags_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [TagKeys](#API_DeleteTags_RequestSyntax) **   <a name="efs-DeleteTags-request-TagKeys"></a>
Une liste de clés d’étiquette à supprimer.  
Type : tableau de chaînes  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_DeleteTags_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteTags_ResponseElements"></a>

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

## Erreurs
<a name="API_DeleteTags_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_DeleteTags_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags) 

# DescribeAccessPoints
<a name="API_DescribeAccessPoints"></a>

Renvoie la description d’un point d’accès Amazon EFS spécifique si `AccessPointId` est fourni. Si vous fournissez un EFS `FileSystemId`, il renvoie les descriptions de tous les points d’accès pour ce système de fichiers. Vous pouvez fournir un `AccessPointId` ou un `FileSystemId` dans la demande, mais pas les deux. 

Cette opération exige des autorisations pour l’action `elasticfilesystem:DescribeAccessPoints`.

## Syntaxe de la demande
<a name="API_DescribeAccessPoints_RequestSyntax"></a>

```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeAccessPoints_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **   <a name="efs-DescribeAccessPoints-request-uri-AccessPointId"></a>
(Facultatif) Spécifie un point d’accès EFS à décrire dans la réponse ; il s’exclut mutuellement avec `FileSystemId`.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` 

 ** [FileSystemId](#API_DescribeAccessPoints_RequestSyntax) **   <a name="efs-DescribeAccessPoints-request-uri-FileSystemId"></a>
(Facultatif) Si vous fournissez un `FileSystemId`, EFS renvoie tous les points d’accès à ce système de fichiers ; ils s’excluent mutuellement avec `AccessPointId`.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) **   <a name="efs-DescribeAccessPoints-request-uri-MaxResults"></a>
(Facultatif) Lorsque vous récupérez tous les points d’accès d’un système de fichiers, vous pouvez éventuellement spécifier le paramètre `MaxItems` pour limiter le nombre d’objets renvoyés dans une réponse. La valeur par défaut est 100.   
Plage valide : valeur minimum de 1.

 ** [NextToken](#API_DescribeAccessPoints_RequestSyntax) **   <a name="efs-DescribeAccessPoints-request-uri-NextToken"></a>
 `NextToken` est présent si la charge utile de la réponse est paginée. Vous pouvez utiliser `NextMarker` pour une demande ultérieure pour obtenir la page suivante de descriptions de points d’accès.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `.+` 

## Corps de la demande
<a name="API_DescribeAccessPoints_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeAccessPoints_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccessPoints": [ 
      { 
         "AccessPointArn": "string",
         "AccessPointId": "string",
         "ClientToken": "string",
         "FileSystemId": "string",
         "LifeCycleState": "string",
         "Name": "string",
         "OwnerId": "string",
         "PosixUser": { 
            "Gid": number,
            "SecondaryGids": [ number ],
            "Uid": number
         },
         "RootDirectory": { 
            "CreationInfo": { 
               "OwnerGid": number,
               "OwnerUid": number,
               "Permissions": "string"
            },
            "Path": "string"
         },
         "Tags": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      }
   ],
   "NextToken": "string"
}
```

## Eléments de réponse
<a name="API_DescribeAccessPoints_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) **   <a name="efs-DescribeAccessPoints-response-AccessPoints"></a>
Un ensemble de descriptions de points d’accès.  
Type : tableau d’objets [AccessPointDescription](API_AccessPointDescription.md)

 ** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **   <a name="efs-DescribeAccessPoints-response-NextToken"></a>
Présent s’il y a plus de points d’accès que ceux renvoyés dans la réponse. Vous pouvez utiliser le NextMarker dans la requête suivante pour récupérer les descriptions supplémentaires.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

## Erreurs
<a name="API_DescribeAccessPoints_Errors"></a>

 ** AccessPointNotFound **   
Renvoyé si la `AccessPointId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_DescribeAccessPoints_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) 

# DescribeAccountPreferences
<a name="API_DescribeAccountPreferences"></a>

Renvoie les paramètres des préférences du compte pour le compte Compte AWS associé à l'utilisateur qui fait la demande, dans la version actuelle Région AWS.

## Syntaxe de la demande
<a name="API_DescribeAccountPreferences_RequestSyntax"></a>

```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json

{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Paramètres de demande URI
<a name="API_DescribeAccountPreferences_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_DescribeAccountPreferences_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **   <a name="efs-DescribeAccountPreferences-request-MaxResults"></a>
(Facultatif) Lorsque vous récupérez les préférences du compte, vous pouvez éventuellement spécifier le paramètre `MaxItems` pour limiter le nombre d’objets renvoyés dans une réponse. La valeur par défaut est 100.   
Type : entier  
Plage valide : Valeur minimum de 1.  
Obligatoire : non

 ** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) **   <a name="efs-DescribeAccountPreferences-request-NextToken"></a>
(Facultatif) Vous pouvez utiliser `NextToken` dans une requête ultérieure pour récupérer la page suivante de préférences Compte AWS des points d’accès si la charge utile de la réponse a été paginée.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+`   
Obligatoire : non

## Syntaxe de la réponse
<a name="API_DescribeAccountPreferences_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ResourceIdPreference": { 
      "ResourceIdType": "string",
      "Resources": [ "string" ]
   }
}
```

## Eléments de réponse
<a name="API_DescribeAccountPreferences_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [NextToken](#API_DescribeAccountPreferences_ResponseSyntax) **   <a name="efs-DescribeAccountPreferences-response-NextToken"></a>
Présent s’il y a plus d’enregistrements que ceux renvoyés dans la réponse. Vous pouvez utiliser `NextToken` dans la requête suivante pour récupérer les descriptions supplémentaires.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

 ** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) **   <a name="efs-DescribeAccountPreferences-response-ResourceIdPreference"></a>
Décrit le paramètre de préférence d'ID de ressource Compte AWS associé à l'utilisateur qui fait la demande, dans la version actuelle Région AWS.  
Type : objet [ResourceIdPreference](API_ResourceIdPreference.md)

## Erreurs
<a name="API_DescribeAccountPreferences_Errors"></a>

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_DescribeAccountPreferences_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) 

# DescribeBackupPolicy
<a name="API_DescribeBackupPolicy"></a>

Renvoie la politique de sauvegarde pour le système de fichiers EFS spécifié.

## Syntaxe de la demande
<a name="API_DescribeBackupPolicy_RequestSyntax"></a>

```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeBackupPolicy_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **   <a name="efs-DescribeBackupPolicy-request-uri-FileSystemId"></a>
Spécifie le système de fichiers EFS pour lequel récupérer le `BackupPolicy`.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DescribeBackupPolicy_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeBackupPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPolicy": { 
      "Status": "string"
   }
}
```

## Eléments de réponse
<a name="API_DescribeBackupPolicy_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) **   <a name="efs-DescribeBackupPolicy-response-BackupPolicy"></a>
Décrit la politique de sauvegarde du système de fichiers, en indiquant si les sauvegardes automatiques sont activées ou désactivées.  
Type : objet [BackupPolicy](API_BackupPolicy.md)

## Erreurs
<a name="API_DescribeBackupPolicy_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** PolicyNotFound **   
Renvoyé si la stratégie IAM ou la politique de ressources spécifiée est introuvable ou accessible. En fonction de l'action exécutée, l'erreur peut également être renvoyée si la politique du système de fichiers par défaut est en vigueur pour le système de fichiers EFS ou si aucune politique de sauvegarde n'est spécifiée.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** ValidationException **   
Renvoyé si le AWS Backup service n'est pas disponible dans le Région AWS pays dans lequel la demande a été faite.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Voir aussi
<a name="API_DescribeBackupPolicy_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) 

# DescribeFileSystemPolicy
<a name="API_DescribeFileSystemPolicy"></a>

Renvoie le `FileSystemPolicy` pour le système de fichiers EFS spécifié.

Cette opération exige des autorisations pour l’action `elasticfilesystem:DescribeFileSystemPolicy`.

## Syntaxe de la demande
<a name="API_DescribeFileSystemPolicy_RequestSyntax"></a>

```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeFileSystemPolicy_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **   <a name="efs-DescribeFileSystemPolicy-request-uri-FileSystemId"></a>
Spécifie le système de fichiers EFS pour lequel récupérer le `FileSystemPolicy`.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DescribeFileSystemPolicy_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeFileSystemPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FileSystemId": "string",
   "Policy": "string"
}
```

## Eléments de réponse
<a name="API_DescribeFileSystemPolicy_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [FileSystemId](#API_DescribeFileSystemPolicy_ResponseSyntax) **   <a name="efs-DescribeFileSystemPolicy-response-FileSystemId"></a>
Spécifie le système de fichiers EFS auquel s’applique `FileSystemPolicy`.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [Policy](#API_DescribeFileSystemPolicy_ResponseSyntax) **   <a name="efs-DescribeFileSystemPolicy-response-Policy"></a>
Le JSON formaté `FileSystemPolicy` pour le système de fichiers EFS.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 20000.  
Modèle : `[\s\S]+` 

## Erreurs
<a name="API_DescribeFileSystemPolicy_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** PolicyNotFound **   
Renvoyé si la stratégie IAM ou la politique de ressources spécifiée est introuvable ou accessible. En fonction de l'action exécutée, l'erreur peut également être renvoyée si la politique du système de fichiers par défaut est en vigueur pour le système de fichiers EFS ou si aucune politique de sauvegarde n'est spécifiée.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

## Exemples
<a name="API_DescribeFileSystemPolicy_Examples"></a>

### Exemple
<a name="API_DescribeFileSystemPolicy_Example_1"></a>

Cet exemple illustre une utilisation de DescribeFileSystemPolicy.

#### Exemple de demande
<a name="API_DescribeFileSystemPolicy_Example_1_Request"></a>

```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```

#### Exemple de réponse
<a name="API_DescribeFileSystemPolicy_Example_1_Response"></a>

```
{
    "FileSystemId": "fs-01234567",
    "Policy": "{
        "Version": "2012-10-17",		 	 	 
        "Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
        "Statement": [ 
            {
                "Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
                "Effect" : "Deny",
                "Principal": {
                "AWS": "*"
                },
                "Action": "*",
                "Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
                "Condition": {
                "Bool": {
                    "aws:SecureTransport": "false"
                    } 
                }
            }, 
            {
                "Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
                "Effect": "Allow",
                "Principal": {
                    "AWS": "*"
                },
                "Action": [
                    "elasticfilesystem:ClientMount", 
                    "elasticfilesystem:ClientWrite" 
                ],
                "Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567"
            }
        ]
    }
}
```

## consultez aussi
<a name="API_DescribeFileSystemPolicy_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) 

# DescribeFileSystems
<a name="API_DescribeFileSystems"></a>

Renvoie la description d’un système de fichiers Amazon EFS spécifique si le système de fichiers `CreationToken` ou le `FileSystemId` est fourni. Dans le cas contraire, il renvoie des descriptions de tous les systèmes de fichiers appartenant Compte AWS à Région AWS l'appelant dans le terminal que vous appelez.

Lorsque vous récupérez toutes les descriptions des systèmes de fichiers, vous pouvez éventuellement spécifier le paramètre `MaxItems` pour limiter le nombre de descriptions dans une réponse. Ce nombre est automatiquement fixé à 100. S’il reste d’autres descriptions de systèmes de fichiers `NextMarker`, Amazon EFS renvoie un jeton opaque dans la réponse. Dans ce cas, vous devez envoyer une demande suivante avec le paramètre de demande `Marker` défini sur la valeur de `NextMarker`. 

Pour récupérer la liste des descriptions de votre système de fichiers, cette opération est utilisée dans un processus itératif, dans lequel elle `DescribeFileSystems` est d’abord appelée sans le `Marker`, puis l’opération continue à l’appeler avec le paramètre `Marker` défini sur la valeur de `NextMarker` de la réponse précédente jusqu’à ce que la réponse n’a pas de `NextMarker`. 

 L’ordre des systèmes de fichiers renvoyés en réponse à un `DescribeFileSystems` appel et l’ordre des systèmes de fichiers renvoyés dans les réponses d’une itération à appels multiples ne sont pas spécifiés. 

 Cette opération exige des autorisations pour l’action `elasticfilesystem:DescribeFileSystems`. 

## Syntaxe de la demande
<a name="API_DescribeFileSystems_RequestSyntax"></a>

```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeFileSystems_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **   <a name="efs-DescribeFileSystems-request-uri-CreationToken"></a>
(Facultatif) Limite la liste au système de fichiers avec ce jeton de création (chaîne). Vous spécifiez un jeton de création lorsque vous créez un système de fichiers Amazon EFS.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+` 

 ** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) **   <a name="efs-DescribeFileSystems-request-uri-FileSystemId"></a>
(Facultatif) ID du système de fichiers dont vous souhaitez récupérer la description (chaîne).  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [Marker](#API_DescribeFileSystems_RequestSyntax) **   <a name="efs-DescribeFileSystems-request-uri-Marker"></a>
(Facultatif) Un jeton de pagination opaque renvoyé par une opération `DescribeFileSystems` précédente (chaîne). Le cas échéant, indique de continuer la liste à partir de laquelle l’appel de retour s’était arrêté.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `.+` 

 ** [MaxItems](#API_DescribeFileSystems_RequestSyntax) **   <a name="efs-DescribeFileSystems-request-uri-MaxItems"></a>
(Facultatif) Spécifie le nombre maximum de systèmes de fichiers à renvoyer dans la réponse (entier). Ce nombre est automatiquement fixé à 100. La réponse est paginée à 100 par page si vous avez plus de 100 systèmes de fichiers.   
Plage valide : valeur minimum de 1.

## Corps de la requête
<a name="API_DescribeFileSystems_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeFileSystems_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FileSystems": [ 
      { 
         "AvailabilityZoneId": "string",
         "AvailabilityZoneName": "string",
         "CreationTime": number,
         "CreationToken": "string",
         "Encrypted": boolean,
         "FileSystemArn": "string",
         "FileSystemId": "string",
         "FileSystemProtection": { 
            "ReplicationOverwriteProtection": "string"
         },
         "KmsKeyId": "string",
         "LifeCycleState": "string",
         "Name": "string",
         "NumberOfMountTargets": number,
         "OwnerId": "string",
         "PerformanceMode": "string",
         "ProvisionedThroughputInMibps": number,
         "SizeInBytes": { 
            "Timestamp": number,
            "Value": number,
            "ValueInArchive": number,
            "ValueInIA": number,
            "ValueInStandard": number
         },
         "Tags": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "ThroughputMode": "string"
      }
   ],
   "Marker": "string",
   "NextMarker": "string"
}
```

## Eléments de réponse
<a name="API_DescribeFileSystems_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) **   <a name="efs-DescribeFileSystems-response-FileSystems"></a>
Tableau de descriptions de systèmes de fichiers.  
Type : tableau d’objets [FileSystemDescription](API_FileSystemDescription.md)

 ** [Marker](#API_DescribeFileSystems_ResponseSyntax) **   <a name="efs-DescribeFileSystems-response-Marker"></a>
Présent s’il est fourni par l’appelant dans la demande (chaîne).  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

 ** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) **   <a name="efs-DescribeFileSystems-response-NextMarker"></a>
Présent s’il y a plus de systèmes de fichiers que ceux renvoyés dans la réponse (String). Vous pouvez utiliser `NextMarker` dans la requête suivante pour récupérer les descriptions.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

## Erreurs
<a name="API_DescribeFileSystems_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Exemples
<a name="API_DescribeFileSystems_Examples"></a>

### Extrait une liste de 10 systèmes de fichiers
<a name="API_DescribeFileSystems_Example_1"></a>

 L’exemple suivant envoie une requête GET au `file-systems` point de terminaison (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`). La demande spécifie un paramètre de requête `MaxItems` pour limiter le nombre de descriptions de systèmes de fichiers à 10.

#### Exemple de demande
<a name="API_DescribeFileSystems_Example_1_Request"></a>

```
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>
```

#### Exemple de réponse
<a name="API_DescribeFileSystems_Example_1_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
   "FileSystems":[
      {
         "OwnerId":"251839141158",
         "CreationToken":"MyFileSystem1",
         "FileSystemId":"fs-01234567",
         "PerformanceMode" : "generalPurpose",
         "CreationTime":"1403301078",
         "LifeCycleState":"created",
         "Name":"my first file system",
         "NumberOfMountTargets":1,
         "SizeInBytes":{
            "Timestamp": 1403301078,
            "Value": 29313618372,
            "ValueInArchive": 201156,
            "ValueInIA": 675432,
            "ValueInStandard": 29312741784
         }
      }
   ]
}
```

## consultez aussi
<a name="API_DescribeFileSystems_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems) 

# DescribeLifecycleConfiguration
<a name="API_DescribeLifecycleConfiguration"></a>

Renvoie l'`LifecycleConfiguration`objet actuel pour le système de fichiers EFS spécifié. La gestion du cycle de vie utilise l’objet `LifecycleConfiguration` pour identifier le moment où il convient de déplacer des fichiers entre les classes de stockage. Pour un système de fichiers sans objet `LifecycleConfiguration`, l’appel renvoie un tableau vide dans la réponse.

Cette opération exige des autorisations pour l’opération `elasticfilesystem:DescribeLifecycleConfiguration`.

## Syntaxe de la demande
<a name="API_DescribeLifecycleConfiguration_RequestSyntax"></a>

```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeLifecycleConfiguration_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **   <a name="efs-DescribeLifecycleConfiguration-request-uri-FileSystemId"></a>
L’ID du système de fichiers dont vous souhaitez récupérer l’objet `LifecycleConfiguration` (String).  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DescribeLifecycleConfiguration_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeLifecycleConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_DescribeLifecycleConfiguration_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) **   <a name="efs-DescribeLifecycleConfiguration-response-LifecyclePolicies"></a>
Un ensemble de politiques de gestion du cycle de vie. EFS prend en charge au maximum une politique par système de fichiers.  
Type : tableau d’objets [LifecyclePolicy](API_LifecyclePolicy.md)  
Membres du tableau : nombre maximum de 3 éléments.

## Erreurs
<a name="API_DescribeLifecycleConfiguration_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Exemples
<a name="API_DescribeLifecycleConfiguration_Examples"></a>

### Récupérer la configuration du cycle de vie d’un système de fichiers
<a name="API_DescribeLifecycleConfiguration_Example_1"></a>

La requête suivante récupère l’objet `LifecycleConfiguration` pour le système de fichiers spécifié.

#### Exemple de demande
<a name="API_DescribeLifecycleConfiguration_Example_1_Request"></a>

```
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
```

#### Exemple de réponse
<a name="API_DescribeLifecycleConfiguration_Example_1_Response"></a>

```
HTTP/1.1 200 OK
        x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
        Content-Type: application/json
        Content-Length: 86
{
  "LifecyclePolicies": [
    {
        "TransitionToArchive": "AFTER_270_DAYS"
    },
    {
        "TransitionToIA": "AFTER_14_DAYS" 
    },
    {
        "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
    }
  ]
}
```

## consultez aussi
<a name="API_DescribeLifecycleConfiguration_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 

# DescribeMountTargets
<a name="API_DescribeMountTargets"></a>

Renvoie les descriptions de toutes les cibles de montage actuelles, ou une cible de montage spécifique, pour un système de fichiers. Lorsque vous demandez toutes les cibles de montage actuelles, l’ordre des cibles de montage renvoyées dans la réponse n’est pas spécifié.

Cette opération nécessite des autorisations pour l’action `elasticfilesystem:DescribeMountTargets`, soit sur l’ID du système de fichiers que vous spécifiez dans `FileSystemId`, soit sur le système de fichiers de la cible de montage dans laquelle vous spécifiez dans `MountTargetId`.

La commande CLI correspondante est`describe-mount-targets`.

## Syntaxe de la demande
<a name="API_DescribeMountTargets_RequestSyntax"></a>

```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeMountTargets_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-AccessPointId"></a>
(Facultatif) L’ID du point d’accès dont vous souhaitez répertorier les cibles de montage. Il doit être inclus dans votre demande si un `FileSystemId` ou `MountTargetId` n’est pas inclus dans votre demande. Accepte un ID de point d’accès ou un ARN en entrée.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` 

 ** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-FileSystemId"></a>
(Facultatif) ID du système de fichiers dont vous souhaitez répertorier les cibles de montage (chaîne). Il doit être inclus dans votre demande si un `AccessPointId` ou `MountTargetId` n’est pas inclus. Accepte un ID de système de fichiers ou un ARN en entrée.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [Marker](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-Marker"></a>
(Facultatif) Un jeton de pagination opaque renvoyé par une opération `DescribeMountTargets` précédente (chaîne). S’il est présent, il indique de continuer la liste à partir de l’endroit où le précédent appel de retour s’est arrêté.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `.+` 

 ** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-MaxItems"></a>
(Facultatif) Nombre maximum de cibles de montage à renvoyer dans la réponse. Actuellement, ce nombre est automatiquement défini sur 10 et les autres valeurs sont ignorées. La réponse est paginée à 100 par page si vous avez plus de 100 cibles de montage.  
Plage valide : valeur minimum de 1.

 ** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-MountTargetId"></a>
(Facultatif) ID de la cible de montage que vous souhaitez faire décrire (chaîne). Il doit être inclus dans votre demande si `FileSystemId` n’est pas inclus. Accepte un ID de cible de montage ou un ARN en entrée.  
Contraintes de longueur : longueur minimale de 13. Longueur maximale de 45.  
Modèle : `^fsmt-[0-9a-f]{8,40}$` 

## Corps de la demande
<a name="API_DescribeMountTargets_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeMountTargets_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Marker": "string",
   "MountTargets": [ 
      { 
         "AvailabilityZoneId": "string",
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "IpAddress": "string",
         "Ipv6Address": "string",
         "LifeCycleState": "string",
         "MountTargetId": "string",
         "NetworkInterfaceId": "string",
         "OwnerId": "string",
         "SubnetId": "string",
         "VpcId": "string"
      }
   ],
   "NextMarker": "string"
}
```

## Eléments de réponse
<a name="API_DescribeMountTargets_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Marker](#API_DescribeMountTargets_ResponseSyntax) **   <a name="efs-DescribeMountTargets-response-Marker"></a>
Si la demande inclut le `Marker`, la réponse renvoie cette valeur dans ce champ.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

 ** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **   <a name="efs-DescribeMountTargets-response-MountTargets"></a>
Renvoie les cibles de montage du système de fichiers sous forme de tableau d’objets `MountTargetDescription`.  
Type : tableau d’objets [MountTargetDescription](API_MountTargetDescription.md)

 ** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **   <a name="efs-DescribeMountTargets-response-NextMarker"></a>
Si une valeur est présente, il y a plus de cibles de montages à renvoyer. Dans une demande ultérieure, vous pouvez fournir `Marker` dans votre demande pour récupérer le prochain ensemble de cibles de montage.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

## Erreurs
<a name="API_DescribeMountTargets_Errors"></a>

 ** AccessPointNotFound **   
Renvoyé si la `AccessPointId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** MountTargetNotFound **   
Renvoyé s’il n’y a aucune cible de montage avec l’identifiant spécifié dans celui de l’appelant Compte AWS.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

## Exemples
<a name="API_DescribeMountTargets_Examples"></a>

### Récupère les descriptions des cibles de montage créées pour un système de fichiers
<a name="API_DescribeMountTargets_Example_1"></a>

La requête suivante récupère les descriptions des cibles de montage créées pour le système de fichiers spécifié. 

#### Exemple de demande
<a name="API_DescribeMountTargets_Example_1_Request"></a>

```
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>
```

#### Exemple de réponse
<a name="API_DescribeMountTargets_Example_1_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357

{
   "MountTargets":[
      {
         "OwnerId":"251839141158",
         "MountTargetId":"fsmt-01234567",
         "FileSystemId":"fs-01234567",
         "SubnetId":"subnet-01234567",
         "LifeCycleState":"added",
         "IpAddress":"10.0.2.42",
         "NetworkInterfaceId":"eni-1bcb7772"
      }
   ]
}
```

## consultez aussi
<a name="API_DescribeMountTargets_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets) 

# DescribeMountTargetSecurityGroups
<a name="API_DescribeMountTargetSecurityGroups"></a>

Renvoie les groupes de sécurité actuellement en vigueur pour une cible de montage. 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 n’est pas `deleted`.

Cette opération nécessite des autorisations pour les actions suivantes :
+  action `elasticfilesystem:DescribeMountTargetSecurityGroups` sur le système de fichiers de la cible de montage. 
+  action `ec2:DescribeNetworkInterfaceAttribute` sur l’interface réseau de la cible de montage. 

## Syntaxe de la demande
<a name="API_DescribeMountTargetSecurityGroups_RequestSyntax"></a>

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

## Paramètres de demande URI
<a name="API_DescribeMountTargetSecurityGroups_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **   <a name="efs-DescribeMountTargetSecurityGroups-request-uri-MountTargetId"></a>
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
<a name="API_DescribeMountTargetSecurityGroups_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeMountTargetSecurityGroups_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SecurityGroups": [ "string" ]
}
```

## Eléments de réponse
<a name="API_DescribeMountTargetSecurityGroups_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) **   <a name="efs-DescribeMountTargetSecurityGroups-response-SecurityGroups"></a>
Tableau de groupes de sécurité.  
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}` 

## Erreurs
<a name="API_DescribeMountTargetSecurityGroups_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** IncorrectMountTargetState **   
Renvoyé si l’état de la cible de montage n’est pas correct pour l’opération.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** MountTargetNotFound **   
Renvoyé s’il n’y a aucune cible de montage avec l’identifiant spécifié dans celui de l’appelant Compte AWS.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

## Exemples
<a name="API_DescribeMountTargetSecurityGroups_Examples"></a>

### Récupérer les groupes de sécurité en vigueur pour un système de fichiers.
<a name="API_DescribeMountTargetSecurityGroups_Example_1"></a>

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

#### Exemple de demande
<a name="API_DescribeMountTargetSecurityGroups_Example_1_Request"></a>

```
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: <...>
```

#### Exemple de réponse
<a name="API_DescribeMountTargetSecurityGroups_Example_1_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57

{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```

## consultez aussi
<a name="API_DescribeMountTargetSecurityGroups_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) 

# DescribeReplicationConfigurations
<a name="API_DescribeReplicationConfigurations"></a>

Récupère la configuration de réplication pour un système de fichiers spécifique. Si aucun système de fichiers n'est spécifié, toutes les configurations de réplication pour le Compte AWS in an Région AWS sont récupérées.

## Syntaxe de la demande
<a name="API_DescribeReplicationConfigurations_RequestSyntax"></a>

```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeReplicationConfigurations_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **   <a name="efs-DescribeReplicationConfigurations-request-uri-FileSystemId"></a>
Vous pouvez récupérer la configuration de réplication pour un système de fichiers spécifique en fournissant son ID de système de fichiers. Pour la réplication entre comptes et entre régions, un compte peut uniquement décrire la configuration de réplication d'un système de fichiers dans sa propre région.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [MaxResults](#API_DescribeReplicationConfigurations_RequestSyntax) **   <a name="efs-DescribeReplicationConfigurations-request-uri-MaxResults"></a>
(Facultatif) Pour limiter le nombre d’objets renvoyés dans une réponse, vous pouvez spécifier le paramètre `MaxItems`. La valeur par défaut est 100.   
Plage valide : valeur minimum de 1.

 ** [NextToken](#API_DescribeReplicationConfigurations_RequestSyntax) **   <a name="efs-DescribeReplicationConfigurations-request-uri-NextToken"></a>
 `NextToken` est présent si la charge utile de la réponse est paginée. Vous pouvez utiliser `NextToken` dans une requête ultérieure pour récupérer la page de sortie suivante.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `.+` 

## Corps de la demande
<a name="API_DescribeReplicationConfigurations_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeReplicationConfigurations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Replications": [ 
      { 
         "CreationTime": number,
         "Destinations": [ 
            { 
               "FileSystemId": "string",
               "LastReplicatedTimestamp": number,
               "OwnerId": "string",
               "Region": "string",
               "RoleArn": "string",
               "Status": "string",
               "StatusMessage": "string"
            }
         ],
         "OriginalSourceFileSystemArn": "string",
         "SourceFileSystemArn": "string",
         "SourceFileSystemId": "string",
         "SourceFileSystemOwnerId": "string",
         "SourceFileSystemRegion": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_DescribeReplicationConfigurations_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [NextToken](#API_DescribeReplicationConfigurations_ResponseSyntax) **   <a name="efs-DescribeReplicationConfigurations-response-NextToken"></a>
Vous pouvez utiliser `NextToken` dans la requête suivante pour récupérer les descriptions supplémentaires.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

 ** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) **   <a name="efs-DescribeReplicationConfigurations-response-Replications"></a>
Ensemble de configurations de réplication renvoyé.  
Type : tableau d’objets [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md)

## Erreurs
<a name="API_DescribeReplicationConfigurations_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ReplicationNotFound **   
Renvoyé si le système de fichiers spécifié ne possède pas de configuration de réplication.    
 ** ErrorCode **   
ReplicationNotFound  
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** ValidationException **   
Renvoyé si le AWS Backup service n'est pas disponible dans le Région AWS pays dans lequel la demande a été faite.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Voir aussi
<a name="API_DescribeReplicationConfigurations_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) 

# DescribeTags
<a name="API_DescribeTags"></a>

**Note**  
OBSOLÈTE - L'action `DescribeTags` est obsolète et n'est pas maintenue. Pour afficher les balises associées aux ressources EFS, utilisez l'action `ListTagsForResource` API.

Renvoie les balises associées à un système de fichiers. L'ordre des balises renvoyées dans la réponse à un appel `DescribeTags` et l'ordre des balises renvoyées dans les réponses d'une itération à appels multiples (lors de l'utilisation de la pagination) ne sont pas spécifiés. 

 Cette opération exige des autorisations pour l’action `elasticfilesystem:DescribeTags`. 

## Syntaxe de la demande
<a name="API_DescribeTags_RequestSyntax"></a>

```
GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeTags_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_DescribeTags_RequestSyntax) **   <a name="efs-DescribeTags-request-uri-FileSystemId"></a>
ID du système de fichiers dont vous voulez récupérer le jeu de balises.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** [Marker](#API_DescribeTags_RequestSyntax) **   <a name="efs-DescribeTags-request-uri-Marker"></a>
(Facultatif) Un jeton de pagination opaque renvoyé par une opération `DescribeTags` précédente (chaîne). S'il est présent, il indique de continuer la liste à partir de l'endroit où l'appel précédent s'est arrêté.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `.+` 

 ** [MaxItems](#API_DescribeTags_RequestSyntax) **   <a name="efs-DescribeTags-request-uri-MaxItems"></a>
(Facultatif) Nombre maximum de balises de système de fichiers à renvoyer dans la réponse. Actuellement, ce nombre est automatiquement défini sur 100 et les autres valeurs sont ignorées. La réponse est paginée à 100 par page si vous avez plus de 100 balises.  
Plage valide : valeur minimum de 1.

## Corps de la requête
<a name="API_DescribeTags_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeTags_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Marker": "string",
   "NextMarker": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_DescribeTags_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Marker](#API_DescribeTags_ResponseSyntax) **   <a name="efs-DescribeTags-response-Marker"></a>
Si la demande inclut un `Marker`, la réponse renvoie cette valeur dans ce champ.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

 ** [NextMarker](#API_DescribeTags_ResponseSyntax) **   <a name="efs-DescribeTags-response-NextMarker"></a>
Si une valeur est présente, il y a d'autres balises à renvoyer. Dans une demande ultérieure, vous pouvez fournir la valeur de `NextMarker` comme valeur du paramètre `Marker` dans votre prochaine demande pour récupérer le prochain ensemble de balises.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

 ** [Tags](#API_DescribeTags_ResponseSyntax) **   <a name="efs-DescribeTags-response-Tags"></a>
Tags associés au système de fichiers, présentés sous forme de tableau des objets `Tag`.   
Type : tableau d’objets [Tag](API_Tag.md)

## Erreurs
<a name="API_DescribeTags_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Exemples
<a name="API_DescribeTags_Examples"></a>

### Récupérer toutes les balises associées à un système de fichiers
<a name="API_DescribeTags_Example_1"></a>

 La requête suivante récupère les balises (paires clé-valeur) associées au système de fichiers spécifié. 

#### Exemple de demande
<a name="API_DescribeTags_Example_1_Request"></a>

```
GET /2015-02-01/tags/fs-01234567/ HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215404Z
Authorization: <...>
```

#### Exemple de réponse
<a name="API_DescribeTags_Example_1_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 288

{
    "Tags":[
        {
            "Key":"Name",
            "Value":"my first file system"
        },
        {
            "Key":"Fleet",
            "Value":"Development"
        },
        {
            "Key":"Developer",
            "Value":"Alice"
        }
    ]
}
```

## consultez aussi
<a name="API_DescribeTags_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Répertorie toutes les balises d’une ressource EFS de haut niveau. Vous devez fournir l’ID de la ressource dont vous souhaitez récupérer les balises.

Cette opération exige des autorisations pour l’action `elasticfilesystem:DescribeAccessPoints`.

## Syntaxe de la demande
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_ListTagsForResource_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [MaxResults](#API_ListTagsForResource_RequestSyntax) **   <a name="efs-ListTagsForResource-request-uri-MaxResults"></a>
(Facultatif) Spécifie le nombre maximum d’objets de balises à renvoyer dans la réponse. La valeur par défaut est 100.  
Plage valide : valeur minimum de 1.

 ** [NextToken](#API_ListTagsForResource_RequestSyntax) **   <a name="efs-ListTagsForResource-request-uri-NextToken"></a>
(Facultatif) Vous pouvez utiliser `NextToken` dans une requête ultérieure pour récupérer la page suivante de descriptions des points d’accès si la charge utile de la réponse a été paginée.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `.+` 

 ** [ResourceId](#API_ListTagsForResource_RequestSyntax) **   <a name="efs-ListTagsForResource-request-uri-ResourceId"></a>
Spécifie la ressource EFS dont vous souhaitez récupérer des balises. Vous pouvez récupérer des balises pour les systèmes de fichiers EFS et les points d’accès à l’aide de ce point de terminaison d’API.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_ListTagsForResource_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListTagsForResource_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [NextToken](#API_ListTagsForResource_ResponseSyntax) **   <a name="efs-ListTagsForResource-response-NextToken"></a>
 `NextToken` est présent si la charge utile de la réponse est paginée. Vous pouvez utiliser `NextToken` pour une demande ultérieure pour obtenir la page suivante de descriptions de points d'accès.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `.+` 

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="efs-ListTagsForResource-response-Tags"></a>
Tableau des balises de ressource EFS spécifiée.  
Type : tableau d’objets [Tag](API_Tag.md)

## Erreurs
<a name="API_ListTagsForResource_Errors"></a>

 ** AccessPointNotFound **   
Renvoyé si la `AccessPointId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_ListTagsForResource_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource) 

# ModifyMountTargetSecurityGroups
<a name="API_ModifyMountTargetSecurityGroups"></a>

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

Lorsque vous créez une cible de montage, Amazon EFS crée également une interface réseau. Pour de plus amples informations, veuillez consulter [CreateMountTarget](API_CreateMountTarget.md). 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 demande
<a name="API_ModifyMountTargetSecurityGroups_RequestSyntax"></a>

```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json

{
   "SecurityGroups": [ "string" ]
}
```

## Paramètres de demande URI
<a name="API_ModifyMountTargetSecurityGroups_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **   <a name="efs-ModifyMountTargetSecurityGroups-request-uri-MountTargetId"></a>
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
<a name="API_ModifyMountTargetSecurityGroups_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **   <a name="efs-ModifyMountTargetSecurityGroups-request-SecurityGroups"></a>
Un ensemble de groupes de sécurité VPC. 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
<a name="API_ModifyMountTargetSecurityGroups_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_ModifyMountTargetSecurityGroups_ResponseElements"></a>

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

## Erreurs
<a name="API_ModifyMountTargetSecurityGroups_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** IncorrectMountTargetState **   
Renvoyé si l’état de la cible de montage n’est pas correct pour l’opération.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** MountTargetNotFound **   
Renvoyé s’il n’y a aucune cible de montage avec l’identifiant spécifié dans celui de l’appelant Compte AWS.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** SecurityGroupLimitExceeded **   
Renvoyé si le nombre `SecurityGroups` spécifié dans la demande est supérieur à la limite, qui est basée sur le quota du compte. Supprimez certains groupes de sécurité ou demandez que le quota de comptes soit augmenté. Pour plus d'informations, consultez [Amazon VPC Quotas](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) dans le *guide de l'utilisateur Amazon VPC* (voir le tableau des groupes de **sécurité**).     
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** SecurityGroupNotFound **   
Renvoyé si l’un des groupes de sécurité spécifiés n’existe pas dans le cloud privé virtuel (VPC) du sous-réseau.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Exemples
<a name="API_ModifyMountTargetSecurityGroups_Examples"></a>

### Remplacer les groupes de sécurité d’une cible de montage
<a name="API_ModifyMountTargetSecurityGroups_Example_1"></a>

 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
<a name="API_ModifyMountTargetSecurityGroups_Example_1_Request"></a>

```
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
<a name="API_ModifyMountTargetSecurityGroups_Example_1_Response"></a>

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

## consultez aussi
<a name="API_ModifyMountTargetSecurityGroups_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 

# PutAccountPreferences
<a name="API_PutAccountPreferences"></a>

Utilisez cette opération pour définir la préférence du compte actuel Région AWS afin d'utiliser une ressource longue de 17 caractères (63 bits) ou courte de 8 caractères (32 bits) IDs pour le nouveau système de fichiers EFS et de monter les ressources cibles. Toutes les ressources existantes ne IDs sont pas affectées par les modifications que vous apportez. Vous pouvez définir la préférence d'identification pendant la période d'inscription lorsque l'EFS passe à une ressource IDs longue. Pour plus d'informations, consultez [la section Gestion des ressources Amazon EFS IDs](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html).

**Note**  
À partir d’octobre 2021, vous recevrez un message d’erreur si vous essayez de définir les préférences du compte pour utiliser l’identifiant de ressource au format court à 8 caractères. Contactez le AWS support si vous recevez un message d'erreur et devez utiliser l'abréviation IDs pour « système de fichiers » et « ressources cibles » de montage.

## Syntaxe de la demande
<a name="API_PutAccountPreferences_RequestSyntax"></a>

```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json

{
   "ResourceIdType": "string"
}
```

## Paramètres de demande URI
<a name="API_PutAccountPreferences_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_PutAccountPreferences_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **   <a name="efs-PutAccountPreferences-request-ResourceIdType"></a>
Spécifie la préférence d'ID de ressource EFS à définir pour l'utilisateur Compte AWS, dans la Région AWS version actuelle, soit `LONG_ID` (17 caractères), soit `SHORT_ID` (8 caractères).  
À partir d’octobre 2021, vous recevrez un message d’erreur lorsque vous aurez défini la préférence du compte sur `SHORT_ID`. Contactez le AWS support si vous recevez un message d'erreur et devez utiliser l'abréviation IDs pour « système de fichiers » et « ressources cibles » de montage.
Type : Chaîne  
Valeurs valides : `LONG_ID | SHORT_ID`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_PutAccountPreferences_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ResourceIdPreference": { 
      "ResourceIdType": "string",
      "Resources": [ "string" ]
   }
}
```

## Eléments de réponse
<a name="API_PutAccountPreferences_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) **   <a name="efs-PutAccountPreferences-response-ResourceIdPreference"></a>
Décrit le type de ressource et son identifiant préféré pour celui de l'utilisateur Compte AWS, dans la version actuelle Région AWS.  
Type : objet [ResourceIdPreference](API_ResourceIdPreference.md)

## Erreurs
<a name="API_PutAccountPreferences_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_PutAccountPreferences_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences) 

# PutBackupPolicy
<a name="API_PutBackupPolicy"></a>

Met à jour la politique de sauvegarde du système de fichiers. Utilisez cette action pour démarrer ou arrêter les sauvegardes automatiques du système de fichiers. 

## Syntaxe de la demande
<a name="API_PutBackupPolicy_RequestSyntax"></a>

```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json

{
   "BackupPolicy": { 
      "Status": "string"
   }
}
```

## Paramètres de demande URI
<a name="API_PutBackupPolicy_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **   <a name="efs-PutBackupPolicy-request-uri-FileSystemId"></a>
Spécifie le système de fichiers EFS pour lequel mettre à jour la politique de sauvegarde.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutBackupPolicy_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **   <a name="efs-PutBackupPolicy-request-BackupPolicy"></a>
Politique de sauvegarde incluse dans la demande `PutBackupPolicy`.  
Type : objet [BackupPolicy](API_BackupPolicy.md)  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_PutBackupPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPolicy": { 
      "Status": "string"
   }
}
```

## Eléments de réponse
<a name="API_PutBackupPolicy_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) **   <a name="efs-PutBackupPolicy-response-BackupPolicy"></a>
Décrit la politique de sauvegarde du système de fichiers, en indiquant si les sauvegardes automatiques sont activées ou désactivées.  
Type : objet [BackupPolicy](API_BackupPolicy.md)

## Erreurs
<a name="API_PutBackupPolicy_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ValidationException **   
Renvoyé si le AWS Backup service n'est pas disponible dans le Région AWS pays dans lequel la demande a été faite.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Voir aussi
<a name="API_PutBackupPolicy_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy) 

# PutFileSystemPolicy
<a name="API_PutFileSystemPolicy"></a>

Applique un `FileSystemPolicy` Amazon EFS à un système de fichiers Amazon EFS. Une politique de système de fichiers est une politique basée sur les ressource IAM et peut contenir plusieurs déclarations de politique. Un système de fichiers possède toujours exactement une politique de système de fichiers, qui peut être la stratégie par défaut ou une politique explicite définie ou mise à jour à l’aide de cette opération d’API. Les politiques du système de fichiers EFS sont limitées à 20 000 caractères. Lorsqu’une politique explicite est définie, elle remplace la stratégie par défaut. Pour plus d'informations sur la politique de système de fichiers par défaut, consultez la section Politique de [système de fichiers EFS par défaut](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy). 

**Note**  
Les politiques du système de fichiers EFS sont limitées à 20 000 caractères.

Cette opération exige des autorisations pour l’action `elasticfilesystem:PutFileSystemPolicy`.

## Syntaxe de la demande
<a name="API_PutFileSystemPolicy_RequestSyntax"></a>

```
PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json

{
   "BypassPolicyLockoutSafetyCheck": boolean,
   "Policy": "string"
}
```

## Paramètres de demande URI
<a name="API_PutFileSystemPolicy_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) **   <a name="efs-PutFileSystemPolicy-request-uri-FileSystemId"></a>
ID du système de fichiers EFS pour lequel vous créez ou mettez à jour `FileSystemPolicy`.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutFileSystemPolicy_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) **   <a name="efs-PutFileSystemPolicy-request-BypassPolicyLockoutSafetyCheck"></a>
(Facultatif) Une valeur booléenne qui indique s’il faut ignorer ou non le contrôle de sécurité du verrouillage `FileSystemPolicy`. Le contrôle de sécurité du verrouillage détermine si la politique de la demande verrouillera ou empêchera le principal IAM qui émet la demande d’effectuer de futures demandes `PutFileSystemPolicy` sur ce système de fichiers. Définissez `BypassPolicyLockoutSafetyCheck` sur `True` uniquement lorsque vous avez l’intention d’empêcher le principal IAM à l’origine de la demande d’effectuer d’autres demandes `PutFileSystemPolicy` sur ce système de fichiers. La valeur par défaut est `False`.   
Type : booléen  
Obligatoire : non

 ** [Policy](#API_PutFileSystemPolicy_RequestSyntax) **   <a name="efs-PutFileSystemPolicy-request-Policy"></a>
La `FileSystemPolicy` que vous créez. Accepte une définition de politique au format JSON. Les politiques du système de fichiers EFS sont limitées à 20 000 caractères. Pour en savoir plus sur les éléments qui constituent une politique de système de fichiers, consultez la section [Politiques basées sur les ressources dans Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies).   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 20000.  
Modèle : `[\s\S]+`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_PutFileSystemPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FileSystemId": "string",
   "Policy": "string"
}
```

## Eléments de réponse
<a name="API_PutFileSystemPolicy_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) **   <a name="efs-PutFileSystemPolicy-response-FileSystemId"></a>
Spécifie le système de fichiers EFS auquel s’applique `FileSystemPolicy`.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) **   <a name="efs-PutFileSystemPolicy-response-Policy"></a>
Le JSON formaté `FileSystemPolicy` pour le système de fichiers EFS.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 20000.  
Modèle : `[\s\S]+` 

## Erreurs
<a name="API_PutFileSystemPolicy_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** InvalidPolicyException **   
Renvoyé si le `FileSystemPolicy` est mal formé ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant. Renvoyé en cas d’erreur liée au contrôle de sécurité lié à la politique de verrouillage.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

## Exemples
<a name="API_PutFileSystemPolicy_Examples"></a>

### Création d'un EFS FileSystemPolicy
<a name="API_PutFileSystemPolicy_Example_1"></a>

La demande suivante crée un système `FileSystemPolicy` qui permet à tous les AWS principaux de monter le système de fichiers EFS spécifié avec des autorisations de lecture et d'écriture.

#### Exemple de demande
<a name="API_PutFileSystemPolicy_Example_1_Request"></a>

```
PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "elasticfilesystem:ClientMount",
                "elasticfilesystem:ClientWrite"
            ],
            "Principal": {
                "AWS": ["*"]
            },
        }
    ]
}
```

#### Exemple de réponse
<a name="API_PutFileSystemPolicy_Example_1_Response"></a>

```
{
    "Version": "2012-10-17",		 	 	 
    "Id": "1",
    "Statement": [
        {
            "Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
            "Effect": "Allow",
            "Action": [
                "elasticfilesystem:ClientMount",
                "elasticfilesystem:ClientWrite"
            ],
            "Principal": {
                "AWS": ["*"]
            },
            "Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567"
        }
    ]
}
```

## consultez aussi
<a name="API_PutFileSystemPolicy_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) 

# PutLifecycleConfiguration
<a name="API_PutLifecycleConfiguration"></a>

Utilisez cette action pour gérer le stockage de votre système de fichiers. Le `LifecycleConfiguration` se compose d’un ou de plusieurs objets `LifecyclePolicy` qui définissent les éléments suivants :
+  **`TransitionToIA`**— Quand déplacer des fichiers dans le système de fichiers depuis le stockage principal (classe de stockage standard) vers le stockage à accès peu fréquent (IA).
+  **`TransitionToArchive`**— Quand déplacer les fichiers du système de fichiers depuis leur classe de stockage actuelle (stockage IA ou standard) vers le stockage d’archives.

  Les systèmes de fichiers ne peuvent pas passer au stockage d’archives avant de passer au stockage IA. Par conséquent, TransitionToArchive il ne doit pas être défini ou doit être postérieur à TransitionTo IA.
**Note**  
 La classe de stockage Archive n'est disponible que pour les systèmes de fichiers qui utilisent le mode débit élastique et le mode de performance General Purpose. 
+  **`TransitionToPrimaryStorageClass`**— S’il faut replacer les fichiers du système de fichiers vers le stockage principal (classe de stockage standard) après leur accès dans le stockage IA ou dans le stockage des archives.

Pour plus d’informations, consultez [Gestion du stockage du système de fichiers](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).

Chaque système de fichiers Amazon EFS prend en charge une configuration de cycle de vie, qui s’applique à tous les fichiers du système de fichiers. Si un `LifecycleConfiguration` objet existe déjà pour le système de fichiers spécifié, un appel `PutLifecycleConfiguration`modifie la configuration existante. Un appel `PutLifecycleConfiguration` avec un tableau `LifecyclePolicies` vide dans le corps de la requête supprime tout tableau existant `LifecycleConfiguration`. Dans la demande, précisez ce qui suit : 
+ ID du système de fichiers pour lequel vous activez, désactivez ou modifiez la gestion du cycle de vie.
+ Un tableau `LifecyclePolicies` d’objets `LifecyclePolicy` qui définit le moment où les fichiers doivent être déplacés vers le stockage IA, vers le stockage d’archives et vers le stockage principal.
**Note**  
Amazon EFS exige que chaque objet `LifecyclePolicy` n’ait qu’une seule transition. Le tableau `LifecyclePolicies` doit donc être structuré avec des objets `LifecyclePolicy` distincts. Pour plus d’informations, veuillez consulter les exemples de demandes dans la section suivante.

Cette opération exige des autorisations pour l’opération `elasticfilesystem:PutLifecycleConfiguration`.

Pour appliquer un `LifecycleConfiguration` objet à un système de fichiers chiffré, vous devez disposer des mêmes AWS Key Management Service autorisations que lorsque vous avez créé le système de fichiers chiffré.

## Syntaxe de la demande
<a name="API_PutLifecycleConfiguration_RequestSyntax"></a>

```
PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_PutLifecycleConfiguration_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **   <a name="efs-PutLifecycleConfiguration-request-uri-FileSystemId"></a>
ID du système de fichiers pour lequel créer l’objet `LifecycleConfiguration` (chaîne).  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutLifecycleConfiguration_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **   <a name="efs-PutLifecycleConfiguration-request-LifecyclePolicies"></a>
Tableau d’objets `LifecyclePolicy` qui définissent l’objet `LifecycleConfiguration` du système de fichiers. Un `LifecycleConfiguration` objet fournit à la gestion du cycle de vie les informations suivantes :  
+  **`TransitionToIA`**— Quand déplacer des fichiers dans le système de fichiers depuis le stockage principal (classe de stockage standard) vers le stockage à accès peu fréquent (IA).
+  **`TransitionToArchive`**— Quand déplacer les fichiers du système de fichiers depuis leur classe de stockage actuelle (stockage IA ou standard) vers le stockage d’archives.

  Les systèmes de fichiers ne peuvent pas passer au stockage d’archives avant de passer au stockage IA. Par conséquent, TransitionToArchive il ne doit pas être défini ou doit être postérieur à TransitionTo IA.
**Note**  
La classe de stockage Archive n'est disponible que pour les systèmes de fichiers qui utilisent le mode débit élastique et le mode de performance General Purpose. 
+  **`TransitionToPrimaryStorageClass`**— S’il faut replacer les fichiers du système de fichiers vers le stockage principal (classe de stockage standard) après leur accès dans le stockage IA ou dans le stockage des archives.
Lorsque vous utilisez la commande `put-lifecycle-configuration` CLI ou l’action `PutLifecycleConfiguration` API, Amazon EFS exige que chaque `LifecyclePolicy` objet n’ait qu’une seule transition. Cela signifie que dans un corps de demande, `LifecyclePolicies` doit être structuré comme un tableau d’objets `LifecyclePolicy`, un objet pour chaque transition de stockage. Pour plus d’informations, veuillez consulter les exemples de demandes dans la section suivante.
Type : tableau d’objets [LifecyclePolicy](API_LifecyclePolicy.md)  
Membres du tableau : nombre maximum de 3 éléments.  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_PutLifecycleConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_PutLifecycleConfiguration_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) **   <a name="efs-PutLifecycleConfiguration-response-LifecyclePolicies"></a>
Un ensemble de politiques de gestion du cycle de vie. EFS prend en charge au maximum une politique par système de fichiers.  
Type : tableau d’objets [LifecyclePolicy](API_LifecyclePolicy.md)  
Membres du tableau : nombre maximum de 3 éléments.

## Erreurs
<a name="API_PutLifecycleConfiguration_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Exemples
<a name="API_PutLifecycleConfiguration_Examples"></a>

### Créer une configuration de cycle de vie
<a name="API_PutLifecycleConfiguration_Example_1"></a>

L’exemple suivant crée un objet `LifecyclePolicy` à l’aide de l’action `PutLifecycleConfiguration`. Cet exemple crée une politique de cycle de vie qui demande à EFS d’effectuer les opérations suivantes :
+ Déplacez tous les fichiers du système de fichiers auxquels vous n’avez pas accédé dans le stockage Standard au cours des 30 derniers jours vers le stockage IA.
+ Déplacez tous les fichiers du système de fichiers auxquels vous n’avez pas accédé dans le stockage standard au cours des 90 derniers jours vers le stockage d’archives. 
+ S’il faut replacer les fichiers vers le stockage principal (standard) après leur accès dans le stockage IA ou dans le stockage d’archives. La classe de stockage Archive n'est disponible que pour les systèmes de fichiers qui utilisent le mode débit élastique et le mode de performance General Purpose.

Pour plus d’informations, consultez les sections [Classes de stockage EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) et [Gestion du stockage des systèmes de fichiers](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).

#### Exemple de demande
<a name="API_PutLifecycleConfiguration_Example_1_Request"></a>

```
PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86

{
   "LifecyclePolicies": [
      {
         "TransitionToArchive": "AFTER_90_DAYS"
      },
      {
         "TransitionToIA": "AFTER_30_DAYS"
      },
      {
         "TransitionToPrimaryStorage": "AFTER_1_ACCESS"
      }
   ]
}
```

#### Exemple de réponse
<a name="API_PutLifecycleConfiguration_Example_1_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86

{
    "LifecyclePolicies": [
      {
         "TransitionToArchive": "AFTER_90_DAYS"
      },
      {
         "TransitionToIA": "AFTER_30_DAYS"
      },
      {
         "TransitionToPrimaryStorage": "AFTER_1_ACCESS"
      }
    ]
}
```

### Exemple de demande put-lifecycle-configuration CLI
<a name="API_PutLifecycleConfiguration_Example_2"></a>

Cet exemple illustre une utilisation de PutLifecycleConfiguration.

#### Exemple de demande
<a name="API_PutLifecycleConfiguration_Example_2_Request"></a>

```
aws efs put-lifecycle-configuration \
   --file-system-id fs-0123456789abcdefb \
   --lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
     {"TransitionToIA":"AFTER_30_DAYS"},
     {"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]  
   --region us-west-2 \
   --profile adminuser
```

#### Exemple de réponse
<a name="API_PutLifecycleConfiguration_Example_2_Response"></a>

```
{
   "LifecyclePolicies": [
       {
           "TransitionToArchive": "AFTER_90_DAYS"
       },
       {
           "TransitionToIA": "AFTER_30_DAYS"
       },
       {
           "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
       }
   ]
}
```

### Désactiver la gestion du cycle de vie ()
<a name="API_PutLifecycleConfiguration_Example_3"></a>

L’exemple suivant désactive la gestion du cycle de vie pour le système de fichiers spécifié.

#### Exemple de demande
<a name="API_PutLifecycleConfiguration_Example_3_Request"></a>

```
PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86

{
   "LifecyclePolicies": [ ]
}
```

#### Exemple de réponse
<a name="API_PutLifecycleConfiguration_Example_3_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86

{
   "LifecyclePolicies": [ ]
}
```

## consultez aussi
<a name="API_PutLifecycleConfiguration_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 

# TagResource
<a name="API_TagResource"></a>

Crée une balise pour une ressource EFS. Vous pouvez créer des balises pour les systèmes de fichiers EFS et les points d’accès à l’aide de cette opération d’API.

Cette opération exige des autorisations pour l’action `elasticfilesystem:TagResource`.

## Syntaxe de la demande
<a name="API_TagResource_RequestSyntax"></a>

```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_TagResource_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [ResourceId](#API_TagResource_RequestSyntax) **   <a name="efs-TagResource-request-uri-ResourceId"></a>
L’ID indiquant la ressource EFS pour laquelle vous souhaitez créer une balise.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_TagResource_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="efs-TagResource-request-Tags"></a>
Un tableau des objets`Tag` à ajouter. Chaque objet `Tag` est une paire clé-valeur.  
Type : tableau d’objets [Tag](API_Tag.md)  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Eléments de réponse
<a name="API_TagResource_ResponseElements"></a>

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

## Erreurs
<a name="API_TagResource_Errors"></a>

 ** AccessPointNotFound **   
Renvoyé si la `AccessPointId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Exemples
<a name="API_TagResource_Examples"></a>

### Créer des balises sur un système de fichiers
<a name="API_TagResource_Example_1"></a>

La requête suivante crée trois balises (`"key1"`,`"key2"`, et `"key3"`) sur le système de fichiers spécifié.

#### Exemple de demande
<a name="API_TagResource_Example_1_Request"></a>

```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
    "Tags": [
        {
            "Key": "key1",
            "Value": "value1"            
        },
        {
            "Key": "key2",
            "Value": "value2"            
        },
        {
            "Key": "key3",
            "Value": "value3"            
        }
    ]
}
```

#### Exemple de réponse
<a name="API_TagResource_Example_1_Response"></a>

```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```

## consultez aussi
<a name="API_TagResource_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Supprime les identifications d’une ressource EFS Vous pouvez supprimer des balises des systèmes de fichiers EFS et des points d’accès à l’aide de cette opération d’API.

Cette opération exige des autorisations pour l’action `elasticfilesystem:UntagResource`.

## Syntaxe de la demande
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```

## Paramètres de demande URI
<a name="API_UntagResource_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [ResourceId](#API_UntagResource_RequestSyntax) **   <a name="efs-UntagResource-request-uri-ResourceId"></a>
Détermine la ressource EFS dont vous souhaitez supprimer les balises.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="efs-UntagResource-request-uri-TagKeys"></a>
Les clés des paires de balises clé-valeur que vous souhaitez supprimer de la ressource EFS spécifiée.  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Modèle : `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`   
Obligatoire : oui

## Corps de la demande
<a name="API_UntagResource_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Eléments de réponse
<a name="API_UntagResource_ResponseElements"></a>

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

## Erreurs
<a name="API_UntagResource_Errors"></a>

 ** AccessPointNotFound **   
Renvoyé si la `AccessPointId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** BadRequest **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

## Voir aussi
<a name="API_UntagResource_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource) 

# UpdateFileSystem
<a name="API_UpdateFileSystem"></a>

Met à jour le mode de débit ou la quantité de débit alloué d’un système de fichiers existant.

## Syntaxe de la demande
<a name="API_UpdateFileSystem_RequestSyntax"></a>

```
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json

{
   "ProvisionedThroughputInMibps": number,
   "ThroughputMode": "string"
}
```

## Paramètres de demande URI
<a name="API_UpdateFileSystem_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) **   <a name="efs-UpdateFileSystem-request-uri-FileSystemId"></a>
L’ID du système de fichiers que vous souhaitez mettre à jour.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_UpdateFileSystem_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) **   <a name="efs-UpdateFileSystem-request-ProvisionedThroughputInMibps"></a>
(Facultatif) Le débit, mesuré en mégaoctets par seconde (MiBps), que vous souhaitez configurer pour le système de fichiers que vous créez. Obligatoire si `ThroughputMode` est défini sur `provisioned`. Les valeurs valides sont comprises entre 1 et 3414 MiBps, la limite supérieure dépendant de la région. Pour augmenter cette limite, contactez Support. Pour plus d’informations, consultez [Quotas Amazon EFS que vous pouvez augmenter](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) dans le *Guide de l’utilisateur Amazon EFS.*  
Type : double  
Plage valide : valeur minimum de 1,0.  
Obligatoire : non

 ** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) **   <a name="efs-UpdateFileSystem-request-ThroughputMode"></a>
(Facultatif) Met à jour le mode de débit du système de fichiers. Si vous ne mettez pas à jour votre mode de débit, vous n’avez pas besoin de fournir cette valeur dans votre demande. Si vous changez `ThroughputMode` en `provisioned`, vous devez également définir une valeur pour `ProvisionedThroughputInMibps`.  
Type : Chaîne  
Valeurs valides : `bursting | provisioned | elastic`   
Obligatoire : non

## Syntaxe de la réponse
<a name="API_UpdateFileSystem_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "CreationTime": number,
   "CreationToken": "string",
   "Encrypted": boolean,
   "FileSystemArn": "string",
   "FileSystemId": "string",
   "FileSystemProtection": { 
      "ReplicationOverwriteProtection": "string"
   },
   "KmsKeyId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "NumberOfMountTargets": number,
   "OwnerId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "SizeInBytes": { 
      "Timestamp": number,
      "Value": number,
      "ValueInArchive": number,
      "ValueInIA": number,
      "ValueInStandard": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}
```

## Eléments de réponse
<a name="API_UpdateFileSystem_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 202.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AvailabilityZoneId](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-AvailabilityZoneId"></a>
Identifiant unique et cohérent de la Zone de disponibilité dans laquelle se trouve le système de fichiers, valide uniquement pour les systèmes de fichiers Zone unique. Par exemple, `use1-az1` il s'agit d'un identifiant de zone de disponibilité pour le Région AWS us-east-1, qui possède le même emplacement dans chaque cas. Compte AWS  
Type : Chaîne

 ** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-AvailabilityZoneName"></a>
Décrit la zone de AWS disponibilité dans laquelle se trouve le système de fichiers et n'est valide que pour les systèmes de fichiers One Zone. Pour de plus amples informations, consultez [Utilisation de classes de stockage EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) dans le *Guide de l’utilisateur Amazon EFS*.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+` 

 ** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-CreationTime"></a>
Heure de création du système de fichiers, en secondes (depuis 1970-01-01T 00:00:00 Z).  
Type : Timestamp

 ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-CreationToken"></a>
Chaîne opaque spécifiée dans la demande.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `.+` 

 ** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-Encrypted"></a>
Valeur booléenne qui, si la valeur est true, indique que le système de fichiers est chiffré.  
Type : Boolean

 ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-FileSystemArn"></a>
Le nom de ressource Amazon Resource Name (ARN) pour le système de fichiers EFS, au format `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Exemple avec des exemples de données : `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`   
Type : Chaîne

 ** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-FileSystemId"></a>
ID du système de fichiers, attribué par Amazon EFS.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [FileSystemProtection](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-FileSystemProtection"></a>
Décrit la protection du système de fichiers.   
Type : objet [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)

 ** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-KmsKeyId"></a>
Identifiant AWS KMS key utilisé pour protéger le système de fichiers chiffré.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 2048.  
Modèle : `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$` 

 ** [LifeCycleState](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-LifeCycleState"></a>
Phase du cycle de vie du système de fichiers.  
Type : Chaîne  
Valeurs valides : `creating | available | updating | deleting | deleted | error` 

 ** [Name](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-Name"></a>
Vous pouvez ajouter des balises à un système de fichiers, y compris une balise `Name`. Pour de plus amples informations, veuillez consulter [CreateFileSystem](API_CreateFileSystem.md). Si le système de fichiers possède une balise `Name`, Amazon EFS renvoie la valeur dans ce champ.   
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 

 ** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-NumberOfMountTargets"></a>
Le nombre actuel de cibles de Montage du système de fichiers. Pour de plus amples informations, veuillez consulter [CreateMountTarget](API_CreateMountTarget.md).  
Type : Integer  
Plage valide : Valeur minimum de 0.

 ** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-OwnerId"></a>
Celui Compte AWS qui a créé le système de fichiers.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$` 

 ** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-PerformanceMode"></a>
Mode de performances du système de fichiers.  
Type : Chaîne  
Valeurs valides : `generalPurpose | maxIO` 

 ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-ProvisionedThroughputInMibps"></a>
Quantité de débit allouée, mesurée en MiBps, pour le système de fichiers. Valable pour les systèmes de fichiers utilisant `ThroughputMode` définit sur `provisioned`.  
Type : double  
Plage valide : Valeur minimum de 1,0.

 ** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-SizeInBytes"></a>
La dernière taille mesurée connue (en octets) des données stockées dans le système de fichiers, dans son champ `Value`, et l’heure à laquelle cette taille a été déterminée dans son champ `Timestamp`. La valeur `Timestamp` est le nombre entier de secondes écoulées depuis 1970-01-01T 00:00:00 Z. La valeur `SizeInBytes` ne représente pas la taille d’un instantané cohérent du système de fichiers, mais elle est finalement cohérente lorsqu’aucune écriture n’est effectuée dans le système de fichiers. Cela signifie que `SizeInBytes` représente la taille réelle uniquement si le système de fichiers n’est pas Modifié pendant une période supérieure à deux heures. Dans le cas contraire, la valeur ne correspond pas exactement à la taille du système de fichiers à un Moment donné.   
Type : objet [FileSystemSize](API_FileSystemSize.md)

 ** [Tags](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-Tags"></a>
Tags associés au système de fichiers, présentés sous forme de tableau des objets `Tag`.  
Type : tableau d’objets [Tag](API_Tag.md)

 ** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) **   <a name="efs-UpdateFileSystem-response-ThroughputMode"></a>
Affiche le mode de débit du système de fichiers. Pour plus d’informations, consultez les [Modes de débit](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) dans le *Guide de l’utilisateur Amazon EFS*.   
Type : Chaîne  
Valeurs valides : `bursting | provisioned | elastic` 

## Erreurs
<a name="API_UpdateFileSystem_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InsufficientThroughputCapacity **   
Renvoyé si la capacité est insuffisante pour fournir un débit supplémentaire. Cette valeur peut être renvoyée lorsque vous essayez de créer un système de fichiers en mode débit alloué, lorsque vous essayez d’augmenter le débit alloué d’un système de fichiers existant ou lorsque vous essayez de faire passer un système de fichiers existant du mode débit en rafale au mode débit alloué. Réessayez ultérieurement.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
HTTP Status Code: 503

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ThroughputLimitExceeded **   
Renvoie si le mode de débit ou la quantité de débit provisionné ne peuvent pas être modifiés car la limite de débit de 1024 MiB/s a été atteinte.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** TooManyRequests **   
Renvoyé si vous n’attendez pas au moins 24 heures avant de modifier le mode de débit ou de diminuer la valeur du débit alloué.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 429

## Voir aussi
<a name="API_UpdateFileSystem_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem) 

# UpdateFileSystemProtection
<a name="API_UpdateFileSystemProtection"></a>

Met à jour la protection sur le système de fichiers.

Cette opération exige des autorisations pour l’action `elasticfilesystem:UpdateFileSystemProtection`. 

## Syntaxe de la demande
<a name="API_UpdateFileSystemProtection_RequestSyntax"></a>

```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json

{
   "ReplicationOverwriteProtection": "string"
}
```

## Paramètres de demande URI
<a name="API_UpdateFileSystemProtection_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **   <a name="efs-UpdateFileSystemProtection-request-uri-FileSystemId"></a>
ID du système de fichiers à mettre à jour.   
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

## Corps de la demande
<a name="API_UpdateFileSystemProtection_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **   <a name="efs-UpdateFileSystemProtection-request-ReplicationOverwriteProtection"></a>
État de la protection contre le remplacement de la réplication du système de fichiers.  
+  `ENABLED` – Le système de fichiers ne peut pas être utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est inscriptible. La protection contre le remplacement de la réplication est par défaut `ENABLED`. 
+  `DISABLED` – Le système de fichiers peut être utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est en lecture seule et ne peut être modifié que par la réplication EFS.
+  `REPLICATING` – Le système de fichiers est utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est en lecture seule et n’est modifié que par la réplication EFS.
Si la configuration de réplication est supprimée, la protection par écrasement de réplication du système de fichiers est réactivée et le système de fichiers devient inscriptible.  
Type : Chaîne  
Valeurs valides : `ENABLED | DISABLED | REPLICATING`   
Obligatoire : non

## Syntaxe de la réponse
<a name="API_UpdateFileSystemProtection_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReplicationOverwriteProtection": "string"
}
```

## Eléments de réponse
<a name="API_UpdateFileSystemProtection_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) **   <a name="efs-UpdateFileSystemProtection-response-ReplicationOverwriteProtection"></a>
État de la protection contre le remplacement de la réplication du système de fichiers.  
+  `ENABLED` – Le système de fichiers ne peut pas être utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est inscriptible. La protection contre le remplacement de la réplication est par défaut `ENABLED`. 
+  `DISABLED` – Le système de fichiers peut être utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est en lecture seule et ne peut être modifié que par la réplication EFS.
+  `REPLICATING` – Le système de fichiers est utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est en lecture seule et n'est modifié que par la réplication EFS.
Si vous supprimez la configuration de réplication, la protection contre l’écrasement par réplication du système de fichiers est réactivée et le système de fichiers devient accessible en écriture.  
Type : Chaîne  
Valeurs valides : `ENABLED | DISABLED | REPLICATING` 

## Erreurs
<a name="API_UpdateFileSystemProtection_Errors"></a>

 ** 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.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** FileSystemNotFound **   
Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404

 ** IncorrectFileSystemLifeCycleState **   
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** InsufficientThroughputCapacity **   
Renvoyé si la capacité est insuffisante pour fournir un débit supplémentaire. Cette valeur peut être renvoyée lorsque vous essayez de créer un système de fichiers en mode débit alloué, lorsque vous essayez d’augmenter le débit alloué d’un système de fichiers existant ou lorsque vous essayez de faire passer un système de fichiers existant du mode débit en rafale au mode débit alloué. Réessayez ultérieurement.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
HTTP Status Code: 503

 ** InternalServerError **   
Renvoyé si une erreur s’est produite côté serveur.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500

 ** ReplicationAlreadyExists **   
Renvoyé si le système de fichiers est déjà inclus dans une configuration de réplication. >    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 409

 ** ThroughputLimitExceeded **   
Renvoyé si le mode de débit ou la quantité de débit provisionné ne peuvent pas être modifiés car la limite de débit de 1024 MiB/s a été atteinte.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400

 ** TooManyRequests **   
Renvoyé si vous n’attendez pas au moins 24 heures avant de modifier le mode de débit ou de diminuer la valeur du débit alloué.    
 ** ErrorCode **   
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.   
 ** Message **   
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 429

## Voir aussi
<a name="API_UpdateFileSystemProtection_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) 

# Types de données
<a name="API_Types"></a>

Les types de données suivants sont pris en charge :
+  [AccessPointDescription](API_AccessPointDescription.md) 
+  [BackupPolicy](API_BackupPolicy.md) 
+  [CreationInfo](API_CreationInfo.md) 
+  [Destination](API_Destination.md) 
+  [DestinationToCreate](API_DestinationToCreate.md) 
+  [FileSystemDescription](API_FileSystemDescription.md) 
+  [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) 
+  [FileSystemSize](API_FileSystemSize.md) 
+  [LifecyclePolicy](API_LifecyclePolicy.md) 
+  [MountTargetDescription](API_MountTargetDescription.md) 
+  [PosixUser](API_PosixUser.md) 
+  [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md) 
+  [ResourceIdPreference](API_ResourceIdPreference.md) 
+  [RootDirectory](API_RootDirectory.md) 
+  [Tag](API_Tag.md) 

# AccessPointDescription
<a name="API_AccessPointDescription"></a>

Fournit une description d’un point d’accès au système de fichiers EFS.

## Table des matières
<a name="API_AccessPointDescription_Contents"></a>

 ** AccessPointArn **   <a name="efs-Type-AccessPointDescription-AccessPointArn"></a>
L’Amazon Resource Name (ARN) associé au point d’accès.  
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$`   
Obligatoire : non

 ** AccessPointId **   <a name="efs-Type-AccessPointDescription-AccessPointId"></a>
L’ID du point d’accès, attribué par Amazon EFS.  
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`   
Obligatoire : non

 ** ClientToken **   <a name="efs-Type-AccessPointDescription-ClientToken"></a>
Chaîne opaque spécifiée dans la demande pour garantir la création idempotente.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `.+`   
Obligatoire : non

 ** FileSystemId **   <a name="efs-Type-AccessPointDescription-FileSystemId"></a>
ID du système de fichiers EFS auquel le point d’accès s’applique.  
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : non

 ** LifeCycleState **   <a name="efs-Type-AccessPointDescription-LifeCycleState"></a>
Identifie la phase du cycle de vie du point d’accès.  
Type : String  
Valeurs valides : `creating | available | updating | deleting | deleted | error`   
Obligatoire : non

 ** Name **   <a name="efs-Type-AccessPointDescription-Name"></a>
Nom de ce point d’accès. Il s’agit de la valeur de la balise `Name`.  
Type : chaîne  
Obligatoire : non

 ** OwnerId **   <a name="efs-Type-AccessPointDescription-OwnerId"></a>
Identifie Compte AWS le propriétaire de la ressource du point d'accès.  
Type : String  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$`   
Obligatoire : non

 ** PosixUser **   <a name="efs-Type-AccessPointDescription-PosixUser"></a>
L'identité POSIX complète, y compris l'ID utilisateur, l'ID de groupe et le groupe secondaire IDs sur le point d'accès utilisé pour toutes les opérations sur les fichiers par les clients NFS utilisant le point d'accès.  
Type : objet [PosixUser](API_PosixUser.md)  
Obligatoire : non

 ** RootDirectory **   <a name="efs-Type-AccessPointDescription-RootDirectory"></a>
Répertoire du système de fichiers Amazon EFS que le point d’accès expose en tant que répertoire racine aux clients NFS utilisant le point d’accès.  
Type : objet [RootDirectory](API_RootDirectory.md)  
Obligatoire : non

 ** Tags **   <a name="efs-Type-AccessPointDescription-Tags"></a>
Les balises associées au point d’accès, présentées sous la forme d’un tableau d’objets Tag.  
Type : tableau d’objets [Tag](API_Tag.md)  
Obligatoire : non

## consultez aussi
<a name="API_AccessPointDescription_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/AccessPointDescription) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/AccessPointDescription) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/AccessPointDescription) 

# BackupPolicy
<a name="API_BackupPolicy"></a>

Politique de sauvegarde du système de fichiers utilisée pour créer des sauvegardes quotidiennes automatiques. Si le statut a une valeur égale à `ENABLED`, le système de fichiers est automatiquement sauvegardé. Pour plus d’informations, consultez [Sauvegardes automatiques](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups).

## Table des matières
<a name="API_BackupPolicy_Contents"></a>

 ** Status **   <a name="efs-Type-BackupPolicy-Status"></a>
Décrit l’état de la politique de sauvegarde du système de fichiers.  
+  **`ENABLED`** – EFS sauvegarde automatiquement le système de fichiers.
+  ** `ENABLING` ** – EFS active les sauvegardes automatiques du système de fichiers.
+  ** `DISABLED` ** – Les sauvegardes automatiques sont désactivées pour le système de fichiers.
+  ** `DISABLING` ** – EFS désactive les sauvegardes automatiques du système de fichiers.
Type : String  
Valeurs valides : `ENABLED | ENABLING | DISABLED | DISABLING`   
Obligatoire : oui

## consultez aussi
<a name="API_BackupPolicy_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/BackupPolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/BackupPolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/BackupPolicy) 

# CreationInfo
<a name="API_CreationInfo"></a>

Obligatoire si le `RootDirectory` > `Path` spécifié n’existe pas. Spécifie le POSIX IDs et les autorisations à appliquer au `RootDirectory` > `Path` du point d'accès. Si le répertoire racine du point d’accès n’existe pas, EFS le crée avec ces paramètres lorsqu’un client se connecte au point d’accès. Lors de la spécification de `CreationInfo`, vous devez inclure des valeurs pour toutes les propriétés. 

Amazon EFS crée un répertoire racine uniquement si vous avez fourni le CreationInfo : OwnUid, le OwnGid et les autorisations pour le répertoire. Si vous ne fournissez pas ces informations, Amazon EFS ne crée pas le répertoire racine. Si le répertoire racine n’existe pas, les tentatives de montage au moyen du point d’accès échoueront.

**Important**  
Si vous ne fournissez pas de valeur pour `CreationInfo` et que le `RootDirectory` spécifié n’existe pas, les tentatives de montage du système de fichiers à l’aide du point d’accès échouent.

## Table des matières
<a name="API_CreationInfo_Contents"></a>

 ** OwnerGid **   <a name="efs-Type-CreationInfo-OwnerGid"></a>
Spécifie l’ID de groupe POSIX à appliquer à `RootDirectory`. Accepte les valeurs comprises entre 0 et 2^32 (4294967295).  
Type : long  
Plage valide : Valeur minimum de 0. Valeur maximale de 4294967295.  
Obligatoire : oui

 ** OwnerUid **   <a name="efs-Type-CreationInfo-OwnerUid"></a>
Spécifie l’ID utilisateur POSIX à appliquer à `RootDirectory`. Accepte les valeurs comprises entre 0 et 2^32 (4294967295).  
Type : long  
Plage valide : Valeur minimum de 0. Valeur maximale de 4294967295.  
Obligatoire : oui

 ** Permissions **   <a name="efs-Type-CreationInfo-Permissions"></a>
Spécifie les autorisations POSIX à appliquer à `RootDirectory`, sous la forme d’un nombre octal représentant les bits de mode du fichier.  
Type : String  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 4.  
Modèle : `^[0-7]{3,4}$`   
Obligatoire : oui

## consultez aussi
<a name="API_CreationInfo_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreationInfo) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreationInfo) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreationInfo) 

# Destination
<a name="API_Destination"></a>

Décrit le système de fichiers de destination dans la configuration de réplication.

## Table des matières
<a name="API_Destination_Contents"></a>

 ** FileSystemId **   <a name="efs-Type-Destination-FileSystemId"></a>
ID du système de fichiers Amazon EFS de destination.  
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** Region **   <a name="efs-Type-Destination-Region"></a>
Le système de fichiers Région AWS dans lequel se trouve le système de fichiers de destination.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`   
Obligatoire : oui

 ** Status **   <a name="efs-Type-Destination-Status"></a>
Décrit l'état de la configuration de réplication. Pour plus d'informations sur l'état de réplication, consultez la section [Affichage des détails de réplication](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#restoring-backup-efsmonitoring-replication-status.html) dans le *guide de l'utilisateur Amazon EFS*.   
Type : String  
Valeurs valides : `ENABLED | ENABLING | DELETING | ERROR | PAUSED | PAUSING`   
Obligatoire : oui

 ** LastReplicatedTimestamp **   <a name="efs-Type-Destination-LastReplicatedTimestamp"></a>
Heure à laquelle la dernière synchronisation s’est terminée avec succès sur le système de fichiers de destination. Toutes les modifications apportées aux données du système de fichiers source avant cette date ont été correctement répliquées sur le système de fichiers de destination. Les modifications survenues après cette période risquent de ne pas être entièrement répliquées.  
Type : Timestamp  
Obligatoire : non

 ** OwnerId **   <a name="efs-Type-Destination-OwnerId"></a>
ID du système de fichiers Compte AWS dans lequel réside le système de fichiers de destination.  
Type : String  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$`   
Obligatoire : non

 ** RoleArn **   <a name="efs-Type-Destination-RoleArn"></a>
Amazon Resource Name (ARN) du rôle IAM dans le compte source qui permet à Amazon EFS d'effectuer la réplication en son nom. Cela est facultatif pour la réplication entre comptes identiques et obligatoire pour la réplication entre comptes.  
Type : String  
Contraintes de longueur : longueur maximale de 2048.  
Modèle : `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatoire : non

 ** StatusMessage **   <a name="efs-Type-Destination-StatusMessage"></a>
Message fournissant des détails sur la configuration `PAUSED` ou l'`ERRROR`état de la configuration de destination de réplication. Pour plus d'informations sur les messages d'état de réplication, consultez la section [Affichage des détails de réplication](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#restoring-backup-efsmonitoring-replication-status.html) dans le *guide de l'utilisateur Amazon EFS*.   
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_Destination_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/Destination) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/Destination) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/Destination) 

# DestinationToCreate
<a name="API_DestinationToCreate"></a>

Décrit le système de fichiers de destination nouveau ou existant pour la configuration de réplication.
+ Si vous souhaitez effectuer une réplication vers un nouveau système de fichiers, ne spécifiez pas l'ID du système de fichiers de destination. Amazon EFS crée un nouveau système de fichiers vide. Pour le stockage One Zone, spécifiez la zone de disponibilité dans laquelle créer le système de fichiers. Pour utiliser une AWS Key Management Service clé autre que la clé KMS par défaut, spécifiez-la. Pour plus d'informations, consultez [la section Configuration de la réplication vers le nouveau système de fichiers Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html) dans le *guide de l'utilisateur Amazon EFS*.
**Note**  
Une fois le système de fichiers créé, vous ne pouvez pas modifier la clé KMS ni le mode de performance.
+ Si vous souhaitez effectuer une réplication vers un système de fichiers existant appartenant au même compte que le système de fichiers source, vous devez fournir l'ID ou le nom de ressource Amazon (ARN) du système de fichiers vers lequel effectuer la réplication. La protection contre le remplacement par réplication du système de fichiers doit être désactivée. Pour plus d'informations, consultez la section [Réplication vers un système de fichiers existant](https://docs.aws.amazon.com/efs/latest/ug/efs-replication#replicate-existing-destination) dans le *guide de l'utilisateur Amazon EFS*.
+ Si vous répliquez le système de fichiers vers un système de fichiers situé dans un compte différent du système de fichiers source (réplication entre comptes), vous devez fournir l'ARN du système de fichiers et le rôle IAM qui permet à Amazon EFS d'effectuer la réplication sur le compte de destination. La protection contre le remplacement par réplication du système de fichiers doit être désactivée. Pour plus d'informations, consultez la section [Replication Comptes AWS dans](https://docs.aws.amazon.com/efs/latest/ug/cross-account-replication.html) le *guide de l'utilisateur Amazon EFS*.

## Table des matières
<a name="API_DestinationToCreate_Contents"></a>

 ** AvailabilityZoneName **   <a name="efs-Type-DestinationToCreate-AvailabilityZoneName"></a>
Pour créer un système de fichiers utilisant le stockage Zone unique, spécifiez le nom de la Zone de disponibilité dans laquelle vous souhaitez créer le système de fichiers de destination.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `.+`   
Obligatoire : non

 ** FileSystemId **   <a name="efs-Type-DestinationToCreate-FileSystemId"></a>
L'ID ou l'ARN du système de fichiers à utiliser pour la destination. Pour la réplication entre comptes, il doit s'agir d'un ARN. La réplication de l’écrasement du système de fichiers doit être désactivée. Si aucun ID ou ARN n'est spécifié, un nouveau système de fichiers est créé.   
Lorsque vous configurez initialement la réplication vers un système de fichiers existant, Amazon EFS écrit des données dans le système de fichiers de destination ou en supprime des données existantes afin qu'elles correspondent aux données du système de fichiers source. Si vous ne souhaitez pas modifier les données du système de fichiers de destination, vous devez plutôt les répliquer vers un nouveau système de fichiers. Pour de plus amples informations, veuillez consulter [https://docs.aws.amazon.com/efs/latest/ug/create-replication.html](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html).
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : non

 ** KmsKeyId **   <a name="efs-Type-DestinationToCreate-KmsKeyId"></a>
Spécifiez la clé AWS Key Management Service (AWS KMS) que vous souhaitez utiliser pour chiffrer le système de fichiers de destination. Si vous ne spécifiez pas de clé KMS, Amazon EFS utilise votre clé KMS par défaut pour Amazon EFS, `/aws/elasticfilesystem`. Cet ID peut être dans l’un des formats suivants :  
+ ID de clé - L’identifiant unique de la clé, par exemple `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ ARN - L'ARN de la clé, par exemple`arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ Alias de clé - Un nom d’affichage précédemment créé pour une clé, par exemple `alias/projectKey1`.
+ ARN d’alias de clé - L’ARN pour un alias de clé, par exemple `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
Type : String  
Contraintes de longueur : longueur maximale de 2048.  
Modèle : `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`   
Obligatoire : non

 ** Region **   <a name="efs-Type-DestinationToCreate-Region"></a>
Pour créer un système de fichiers utilisant le stockage régional, spécifiez le système de fichiers Région AWS dans lequel vous souhaitez créer le système de fichiers de destination. La région doit être activée pour Compte AWS le propriétaire du système de fichiers source. Pour plus d'informations, consultez [la section Gestion Régions AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) dans le *Guide de référence AWS général*.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`   
Obligatoire : non

 ** RoleArn **   <a name="efs-Type-DestinationToCreate-RoleArn"></a>
Amazon Resource Name (ARN) du rôle IAM dans le compte source qui permet à Amazon EFS d'effectuer la réplication en son nom. Cela est facultatif pour la réplication entre comptes identiques et obligatoire pour la réplication entre comptes.  
Type : String  
Contraintes de longueur : longueur maximale de 2048.  
Modèle : `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatoire : non

## consultez aussi
<a name="API_DestinationToCreate_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DestinationToCreate) 

# FileSystemDescription
<a name="API_FileSystemDescription"></a>

Une description du système de fichiers.

## Table des matières
<a name="API_FileSystemDescription_Contents"></a>

 ** CreationTime **   <a name="efs-Type-FileSystemDescription-CreationTime"></a>
Heure de création du système de fichiers, en secondes (depuis 1970-01-01T 00:00:00 Z).  
Type : Timestamp  
Obligatoire : oui

 ** CreationToken **   <a name="efs-Type-FileSystemDescription-CreationToken"></a>
Chaîne opaque spécifiée dans la demande.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `.+`   
Obligatoire : oui

 ** FileSystemId **   <a name="efs-Type-FileSystemDescription-FileSystemId"></a>
ID du système de fichiers, attribué par Amazon EFS.  
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** LifeCycleState **   <a name="efs-Type-FileSystemDescription-LifeCycleState"></a>
Phase du cycle de vie du système de fichiers.  
Type : String  
Valeurs valides : `creating | available | updating | deleting | deleted | error`   
Obligatoire : oui

 ** NumberOfMountTargets **   <a name="efs-Type-FileSystemDescription-NumberOfMountTargets"></a>
Le nombre actuel de cibles de montage du système de fichiers. Pour de plus amples informations, veuillez consulter [CreateMountTarget](API_CreateMountTarget.md).  
Type : entier  
Plage valide : Valeur minimum de 0.  
Obligatoire : oui

 ** OwnerId **   <a name="efs-Type-FileSystemDescription-OwnerId"></a>
Celui Compte AWS qui a créé le système de fichiers.  
Type : String  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$`   
Obligatoire : oui

 ** PerformanceMode **   <a name="efs-Type-FileSystemDescription-PerformanceMode"></a>
Mode de performances du système de fichiers.  
Type : String  
Valeurs valides : `generalPurpose | maxIO`   
Obligatoire : oui

 ** SizeInBytes **   <a name="efs-Type-FileSystemDescription-SizeInBytes"></a>
La dernière taille mesurée connue (en octets) des données stockées dans le système de fichiers, dans son champ `Value`, et l’heure à laquelle cette taille a été déterminée dans son champ `Timestamp`. La valeur `Timestamp` est le nombre entier de secondes écoulées depuis 1970-01-01T 00:00:00 Z. La valeur `SizeInBytes` ne représente pas la taille d’un instantané cohérent du système de fichiers, mais elle est finalement cohérente lorsqu’aucune écriture n’est effectuée dans le système de fichiers. Cela signifie que `SizeInBytes` représente la taille réelle uniquement si le système de fichiers n’est pas Modifié pendant une période supérieure à deux heures. Dans le cas contraire, la valeur ne correspond pas exactement à la taille du système de fichiers à un Moment donné.   
Type : objet [FileSystemSize](API_FileSystemSize.md)  
Obligatoire : oui

 ** Tags **   <a name="efs-Type-FileSystemDescription-Tags"></a>
Tags associés au système de fichiers, présentés sous forme de tableau des objets `Tag`.  
Type : tableau d’objets [Tag](API_Tag.md)  
Obligatoire : oui

 ** AvailabilityZoneId **   <a name="efs-Type-FileSystemDescription-AvailabilityZoneId"></a>
Identifiant unique et cohérent de la Zone de disponibilité dans laquelle se trouve le système de fichiers, valide uniquement pour les systèmes de fichiers Zone unique. Par exemple, `use1-az1` il s'agit d'un identifiant de zone de disponibilité pour le Région AWS us-east-1, qui possède le même emplacement dans chaque cas. Compte AWS  
Type : chaîne  
Obligatoire : non

 ** AvailabilityZoneName **   <a name="efs-Type-FileSystemDescription-AvailabilityZoneName"></a>
Décrit la zone de AWS disponibilité dans laquelle se trouve le système de fichiers et n'est valide que pour les systèmes de fichiers One Zone. Pour de plus amples informations, consultez [Utilisation de classes de stockage EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) dans le *Guide de l’utilisateur Amazon EFS*.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `.+`   
Obligatoire : non

 ** Encrypted **   <a name="efs-Type-FileSystemDescription-Encrypted"></a>
Valeur booléenne qui, si la valeur est true, indique que le système de fichiers est chiffré.  
Type : booléen  
Obligatoire : non

 ** FileSystemArn **   <a name="efs-Type-FileSystemDescription-FileSystemArn"></a>
Le nom de ressource Amazon Resource Name (ARN) pour le système de fichiers EFS, au format `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Exemple avec des exemples de données : `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`   
Type : chaîne  
Obligatoire : non

 ** FileSystemProtection **   <a name="efs-Type-FileSystemDescription-FileSystemProtection"></a>
Décrit la protection du système de fichiers.   
Type : objet [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)  
Obligatoire : non

 ** KmsKeyId **   <a name="efs-Type-FileSystemDescription-KmsKeyId"></a>
Identifiant AWS KMS key utilisé pour protéger le système de fichiers chiffré.  
Type : String  
Contraintes de longueur : longueur maximale de 2048.  
Modèle : `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`   
Obligatoire : non

 ** Name **   <a name="efs-Type-FileSystemDescription-Name"></a>
Vous pouvez ajouter des balises à un système de fichiers, y compris une balise `Name`. Pour de plus amples informations, veuillez consulter [CreateFileSystem](API_CreateFileSystem.md). Si le système de fichiers possède une balise `Name`, Amazon EFS renvoie la valeur dans ce champ.   
Type : String  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Obligatoire : non

 ** ProvisionedThroughputInMibps **   <a name="efs-Type-FileSystemDescription-ProvisionedThroughputInMibps"></a>
Quantité de débit allouée, mesurée en MiBps, pour le système de fichiers. Valable pour les systèmes de fichiers utilisant `ThroughputMode` définit sur `provisioned`.  
Type : double  
Plage valide : valeur minimum de 1,0.  
Obligatoire : non

 ** ThroughputMode **   <a name="efs-Type-FileSystemDescription-ThroughputMode"></a>
Affiche le mode de débit du système de fichiers. Pour plus d’informations, consultez les [Modes de débit](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) dans le *Guide de l’utilisateur Amazon EFS*.   
Type : String  
Valeurs valides : `bursting | provisioned | elastic`   
Obligatoire : non

## consultez aussi
<a name="API_FileSystemDescription_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/FileSystemDescription) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/FileSystemDescription) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/FileSystemDescription) 

# FileSystemProtectionDescription
<a name="API_FileSystemProtectionDescription"></a>

Décrit la protection d’un système de fichiers. 

## Table des matières
<a name="API_FileSystemProtectionDescription_Contents"></a>

 ** ReplicationOverwriteProtection **   <a name="efs-Type-FileSystemProtectionDescription-ReplicationOverwriteProtection"></a>
État de la protection contre le remplacement de la réplication du système de fichiers.  
+  `ENABLED` – Le système de fichiers ne peut pas être utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est inscriptible. La protection contre le remplacement de la réplication est par défaut `ENABLED`. 
+  `DISABLED` – Le système de fichiers peut être utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est en lecture seule et ne peut être modifié que par la réplication EFS.
+  `REPLICATING` – Le système de fichiers est utilisé comme système de fichiers de destination dans une configuration de réplication. Le système de fichiers est en lecture seule et n'est modifié que par la réplication EFS.
Si vous supprimez la configuration de réplication, la protection contre l’écrasement par réplication du système de fichiers est réactivée et le système de fichiers devient accessible en écriture.  
Type : String  
Valeurs valides : `ENABLED | DISABLED | REPLICATING`   
Obligatoire : non

## consultez aussi
<a name="API_FileSystemProtectionDescription_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/FileSystemProtectionDescription) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/FileSystemProtectionDescription) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/FileSystemProtectionDescription) 

# FileSystemSize
<a name="API_FileSystemSize"></a>

La dernière taille mesurée connue (en octets) des données stockées dans le système de fichiers, dans son champ `Value`, et l’heure à laquelle cette taille a été déterminée dans son champ `Timestamp`. La valeur ne représente pas la taille d’un instantané cohérent du système de fichiers, mais elle est finalement cohérente lorsqu’aucune écriture n’est effectuée dans le système de fichiers. Cela signifie que la valeur représente la taille réelle uniquement si le système de fichiers n’est pas modifié pendant une période supérieure à deux heures. Dans le cas contraire, la valeur ne correspond pas nécessairement à la taille exacte du système de fichiers à un moment donné.

## Table des matières
<a name="API_FileSystemSize_Contents"></a>

 ** Value **   <a name="efs-Type-FileSystemSize-Value"></a>
La dernière taille mesurée connue (en octets) des données stockées dans le système de fichiers.  
Type : long  
Plage valide : Valeur minimum de 0.  
Obligatoire : oui

 ** Timestamp **   <a name="efs-Type-FileSystemSize-Timestamp"></a>
Heure à laquelle la taille des données renvoyées sur le champ `Value` a été déterminée. La valeur est le nombre entier de secondes écoulées depuis 1970-01-01T 00:00:00 Z.  
Type : Timestamp  
Obligatoire : non

 ** ValueInArchive **   <a name="efs-Type-FileSystemSize-ValueInArchive"></a>
Dernière taille mesurée connue (en octets) des données stockées dans la classe de stockage Archive.  
Type : long  
Plage valide : Valeur minimum de 0.  
Obligatoire : non

 ** ValueInIA **   <a name="efs-Type-FileSystemSize-ValueInIA"></a>
La dernière taille mesurée connue (en octets) des données stockées dans la classe de stockage Accès peu fréquent.  
Type : long  
Plage valide : Valeur minimum de 0.  
Obligatoire : non

 ** ValueInStandard **   <a name="efs-Type-FileSystemSize-ValueInStandard"></a>
La dernière taille mesurée connue (en octets) des données stockées dans la classe de stockage Standard.  
Type : long  
Plage valide : Valeur minimum de 0.  
Obligatoire : non

## consultez aussi
<a name="API_FileSystemSize_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/FileSystemSize) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/FileSystemSize) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/FileSystemSize) 

# LifecyclePolicy
<a name="API_LifecyclePolicy"></a>

Décrit une politique utilisée par la gestion du cycle de vie qui indique à quel moment les fichiers doivent être transférés vers et hors des classes de stockage. Pour plus d’informations, consultez [Gestion du stockage du système de fichiers](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).

**Note**  
Lorsque vous utilisez la commande `put-lifecycle-configuration` CLI ou l’action `PutLifecycleConfiguration` API, Amazon EFS exige que chaque `LifecyclePolicy` objet n’ait qu’une seule transition. Cela signifie que dans un corps de demande, `LifecyclePolicies` doit être structuré comme un tableau d’objets `LifecyclePolicy`, un objet pour chaque transition. Pour plus d’informations, consultez les exemples de demandes dans [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md).

## Table des matières
<a name="API_LifecyclePolicy_Contents"></a>

 ** TransitionToArchive **   <a name="efs-Type-LifecyclePolicy-TransitionToArchive"></a>
Nombre de jours après le dernier accès aux fichiers dans le stockage principal (classe de stockage standard) pendant lesquels ils ont été transférés vers le stockage d'archives. Les opérations sur les métadonnées, par exemple l’affichage du contenu d’un répertoire, ne sont pas considérées comme des événements d’accès aux fichiers.  
Type : String  
Valeurs valides : `AFTER_1_DAY | AFTER_7_DAYS | AFTER_14_DAYS | AFTER_30_DAYS | AFTER_60_DAYS | AFTER_90_DAYS | AFTER_180_DAYS | AFTER_270_DAYS | AFTER_365_DAYS`   
Obligatoire : non

 ** TransitionToIA **   <a name="efs-Type-LifecyclePolicy-TransitionToIA"></a>
Nombre de jours après le dernier accès aux fichiers dans le stockage principal (classe de stockage standard) pendant lesquels les fichiers doivent être transférés vers le stockage à accès peu fréquent (IA). Les opérations sur les métadonnées, par exemple l’affichage du contenu d’un répertoire, ne sont pas considérées comme des événements d’accès aux fichiers.  
Type : String  
Valeurs valides : `AFTER_7_DAYS | AFTER_14_DAYS | AFTER_30_DAYS | AFTER_60_DAYS | AFTER_90_DAYS | AFTER_1_DAY | AFTER_180_DAYS | AFTER_270_DAYS | AFTER_365_DAYS`   
Obligatoire : non

 ** TransitionToPrimaryStorageClass **   <a name="efs-Type-LifecyclePolicy-TransitionToPrimaryStorageClass"></a>
S’il faut replacer les fichiers vers le stockage principal (standard) après leur accès dans le stockage IA ou dans le stockage d’archives. Les opérations sur les métadonnées, par exemple l’affichage du contenu d’un répertoire, ne sont pas considérées comme des événements d’accès aux fichiers.  
Type : String  
Valeurs valides : `AFTER_1_ACCESS`   
Obligatoire : non

## consultez aussi
<a name="API_LifecyclePolicy_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/LifecyclePolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/LifecyclePolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/LifecyclePolicy) 

# MountTargetDescription
<a name="API_MountTargetDescription"></a>

Fournit une description d’une cible de montage.

## Table des matières
<a name="API_MountTargetDescription_Contents"></a>

 ** FileSystemId **   <a name="efs-Type-MountTargetDescription-FileSystemId"></a>
L’ID du système de fichiers pour lequel la cible de montage est destinée.  
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** LifeCycleState **   <a name="efs-Type-MountTargetDescription-LifeCycleState"></a>
État du cycle de vie de la cible de montage.  
Type : String  
Valeurs valides : `creating | available | updating | deleting | deleted | error`   
Obligatoire : oui

 ** MountTargetId **   <a name="efs-Type-MountTargetDescription-MountTargetId"></a>
ID de cible de montage attribué par le système.  
Type : String  
Contraintes de longueur : longueur minimale de 13. Longueur maximale de 45.  
Modèle : `^fsmt-[0-9a-f]{8,40}$`   
Obligatoire : oui

 ** SubnetId **   <a name="efs-Type-MountTargetDescription-SubnetId"></a>
ID du sous-réseau de la cible de montage.  
Type : String  
Contraintes de longueur : longueur minimale de 15. Longueur maximale de 47.  
Modèle : `^subnet-[0-9a-f]{8,40}$`   
Obligatoire : oui

 ** AvailabilityZoneId **   <a name="efs-Type-MountTargetDescription-AvailabilityZoneId"></a>
Identifiant unique et cohérent de la Zone de disponibilité dans laquelle réside la cible de montage. Par exemple, `use1-az1` il s'agit d'un ID AZ pour la région us-east-1 et il a le même emplacement dans chaque région. Compte AWS  
Type : chaîne  
Obligatoire : non

 ** AvailabilityZoneName **   <a name="efs-Type-MountTargetDescription-AvailabilityZoneName"></a>
Nom de la Zone de disponibilité dans laquelle se trouve la cible de montage. Les zones de disponibilité sont associées indépendamment aux noms de chacune d'entre elles Compte AWS. Par exemple, il se Compte AWS peut que votre zone `us-east-1a` de disponibilité ne soit pas la même que celle `us-east-1a` d'une autre Compte AWS.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `.+`   
Obligatoire : non

 ** IpAddress **   <a name="efs-Type-MountTargetDescription-IpAddress"></a>
 IPv4 Adresse de la cible de montage.  
Type : String  
Contraintes de longueur : longueur minimale de 7. Longueur maximale de 15.  
Modèle : `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`   
Obligatoire : non

 ** Ipv6Address **   <a name="efs-Type-MountTargetDescription-Ipv6Address"></a>
 IPv6 Adresse de la cible de montage.  
Type : String  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 39  
Obligatoire : non

 ** NetworkInterfaceId **   <a name="efs-Type-MountTargetDescription-NetworkInterfaceId"></a>
ID de l’interface réseau créée par Amazon EFS lors de la création de la cible de montage.  
Type : chaîne  
Obligatoire : non

 ** OwnerId **   <a name="efs-Type-MountTargetDescription-OwnerId"></a>
 Compte AWS ID propriétaire de la ressource.  
Type : String  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$`   
Obligatoire : non

 ** VpcId **   <a name="efs-Type-MountTargetDescription-VpcId"></a>
ID du cloud privé virtuel (VPC) dans lequel la cible de montage est configurée.  
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_MountTargetDescription_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/MountTargetDescription) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/MountTargetDescription) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/MountTargetDescription) 

# PosixUser
<a name="API_PosixUser"></a>

L'identité POSIX complète, y compris l'ID utilisateur, l'ID de groupe et tout groupe secondaire IDs, sur le point d'accès utilisé pour toutes les opérations du système de fichiers effectuées par les clients NFS utilisant le point d'accès.

## Table des matières
<a name="API_PosixUser_Contents"></a>

 ** Gid **   <a name="efs-Type-PosixUser-Gid"></a>
ID de groupe POSIX utilisé pour toutes les opérations de système de fichiers utilisant ce point d’accès.  
Type : long  
Plage valide : Valeur minimum de 0. Valeur maximale de 4294967295.  
Obligatoire : oui

 ** Uid **   <a name="efs-Type-PosixUser-Uid"></a>
ID utilisateur POSIX utilisé pour toutes les opérations de système de fichiers utilisant ce point d’accès.  
Type : long  
Plage valide : Valeur minimum de 0. Valeur maximale de 4294967295.  
Obligatoire : oui

 ** SecondaryGids **   <a name="efs-Type-PosixUser-SecondaryGids"></a>
Groupe POSIX secondaire IDs utilisé pour toutes les opérations du système de fichiers utilisant ce point d'accès.  
Type : Tableau de longueurs  
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 16 éléments.  
Plage valide : Valeur minimum de 0. Valeur maximale de 4294967295.  
Obligatoire : non

## consultez aussi
<a name="API_PosixUser_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PosixUser) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PosixUser) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PosixUser) 

# ReplicationConfigurationDescription
<a name="API_ReplicationConfigurationDescription"></a>

Décrit la configuration de réplication pour un système de fichiers spécifique.

## Table des matières
<a name="API_ReplicationConfigurationDescription_Contents"></a>

 ** CreationTime **   <a name="efs-Type-ReplicationConfigurationDescription-CreationTime"></a>
Décrit le moment où la configuration de réplication a été créée.  
Type : Timestamp  
Obligatoire : oui

 ** Destinations **   <a name="efs-Type-ReplicationConfigurationDescription-Destinations"></a>
Tableau d’objets de destination. Un seul objet de destination est pris en charge.  
Type : tableau d’objets [Destination](API_Destination.md)  
Obligatoire : oui

 ** OriginalSourceFileSystemArn **   <a name="efs-Type-ReplicationConfigurationDescription-OriginalSourceFileSystemArn"></a>
Amazon Resource Name (ARN) du système de fichiers EFS source d’origine dans la configuration de réplication.  
Type : String  
Obligatoire : oui

 ** SourceFileSystemArn **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemArn"></a>
Amazon Resource Name (ARN) du système de fichiers source actuel dans la configuration de réplication.  
Type : String  
Obligatoire : oui

 ** SourceFileSystemId **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemId"></a>
ID du système de fichiers Amazon EFS source qui est répliqué.  
Type : String  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatoire : oui

 ** SourceFileSystemRegion **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemRegion"></a>
Le système de fichiers EFS source Région AWS dans lequel se trouve le système de fichiers EFS.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`   
Obligatoire : oui

 ** SourceFileSystemOwnerId **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemOwnerId"></a>
ID du système de fichiers source Compte AWS dans lequel réside le système de fichiers.  
Type : String  
Contraintes de longueur : longueur maximale de 14.  
Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$`   
Obligatoire : non

## consultez aussi
<a name="API_ReplicationConfigurationDescription_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ReplicationConfigurationDescription) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ReplicationConfigurationDescription) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ReplicationConfigurationDescription) 

# ResourceIdPreference
<a name="API_ResourceIdPreference"></a>

Décrit le type de ressource et son identifiant préféré pour celui de l'utilisateur Compte AWS, dans la version actuelle Région AWS.

## Table des matières
<a name="API_ResourceIdPreference_Contents"></a>

 ** ResourceIdType **   <a name="efs-Type-ResourceIdPreference-ResourceIdType"></a>
Identifie la préférence d’ID de ressource EFS, soit `LONG_ID` (17 caractères) soit `SHORT_ID` (8 caractères).  
Type : String  
Valeurs valides : `LONG_ID | SHORT_ID`   
Obligatoire : non

 ** Resources **   <a name="efs-Type-ResourceIdPreference-Resources"></a>
Identifie les ressources Amazon EFS auxquelles s’applique le paramètre de préférence d’identification, `FILE_SYSTEM` et `MOUNT_TARGET`.  
Type : tableau de chaînes  
Valeurs valides : `FILE_SYSTEM | MOUNT_TARGET`   
Obligatoire : non

## consultez aussi
<a name="API_ResourceIdPreference_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ResourceIdPreference) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ResourceIdPreference) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ResourceIdPreference) 

# RootDirectory
<a name="API_RootDirectory"></a>

Spécifie le répertoire du système de fichiers Amazon EFS auquel le point d’accès donne accès. Le point d’accès expose le chemin du système de fichiers spécifié en tant que répertoire racine de votre système de fichiers aux applications utilisant le point d’accès. Les clients NFS utilisant le point d'accès peuvent uniquement accéder aux données du point d'accès `RootDirectory` et de ses sous-répertoires.

## Table des matières
<a name="API_RootDirectory_Contents"></a>

 ** CreationInfo **   <a name="efs-Type-RootDirectory-CreationInfo"></a>
(Facultatif) Spécifie le POSIX IDs et les autorisations à appliquer aux points d'`RootDirectory`accès. Si le `RootDirectory` > `Path` spécifié n’existe pas, EFS crée le répertoire racine à l’aide des paramètres `CreationInfo` lorsqu’un client se connecte à un point d’accès. Lorsque vous spécifiez le `CreationInfo`, vous devez fournir des valeurs pour toutes les propriétés.   
Si vous ne fournissez pas de valeur pour `CreationInfo` et que le `RootDirectory` > `Path` spécifié n’existe pas, les tentatives de montage du système de fichiers à l’aide du point d’accès échouent.
Type : objet [CreationInfo](API_CreationInfo.md)  
Obligatoire : non

 ** Path **   <a name="efs-Type-RootDirectory-Path"></a>
Spécifie le chemin d’accès sur le système de fichiers EFS à exposer en tant que répertoire racine aux clients NFS à l’aide du point d’accès pour accéder au système de fichiers EFS. Un chemin peut comporter jusqu’à quatre sous-répertoires. Si le chemin spécifié n’existe pas, vous devez fournir le `CreationInfo`.  
Type : String  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^(\/|(\/(?!\.)+[^$#<>;`|&?{}^*/\n]+){1,4})$`   
Obligatoire : non

## consultez aussi
<a name="API_RootDirectory_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/RootDirectory) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/RootDirectory) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/RootDirectory) 

# Tag
<a name="API_Tag"></a>

Une balise est une paire clé-valeur. Les caractères autorisés sont les lettres, les espaces et les chiffres qui peuvent être représentés au format UTF-8, ainsi que les caractères suivants :` + - = . _ : /`. 

## Table des matières
<a name="API_Tag_Contents"></a>

 ** Key **   <a name="efs-Type-Tag-Key"></a>
Clé de la balise (chaîne). La clé ne peut pas commencer par `aws:`.  
Type : String  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.  
Modèle : `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`   
Obligatoire : oui

 ** Value **   <a name="efs-Type-Tag-Value"></a>
Valeur de la clé de balise.  
Type : String  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Obligatoire : oui

## consultez aussi
<a name="API_Tag_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/Tag) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/Tag) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/Tag)