UpdateFileSystem - Amazon Elastic File System
Sintaxis de la solicitudURIParámetros de solicitudCuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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"
}

URIParámetros de solicitud

La solicitud utiliza los siguientes URI parámetros.

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 JSON formato.

ProvisionedThroughputInMibps

(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. AWS Support Para obtener más información, consulta EFSlas cuotas de Amazon que puedes aumentar en la Guía del EFS usuario de Amazon.

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 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 de HTTP 202.

El servicio devuelve los siguientes datos en JSON formato.

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

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, consulta Uso EFS de clases de almacenamiento en la Guía del EFS usuario de Amazon.

Tipo: string

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: string

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

El nombre del recurso de Amazon (ARN) del sistema de EFS archivos, en el formatoarn: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

El ID del sistema de archivos, asignado por AmazonEFS.

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 ID de un usuario AWS KMS key utilizado 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 Name etiqueta, 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 ThroughputMode establecido en provisioned.

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

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, consulta Modos de rendimiento en la Guía del EFS usuario de Amazon.

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.

HTTPCódigo de estado: 400

FileSystemNotFound

Se devuelve si el FileSystemId valor especificado no existe en el del Cuenta de AWS solicitante.

HTTPCódigo de estado: 404

IncorrectFileSystemLifeCycleState

Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.

HTTPCódigo de estado: 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.

HTTPCódigo de estado: 503

InternalServerError

Se devuelve si se ha producido un error en el servidor.

HTTPCódigo de estado: 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.

HTTPCódigo de estado: 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.

HTTPCódigo de estado: 429

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: