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](#API_UpdateFileSystem_RequestSyntax) ** 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})$` Obrigatório: Sim ## Corpo da Solicitação A solicitação aceita os dados a seguir no formato JSON. ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) ** (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 Suporte. Para obter mais informações, consulte [Cotas do Amazon EFS que você pode aumentar](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) no *Guia do usuário do Amazon EFS*. Tipo: duplo Faixa válida: valor mínimo de 1.0. Obrigatório: não ** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) ** (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: 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](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** 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](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) no *Guia do usuário do Amazon EFS*. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64. Padrão: `.+` ** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) ** A hora em que o sistema de arquivos foi criado, em segundos (desde 1970-01-01T 00:00:00 Z). Tipo: Timestamp ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) ** A string opaca especificada na solicitação. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64. Padrão: `.+` ** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) ** Um valor booliano que, quando verdadeiro, indica que o sistema de arquivos é criptografado. Tipo: booliano ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Descreve a proteção no sistema de arquivos. Tipo: objeto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) ** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** A fase do ciclo de vida do sistema de arquivos. Tipo: string Valores válidos: `creating | available | updating | deleting | deleted | error` ** [Name](#API_UpdateFileSystem_ResponseSyntax) ** Você pode adicionar tags a um sistema de arquivos, incluindo uma tag `Name`. Para obter mais informações, consulte [CreateFileSystem](API_CreateFileSystem.md). Se o sistema de arquivos tiver uma tag `Name`, 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](#API_UpdateFileSystem_ResponseSyntax) ** O número atual de destinos de montagem que o sistema de arquivos tem. Para obter mais informações, consulte [CreateMountTarget](API_CreateMountTarget.md). Tipo: inteiro Intervalo válido: valor mínimo de 0. ** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** O modo de desempenho do sistema de arquivos. Tipo: string Valores válidos: `generalPurpose | maxIO` ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** 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](API_FileSystemSize.md) ** [Tags](#API_UpdateFileSystem_ResponseSyntax) ** As tags associadas ao sistema de arquivos, apresentadas como uma matriz de objetos de `Tag`. Tipo: matriz de objetos [Tag](API_Tag.md) ** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) ** Mostra o modo de taxa de transferência para um sistema de arquivos. Para obter mais informações, consulte [Modos de throughput](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) 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. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 400 ** FileSystemNotFound ** Retornado se o `FileSystemId` valor especificado não existir no valor do Conta da AWS solicitante. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 503 ** InternalServerError ** Retornado se ocorreu um erro no lado do servidor. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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 foi atingido. MiB/s ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)