UpdateFileSystem - Amazon Elastic File System

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

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

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

(Facultatif) Le débit, mesuré en mégaoctets 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 AWS Support. Pour plus d’informations, consultez Quotas Amazon EFS que vous pouvez augmenter dans le Guide de l’utilisateur Amazon EFS.

Type : double

Plage valide : valeur minimum de 1,0.

Obligatoire : non

ThroughputMode

(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

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

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 dans le Guide de l’utilisateur Amazon EFS.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : .+

CreationTime

Heure de création du système de fichiers, en secondes (depuis 1970-01-01T 00:00:00 Z).

Type : Timestamp

CreationToken

Chaîne opaque spécifiée dans la demande.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : .+

Encrypted

Valeur booléenne qui, si la valeur est true, indique que le système de fichiers est chiffré.

Type : booléen

FileSystemArn

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

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

Décrit la protection du système de fichiers.

Type : objet FileSystemProtectionDescription

KmsKeyId

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

Phase du cycle de vie du système de fichiers.

Type : chaîne

Valeurs valides : creating | available | updating | deleting | deleted | error

Name

Vous pouvez ajouter des balises à un système de fichiers, y compris une balise Name. Pour de plus amples informations, veuillez consulter 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

Le nombre actuel de cibles de Montage du système de fichiers. Pour de plus amples informations, veuillez consulter CreateMountTarget.

Type : entier

Plage valide : Valeur minimum de 0.

OwnerId

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

Mode de performances du système de fichiers.

Type : chaîne

Valeurs valides : generalPurpose | maxIO

ProvisionedThroughputInMibps

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

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

Tags

Tags associés au système de fichiers, présentés sous forme de tableau des objets Tag.

Type : tableau d’objets Tag

ThroughputMode

Affiche le mode de débit du système de fichiers. Pour plus d’informations, consultez les Modes de débit 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.

Code d’état HTTP : 400

FileSystemNotFound

Renvoyé si la FileSystemId valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.

Code d’état HTTP : 404

IncorrectFileSystemLifeCycleState

Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».

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.

HTTP Status Code: 503

InternalServerError

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

Code d’état HTTP : 500

ThroughputLimitExceeded

Renvoie si le mode de débit ou la quantité de débit alloué ne peuvent pas être Modifiés car la limite de débit de 1024 Mbits/s a été atteinte.

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é.

Code d’état HTTP : 429

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :