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.
# Actions
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
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
```
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
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [ClientToken](#API_CreateAccessPoint_RequestSyntax) **
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) **
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) **
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) **
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) **
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
```
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
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) **
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) **
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) **
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) **
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) **
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) **
Nom de ce point d’accès. Il s’agit de la valeur de la balise `Name`.
Type : Chaîne
** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) **
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) **
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) **
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) **
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
** 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
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
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
```
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
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **
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) **
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) **
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) **
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) **
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) **
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) **
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) **
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) **
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
```
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
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) **
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) **
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) **
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) **
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) **
Valeur booléenne qui, si la valeur est true, indique que le système de fichiers est chiffré.
Type : Boolean
** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) **
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) **
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) **
Décrit la protection du système de fichiers.
Type : objet [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) **
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) **
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) **
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) **
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) **
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) **
Mode de performances du système de fichiers.
Type : Chaîne
Valeurs valides : `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) **
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) **
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) **
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) **
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
** 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
### Créez d’un système de fichiers EFS
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
```
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
```
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
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
```
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
```
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
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
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
```
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
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **
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) **
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) **
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) **
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) **
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) **
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
```
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
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) **
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) **
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) **
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) **
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) **
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) **
É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) **
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) **
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) **
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) **
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) **
ID du cloud privé virtuel (VPC) dans lequel la cible de montage est configurée.
Type : Chaîne
## Erreurs
** 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
### Création d'une cible de montage à une IPv4 adresse disponible sur un sous-réseau
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
```
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
```
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
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
```
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
```
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
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
```
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
```
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
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
```
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
```
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
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
```
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
```
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
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
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
```
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
La demande utilise les paramètres URI suivants.
** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **
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
```
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
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) **
Décrit le moment où la configuration de réplication a été créée.
Type : Timestamp
** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **
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) **
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) **
Amazon Resource Name (ARN) du système de fichiers source actuel dans la configuration de réplication.
Type : Chaîne
** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **
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) **
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) **
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
** 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
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
**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
```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_CreateTags_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [Tags](#API_CreateTags_RequestSyntax) **
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
```
HTTP/1.1 204
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
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
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
```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 204
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Erreurs
** 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
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
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
```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 204
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
### Supprimer un système de fichiers
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
```
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
```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```
## consultez aussi
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
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
```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
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
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
```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 204
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
### Supprimer la cible de montage d’un système de fichiers
L’exemple suivant envoie une demande DELETE pour supprimer une cible de montage spécifique.
#### Exemple de demande
```
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
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## consultez aussi
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
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
```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **
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) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 204
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
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
**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
```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"TagKeys": [ "string" ]
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DeleteTags_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [TagKeys](#API_DeleteTags_RequestSyntax) **
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
```
HTTP/1.1 204
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
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
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
```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **
(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) **
(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) **
(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) **
`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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
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
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) **
Un ensemble de descriptions de points d’accès.
Type : tableau d’objets [AccessPointDescription](API_AccessPointDescription.md)
** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **
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
** 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
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
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
```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string"
}
```
## Paramètres de demande URI
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **
(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) **
(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
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## Eléments de réponse
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) **
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) **
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
** 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
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
Renvoie la politique de sauvegarde pour le système de fichiers EFS spécifié.
## Syntaxe de la demande
```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Eléments de réponse
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) **
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
** 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
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
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
```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "string"
}
```
## Eléments de réponse
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) **
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) **
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
** 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
### Exemple
Cet exemple illustre une utilisation de DescribeFileSystemPolicy.
#### Exemple de demande
```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```
#### Exemple de réponse
```
{
"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
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
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
```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **
(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) **
(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) **
(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) **
(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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
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
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) **
Tableau de descriptions de systèmes de fichiers.
Type : tableau d’objets [FileSystemDescription](API_FileSystemDescription.md)
** [Marker](#API_DescribeFileSystems_ResponseSyntax) **
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) **
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
** 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
### Extrait une liste de 10 systèmes de fichiers
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
```
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
```
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
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
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
```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Eléments de réponse
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) **
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
** 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
### Récupérer la configuration du cycle de vie d’un système de fichiers
La requête suivante récupère l’objet `LifecycleConfiguration` pour le système de fichiers spécifié.
#### Exemple de demande
```
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
```
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
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
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
```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **
(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) **
(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) **
(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) **
(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) **
(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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
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
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) **
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) **
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) **
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
** 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
### Récupère les descriptions des cibles de montage créées pour un système de fichiers
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
```
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
```
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
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
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
```
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **
ID de la cible de montage dont vous souhaitez modifier les groupes de sécurité.
Contraintes de longueur : longueur minimale de 13. Longueur maximale de 45.
Modèle : `^fsmt-[0-9a-f]{8,40}$`
Obligatoire : oui
## Corps de la demande
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Eléments de réponse
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) **
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
** 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
### Récupérer les groupes de sécurité en vigueur pour un système de fichiers.
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
```
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
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
## consultez aussi
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
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
```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **
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) **
(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) **
`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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
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
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) **
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) **
Ensemble de configurations de réplication renvoyé.
Type : tableau d’objets [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md)
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
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
**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
```
GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_DescribeTags_RequestSyntax) **
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) **
(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) **
(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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"NextMarker": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Eléments de réponse
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) **
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) **
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) **
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
** 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
### Récupérer toutes les balises associées à un système de fichiers
La requête suivante récupère les balises (paires clé-valeur) associées au système de fichiers spécifié.
#### Exemple de demande
```
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
```
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
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
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
```
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [MaxResults](#API_ListTagsForResource_RequestSyntax) **
(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) **
(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) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Eléments de réponse
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) **
`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) **
Tableau des balises de ressource EFS spécifiée.
Type : tableau d’objets [Tag](API_Tag.md)
## Erreurs
** 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
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
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
```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
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
```
HTTP/1.1 204
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Erreurs
** BadRequest **
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
** 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
### Remplacer les groupes de sécurité d’une cible de montage
L’exemple suivant remplace les groupes de sécurité en vigueur pour l’interface réseau associée à une cible de montage.
#### Exemple de demande
```
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
#### Exemple de réponse
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## consultez aussi
Pour plus d'informations sur 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
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
```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}
```
## Paramètres de demande URI
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **
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
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## Eléments de réponse
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) **
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
** 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
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
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
```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **
Politique de sauvegarde incluse dans la demande `PutBackupPolicy`.
Type : objet [BackupPolicy](API_BackupPolicy.md)
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Eléments de réponse
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) **
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
** 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
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
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
```
PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json
{
"BypassPolicyLockoutSafetyCheck": boolean,
"Policy": "string"
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) **
(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) **
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
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "string"
}
```
## Eléments de réponse
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) **
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) **
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
** 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
### Création d'un EFS FileSystemPolicy
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
```
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
```
{
"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
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
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
```
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
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **
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
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Eléments de réponse
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) **
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
** 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
### Créer une configuration de cycle de vie
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
```
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
```
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
Cet exemple illustre une utilisation de PutLifecycleConfiguration.
#### Exemple de demande
```
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
```
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
### Désactiver la gestion du cycle de vie ()
L’exemple suivant désactive la gestion du cycle de vie pour le système de fichiers spécifié.
#### Exemple de demande
```
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
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
## consultez aussi
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
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
```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [ResourceId](#API_TagResource_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [Tags](#API_TagResource_RequestSyntax) **
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
```
HTTP/1.1 200
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
** 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
### Créer des balises sur un système de fichiers
La requête suivante crée trois balises (`"key1"`,`"key2"`, et `"key3"`) sur le système de fichiers spécifié.
#### Exemple de demande
```
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
```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## consultez aussi
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
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
```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [ResourceId](#API_UntagResource_RequestSyntax) **
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) **
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
La demande n’a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
** 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
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
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
```
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number,
"ThroughputMode": "string"
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) **
(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) **
(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
```
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
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) **
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) **
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) **
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) **
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) **
Valeur booléenne qui, si la valeur est true, indique que le système de fichiers est chiffré.
Type : Boolean
** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) **
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) **
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) **
Décrit la protection du système de fichiers.
Type : objet [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) **
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) **
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) **
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) **
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) **
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) **
Mode de performances du système de fichiers.
Type : Chaîne
Valeurs valides : `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) **
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) **
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) **
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) **
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
** 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
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
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
```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **
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
Cette demande accepte les données suivantes au format JSON.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **
É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
```
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Eléments de réponse
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) **
É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
** 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
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)