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á.
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 comoprovisioned
. 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 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
paraprovisioned
, você também deve definir um valor paraProvisionedThroughputInMibps
.Tipo: string
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 AWSTipo: 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 Usar classes de armazenamento EFS no Guia do usuário do Amazon EFS.
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 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: string
- FileSystemId
-
O ID do sistema de arquivos, atribuído pelo Amazon EFS.
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: string
Valores Válidos:
creating | available | updating | deleting | deleted | error
- Name
-
Você pode adicionar tags a um sistema de arquivos, incluindo uma tag
Name
. Para obter mais informações, consulte CreateFileSystem. Se o sistema de arquivos tiver uma tagName
, o 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 obter 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: 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: string
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 comoprovisioned
.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 campoTimestamp
. O valorTimestamp
é o número inteiro de segundos desde 1970-01-01T 00:00:00 Z. O valorSizeInBytes
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: string
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 uma das linguagens específicas AWS SDKs, consulte o seguinte: