UpdateFileSystem - Amazon Elastic File System
Sintaxis de la solicitudParámetros de solicitud del URICuerpo 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"
}

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

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

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

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

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

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, 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 FileSystemId valor especificado no existe en el del solicitante. Cuenta de AWS

Có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 AWS SDK específicos del idioma, consulta lo siguiente: