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á.
# Ações
As ações a seguir são compatíveis:
+ [CreateAccessPoint](API_CreateAccessPoint.md)
+ [CreateFileSystem](API_CreateFileSystem.md)
+ [CreateMountTarget](API_CreateMountTarget.md)
+ [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md)
+ [CreateTags](API_CreateTags.md)
+ [DeleteAccessPoint](API_DeleteAccessPoint.md)
+ [DeleteFileSystem](API_DeleteFileSystem.md)
+ [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md)
+ [DeleteMountTarget](API_DeleteMountTarget.md)
+ [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md)
+ [DeleteTags](API_DeleteTags.md)
+ [DescribeAccessPoints](API_DescribeAccessPoints.md)
+ [DescribeAccountPreferences](API_DescribeAccountPreferences.md)
+ [DescribeBackupPolicy](API_DescribeBackupPolicy.md)
+ [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md)
+ [DescribeFileSystems](API_DescribeFileSystems.md)
+ [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md)
+ [DescribeMountTargets](API_DescribeMountTargets.md)
+ [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md)
+ [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md)
+ [DescribeTags](API_DescribeTags.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md)
+ [PutAccountPreferences](API_PutAccountPreferences.md)
+ [PutBackupPolicy](API_PutBackupPolicy.md)
+ [PutFileSystemPolicy](API_PutFileSystemPolicy.md)
+ [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateFileSystem](API_UpdateFileSystem.md)
+ [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md)
# CreateAccessPoint
Criar um ponto de acesso do EFS Um ponto de acesso é uma visualização específica da aplicação em um sistema de arquivos do EFS que aplica um usuário e grupo do sistema operacional, e um caminho do sistema de arquivos, a qualquer solicitação do sistema de arquivos feita por meio do ponto de acesso. O usuário e o grupo do sistema operacional substituem qualquer informação de identidade fornecida pelo cliente NFS. O caminho do sistema de arquivos é exposto como o diretório raiz do ponto de acesso. Os aplicativos que usam o ponto de acesso só podem acessar dados no próprio diretório do aplicativo e em quaisquer subdiretórios. Um sistema de arquivos pode ter até 10 mil pontos de acesso, a menos que você solicite um aumento. Para saber mais, consulte [Montar um sistema de arquivos usando pontos de acesso do EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html).
**nota**
Se várias solicitações para criar pontos de acesso no mesmo sistema de arquivos forem enviadas em rápida sucessão e o sistema de arquivos estiver próximo do limite de pontos de acesso, você poderá enfrentar uma resposta de controle de utilização para essas solicitações. Isso é para garantir que o sistema de arquivos não exceda o limite de pontos de acesso declarado.
Essa operação exige permissões para a ação `elasticfilesystem:CreateAccessPoint`.
Os pontos de acesso podem ser marcados na criação. Se tags forem especificadas na ação de criação, o IAM realizará autorização adicional na ação `elasticfilesystem:TagResource` para verificar se os usuários têm permissões para criar tags. Portanto, os usuários também precisam ter permissões para usar a ação `elasticfilesystem:TagResource`. Para obter mais informações, consulte [Conceder permissões para marcar recursos durante a criação](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).
## Sintaxe da Solicitação
```
POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"FileSystemId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [ClientToken](#API_CreateAccessPoint_RequestSyntax) **
Uma sequência de até 64 caracteres ASCII que o Amazon EFS usa para garantir a criação idempotente.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.
Padrão: `.+`
Obrigatório: Sim
** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) **
O ID do sistema de arquivos do EFS ao qual o ponto de acesso se aplica.
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})$`
Obrigatório: Sim
** [PosixUser](#API_CreateAccessPoint_RequestSyntax) **
O usuário e o grupo do sistema operacional se aplicaram a todas as solicitações do sistema de arquivos feitas usando o ponto de acesso.
Tipo: objeto [PosixUser](API_PosixUser.md)
Obrigatório: não
** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) **
Especifica o diretório no sistema de arquivos do EFS que o ponto de acesso expõe como o diretório raiz do seu sistema de arquivos para clientes NFS que usam o ponto de acesso. Os clientes que usam o ponto de acesso só podem acessar o diretório raiz e abaixo dele. Se o `RootDirectory` > `Path` especificado não existir, o Amazon EFS o criará usando as configurações `CreationInfo` quando um cliente se conectar a um ponto de acesso. Ao especificar um `RootDirectory`, você deve fornecer o `Path` e o `CreationInfo`.
O Amazon EFS cria um diretório raiz somente se você tiver fornecido CreationInfo: OwnUid, ownGid e permissões para o diretório. Se você não fornecer essas informações, o Amazon EFS não criará o diretório raiz. Se o diretório raiz não existir, as tentativas de montar usando o ponto de acesso apresentarão falha.
Tipo: objeto [RootDirectory](API_RootDirectory.md)
Obrigatório: não
** [Tags](#API_CreateAccessPoint_RequestSyntax) **
Cria etiquetas associadas ao ponto de acesso. Cada tag é um par de valores-chave, cada chave deve ser única. Para obter mais informações, consulte [AWS Recursos de marcação](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) no *Guia de referência AWS geral*.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obrigatório: não
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) **
O nome do recurso da Amazon (ARN) associado ao ponto de acesso.
Tipo: string
Restrições de tamanho: tamanho máximo de 128.
Padrão: `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$`
** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) **
O ID do ponto de acesso, 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-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) **
A string opaca especificada na solicitação para garantir a criação idempotente.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.
Padrão: `.+`
** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) **
O ID do sistema de arquivos do EFS ao qual o ponto de acesso se aplica.
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})$`
** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) **
Identifica a fase do ciclo de vida do ponto de acesso.
Tipo: string
Valores válidos: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateAccessPoint_ResponseSyntax) **
O nome deste ponto de acesso. Esse é o valor da tag `Name`.
Tipo: string
** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) **
Identifica quem é proprietário do recurso de ponto de acesso. Conta da AWS
Tipo: string
Restrições de tamanho: tamanho máximo de 14.
Padrão: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) **
A identidade POSIX completa, incluindo o ID do usuário, o ID do grupo e o grupo secundário IDs no ponto de acesso que é usado para todas as operações de arquivo pelos clientes NFS que usam o ponto de acesso.
Tipo: objeto [PosixUser](API_PosixUser.md)
** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) **
O diretório no sistema de arquivos do EFS que o ponto de acesso expõe como o diretório raiz para clientes NFS que usam o ponto de acesso.
Tipo: objeto [RootDirectory](API_RootDirectory.md)
** [Tags](#API_CreateAccessPoint_ResponseSyntax) **
As tags associadas ao ponto de acesso, apresentadas como uma matriz de objetos de tag.
Tipo: matriz de objetos [Tag](API_Tag.md)
## Erros
** AccessPointAlreadyExists **
Retornado se o ponto de acesso que você está tentando criar já existir, com o token de criação fornecido na solicitação.
** 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
** AccessPointLimitExceeded **
Retornado se o já Conta da AWS tiver criado o número máximo de pontos de acesso permitidos por sistema de arquivos. Para obter informações, consulte [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region).
** 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: 403
** 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
** 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
** ThrottlingException **
Retornado quando a ação `CreateAccessPoint` da API é chamada muito rapidamente e o número de pontos de acesso no sistema de arquivos está próximo do [limite de 120](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region).
** 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/CreateAccessPoint)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
# CreateFileSystem
Cria um novo sistema de arquivos vazio. A operação requer um token de criação na solicitação que o Amazon EFS usa para garantir a criação idempotente (chamar a operação com o mesmo token de criação não tem efeito). Se não existir atualmente um sistema de arquivos pertencente ao chamador Conta da AWS com o token de criação especificado, essa operação faz o seguinte:
+ Cria um novo sistema de arquivos vazio. O sistema de arquivos terá um ID atribuído pelo Amazon EFS e um estado de ciclo de vida inicial de `creating`.
+ Retorna com a descrição do sistema de arquivos criado.
Caso contrário, essa operação retornará um erro `FileSystemAlreadyExists` com o ID do sistema de arquivos existente.
**nota**
Para casos de uso básicos, você pode usar um UUID gerado aleatoriamente para o token de criação.
A operação idempotente permite que você tente novamente uma chamada à `CreateFileSystem` sem o risco de criar um sistema de arquivos extra. Isso pode acontecer quando há uma falha na chamada inicial de uma forma que deixa dúvida sobre se um sistema de arquivos foi realmente criado. Um exemplo pode ser a ocorrência um tempo limite de nível de transporte ou a redefinição de sua conexão. Desde que você use o mesmo token de criação, se a chamada inicial tiver criado um sistema de arquivos com êxito, o cliente poderá saber de sua existência a partir do erro `FileSystemAlreadyExists`.
Para obter mais informações, consulte [Criar um sistema de arquivos](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1) no *Guia do usuário do Amazon EFS*.
**nota**
A chamada de `CreateFileSystem` retorna enquanto o estado do ciclo de vida do sistema de arquivos ainda for `creating`. Você pode verificar o status da criação do sistema de arquivos chamando a operação [DescribeFileSystems](API_DescribeFileSystems.md) que, entre outras coisas, retorna o estado do sistema de arquivos.
Essa operação também aceita um parâmetro `PerformanceMode` opcional que você escolhe para seu sistema de arquivos. Recomendamos `PerformanceMode` `generalPurpose` para todos os sistemas de arquivos. O `maxIO` modo é um tipo de desempenho da geração anterior, projetado para cargas de trabalho altamente paralelizadas que podem tolerar latências mais altas do que o modo. `generalPurpose` `MaxIO`o modo não é compatível com sistemas de arquivos One Zone ou sistemas de arquivos que usam Elastic throughput.
O `PerformanceMode` não pode ser alterado depois que o sistema de arquivos tiver sido criado. Para obter mais informações, consulte [Modos de performance do Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html).
Você pode definir o modo de throughput do sistema de arquivos usando o parâmetro `ThroughputMode`.
Quando o sistema de arquivos estiver totalmente criado, o Amazon EFS definirá seu estado de ciclo de vida como `available`. Nesse ponto, você pode criar um ou mais destinos de montagem para o sistema de arquivos em sua VPC. Para obter mais informações, consulte [CreateMountTarget](API_CreateMountTarget.md). Você monta seu sistema de arquivos Amazon EFS em uma EC2 instância em sua VPC usando o destino de montagem. Para obter mais informações, consulte [Amazon EFS: como ele funciona](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Essa operação exige permissões para a ação `elasticfilesystem:CreateFileSystem`.
Os sistemas de arquivos podem ser marcados na criação. Se tags forem especificadas na ação de criação, o IAM realizará autorização adicional na ação `elasticfilesystem:TagResource` para verificar se os usuários têm permissões para criar tags. Portanto, os usuários também precisam ter permissões para usar a ação `elasticfilesystem:TagResource`. Para obter mais informações, consulte [Conceder permissões para marcar recursos durante a criação](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).
## Sintaxe da Solicitação
```
POST /2015-02-01/file-systems HTTP/1.1
Content-type: application/json
{
"AvailabilityZoneName": "string",
"Backup": boolean,
"CreationToken": "string",
"Encrypted": boolean,
"KmsKeyId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **
Para sistemas de arquivos One Zone, especifique a zona de disponibilidade da AWS na qual criar o sistema de arquivos. Use o formato `us-east-1a` para especificar a zona de disponibilidade. Para obter mais informações sobre sistemas de arquivos One Zone, consulte [Tipos de sistema de arquivos EFS](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) no *Guia do usuário do Amazon EFS*.
Os sistemas de arquivos de uma zona não estão disponíveis em todas as zonas de disponibilidade nas Regiões da AWS quais o Amazon EFS está disponível.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.
Padrão: `.+`
Obrigatório: não
** [Backup](#API_CreateFileSystem_RequestSyntax) **
Especifica se os backups automáticos estão habilitados no sistema de arquivos que você está criando. Defina o valor `true` para habilitar backups automáticos. Se você estiver criando um sistema de arquivos One Zone, os backups automáticos estão habilitados por padrão. Para obter mais informações, consulte [Backups automáticos](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) no *Guia do usuário do Amazon EFS*.
O padrão é `false`. No entanto, se você especificar um `AvailabilityZoneName`, o padrão será `true`.
AWS Backup não está disponível em todos os Regiões da AWS locais em que o Amazon EFS está disponível.
Tipo: booliano
Obrigatório: não
** [CreationToken](#API_CreateFileSystem_RequestSyntax) **
Uma sequência de até 64 caracteres ASCII. O Amazon EFS usa isso para garantir a criação de idempotência.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.
Padrão: `.+`
Obrigatório: Sim
** [Encrypted](#API_CreateFileSystem_RequestSyntax) **
Um valor booliano que, quando é verdadeiro, cria um sistema de arquivos criptografado. Ao criar um sistema de arquivos criptografado, você tem a opção de especificar uma AWS Key Management Service chave existente (chave KMS). Se você não especificar uma chave do KMS, a chave do KMS padrão para o Amazon EFS, `/aws/elasticfilesystem`, será usada para proteger o sistema de arquivos criptografado.
Tipo: booliano
Obrigatório: não
** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) **
O ID da chave do KMS a ser usada para proteger o sistema de arquivos criptografado. Esse parâmetro é necessário somente se você quiser usar uma chave do KMS não padrão. Se esse parâmetro não for especificado, a chave do KMS padrão para o Amazon EFS será usada. Você pode especificar esse ID da chave KMS usando os formatos a seguir:
+ ID da chave – um identificador exclusivo da chave, por exemplo, `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ ARN – um nome de recurso da Amazon (ARN) para a chave, por exemplo, `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ Alias da chave: um nome de exibição criado anteriormente para uma chave, por exemplo, `alias/projectKey1`.
+ ARN do alias da chave – um ARN para um alias da chave, por exemplo, `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
Se você usar`KmsKeyId`, deverá definir o [CreateFileSystemparâmetro:encrypted como true](#efs-CreateFileSystem-request-Encrypted).
O EFS apenas aceita chaves do KMS simétricas. Você não pode usar chaves KMS assimétricas com sistemas de arquivos Amazon EFS.
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/_-]+))))$`
Obrigatório: não
** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) **
O modo de desempenho do sistema de arquivos. Recomendamos o modo de desempenho `generalPurpose` para todos os sistemas de arquivos. Os sistemas de arquivos que estão usando o modo de desempenho `maxIO` podem ser dimensionados para níveis mais altos de throughput e operações agregadas por segundo, fornecendo, em troca, latências um pouco mais altas para a maioria das operações de arquivo. O modo de desempenho não pode ser alterado depois que o sistema de arquivos tiver sido criado. O modo `maxIO` não é compatível em sistemas de arquivos One Zone.
Devido às maiores latências por operação com Max I/O, recomendamos usar o modo de desempenho de uso geral para todos os sistemas de arquivos.
O padrão é `generalPurpose`.
Tipo: string
Valores válidos: `generalPurpose | maxIO`
Obrigatório: não
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) **
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
** [Tags](#API_CreateFileSystem_RequestSyntax) **
Use para criar uma ou mais tags associadas ao sistema de arquivos. Cada tag é um par de chave-valor definido pelo usuário. Nomeie seu sistema de arquivos na criação, incluindo um par de chave-valor `"Key":"Name","Value":"{value}"`. Cada chave deve ser exclusiva. Para obter mais informações, consulte [AWS Recursos de marcação](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) no *Guia de referência AWS geral*.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obrigatório: não
** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) **
Especifica o modo de throughput do sistema de arquivos. O modo pode ser `bursting`, `provisioned` ou `elastic`. Ao definir `ThroughputMode` como `provisioned`, você também deve definir um valor para `ProvisionedThroughputInMibps`. Depois de criar o sistema de arquivos, você pode diminuir o throughput Provisioned do sistema de arquivos ou alterar entre os modos de throughput, com certas restrições de tempo. Para obter mais informações, consulte [Especificando o throughput com o modo provisionado](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput) no *Guia do usuário do Amazon EFS*.
O padrão é `bursting`.
Tipo: string
Valores válidos: `bursting | provisioned | elastic`
Obrigatório: não
## Sintaxe da resposta
```
HTTP/1.1 201
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 201.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [AvailabilityZoneId](#API_CreateFileSystem_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_CreateFileSystem_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_CreateFileSystem_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_CreateFileSystem_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_CreateFileSystem_ResponseSyntax) **
Um valor booliano que, quando verdadeiro, indica que o sistema de arquivos é criptografado.
Tipo: booliano
** [FileSystemArn](#API_CreateFileSystem_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_CreateFileSystem_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_CreateFileSystem_ResponseSyntax) **
Descreve a proteção no sistema de arquivos.
Tipo: objeto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_CreateFileSystem_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_CreateFileSystem_ResponseSyntax) **
A fase do ciclo de vida do sistema de arquivos.
Tipo: string
Valores válidos: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateFileSystem_ResponseSyntax) **
Você pode adicionar tags a um sistema de arquivos, incluindo uma tag `Name`. Para obter mais informações, consulte [CreateFileSystem](#API_CreateFileSystem). 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_CreateFileSystem_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_CreateFileSystem_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_CreateFileSystem_ResponseSyntax) **
O modo de desempenho do sistema de arquivos.
Tipo: string
Valores válidos: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_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_CreateFileSystem_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_CreateFileSystem_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_CreateFileSystem_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
** FileSystemAlreadyExists **
Retornado se o sistema de arquivos que você está tentando criar já existir, com o token de criação fornecido.
** 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
** FileSystemLimitExceeded **
Retornado se o já Conta da AWS tiver criado o número máximo de sistemas de arquivos permitidos por conta.
** 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: 403
** 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
** UnsupportedAvailabilityZone **
Retornado se a funcionalidade solicitada do Amazon EFS não estiver disponível na zona de disponibilidade especificada.
** 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
## Exemplos
### Criar um sistema de arquivos EFS criptografado
O exemplo a seguir envia uma solicitação POST para criar um sistema de arquivos na região `us-west-2` com backups automáticos ativados. A solicitação especifica `myFileSystem1` como o token de criação para idempotência.
#### Exemplo de solicitação
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem1",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"Encrypted": true,
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Resposta da amostra
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
### Criar um sistema de arquivos EFS criptografado com disponibilidade One Zone
O exemplo a seguir envia uma solicitação POST para criar um sistema de arquivos na região `us-west-2` com backups automáticos ativados. O sistema de arquivos terá armazenamento One Zone na zona de disponibilidade `us-west-2b`.
#### Exemplo de solicitação
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem2",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"AvailabilityZoneName": "us-west-2b",
"Encrypted": true,
"ThroughputMode": "elastic",
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Resposta da amostra
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"AvailabilityZoneId": "usew2-az2",
"AvailabilityZoneName": "us-west-2b",
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
## 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/CreateFileSystem)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem)
# CreateMountTarget
Cria destino de montagem para um sistema de arquivos. Em seguida, você pode montar o sistema de arquivos nas EC2 instâncias usando o destino de montagem. Para acessar mais informações sobre destinos de montagem, consulte [Gerenciar destinos de montagem](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html).
Para criar um destino de montagem para um sistema de arquivos do EFS, o estado do ciclo de vida do sistema de arquivos deve ser `available`. Para obter mais informações, consulte [DescribeFileSystems](API_DescribeFileSystems.md).
Depois de criar o destino de montagem, o Amazon EFS exibe uma resposta que inclui um `MountTargetId` e um endereço IP (`IpAddress` ou `Ipv6Address`). Você usa esse endereço IP ao montar o sistema de arquivos em uma EC2 instância. Você também pode usar o nome DNS do destino de montagem ao montar o sistema de arquivos. A EC2 instância na qual você monta o sistema de arquivos usando o destino de montagem pode resolver o nome DNS do destino de montagem em seu endereço IP. Para acessar mais informações, consulte [Como o Amazon EFS funciona](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Observe que você pode criar destinos de montagem para um sistema de arquivos em apenas uma VPC, e pode haver apenas um destino de montagem por zona de disponibilidade. Para acessar mais informações, consulte [Criar destinos de montagem](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html).
Se a solicitação atender aos requisitos, o Amazon EFS fará o seguinte:
+ Criará um novo destino de montagem na sub-rede especificada.
+ Cria uma interface de rede na sub-rede com o seguinte:
+ A descrição `Mount target fsmt-id for file system fs-id ` em que ` fsmt-id ` é o ID do destino de montagem, e ` fs-id ` é o `FileSystemId`.
+ A propriedade `requesterManaged` da interface de rede definida como `true`, e o valor de `requesterId` definido como `EFS`.
Cada destino de montagem tem uma interface de rede correspondente gerenciada pelo solicitante EC2 . Depois que a interface de rede é criada, o Amazon EFS define o campo `NetworkInterfaceId` na descrição do destino de montagem como o ID da interface de rede e o endereço IP como seu endereço. Se a criação da interface de rede falhar, toda a operação `CreateMountTarget` falhará.
**nota**
A chamada `CreateMountTarget` retorna somente depois da criação da interface de rede, mas enquanto o estado do destino de montagem ainda for `creating`, você poderá verificar o status da criação do destino de montagem chamando a operação [DescribeMountTargets](API_DescribeMountTargets.md), o que, entre outras coisas, retorna o estado do destino de montagem.
Essa operação exige permissões para a seguinte ação no sistema de arquivos:
+ `elasticfilesystem:CreateMountTarget`
Essa operação também requer permissões para as seguintes EC2 ações da Amazon:
+ `ec2:DescribeSubnets`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:CreateNetworkInterface`
## Sintaxe da Solicitação
```
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string",
"IpAddress": "string",
"IpAddressType": "string",
"Ipv6Address": "string",
"SecurityGroups": [ "string" ],
"SubnetId": "string"
}
```
## Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **
O ID do sistema de arquivos para o qual você cria o destino de montagem.
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})$`
Obrigatório: Sim
** [IpAddress](#API_CreateMountTarget_RequestSyntax) **
Se o `IpAddressType` para o destino de montagem for IPv4 (`IPV4_ONLY`ou`DUAL_STACK`), especifique o IPv4 endereço a ser usado. Se você não especificar um `IpAddress`, o Amazon EFS selecionará um endereço IP não utilizado da sub-rede especificada para `SubnetId`.
Tipo: string
Restrições de comprimento: comprimento mínimo de 7. Comprimento máximo de 15.
Padrão: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
Obrigatório: não
** [IpAddressType](#API_CreateMountTarget_RequestSyntax) **
O tipo de endereço IP do destino de montagem. Os valores possíveis são `IPV4_ONLY` (somente IPv4 endereços), `IPV6_ONLY` (somente IPv6 endereços) e `DUAL_STACK` (pilha dupla, ambos IPv4 e IPv6 endereços). Se você não especificar um `IpAddressType`, `IPV4_ONLY` será usado.
O `IPAddressType` deve corresponder ao tipo de IP da sub-rede. Além disso, o parâmetro `IPAddressType` substitui o valor definido como o endereço IP padrão para a sub-rede na VPC. Por exemplo, se `IPAddressType` for `IPV4_ONLY` e `AssignIpv6AddressOnCreation` IPv4 for`true`, será usado para o alvo de montagem. Para obter mais informações, consulte [Modificar os atributos de endereçamento IP da sua sub-rede](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html).
Tipo: string
Valores válidos: `IPV4_ONLY | IPV6_ONLY | DUAL_STACK`
Obrigatório: não
** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) **
Se o `IPAddressType` para o destino de montagem for IPv6 (`IPV6_ONLY`ou`DUAL_STACK`), especifique o IPv6 endereço a ser usado. Se você não especificar um `Ipv6Address`, o Amazon EFS selecionará um endereço IP não utilizado da sub-rede especificada para `SubnetId`.
Tipo: string
Restrições de tamanho: tamanho mínimo 3. Comprimento máximo de 39.
Obrigatório: não
** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) **
Grupo de segurança VPC IDs, do formulário. `sg-xxxxxxxx` Esses devem ser da mesma VPC que a sub-rede especificada. O número máximo de grupos de segurança depende da cota da conta. Para acessar mais informações, consulte [Cotas da Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) no *Guia do usuário da Amazon VPC* (consulte a tabela **Grupos de segurança**). Se você não especificar um grupo de segurança, o Amazon EFS usará o grupo de segurança padrão para a VPC da sub-rede.
Tipo: matriz de strings
Membros da matriz: número máximo de 100 itens.
Restrições de tamanho: tamanho mínimo de 11. Tamanho máximo de 43.
Padrão: `^sg-[0-9a-f]{8,40}`
Obrigatório: não
** [SubnetId](#API_CreateMountTarget_RequestSyntax) **
O ID da sub-rede na qual adicionar o destino de montagem. Para sistemas de arquivos One Zone, use a sub-rede associada à zona de disponibilidade do sistema de arquivos. O tipo de sub-rede deve ser equivalente a `IpAddressType`.
Tipo: string
Restrições de tamanho: tamanho mínimo de 15. Tamanho máximo de 47.
Padrão: `^subnet-[0-9a-f]{8,40}$`
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) **
O identificador exclusivo e consistente da zona de disponibilidade em que o alvo de montagem reside. Por exemplo, `use1-az1` é uma ID AZ para a região us-east-1 e tem a mesma localização em todas. Conta da AWS
Tipo: string
** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) **
O nome da zona de disponibilidade na qual o destino de montagem está localizado. As zonas de disponibilidade são mapeadas de forma independente com os nomes de cada uma Conta da AWS. Por exemplo, a zona de disponibilidade da `us-east-1a` sua Conta da AWS pode não ser a mesma localização `us-east-1a` de outra Conta da AWS.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.
Padrão: `.+`
** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) **
O ID do sistema de arquivos para o qual você cria o destino de montagem.
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})$`
** [IpAddress](#API_CreateMountTarget_ResponseSyntax) **
O IPv4 endereço do alvo de montagem.
Tipo: string
Restrições de comprimento: comprimento mínimo de 7. Comprimento máximo de 15.
Padrão: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) **
O IPv6 endereço do alvo de montagem.
Tipo: string
Restrições de tamanho: tamanho mínimo 3. Comprimento máximo de 39.
** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) **
Estado do ciclo de vida do destino de montagem.
Tipo: string
Valores válidos: `creating | available | updating | deleting | deleted | error`
** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) **
ID do destino de montagem atribuída pelo sistema.
Tipo: string
Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45.
Padrão: `^fsmt-[0-9a-f]{8,40}$`
** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) **
O ID da interface de rede que o Amazon EFS gerou ao criar o destino de montagem.
Tipo: string
** [OwnerId](#API_CreateMountTarget_ResponseSyntax) **
Conta da AWS ID que possui o recurso.
Tipo: string
Restrições de tamanho: tamanho máximo de 14.
Padrão: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SubnetId](#API_CreateMountTarget_ResponseSyntax) **
O ID da sub-rede do destino de montagem.
Tipo: string
Restrições de tamanho: tamanho mínimo de 15. Tamanho máximo de 47.
Padrão: `^subnet-[0-9a-f]{8,40}$`
** [VpcId](#API_CreateMountTarget_ResponseSyntax) **
O ID da nuvem privada virtual (VPC) em que o destino de montagem está configurado.
Tipo: string
## Erros
** AvailabilityZonesMismatch **
Exibido se a zona de disponibilidade especificada para o destino de montagem for diferente da zona de disponibilidade do sistema. Para obter mais informações, consulte [Redundância de armazenamento regional e de One Zone](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs).
** 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
** 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
** 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
** IpAddressInUse **
Exibido se a solicitação especificou um endereço IP (`IpAddress` ou `Ipv6Address`) já está em uso na sub-rede.
** 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
** MountTargetConflict **
Retornado se o destino de montagem violar uma das restrições especificadas com base nos destinos de montagem existentes no sistema de arquivos.
** 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
** NetworkInterfaceLimitExceeded **
A conta de chamada atingiu o limite de interfaces de rede elástica para a Região da AWS específica. Exclua algumas interfaces de rede ou solicite que a cota da conta seja aumentada. Para acessar mais informações, consulte [Cotas da Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) no *Guia do usuário da Amazon VPC* (consulte a entrada **Interfaces de rede por região** na tabela **Interfaces de rede**).
** 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
** NoFreeAddressesInSubnet **
Exibido se `IpAddress` ou `Ipv6Address` não for fornecido na solicitação e não houver endereços IP gratuitos na sub-rede especificada.
** 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
** SecurityGroupLimitExceeded **
Exibido se o número de `SecurityGroups` especificado na solicitação for maior que o limite, que se baseia na cota da conta. Exclua alguns grupos de segurança ou solicite que a cota da conta seja aumentada. Para acessar mais informações, consulte [Cotas da Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) no *Guia do usuário da Amazon VPC* (consulte a tabela **Grupos de segurança**).
** 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
** SecurityGroupNotFound **
Retornado se um dos grupos de segurança especificados não existir na nuvem privada virtual (VPC) da sub-rede.
** 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
** SubnetNotFound **
Retornado se não houver sub-rede com o ID de `SubnetId` fornecido na solicitação.
** 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
** UnsupportedAvailabilityZone **
Retornado se a funcionalidade solicitada do Amazon EFS não estiver disponível na zona de disponibilidade especificada.
** 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
## Exemplos
### Crie um destino de montagem em um IPv4 endereço disponível em uma sub-rede
A solicitação a seguir especifica o sistema de arquivos e a sub-rede do destino de montagem. O destino é criado em um IPv4 endereço disponível na sub-rede especificada, com o grupo de segurança padrão associado à VPC.
#### Exemplo de solicitação
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crie um alvo de montagem em um IPv4 endereço específico
A solicitação a seguir especifica o sistema de arquivos, a sub-rede, o grupo de segurança e o IPv4 endereço a serem usados para o destino de montagem.
#### Exemplo de solicitação
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddress":"10.0.2.42",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crie um alvo de montagem em um IPv6 endereço específico
A solicitação a seguir especifica o sistema de arquivos, a sub-rede, o grupo de segurança e o IPv6 endereço a serem usados para o destino de montagem.
#### Exemplo de solicitação
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"IpAddressType": "IPV6_ONLY",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crie um destino de montagem em um IPv4 endereço disponível na sub-rede de pilha dupla
A solicitação a seguir especifica o sistema de arquivos, a sub-rede e o tipo de endereço do destino de montagem. O destino é criado em um IPv4 endereço disponível na sub-rede de pilha dupla especificada, com o grupo de segurança padrão associado à VPC.
#### Exemplo de solicitação
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "251839141158",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crie um destino de montagem em IPv4 e IPv6 endereços específicos na sub-rede de pilha dupla
A solicitação a seguir especifica o sistema de arquivos, a sub-rede, o grupo de segurança, o IPv4 endereço e o IPv6 endereço do destino de montagem. O destino é criado nos IPv6 endereços especificados IPv4 e em uma sub-rede de pilha dupla.
#### Exemplo de solicitação
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddressType": "DUAL_STACK",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
## 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/CreateMountTarget)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget)
# CreateReplicationConfiguration
Cria uma configuração de replicação para um sistema de arquivos EFS novo ou existente. Para obter mais informações, consulte [Replicação do Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) no *Guia do usuário do Amazon EFS*. A configuração de replicação básica especifica o seguinte:
+ **Sistema de arquivos de origem**: um sistema de arquivos do EFS que você deseja replicar.
+ **Sistema de arquivos de destino**: o sistema de arquivos de destino para o qual o sistema de arquivos de origem é replicado. Só pode haver um sistema de arquivos de destino em uma configuração de replicação.
**nota**
Um sistema de arquivos só pode fazer parte de uma configuração de replicação.
Os parâmetros de destino para a configuração de replicação dependem se você está realizando a replicação para um sistema de arquivos novo ou existente e se a operação está sendo realizada entre Contas da AWS. Consulte [DestinationToCreate](API_DestinationToCreate.md) para obter mais informações.
Essa operação exige permissões para a ação `elasticfilesystem:CreateReplicationConfiguration`. Além disso, outras permissões são necessárias, dependendo de como você está replicando os sistemas de arquivos. Para acessar mais informações, consulte [Permissões necessárias para replicação](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions) no *Guia do usuário do Amazon EFS*.
## Sintaxe da Solicitação
```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string",
"RoleArn": "string"
}
]
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **
Especifica o sistema de arquivos do Amazon EFS que você deseja replicar. Esse sistema de arquivos não pode ser um sistema de arquivos de origem ou destino em outra configuração de replicação.
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.
** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **
Uma matriz de objetos de configuração de destino. Somente um objeto de configuração de destino é compatível.
Tipo: matriz de objetos [DestinationToCreate](API_DestinationToCreate.md)
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) **
Descreve quando a configuração de replicação foi criada.
Tipo: Timestamp
** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **
Uma matriz de objetos de destino. Somente um objeto de destino é compatível.
Tipo: matriz de objetos [Destination](API_Destination.md)
** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
O nome do recurso da Amazon (ARN) do sistema de arquivos do EFS de origem original na configuração de replicação.
Tipo: string
** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
O nome do recurso da Amazon (ARN) do sistema de arquivos de origem atual na configuração de replicação.
Tipo: string
** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **
O ID do sistema de arquivos do Amazon EFS de origem que está sendo replicado.
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})$`
** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **
ID do Conta da AWS em que o sistema de arquivos de origem reside.
Tipo: string
Restrições de tamanho: tamanho máximo de 14.
Padrão: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **
O Região da AWS em que o sistema de arquivos EFS de origem está localizado.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.
Padrão: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`
## 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
** ConflictException **
Retornado se o sistema de arquivos de origem em uma replicação estiver criptografado, mas o sistema de arquivos de destino não estiver criptografado.
** 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
** FileSystemLimitExceeded **
Retornado se o já Conta da AWS tiver criado o número máximo de sistemas de arquivos permitidos por conta.
** 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: 403
** 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
** ReplicationNotFound **
Retornado se o sistema de arquivos especificado não tiver uma configuração de replicação.
** ErrorCode **
ReplicationNotFound
** 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
** 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
** UnsupportedAvailabilityZone **
Retornado se a funcionalidade solicitada do Amazon EFS não estiver disponível na zona de disponibilidade especificada.
** 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
** ValidationException **
Retornado se o AWS Backup serviço não estiver disponível no Região da AWS local em que a solicitação foi feita.
** 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
## 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/CreateReplicationConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
# CreateTags
**nota**
OBSOLETO: `CreateTags` está obsoleto e não será mantido. Para criar tags para recursos do EFS, use a ação [TagResource](API_TagResource.md) da API.
Cria ou substitui as tags associadas a um sistema de arquivos. Cada tag é um par de chave/valor. Se uma chave de tag especificada na solicitação já existir no sistema de arquivos, essa operação substituirá seu valor pelo valor fornecido na solicitação. Se você adicionar a tag `Name` ao seu sistema de arquivos, o Amazon EFS a retornará na resposta à operação [DescribeFileSystems](API_DescribeFileSystems.md).
Essa operação exige permissão para a ação `elasticfilesystem:CreateTags`.
## Sintaxe da Solicitação
```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_CreateTags_RequestSyntax) **
O ID do sistema de arquivos cujas tags você deseja modificar (String). Essa operação modifica somente as tags, não o sistema de arquivos.
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.
** [Tags](#API_CreateTags_RequestSyntax) **
Uma matriz de objetos de `Tag` para adicionar. Cada objeto de `Tag` é um par de chave-valor.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 204
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## 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
** 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
## 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/CreateTags)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags)
# DeleteAccessPoint
Exclui o ponto de acesso especificado. Depois que a exclusão for concluída, novos clientes não poderão mais se conectar aos pontos de acesso. Os clientes conectados ao ponto de acesso no momento da exclusão continuarão funcionando até encerrar a conexão.
Essa operação exige permissões para a ação `elasticfilesystem:DeleteAccessPoint`.
## Sintaxe da Solicitação
```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **
O ID do ponto de acesso que você deseja excluir.
Restrições de Tamanho: Tamanho máximo de 128.
Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
Obrigatório: Sim
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 204
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## Erros
** AccessPointNotFound **
Retornado se o `AccessPointId` 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
** 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
** 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
## 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/DeleteAccessPoint)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
# DeleteFileSystem
Exclui um sistema de arquivos rompendo permanentemente o acesso a seu conteúdo. Ao retornar, o sistema de arquivos não existe mais e você não pode acessar nenhum conteúdo do sistema de arquivos excluído.
Você precisa excluir manualmente os destinos de montagem anexados a um sistema de arquivos antes de excluir um sistema de arquivos EFS. Essa etapa é executada quando você usa o AWS console para excluir um sistema de arquivos.
**nota**
Você não pode excluir um sistema de arquivos que faz parte de uma configuração de replicação do EFS. É necessário excluir a configuração de replicação primeiro.
Não é possível excluir um sistema de arquivos que esteja em uso. Ou seja, se o sistema de arquivos tiver algum destino de montagem, você deverá primeiro excluí-lo. Para obter mais informações, consulte [DescribeMountTargets](API_DescribeMountTargets.md) e [DeleteMountTarget](API_DeleteMountTarget.md).
**nota**
A chamada `DeleteFileSystem` retorna enquanto o estado do ciclo de vida do sistema de arquivos ainda for `deleting`. Você pode verificar o status de exclusão do sistema de arquivos chamando a operação [DescribeFileSystems](API_DescribeFileSystems.md), que retorna uma lista dos sistemas de arquivos em sua conta. Se você passar o ID do sistema de arquivos ou o token de criação para o sistema de arquivos excluído, o [DescribeFileSystems](API_DescribeFileSystems.md) retornará um erro `404 FileSystemNotFound`.
Essa operação exige permissões para a ação `elasticfilesystem:DeleteFileSystem`.
## Sintaxe da Solicitação
```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **
O ID do sistema de arquivos que você deseja excluir.
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
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 204
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## 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
** FileSystemInUse **
Retornado se um sistema de arquivos tiver destinos de montagem.
** 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
** 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
** 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
## Exemplos
### Excluir um sistema de arquivos
O exemplo a seguir envia uma solicitação DELETE ao endpoint `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`) para excluir um sistema de arquivos cujo ID é `fs-01234567`.
#### Exemplo de solicitação
```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```
#### Resposta da amostra
```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```
## 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/DeleteFileSystem)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
# DeleteFileSystemPolicy
Exclui a `FileSystemPolicy` para o sistema de arquivos especificado. O padrão `FileSystemPolicy` entra em vigor quando a política existente é excluída. Para obter mais informações sobre a política padrão do sistema de arquivos, consulte [Usar políticas baseadas em recursos com o EFS](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html).
Essa operação exige permissões para a ação `elasticfilesystem:DeleteFileSystemPolicy`.
## Sintaxe da Solicitação
```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **
Especifica o sistema de arquivos EFS do qual excluir a `FileSystemPolicy`.
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
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
```
## Elementos de Resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.
## 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
** 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
## 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/DeleteFileSystemPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
# DeleteMountTarget
Exclui o destino de montagem especificado.
Essa operação quebra à força quaisquer montagens do sistema de arquivos usando o ponto de acesso NFS que está sendo excluído, o que pode interromper instâncias ou aplicativos que usam essas montagens. Para evitar que os aplicativos sejam interrompidos abruptamente, considere desmontar qualquer suporte do destino de montagem, se possível. A operação também exclui a interface de rede associada. As gravações não confirmadas podem ser perdidas, mas quebrar um destino de montagem usando essa operação não corrompe o sistema de arquivos em si. O sistema de arquivos que você criou permanece. Você pode montar uma EC2 instância na sua VPC usando outro destino de montagem.
Essa operação exige permissões para a seguinte ação no sistema de arquivos:
+ `elasticfilesystem:DeleteMountTarget`
**nota**
A chamada `DeleteMountTarget` retorna enquanto o estado de destino da montagem ainda for `deleting`. Você pode verificar a exclusão do destino de montagem chamando a operação [DescribeMountTargets](API_DescribeMountTargets.md), que retorna uma lista das descrições do destino de montagem para o sistema de arquivos especificado.
A operação também requer permissões para a seguinte EC2 ação da Amazon na interface de rede do alvo de montagem:
+ `ec2:DeleteNetworkInterface`
## Sintaxe da Solicitação
```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **
O ID do destino de montagem a ser excluído (String).
Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45.
Padrão: `^fsmt-[0-9a-f]{8,40}$`
Obrigatório: Sim
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 204
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## 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
** DependencyTimeout **
O serviço atingiu o tempo limite ao tentar atender à solicitação, e o cliente deve tentar a chamada novamente.
** 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: 504
** 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
** MountTargetNotFound **
Retornado se não houver um destino de montagem com o ID especificado encontrado na Conta da AWS do chamador.
** 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
## Exemplos
### Remover o destino de montagem de um sistema de arquivos
O exemplo a seguir envia uma solicitação DELETE para excluir um destino de montagem específico.
#### Exemplo de solicitação
```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```
#### Resposta da amostra
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/DeleteMountTarget)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
# DeleteReplicationConfiguration
Exclui uma configuração de replicação. A exclusão de uma configuração de replicação encerra o processo de replicação. Depois que uma configuração de replicação é excluída, o sistema de arquivos de destino se torna `Writeable` e sua proteção contra substituição de replicação é reativada. Para obter mais informações, consulte [Excluir configuração de replicação](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html).
Essa operação exige permissões para a ação `elasticfilesystem:DeleteReplicationConfiguration`.
## Sintaxe da Solicitação
```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **
Ao replicar entre Contas da AWS ou entre si Regiões da AWS, o Amazon EFS exclui a configuração de replicação da conta de origem e de destino ou da Região (`ALL_CONFIGURATIONS`) por padrão. Se houver um problema de configuração ou permissão que impeça o Amazon EFS de excluir a configuração de replicação de ambos os lados, você poderá usar o modo `LOCAL_CONFIGURATION_ONLY` para excluir a configuração de replicação somente do lado local (a conta ou região da qual a exclusão é realizada).
Use o modo `LOCAL_CONFIGURATION_ONLY` somente no caso de o Amazon EFS não conseguir excluir a configuração de replicação na conta ou na região de origem e de destino. A exclusão da configuração local deixa a configuração na outra conta ou região irrecuperável.
Além disso, não use esse modo para replicação na mesma conta e na mesma região, pois isso resultará em um erro de exceção. BadRequest
Valores válidos: `ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY`
** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) **
O ID do sistema de arquivos de origem na configuração de replicação.
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
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 204
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## 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
** 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
** ReplicationNotFound **
Retornado se o sistema de arquivos especificado não tiver uma configuração de replicação.
** ErrorCode **
ReplicationNotFound
** 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
## 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/DeleteReplicationConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
# DeleteTags
**nota**
OBSOLETO: `DeleteTags` está obsoleto e não será mantido. Para remover tags de um recurso do EFS, use a ação [UntagResource](API_UntagResource.md) da API.
Exclui as tags especificadas de um sistema de arquivos. Se a solicitação `DeleteTags` incluir uma chave de tag que não existe, o Amazon EFS a ignora e não causa nenhum erro. Para obter mais informações sobre tags e restrições relacionadas, consulte [Restrições de tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia Gerenciamento de Faturamento e Custos da AWS do usuário*.
Essa operação exige permissões para a ação `elasticfilesystem:DeleteTags`.
## Sintaxe da Solicitação
```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"TagKeys": [ "string" ]
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DeleteTags_RequestSyntax) **
O ID do sistema de arquivos cujas tags você deseja excluir (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})$`
Obrigatório: Sim
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [TagKeys](#API_DeleteTags_RequestSyntax) **
Uma lista de chaves de tag a serem excluídas.
Tipo: matriz de strings
Membros da matriz: número mínimo de 1 item. Número máximo de 50 itens.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 204
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## 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
** 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
## 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/DeleteTags)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags)
# DescribeAccessPoints
Retorna a descrição de um ponto de acesso específico do Amazon EFS, se o `AccessPointId` for fornecido. Se você fornecer um `FileSystemId` do EFS, ele retornará descrições de todos os pontos de acesso desse sistema de arquivos. Você pode fornecer um `AccessPointId` ou um `FileSystemId` na solicitação, mas não ambos.
Essa operação exige permissões para a ação `elasticfilesystem:DescribeAccessPoints`.
## Sintaxe da Solicitação
```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **
(Opcional) Especifica um ponto de acesso EFS a ser descrito na resposta. É mutuamente exclusivo com `FileSystemId`.
Restrições de Tamanho: Tamanho máximo de 128.
Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [FileSystemId](#API_DescribeAccessPoints_RequestSyntax) **
(Opcional) Se você fornecer um`FileSystemId`, o EFS retornará todos os pontos de acesso desse sistema de arquivos. É mutuamente exclusivos com `AccessPointId`.
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})$`
** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) **
(Opcional) Ao recuperar todos os pontos de acesso de um sistema de arquivos, você pode especificar opcionalmente o parâmetro `MaxItems` para limitar o número de objetos retornados em uma resposta. O valor padrão é 100.
Faixa válida: valor mínimo de 1.
** [NextToken](#API_DescribeAccessPoints_RequestSyntax) **
O `NextToken` estará presente se a resposta for paginada. Você pode usar o `NextMarker` na solicitação subsequente para buscar a próxima página de descrições de ponto de acesso.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPoints": [
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
],
"NextToken": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) **
Uma matriz de descrições de pontos de acesso.
Tipo: matriz de objetos [AccessPointDescription](API_AccessPointDescription.md)
** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **
Presente se houver mais pontos de acesso do que os retornados na resposta. Você pode usar o NextMarker na solicitação subsequente para buscar as descrições adicionais.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
## Erros
** AccessPointNotFound **
Retornado se o `AccessPointId` 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
** 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
** 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
## 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/DescribeAccessPoints)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
# DescribeAccountPreferences
Retorna as configurações de preferências da conta para o Conta da AWS associado ao usuário que fez a solicitação, na atual Região da AWS.
## Sintaxe da Solicitação
```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **
(Opcional) Ao recuperar as preferências da conta, você pode especificar opcionalmente o parâmetro `MaxItems` para limitar o número de objetos retornados em uma resposta. O valor padrão é 100.
Tipo: inteiro
Intervalo válido: valor mínimo de 1.
Obrigatório: não
** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) **
(Opcional) Você pode usar o `NextToken` em uma solicitação subsequente para buscar a próxima página de preferências da Conta da AWS se a carga útil da resposta tiver sido paginada.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
Obrigatório: Não
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [NextToken](#API_DescribeAccountPreferences_ResponseSyntax) **
Presente se houver mais registros do que os retornados na resposta. Você pode usar o `NextToken` na solicitação subsequente para buscar as descrições adicionais.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) **
Descreve a configuração de preferência de ID do recurso para o Conta da AWS associado ao usuário que fez a solicitação, na atual Região da AWS.
Tipo: objeto [ResourceIdPreference](API_ResourceIdPreference.md)
## Erros
** 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
## 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/DescribeAccountPreferences)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
# DescribeBackupPolicy
Retorna a política de backup para o sistema de arquivos EFS especificado.
## Sintaxe da Solicitação
```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **
Especifica para qual sistema de arquivos EFS recuperar a `BackupPolicy`.
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
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) **
Descreve a política de backup do sistema de arquivos, indicando se os backups automáticos estão ativados ou desativados.
Tipo: objeto [BackupPolicy](API_BackupPolicy.md)
## 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
** 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
** PolicyNotFound **
Exibido se não for possível localizar ou acessar a política do IAM ou a política de recursos especificada. Dependendo da ação que está sendo executada, o erro também poderá ser exibido se a política padrão do sistema de arquivos EFS estiver implementada para o sistema de arquivos EFS ou se nenhuma política de backup for especificada.
** 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
** ValidationException **
Retornado se o AWS Backup serviço não estiver disponível no Região da AWS local em que a solicitação foi feita.
** 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
## 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/DescribeBackupPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
# DescribeFileSystemPolicy
Retorna a `FileSystemPolicy` para o sistema de arquivos EFS especificado.
Essa operação exige permissões para a ação `elasticfilesystem:DescribeFileSystemPolicy`.
## Sintaxe da Solicitação
```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **
Especifica para qual sistema de arquivos EFS recuperar a `FileSystemPolicy`.
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
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [FileSystemId](#API_DescribeFileSystemPolicy_ResponseSyntax) **
Especifica o sistema de arquivos EFS ao qual a `FileSystemPolicy` se aplica.
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})$`
** [Policy](#API_DescribeFileSystemPolicy_ResponseSyntax) **
A `FileSystemPolicy` em formato JSON para o sistema de arquivos EFS.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 20.000.
Padrão: `[\s\S]+`
## 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
** 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
** PolicyNotFound **
Exibido se não for possível localizar ou acessar a política do IAM ou a política de recursos especificada. Dependendo da ação que está sendo executada, o erro também poderá ser exibido se a política padrão do sistema de arquivos EFS estiver implementada para o sistema de arquivos EFS ou se nenhuma política de backup for especificada.
** 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
## Exemplos
### Exemplo
Este exemplo ilustra um uso do. DescribeFileSystemPolicy
#### Exemplo de solicitação
```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```
#### Resposta da amostra
```
{
"FileSystemId": "fs-01234567",
"Policy": "{
"Version": "2012-10-17",
"Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect" : "Deny",
"Principal": {
"AWS": "*"
},
"Action": "*",
"Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
"Condition": {
"Bool": {
"aws:SecureTransport": "false"
}
}
},
{
"Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567"
}
]
}
}
```
## 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/DescribeFileSystemPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
# DescribeFileSystems
Retorna a descrição de um sistema de arquivos específico do Amazon EFS se o sistema de arquivos `CreationToken` ou o `FileSystemId` for fornecido. Caso contrário, ele retornará descrições de todos os sistemas de arquivos pertencentes ao chamador Conta da AWS no Região da AWS endpoint que você está chamando.
Ao recuperar todas as descrições do sistema de arquivos, você pode especificar opcionalmente o parâmetro `MaxItems` para limitar o número de descrições em uma resposta. Esse número é automaticamente definido como 100. Se mais descrições do sistema de arquivos permanecerem, o Amazon EFS retornará um `NextMarker`, um token opaco, na resposta. Nesse caso, você deve enviar uma solicitação subsequente com o parâmetro de solicitação `Marker` definido como o valor de `NextMarker`.
Para recuperar uma lista das descrições do sistema de arquivos, essa operação é usada em um processo iterativo, em que `DescribeFileSystems` é chamada primeiro sem o `Marker` e, em seguida, a operação continua a chamá-la com o parâmetro `Marker` definido como o valor de `NextMarker` da resposta anterior até que a resposta não tenha `NextMarker`.
A ordem dos sistemas de arquivos retornados na resposta de uma chamada `DescribeFileSystems` e a ordem retornada nas respostas de uma iteração de várias chamadas não é especificada.
Essa operação exige permissões para a ação `elasticfilesystem:DescribeFileSystems`.
## Sintaxe da Solicitação
```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) Restringe a lista ao sistema de arquivos com esse token de criação (String). Você especifica um token de criação ao criar um sistema de arquivos do Amazon EFS.
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
Padrão: `.+`
** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) ID do sistema de arquivos cuja descrição você deseja recuperar (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})$`
** [Marker](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) Token de paginação opaco retornado de uma `DescribeFileSystems` operação anterior (String). Se presente, especifica a continuação da lista de onde a chamada retornada foi interrompida.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [MaxItems](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) Especifica o número máximo de sistemas de arquivos a serem retornados na resposta (inteiro). Esse número é automaticamente definido como 100. A resposta é paginada em 100 por página se você tiver mais de 100 sistemas de arquivos.
Faixa válida: valor mínimo de 1.
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystems": [
{
"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"
}
],
"Marker": "string",
"NextMarker": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) **
Uma matriz de descrições do sistema de arquivos.
Tipo: matriz de objetos [FileSystemDescription](API_FileSystemDescription.md)
** [Marker](#API_DescribeFileSystems_ResponseSyntax) **
Presente se fornecido pelo chamador na solicitação (String).
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) **
Presente se houver mais sistemas de arquivos do que os retornados na resposta (String). Você pode usar o `NextMarker` na solicitação subsequente para buscar as descrições.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
## 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
** 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
## Exemplos
### Recupere uma lista de 10 sistemas de arquivos
O exemplo a seguir envia uma solicitação GET para o endpoint do `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`). A solicitação especifica um parâmetro de consulta `MaxItems` para limitar o número de descrições do sistema de arquivos a 10.
#### Exemplo de solicitação
```
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
"FileSystems":[
{
"OwnerId":"251839141158",
"CreationToken":"MyFileSystem1",
"FileSystemId":"fs-01234567",
"PerformanceMode" : "generalPurpose",
"CreationTime":"1403301078",
"LifeCycleState":"created",
"Name":"my first file system",
"NumberOfMountTargets":1,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
}
}
]
}
```
## 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/DescribeFileSystems)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
# DescribeLifecycleConfiguration
Exibe o objeto `LifecycleConfiguration` atual para o sistema de arquivos do EFS especificado. O Gerenciamento do ciclo de vida usa o objeto `LifecycleConfiguration` para identificar quando mover arquivos entre as classes de armazenamento. Para um sistema de arquivos sem um objeto `LifecycleConfiguration`, a chamada retorna uma matriz vazia na resposta.
Essa operação exige permissões para a operação `elasticfilesystem:DescribeLifecycleConfiguration`.
## Sintaxe da Solicitação
```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **
O ID do sistema de arquivos cujo objeto `LifecycleConfiguration` você deseja recuperar (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})$`
Obrigatório: Sim
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) **
Uma matriz de políticas de gerenciamento do ciclo de vida. O EFS é compatível com no máximo uma política por sistema de arquivos.
Tipo: matriz de objetos [LifecyclePolicy](API_LifecyclePolicy.md)
Membros da matriz: número máximo de três itens.
## 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
** 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
## Exemplos
### Recuperar a configuração do ciclo de vida de um sistema de arquivos
A solicitação a seguir recupera o objeto `LifecycleConfiguration` para o sistema de arquivos especificado.
#### Exemplo de solicitação
```
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
## 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/DescribeLifecycleConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
# DescribeMountTargets
Retorna as descrições de todos os destinos de montagem atuais ou de um determinado destino de montagem de um sistema de arquivos. Ao solicitar todos os destinos de montagem atuais, a ordem dos destinos de montagem retornados na resposta não é especificada.
Essa operação requer permissões para a ação `elasticfilesystem:DescribeMountTargets` no ID do sistema de arquivos especificado em `FileSystemId` ou no sistema de arquivos do destino de montagem especificado em `MountTargetId`.
O comando CLI correspondente é `describe-mount-targets`.
## Sintaxe da Solicitação
```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) O ID do ponto de acesso cujos destinos de montagem você deseja listar. Ele deve ser incluído em sua solicitação se um `FileSystemId` ou `MountTargetId` não estiver incluído em sua solicitação. Aceita um ID de ponto de acesso ou ARN como entrada.
Restrições de Tamanho: Tamanho máximo de 128.
Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) ID do sistema de arquivos cujos destinos de montagem você deseja listar (String). Ele deve ser incluído em sua solicitação, se `AccessPointId` ou `MountTargetId` não forem incluídos. Aceita um ID de sistema de arquivos ou ARN como entrada.
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})$`
** [Marker](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) Token de paginação opaco retornado de uma operação `DescribeMountTargets` anterior (String). Se presente, ele especifica continuar a lista de onde a chamada retornada anterior parou.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) O número máximo de destinos de montagem a ser retornado na resposta. Atualmente, esse número é automaticamente definido como 10 e outros valores são ignorados. A resposta é paginada em 100 por página se você tiver mais de 100 destinos de montagem.
Faixa válida: valor mínimo de 1.
** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) ID do destino de montagem que você deseja descrever (String). Ele deve ser incluído em sua solicitação, se `FileSystemId` não estiver incluído. Aceita um ID de destino de montagem ou ARN como entrada.
Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45.
Padrão: `^fsmt-[0-9a-f]{8,40}$`
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"MountTargets": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
],
"NextMarker": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [Marker](#API_DescribeMountTargets_ResponseSyntax) **
Se a solicitação incluiu `Marker`, a resposta retornará esse valor nesse campo.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **
Retorna os destinos de montagem do sistema de arquivos como uma matriz de objetos `MountTargetDescription`.
Tipo: matriz de objetos [MountTargetDescription](API_MountTargetDescription.md)
** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **
Se um valor estiver presente, há mais destinos de montagem a serem retornados. Em uma solicitação subsequente, você pode fornecer `Marker` em sua solicitação com este valor para recuperar o próximo conjunto de destinos de montagem.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
## Erros
** AccessPointNotFound **
Retornado se o `AccessPointId` 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
** 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
** 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
** MountTargetNotFound **
Retornado se não houver um destino de montagem com o ID especificado encontrado na Conta da AWS do chamador.
** 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
## Exemplos
### Recuperar descrições de destinos de montagem criados para um sistema de arquivos
A solicitação a seguir recupera as descrições dos destinos de montagem criados para o sistema de arquivos especificado.
#### Exemplo de solicitação
```
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357
{
"MountTargets":[
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-01234567",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"LifeCycleState":"added",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
}
]
}
```
## 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/DescribeMountTargets)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
# DescribeMountTargetSecurityGroups
Retorna os security groups que estão em vigor para um destino de montagem. Essa operação exige que a interface de rede do destino de montagem tenha sido criada e que o estado do ciclo de vida do destino de montagem não seja `deleted`.
Essa operação exige permissões para as seguintes ações:
+ Ação `elasticfilesystem:DescribeMountTargetSecurityGroups` no sistema de arquivos do destino de montagem.
+ Ação `ec2:DescribeNetworkInterfaceAttribute` na interface de rede do destino de montagem.
## Sintaxe da Solicitação
```
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **
O ID do destino de montagem com os grupos de segurança você deseja recuperar.
Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45.
Padrão: `^fsmt-[0-9a-f]{8,40}$`
Obrigatório: Sim
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) **
Uma matriz de grupos de segurança.
Tipo: matriz de strings
Membros da matriz: número máximo de 100 itens.
Restrições de tamanho: tamanho mínimo de 11. Tamanho máximo de 43.
Padrão: `^sg-[0-9a-f]{8,40}`
## 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
** IncorrectMountTargetState **
Retornado se o destino da montagem não estiver no estado correto para a operação.
** 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
** 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
** MountTargetNotFound **
Retornado se não houver um destino de montagem com o ID especificado encontrado na Conta da AWS do chamador.
** 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
## Exemplos
### Recuperar grupos de segurança em vigor para um sistema de arquivos
O exemplo a seguir recupera os grupos de segurança que estão em vigor para a interface de rede associada a um destino de montagem.
#### Exemplo de solicitação
```
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223513Z
Authorization: <...>
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
## 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/DescribeMountTargetSecurityGroups)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
# DescribeReplicationConfigurations
Recupera a configuração de replicação de um sistema de arquivos específico. Se um sistema de arquivos não for especificado, todas as configurações de replicação do Conta da AWS in an Região da AWS serão recuperadas.
## Sintaxe da Solicitação
```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **
Você pode recuperar a configuração de replicação de um sistema de arquivos específico fornecendo seu ID do sistema de arquivos. Para replicação entre contas e regiões, uma conta só pode descrever a configuração de replicação de um sistema de arquivos em sua própria região.
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})$`
** [MaxResults](#API_DescribeReplicationConfigurations_RequestSyntax) **
(Opcional) Para limitar o número de objetos retornados em uma resposta, você pode especificar o parâmetro `MaxItems`. O valor padrão é 100.
Faixa válida: valor mínimo de 1.
** [NextToken](#API_DescribeReplicationConfigurations_RequestSyntax) **
O `NextToken` estará presente se a resposta for paginada. Você pode usar o `NextToken` em uma solicitação subsequente para buscar a próxima página de saída.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Replications": [
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "string"
}
]
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [NextToken](#API_DescribeReplicationConfigurations_ResponseSyntax) **
Você pode usar o `NextToken` da resposta anterior em uma solicitação subsequente para buscar as descrições adicionais.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) **
A coleção de configurações de replicação que é retornada.
Tipo: matriz de objetos [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md)
## 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
** 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
** ReplicationNotFound **
Retornado se o sistema de arquivos especificado não tiver uma configuração de replicação.
** ErrorCode **
ReplicationNotFound
** 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
** ValidationException **
Retornado se o AWS Backup serviço não estiver disponível no Região da AWS local em que a solicitação foi feita.
** 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
## 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/DescribeReplicationConfigurations)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
# DescribeTags
**nota**
OBSOLETO: a ação `DescribeTags` está obsoleta e não será mantida. Para visualizar as tags associadas aos recursos do EFS, use a ação `ListTagsForResource` da API.
Retorna as tags associadas a um sistema de arquivos. A ordem das tags retornadas na resposta de uma chamada `DescribeTags` e a ordem das tags retornadas nas respostas de uma iteração de várias chamadas (ao usar paginação) não são especificadas.
Essa operação exige permissões para a ação `elasticfilesystem:DescribeTags`.
## Sintaxe da Solicitação
```
GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_DescribeTags_RequestSyntax) **
O ID do sistema de arquivos com o conjunto de tags que você deseja recuperar.
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
** [Marker](#API_DescribeTags_RequestSyntax) **
(Opcional) Um token de paginação opaco retornado de uma operação `DescribeTags` anterior (String). Se presente, especifica continuar a lista de onde a chamada anterior parou.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [MaxItems](#API_DescribeTags_RequestSyntax) **
(Opcional) O número máximo de tags do sistema de arquivos a ser retornado na resposta. Atualmente, esse número é automaticamente definido como 100 e outros valores são ignorados. A resposta é paginada em 100 por página se você tiver mais de 100 tags.
Faixa válida: valor mínimo de 1.
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"NextMarker": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [Marker](#API_DescribeTags_ResponseSyntax) **
Se a solicitação incluiu um `Marker`, a resposta retornará esse valor nesse campo.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [NextMarker](#API_DescribeTags_ResponseSyntax) **
Se um valor estiver presente, haverá mais tags a serem retornadas. Em uma solicitação subsequente, você pode fornecer o valor de `NextMarker` como o valor do parâmetro `Marker` em sua próxima solicitação para recuperar o próximo conjunto de tags.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [Tags](#API_DescribeTags_ResponseSyntax) **
Retorna tags associadas ao sistema de arquivos como uma matriz de objetos de `Tag`.
Tipo: matriz de objetos [Tag](API_Tag.md)
## 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
** 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
## Exemplos
### Recuperar tags associadas a um sistema de arquivos
A solicitação a seguir recupera tags (pares de chave-valor) associadas ao sistema de arquivos especificado.
#### Exemplo de solicitação
```
GET /2015-02-01/tags/fs-01234567/ HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215404Z
Authorization: <...>
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 288
{
"Tags":[
{
"Key":"Name",
"Value":"my first file system"
},
{
"Key":"Fleet",
"Value":"Development"
},
{
"Key":"Developer",
"Value":"Alice"
}
]
}
```
## 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/DescribeTags)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags)
# ListTagsForResource
Lista todas as tags de um recurso EFS de nível superior. Você deve fornecer o ID do recurso para o qual deseja recuperar as tags.
Essa operação exige permissões para a ação `elasticfilesystem:DescribeAccessPoints`.
## Sintaxe da Solicitação
```
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [MaxResults](#API_ListTagsForResource_RequestSyntax) **
(Opcional) Especifica o número máximo de objetos de tag a ser retornado na resposta. O valor padrão é 100.
Faixa válida: valor mínimo de 1.
** [NextToken](#API_ListTagsForResource_RequestSyntax) **
(Opcional) Você pode usar `NextToken` em uma solicitação subsequente para buscar a próxima página de descrições dos pontos de acesso se a carga útil da resposta tiver sido paginada.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [ResourceId](#API_ListTagsForResource_RequestSyntax) **
Especifica o recurso EFS para o qual você deseja recuperar as tags. Você pode recuperar tags para sistemas de arquivos e pontos de acesso EFS usando esse endpoint de API.
Restrições de Tamanho: Tamanho máximo de 128.
Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Obrigatório: Sim
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [NextToken](#API_ListTagsForResource_ResponseSyntax) **
`NextToken` estará presente se a carga útil da resposta estiver paginada. Você pode usar `NextToken` em uma solicitação subsequente para buscar a próxima página de descrições dos pontos de acesso.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `.+`
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
Uma matriz de tags para o recurso EFS especificado.
Tipo: matriz de objetos [Tag](API_Tag.md)
## Erros
** AccessPointNotFound **
Retornado se o `AccessPointId` 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
** 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
** 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
## 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/ListTagsForResource)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource)
# ModifyMountTargetSecurityGroups
Modifica o conjunto de security groups que estão em vigor para um destino de montagem.
Quando você cria um destino de montagem, o Amazon EFS também cria uma nova interface de rede. Para obter mais informações, consulte [CreateMountTarget](API_CreateMountTarget.md). Essa operação substitui os grupos de segurança em vigor para a interface de rede associada a um destino de montagem, com os `SecurityGroups` fornecidos na solicitação. Essa operação exige que a interface de rede do destino de montagem tenha sido criada e que o estado do ciclo de vida do destino de montagem não seja `deleted`.
Essa operação exige permissões para as seguintes ações:
+ ação `elasticfilesystem:ModifyMountTargetSecurityGroups` no sistema de arquivos do destino de montagem.
+ Ação `ec2:ModifyNetworkInterfaceAttribute` na interface de rede do destino de montagem.
## Sintaxe da Solicitação
```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
O ID do destino de montagem cujos grupos de segurança você deseja modificar.
Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45.
Padrão: `^fsmt-[0-9a-f]{8,40}$`
Obrigatório: Sim
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
Uma matriz de grupos de segurança de VPC. IDs
Tipo: matriz de strings
Membros da matriz: número máximo de 100 itens.
Restrições de tamanho: tamanho mínimo de 11. Tamanho máximo de 43.
Padrão: `^sg-[0-9a-f]{8,40}`
Obrigatório: Não
## Sintaxe da resposta
```
HTTP/1.1 204
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## 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
** IncorrectMountTargetState **
Retornado se o destino da montagem não estiver no estado correto para a operação.
** 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
** 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
** MountTargetNotFound **
Retornado se não houver um destino de montagem com o ID especificado encontrado na Conta da AWS do chamador.
** 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
** SecurityGroupLimitExceeded **
Exibido se o número de `SecurityGroups` especificado na solicitação for maior que o limite, que se baseia na cota da conta. Exclua alguns grupos de segurança ou solicite que a cota da conta seja aumentada. Para acessar mais informações, consulte [Cotas da Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) no *Guia do usuário da Amazon VPC* (consulte a tabela **Grupos de segurança**).
** 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
** SecurityGroupNotFound **
Retornado se um dos grupos de segurança especificados não existir na nuvem privada virtual (VPC) da sub-rede.
** 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
## Exemplos
### Substituir os grupos de segurança de um destino de montagem
O exemplo a seguir substitui os grupos de segurança em vigor na interface de rede associada a um destino de montagem.
#### Exemplo de solicitação
```
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
#### Resposta da amostra
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/ModifyMountTargetSecurityGroups)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
# PutAccountPreferences
Use essa operação para definir a preferência da conta atual Região da AWS para usar o recurso longo de 17 caracteres (63 bits) ou curto de 8 caracteres (32 bits) IDs para o novo sistema de arquivos EFS e montar recursos de destino. Todos os recursos existentes não IDs são afetados por nenhuma alteração que você fizer. Você pode definir a preferência de ID durante o período de aceitação à medida que o EFS faz a transição para um recurso longo. IDs Para obter mais informações, consulte [Gerenciando o recurso Amazon EFS IDs](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html).
**nota**
A partir de outubro de 2021, você receberá uma mensagem de erro se tentar definir a preferência da conta para usar o ID de recurso de formato curto de 8 caracteres. Entre em contato com o AWS suporte se você receber um erro e precisar usar a abreviação IDs para sistema de arquivos e recursos de destino de montagem.
## Sintaxe da Solicitação
```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}
```
## Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **
Especifica a preferência de ID do recurso EFS a ser definida para o usuário Conta da AWS Região da AWS, na atual `LONG_ID` (17 caracteres) ou `SHORT_ID` (8 caracteres).
A partir de outubro de 2021, você receberá uma mensagem de erro ao definir a preferência da conta como `SHORT_ID`. Entre em contato com o AWS suporte se você receber um erro e precisar usar a abreviação IDs para sistema de arquivos e recursos de destino de montagem.
Tipo: string
Valores válidos: `LONG_ID | SHORT_ID`
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) **
Descreve o tipo de recurso e sua preferência de ID para a do usuário Conta da AWS, no atual Região da AWS.
Tipo: objeto [ResourceIdPreference](API_ResourceIdPreference.md)
## 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
** 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
## 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/PutAccountPreferences)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
# PutBackupPolicy
Atualiza a política de backup do sistema de arquivos. Use essa ação para iniciar ou interromper os backups automáticos do sistema de arquivos.
## Sintaxe da Solicitação
```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **
Especifica para qual sistema de arquivos EFS atualizar a política de backup.
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.
** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **
A política de backup incluída na solicitação `PutBackupPolicy`.
Tipo: objeto [BackupPolicy](API_BackupPolicy.md)
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) **
Descreve a política de backup do sistema de arquivos, indicando se os backups automáticos estão ativados ou desativados.
Tipo: objeto [BackupPolicy](API_BackupPolicy.md)
## 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
** 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
** ValidationException **
Retornado se o AWS Backup serviço não estiver disponível no Região da AWS local em que a solicitação foi feita.
** 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
## 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/PutBackupPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
# PutFileSystemPolicy
Aplica uma `FileSystemPolicy` do Amazon EFS a um sistema de arquivos do Amazon EFS. Uma política de sistema de arquivos é uma política baseada em recursos do IAM e pode conter várias declarações de política. Um sistema de arquivos sempre tem exatamente uma política de sistema de arquivos, que pode ser a política padrão ou uma política explícita definida ou atualizada usando essa operação de API. As políticas do sistema de arquivos EFS têm um limite de 20.000 caracteres. Quando uma política explícita é definida, ela substitui a política padrão. Para obter mais informações sobre a política padrão do sistema de arquivos, consulte [Política padrão do sistema de arquivos EFS](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy).
**nota**
As políticas do sistema de arquivos EFS têm um limite de 20.000 caracteres.
Essa operação exige permissões para a ação `elasticfilesystem:PutFileSystemPolicy`.
## Sintaxe da Solicitação
```
PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json
{
"BypassPolicyLockoutSafetyCheck": boolean,
"Policy": "string"
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) **
O ID do sistema de arquivos do EFS para o qual você deseja criar ou atualizar a `FileSystemPolicy`.
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.
** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) **
(Opcional) Um booliano que especifica se é necessário ou não ignorar a verificação de segurança de bloqueio `FileSystemPolicy`. A verificação de segurança de bloqueio determina se a política na solicitação bloqueará ou impedirá que a entidade principal do IAM que está fazendo a solicitação faça o solicitações `PutFileSystemPolicy` futuras neste sistema de arquivos. Defina `BypassPolicyLockoutSafetyCheck` como `True` somente quando quiser impedir que a entidade principal do IAM que está fazendo a solicitação faça solicitações `PutFileSystemPolicy` subsequentes nesse sistema de arquivos. O valor padrão é `False`.
Tipo: booliano
Obrigatório: não
** [Policy](#API_PutFileSystemPolicy_RequestSyntax) **
A `FileSystemPolicy` que você está criando. Aceita uma definição de política formatada em JSON. As políticas do sistema de arquivos EFS têm um limite de 20.000 caracteres. Para descobrir mais sobre os elementos que compõem uma política de sistema de arquivos, consulte [Políticas baseadas em recursos do Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies).
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 20.000.
Padrão: `[\s\S]+`
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) **
Especifica o sistema de arquivos EFS ao qual a `FileSystemPolicy` se aplica.
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})$`
** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) **
A `FileSystemPolicy` em formato JSON para o sistema de arquivos EFS.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 20.000.
Padrão: `[\s\S]+`
## 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
** 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
** InvalidPolicyException **
Retornado se a `FileSystemPolicy` estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente. Retornado no caso de um erro na verificação de segurança do bloqueio da política.
** 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
## Exemplos
### Crie um EFS FileSystemPolicy
A solicitação a seguir cria uma `FileSystemPolicy` que permite que todos os AWS diretores montem o sistema de arquivos EFS especificado com permissões de leitura e gravação.
#### Exemplo de solicitação
```
PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
}
]
}
```
#### Resposta da amostra
```
{
"Version": "2012-10-17",
"Id": "1",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
"Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567"
}
]
}
```
## 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/PutFileSystemPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
# PutLifecycleConfiguration
Use essa ação para gerenciar o armazenamento do seu sistema de arquivos. Um `LifecycleConfiguration` consiste em um ou mais objetos `LifecyclePolicy` que definem o seguinte:
+ **`TransitionToIA`**: quando mover arquivos no sistema de arquivos do armazenamento principal (classe de armazenamento Standard) para o armazenamento Infrequent Access (IA).
+ **`TransitionToArchive`**: quando mover arquivos no sistema de arquivos de sua classe de armazenamento atual (IA ou armazenamento Standard) para o armazenamento Archive.
Os sistemas de arquivos não podem fazer a transição para o armazenamento Archive antes da transição para o armazenamento IA. Portanto, não TransitionToArchive deve ser definido ou deve ser posterior ao TransitionTo IA.
**nota**
A classe de armazenamento de arquivos está disponível somente para sistemas de arquivos que usam o modo de throughput elástico e o modo de desempenho de uso geral.
+ **`TransitionToPrimaryStorageClass`**: se os arquivos do sistema de arquivos devem ser movidos de volta para o armazenamento primário (classe de armazenamento Standard) após serem acessados no IA ou no armazenamento Archive.
Para obter mais informações, consulte [Como gerenciar o armazenamento de sistema de arquivos](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
Cada sistema de arquivos do Amazon EFS é compatível com uma configuração de ciclo de vida, que se aplica a todos os arquivos no sistema de arquivos. Se já existir um objeto `LifecycleConfiguration` para o sistema de arquivos especificado, uma chamada `PutLifecycleConfiguration` modifica a configuração existente. Uma chamada `PutLifecycleConfiguration` com uma matriz `LifecyclePolicies` vazia no corpo da solicitação exclui qualquer `LifecycleConfiguration` existente. Na solicitação, especifique o seguinte:
+ O ID do sistema de arquivos para o qual você está habilitando, desabilitando ou modificando o gerenciamento do ciclo de vida.
+ Uma matriz `LifecyclePolicies` de objetos da `LifecyclePolicy` que define quando mover arquivos para o armazenamento IA, para o armazenamento Archive e de volta para o armazenamento primário.
**nota**
O Amazon EFS exige que cada objeto `LifecyclePolicy` tenha apenas uma única transição. Portanto, a matriz `LifecyclePolicies` precisa ser estruturada com objetos `LifecyclePolicy` separados. Consulte os exemplos de solicitações na seção a seguir para obter mais informações.
Essa operação exige permissões para a operação `elasticfilesystem:PutLifecycleConfiguration`.
Para aplicar um `LifecycleConfiguration` objeto a um sistema de arquivos criptografado, você precisa das mesmas AWS Key Management Service permissões de quando criou o sistema de arquivos criptografado.
## Sintaxe da Solicitação
```
PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **
O ID do sistema de arquivos para o qual você está criando o objeto `LifecycleConfiguration` (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})$`
Obrigatório: Sim
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **
Uma matriz de objetos `LifecyclePolicy` que definem o objeto `LifecycleConfiguration` do sistema de arquivos. Um objeto `LifecycleConfiguration` informa o gerenciamento do ciclo de vida sobre o seguinte:
+ **`TransitionToIA`**: quando mover arquivos no sistema de arquivos do armazenamento principal (classe de armazenamento Standard) para o armazenamento Infrequent Access (IA).
+ **`TransitionToArchive`**: quando mover arquivos no sistema de arquivos de sua classe de armazenamento atual (IA ou armazenamento Standard) para o armazenamento Archive.
Os sistemas de arquivos não podem fazer a transição para o armazenamento Archive antes da transição para o armazenamento IA. Portanto, não TransitionToArchive deve ser definido ou deve ser posterior ao TransitionTo IA.
**nota**
A classe de armazenamento de arquivos está disponível somente para sistemas de arquivos que usam o modo de throughput elástico e o modo de desempenho de uso geral.
+ **`TransitionToPrimaryStorageClass`**: se os arquivos do sistema de arquivos devem ser movidos de volta para o armazenamento primário (classe de armazenamento Standard) após serem acessados no IA ou no armazenamento Archive.
Ao usar o comando `put-lifecycle-configuration` da CLI ou a ação `PutLifecycleConfiguration` da API, o Amazon EFS exige que cada objeto `LifecyclePolicy` tenha apenas uma única transição. Isso significa que, no corpo de uma solicitação, o `LifecyclePolicies` deve ser estruturado como uma matriz de objetos da `LifecyclePolicy`, um objeto para cada transição. Consulte os exemplos de solicitações na seção a seguir para obter mais informações.
Tipo: matriz de objetos [LifecyclePolicy](API_LifecyclePolicy.md)
Membros da matriz: número máximo de três itens.
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) **
Uma matriz de políticas de gerenciamento do ciclo de vida. O EFS é compatível com no máximo uma política por sistema de arquivos.
Tipo: matriz de objetos [LifecyclePolicy](API_LifecyclePolicy.md)
Membros da matriz: número máximo de três itens.
## 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
** 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
## Exemplos
### Criar uma configuração de ciclo de vida
O exemplo a seguir cria um objeto `LifecyclePolicy` usando a ação `PutLifecycleConfiguration`. Este exemplo cria uma política de ciclo de vida que instrui o EFS a fazer o seguinte:
+ Mova todos os arquivos no sistema de arquivos que não foram acessados no armazenamento Standard nos últimos 30 dias para o armazenamento IA.
+ Mova todos os arquivos no sistema de arquivos que não foram acessados no armazenamento Standard nos últimos 90 dias para o armazenamento Archive.
+ Mova os arquivos de volta para o armazenamento Standard depois que eles forem acessados no armazenamento IA ou Archive. A classe de armazenamento de arquivos está disponível somente para sistemas de arquivos que usam o modo de throughput elástico e o modo de desempenho de uso geral.
Para obter mais informações, consulte [Classes de armazenamento do EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) e [Como gerenciar o armazenamento do sistema de arquivos](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
#### Exemplo de solicitação
```
PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
### Exemplo de put-lifecycle-configuration solicitação de CLI
Este exemplo ilustra um uso do. PutLifecycleConfiguration
#### Exemplo de solicitação
```
aws efs put-lifecycle-configuration \
--file-system-id fs-0123456789abcdefb \
--lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
{"TransitionToIA":"AFTER_30_DAYS"},
{"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]
--region us-west-2 \
--profile adminuser
```
#### Resposta da amostra
```
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
### Desativar o gerenciamento de ciclo de vida
O exemplo a seguir desativa o gerenciamento do ciclo de vida do sistema de arquivos especificado.
#### Exemplo de solicitação
```
PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
#### Resposta da amostra
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
## 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/PutLifecycleConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
# TagResource
Criar uma tag para um recurso do EFS. Você pode criar tags para sistemas de arquivos e pontos de acesso do EFS usando essa operação de API.
Essa operação exige permissões para a ação `elasticfilesystem:TagResource`.
## Sintaxe da Solicitação
```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [ResourceId](#API_TagResource_RequestSyntax) **
O ID que especifica o recurso do EFS para o qual você deseja criar uma tag.
Restrições de Tamanho: Tamanho máximo de 128.
Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Obrigatório: Sim
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [Tags](#API_TagResource_RequestSyntax) **
Uma matriz de objetos de `Tag` para adicionar. Cada objeto de `Tag` é um par de chave-valor.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
```
## Elementos de Resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.
## Erros
** AccessPointNotFound **
Retornado se o `AccessPointId` 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
** 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
** 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
## Exemplos
### Criar tags em um sistema de arquivos
A solicitação a seguir cria três tags (`"key1"`, `"key2"`, e `"key3"`) no sistema de arquivos especificado.
#### Exemplo de solicitação
```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
#### Resposta da amostra
```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/TagResource)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)
# UntagResource
Remove tags de um recurso do Amazon EFS. Você pode remover tags dos sistemas de arquivos e pontos de acesso do EFS usando essa operação de API.
Essa operação exige permissões para a ação `elasticfilesystem:UntagResource`.
## Sintaxe da Solicitação
```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [ResourceId](#API_UntagResource_RequestSyntax) **
Especifica as tags que você quer remover do recurso especificado.
Restrições de Tamanho: Tamanho máximo de 128.
Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Obrigatório: Sim
** [TagKeys](#API_UntagResource_RequestSyntax) **
As chaves dos pares de chave/valor de tags que você deseja remover do recurso do EFS especificado.
Membros da matriz: número mínimo de 1 item. Número máximo de 50 itens.
Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128.
Padrão: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Obrigatório: Sim
## Corpo da Solicitação
Essa solicitação não tem corpo.
## Sintaxe da resposta
```
HTTP/1.1 200
```
## Elementos de Resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.
## Erros
** AccessPointNotFound **
Retornado se o `AccessPointId` 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
** 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
** 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
## 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/UntagResource)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource)
# 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)
# UpdateFileSystemProtection
Atualiza a proteção no sistema de arquivos.
Essa operação exige permissões para a ação `elasticfilesystem:UpdateFileSystemProtection`.
## Sintaxe da Solicitação
```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **
O ID do sistema de arquivos a ser atualizado.
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.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **
O status da proteção contra substituição de replicação do sistema de arquivos.
+ `ENABLED` - o sistema de arquivos de origem não pode ser usado como sistema de arquivos de destino em uma configuração de replicação. O sistema de arquivos é gravável. A proteção contra substituição de replicação é `ENABLED` por padrão.
+ `DISABLED`: o sistema de arquivos de origem pode ser usado como sistema de arquivos de destino em uma configuração de replicação. O sistema de arquivos é somente para leitura e só pode ser modificado pela replicação do EFS.
+ `REPLICATING`: o sistema de arquivos de origem está sendo usado como sistema de arquivos de destino em uma configuração de replicação. O sistema de arquivos é somente para leitura e só é modificado pela replicação do EFS.
Se a configuração de replicação for excluída, a proteção contra substituição de replicação do sistema de arquivos será reativada e o sistema de arquivos se tornará gravável.
Tipo: string
Valores válidos: `ENABLED | DISABLED | REPLICATING`
Obrigatório: não
## Sintaxe da resposta
```
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) **
O status da proteção contra substituição de replicação do sistema de arquivos.
+ `ENABLED` - o sistema de arquivos de origem não pode ser usado como sistema de arquivos de destino em uma configuração de replicação. O sistema de arquivos é gravável. A proteção contra substituição de replicação é `ENABLED` por padrão.
+ `DISABLED`: o sistema de arquivos de origem pode ser usado como sistema de arquivos de destino em uma configuração de replicação. O sistema de arquivos é somente para leitura e só pode ser modificado pela replicação do EFS.
+ `REPLICATING`: o sistema de arquivos de origem está sendo usado como sistema de arquivos de destino em uma configuração de replicação. O sistema de arquivos é somente leitura e só é modificado pela replicação do EFS.
Se a configuração de replicação for excluída, a proteção contra substituição de replicação do sistema de arquivos será reativada, o sistema de arquivos se tornará gravável.
Tipo: string
Valores válidos: `ENABLED | DISABLED | REPLICATING`
## 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
** ReplicationAlreadyExists **
Retornado se o sistema de arquivos já estiver incluído em uma configuração de replicação.>
** 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
** 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/UpdateFileSystemProtection)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)