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 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 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
paraprovisioned
, você também deve definir um valor paraProvisionedThroughputInMibps
.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 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 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 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 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 umaName
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 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 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: