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. # UpdateFileSystem 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](#API_UpdateFileSystem_RequestSyntax) ** 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](#API_UpdateFileSystem_RequestSyntax) ** (Opcional) El rendimiento, medido en mebibytes por segundo (MiBps), que desea aprovisionar para el sistema de archivos que está creando. Obligatorio si `ThroughputMode` se establece en `provisioned`. 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. Soporte Para obtener más información, consulte [Cuotas de Amazon EFS que puede incrementar](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) en la *Guía del usuario de Amazon EFS.* Tipo: Doble Rango válido: valor mínimo de 1.0. Obligatorio: no ** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) ** (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 `ThroughputMode` a `provisioned`, también debe establecer un valor para `ProvisionedThroughputInMibps`. Tipo: cadena Valores válidos: `bursting | provisioned | elastic` Obligatorio: 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](#API_UpdateFileSystem_ResponseSyntax) ** 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-az1` es 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 AWS Tipo: cadena ** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) ** 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](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) 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](#API_UpdateFileSystem_ResponseSyntax) ** Hora en que se creó el sistema de archivos, en segundos (desde 1970-01-01T 00:00:00 Z). Tipo: marca temporal ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Un valor booleano que, si es verdadero, indica que el sistema de archivos está cifrado. Tipo: Booleano ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) ** 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-01234567` Tipo: cadena ** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Describe la protección del sistema de archivos. Tipo: objeto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) ** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** La fase del ciclo de vida del sistema de archivos. Tipo: cadena Valores válidos: `creating | available | updating | deleting | deleted | error` ** [Name](#API_UpdateFileSystem_ResponseSyntax) ** Puede añadir etiquetas a un sistema de archivos, incluida una etiqueta `Name`. Para obtener más información, consulte [CreateFileSystem](API_CreateFileSystem.md). Si el sistema de archivos tiene una etiqueta `Name`, 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](#API_UpdateFileSystem_ResponseSyntax) ** El número actual de destinos de montaje que tiene el sistema de archivos. Para obtener más información, consulte [CreateMountTarget](API_CreateMountTarget.md). Tipo: entero Rango válido: valor mínimo de 0. ** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** El modo de desempeño del sistema de archivos. Tipo: cadena Valores válidos: `generalPurpose | maxIO` ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) ** La cantidad de rendimiento aprovisionada, medida en MiBps, para el sistema de archivos. Válido para los sistemas de archivos que utilizan `ThroughputMode` establecido en `provisioned`. Tipo: Doble Rango válido: valor mínimo de 0.0. ** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) ** 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 campo `Timestamp`. El valor de `Timestamp` es el número entero de segundos transcurridos desde 1970-01-01T 00:00:00 Z. El valor de `SizeInBytes` no 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, `SizeInBytes` representa 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](API_FileSystemSize.md) ** [Tags](#API_UpdateFileSystem_ResponseSyntax) ** Las etiquetas asociadas al sistema de archivos, presentadas como un conjunto de objetos `Tag`. Tipo: matriz de objetos [Tag](API_Tag.md) ** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) ** Muestra el modo de rendimiento de un sistema de archivos. Para obtener más información, consulte [Modos de rendimiento](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) 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. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 400 ** FileSystemNotFound ** Se devuelve si el `FileSystemId` valor especificado no existe en el del solicitante. Cuenta de AWS ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 503 ** InternalServerError ** Se devuelve si se ha producido un error en el servidor. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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 ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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 AWS SDKs específicos, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)