UpdateFileSystem - Amazon Elastic File System
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

UpdateFileSystem

Atualiza o modo de taxa de transferência ou a quantidade de taxa de transferência provisionada de um sistema de arquivos existente.

Sintaxe da Solicitação

PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json

{
   "ProvisionedThroughputInMibps": number,
   "ThroughputMode": "string"
}

Parâmetros da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

FileSystemId

O ID do sistema de arquivos que você deseja atualizar.

Restrições de Tamanho: Tamanho máximo de 128.

Padrão: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Exigido: Sim

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

ProvisionedThroughputInMibps

(Opcional) A taxa de transferência, medida em mebibytes por segundo (MiBps), que você deseja provisionar para um sistema de arquivos que você está criando. Necessário se ThroughputMode estiver definido como provisioned. Os valores válidos são de 1 a 3414 MiBps, com o limite superior dependendo da região. Para aumentar esse limite, entre em contato AWS Support. Para obter mais informações, consulte Cotas do Amazon EFS que você pode aumentar no Guia do usuário do Amazon EFS.

Tipo: duplo

Faixa válida: valor mínimo de 1.0.

Obrigatório: não

ThroughputMode

(Opcional) Atualiza o modo de taxa de transferência do sistema de arquivos. Se você não estiver atualizando seu modo de taxa de transferência, não precisará fornecer esse valor em sua solicitação. Se estiver alterando ThroughputMode para provisioned, você também deve definir um valor para ProvisionedThroughputInMibps.

Tipo: sequências

Valores Válidos: bursting | provisioned | elastic

Obrigatório: Não

Sintaxe da Resposta

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 Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 202.

Os dados a seguir são retornados no formato JSON pelo serviço.

AvailabilityZoneId

O identificador exclusivo e consistente da zona de disponibilidade na qual o sistema de arquivos está localizado e é válido somente para sistemas de arquivos One Zone. Por exemplo, use1-az1 é um ID de zona de disponibilidade para Região da AWS us-east-1 e tem a mesma localização em todos. Conta da AWS

Tipo: sequência

AvailabilityZoneName

Descreve a zona de AWS disponibilidade na qual o sistema de arquivos está localizado e é válido somente para sistemas de arquivos de uma zona. Para obter mais informações, consulte Usar classes de armazenamento EFS no Guia do usuário do Amazon EFS.

Tipo: sequência

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: .+

CreationTime

A hora em que o sistema de arquivos foi criado, em segundos (desde 1970-01-01T 00:00:00 Z).

Tipo: carimbo de data/hora

CreationToken

A string opaca especificada na solicitação.

Tipo: sequência

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: .+

Encrypted

Um valor booliano que, quando verdadeiro, indica que o sistema de arquivos é criptografado.

Tipo: booliano

FileSystemArn

O nome do recurso da Amazon (ARN) para o sistema de arquivos do Amazon EFS no formato arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id . Exemplo com dados de amostra: arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567

Tipo: sequência

FileSystemId

O ID do sistema de arquivos, atribuído pelo Amazon EFS.

Tipo: sequência

Restrições de tamanho: tamanho máximo de 128.

Padrão: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

FileSystemProtection

Descreve a proteção no sistema de arquivos.

Tipo: objeto FileSystemProtectionDescription

KmsKeyId

O ID de um AWS KMS key usado para proteger o sistema de arquivos criptografados.

Tipo: sequência

Restrições de tamanho: tamanho máximo de 2.048.

Padrão: ^([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

A fase do ciclo de vida do sistema de arquivos.

Tipo: sequências

Valores Válidos: creating | available | updating | deleting | deleted | error

Name

Você pode adicionar tags a um sistema de arquivos, incluindo uma tag Name. Para ter mais informações, consulte CreateFileSystem. Se o sistema de arquivos tiver uma tag Name, o Amazon EFS retornará o valor nesse campo.

Tipo: sequência

Restrições de tamanho: o tamanho máximo é 256.

Padrão: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

NumberOfMountTargets

O número atual de destinos de montagem que o sistema de arquivos tem. Para ter mais informações, consulte CreateMountTarget.

Tipo: inteiro

Intervalo válido: valor mínimo de 0.

OwnerId

O Conta da AWS que criou o sistema de arquivos.

Tipo: sequência

Restrições de tamanho: tamanho máximo de 14.

Padrão: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

O modo de desempenho do sistema de arquivos.

Tipo: sequências

Valores Válidos: generalPurpose | maxIO

ProvisionedThroughputInMibps

A quantidade de taxa de transferência provisionada, medida em MiBps, para o sistema de arquivos. Válido para sistemas de arquivos usando ThroughputMode definido como provisioned.

Tipo: duplo

Faixa válida: valor mínimo de 1.0.

SizeInBytes

O último tamanho medido conhecido (em bytes) dos dados armazenados no sistema de arquivos, em seu campo Value, e a hora em que esse tamanho foi determinado em seu campo Timestamp. O valor Timestamp é o número inteiro de segundos desde 1970-01-01T 00:00:00 Z. O valor SizeInBytes não representa o tamanho de um instantâneo consistente do sistema de arquivos, mas acaba sendo consistente quando não há gravações no sistema de arquivos. Ou seja, SizeInBytes representa o tamanho real somente se o sistema de arquivos não for modificado por um período superior a algumas horas. Caso contrário, o valor não é o tamanho exato que o sistema de arquivos tinha em algum momento.

Tipo: objeto FileSystemSize

Tags

As tags associadas ao sistema de arquivos, apresentadas como uma matriz de objetos de Tag.

Tipo: matriz de objetos Tag

ThroughputMode

Mostra o modo de taxa de transferência para um sistema de arquivos. Para obter mais informações, consulte Modos de throughput no Guia do usuário do Amazon EFS.

Tipo: sequências

Valores Válidos: bursting | provisioned | elastic

Erros

BadRequest

Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente.

Código de Status HTTP: 400

FileSystemNotFound

Retornado se o FileSystemId valor especificado não existir no valor do Conta da AWS solicitante.

Código de Status HTTP: 404

IncorrectFileSystemLifeCycleState

Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”.

Código de Status HTTP: 409

InsufficientThroughputCapacity

Retornado se não houver capacidade suficiente para provisionar throughput adicional. Esse valor pode ser retornado ao tentar criar um sistema de arquivos no modo de taxa de transferência provisionada, ao tentar aumentar a taxa de transferência provisionada de um sistema de arquivos existente ou ao tentar alterar um sistema de arquivos existente do modo de taxa de transferência intermitente para o modo de taxa de transferência provisionada. Tente novamente mais tarde.

Código de status HTTP: 503

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

Código de Status HTTP: 500

ThroughputLimitExceeded

Retornado se o modo de taxa de transferência ou a quantidade de taxa de transferência provisionada não puderem ser alterados porque o limite de taxa de transferência de 1024 MiB/s foi atingido.

Código de Status HTTP: 400

TooManyRequests

Retornado se você não esperar pelo menos 24 horas antes de alterar o modo de taxa de transferência ou diminuir o valor da taxa de transferência provisionada.

Código de status HTTP: 429

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: