Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Actualiza el modo de rendimiento o la cantidad de rendimiento aprovisionado de un sistema de archivos existente.
Sintaxis de la solicitud
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number,
"ThroughputMode": "string"
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- FileSystemId
-
El ID del sistema de archivos que desea actualizar.
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$Obligatorio: sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- ProvisionedThroughputInMibps
-
(Opcional) El rendimiento, medido en mebibytes por segundo (MiBps), que desea aprovisionar para el sistema de archivos que está creando. Obligatorio si
ThroughputModese establece enprovisioned. Los valores válidos son del 1 al 3414 MiBps, y el límite superior depende de la región. Para aumentar este límite, póngase en contacto con. Support Para obtener más información, consulte Cuotas de Amazon EFS que puede incrementar en la Guía del usuario de Amazon EFS.Tipo: Doble
Rango válido: valor mínimo de 1.0.
Obligatorio: no
- ThroughputMode
-
(Opcional) Actualiza el modo de rendimiento del sistema de archivos. Si no va a actualizar el modo de rendimiento, no necesita proporcionar este valor en la solicitud. Si cambia
ThroughputModeaprovisioned, también debe establecer un valor paraProvisionedThroughputInMibps.Tipo: cadena
Valores válidos:
bursting | provisioned | elasticObligatorio: no
Sintaxis de la respuesta
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"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 202.
El servicio devuelve los datos siguientes en formato JSON.
- AvailabilityZoneId
-
El identificador único y coherente de la zona de disponibilidad en la que se encuentra el sistema de archivos y solo es válido para los sistemas de archivos One Zone. Por ejemplo,
use1-az1es un identificador de zona de disponibilidad para el Región de AWS us-east-1 y tiene la misma ubicación en todas. Cuenta de AWSTipo: cadena
- AvailabilityZoneName
-
Describe la zona de AWS disponibilidad en la que se encuentra el sistema de archivos y solo es válido para los sistemas de archivos de una zona. Para obtener más información, consulte Uso de clases de almacenamiento de EFS en la Guía del usuario de Amazon EFS.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón:
.+ - CreationTime
-
Hora en que se creó el sistema de archivos, en segundos (desde 1970-01-01T 00:00:00 Z).
Tipo: marca temporal
- CreationToken
-
La cadena opaca especificada en la solicitud.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón:
.+ - Encrypted
-
Un valor booleano que, si es verdadero, indica que el sistema de archivos está cifrado.
Tipo: Booleano
- FileSystemArn
-
Nombre de recurso de Amazon (ARN) para el sistema de archivos de EFS en el formato
arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id. Ejemplo con datos de muestra:arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567Tipo: cadena
- FileSystemId
-
El ID del sistema de archivos, asignado por Amazon EFS.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - FileSystemProtection
-
Describe la protección del sistema de archivos.
Tipo: objeto FileSystemProtectionDescription
- KmsKeyId
-
El identificador de un sistema de archivos cifrado que AWS KMS key se utiliza para proteger el sistema de archivos cifrados.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 2048 caracteres.
Patrón:
^([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
-
La fase del ciclo de vida del sistema de archivos.
Tipo: cadena
Valores válidos:
creating | available | updating | deleting | deleted | error - Name
-
Puede añadir etiquetas a un sistema de archivos, incluida una etiqueta
Name. Para obtener más información, consulte CreateFileSystem. Si el sistema de archivos tiene una etiquetaName, Amazon EFS devuelve el valor de este campo.Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$ - NumberOfMountTargets
-
El número actual de destinos de montaje que tiene el sistema de archivos. Para obtener más información, consulte CreateMountTarget.
Tipo: entero
Rango válido: valor mínimo de 0.
- OwnerId
-
El Cuenta de AWS que creó el sistema de archivos.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón:
^(\d{12})|(\d{4}-\d{4}-\d{4})$ - PerformanceMode
-
El modo de desempeño del sistema de archivos.
Tipo: cadena
Valores válidos:
generalPurpose | maxIO - ProvisionedThroughputInMibps
-
La cantidad de rendimiento aprovisionada, medida en MiBps, para el sistema de archivos. Válido para los sistemas de archivos que utilizan
ThroughputModeestablecido enprovisioned.Tipo: Doble
Rango válido: valor mínimo de 0.0.
- SizeInBytes
-
El último tamaño medido conocido (en bytes) de los datos almacenados en el sistema de archivos, en su campo
Value, y el momento en que se determinó ese tamaño en su campoTimestamp. El valor deTimestampes el número entero de segundos transcurridos desde 1970-01-01T 00:00:00 Z. El valor deSizeInBytesno representa el tamaño de una instantánea coherente del sistema de archivos, pero en última instancia es coherente cuando no hay escrituras en el sistema de archivos. Es decir,SizeInBytesrepresenta el tamaño real solo si el sistema de archivos no se modifica durante un período superior a un par de horas. De lo contrario, el valor no es el tamaño exacto que tenía el sistema de archivos en ningún momento.Tipo: objeto FileSystemSize
- Tags
-
Las etiquetas asociadas al sistema de archivos, presentadas como un conjunto de objetos
Tag.Tipo: matriz de objetos Tag
- ThroughputMode
-
Muestra el modo de rendimiento de un sistema de archivos. Para obtener más información, consulte Modos de rendimiento en la Guía del usuario de Amazon EFS.
Tipo: cadena
Valores válidos:
bursting | provisioned | elastic
Errores
- BadRequest
-
Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio.
Código de estado HTTP: 400
- FileSystemNotFound
-
Se devuelve si el
FileSystemIdvalor especificado no existe en el del solicitante. Cuenta de AWSCódigo de estado HTTP: 404
- IncorrectFileSystemLifeCycleState
-
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
Código de estado HTTP: 409
- InsufficientThroughputCapacity
-
Se devuelve si no hay suficiente capacidad para aprovisionar un rendimiento adicional. Este valor puede devolverse al intentar crear un sistema de archivos en el modo de rendimiento aprovisionado, al intentar aumentar el rendimiento aprovisionado de un sistema de archivos existente o al intentar cambiar un sistema de archivos existente del modo de rendimiento de ráfaga al de rendimiento aprovisionado. Inténtelo de nuevo más tarde.
Código de estado HTTP: 503
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
Código de estado HTTP: 500
- ThroughputLimitExceeded
-
Se devuelve si el modo de rendimiento o la cantidad de rendimiento aprovisionada no se pueden cambiar porque se ha alcanzado el límite de rendimiento de 1024 MiB/s.
Código de estado HTTP: 400
- TooManyRequests
-
Se devuelve si no esperas al menos 24 horas antes de cambiar el modo de rendimiento o reducir el valor del rendimiento aprovisionado.
Código de estado HTTP: 429
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
