UpdateFileSystem - Amazon Elastic File System

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

URIParâmetros de solicitação

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

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 seguintes dados no JSON formato.

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 as EFScotas da Amazon que você pode aumentar no Guia do EFS usuário da Amazon.

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 em JSON formato 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: string

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 Usando classes EFS de armazenamento no Guia EFS do usuário da Amazon.

Tipo: string

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

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 Amazon Resource Name (ARN) para o sistema de EFS arquivos, no formatoarn: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: string

FileSystemId

O ID do sistema de arquivos, atribuído pela AmazonEFS.

Tipo: string

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

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

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 Name tag, a Amazon EFS retornará o valor nesse campo.

Tipo: string

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: número inteiro

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

OwnerId

O Conta da AWS que criou o sistema de arquivos.

Tipo: string

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 taxa de transferência no Guia do EFS usuário da Amazon.

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.

HTTPCódigo de status: 400

FileSystemNotFound

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

HTTPCódigo de status: 404

IncorrectFileSystemLifeCycleState

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

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

HTTPCódigo de status: 503

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

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

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

HTTPCódigo de status: 429

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: