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á.

API do Amazon EFS

A API do Amazon EFS é um protocolo de rede com base em HTTP (RFC 2616). Para cada chamada de API, você faz uma solicitação HTTP para o endpoint da API Amazon EFS específico da região Região da AWS onde você deseja gerenciar sistemas de arquivos. A API usa documentos JSON (RFC 4627) para órgãos de solicitação/resposta de HTTP.

A API do Amazon EFS é um modelo de RPC. Nesse modelo, há um conjunto fixo de operações, e os clientes conhecem a sintaxe de cada operação sem qualquer interação prévia. Na seção a seguir, você encontrará uma descrição de cada operação de API que usa uma notação abstrata de RPC. Cada uma tem um nome de operação que não aparece na rede. Para cada operação, o tópico especifica o mapeamento para elementos de solicitação de HTTP.

A operação do Amazon EFS específica para a qual certa solicitação é mapeada é determinada por uma combinação entre métodos de solicitação (EFS, GET, PUT ou DELETE) e diversos padrões aos quais seu URI de solicitação corresponde. Se a operação for PUT ou POST, o Amazon EFS extrai argumentos de chamada do segmento do caminho do URI da solicitação, parâmetros de consulta e o objeto JSON no corpo de solicitação.

Endpoints da API

Um endpoint é uma URL que serve como ponto de entrada para um serviço AWS web. O Amazon EFS oferece suporte aos seguintes tipos de endpoints:

Ao fazer uma solicitação, você pode especificar o endpoint a ser usado. Se você não especificar um endpoint, o IPv4 endpoint será usado por padrão. Para usar outro tipo de endpoint, você deve especificá-lo em sua solicitação. Para obter exemplos de como fazer isso, consulte Especificar endpoints. Para obter uma tabela de endpoints disponíveis, consulte endpoints e cotas do Amazon EFS.

IPv4 endpoints

IPv4 os endpoints oferecem suporte somente ao IPv4 tráfego. IPv4 os endpoints estão disponíveis para todas as regiões. O formato do IPv4 endpoint depende da região.

Endpoints de pilha dupla (IPv4 e) IPv6

Os endpoints de pilha dupla oferecem suporte tanto ao tráfego quanto ao tráfego. IPv4 IPv6 Quando você faz uma solicitação para um endpoint de pilha dupla, o URL do endpoint é resolvido para um IPv4 endereço IPv6 ou, dependendo do protocolo usado pela rede e pelo cliente. O formato do endpoint de pilha dupla depende da região.

Especificar endpoints

Os exemplos a seguir mostram como especificar um endpoint para a região Oeste dos EUA (Norte da Califórnia) (us-west-1) usando o para AWS CLI Amazon EFS.

IPv4

aws efs get-rest-apis --region us-west-1 --endpoint-url https://elasticfilesystem.us-west-1.amazonaws.com

Pilha dupla

aws efs get-rest-apis --region us-west-1 --endpoint-url https://efs.us-west-1.api.aws

Versão da API

A versão da API que está sendo usada para uma chamada é identificada pelo primeiro segmento do caminho do URI da solicitação e tem o formato de data ISO 8601. Por exemplo, consulte CreateFileSystem.

A documentação descreve a versão da API de 2015-02-01.

Tópicos relacionados

As seções a seguir oferecem descrições das operações de API, como criar uma solicitação de assinatura para autenticação, e como conceder permissões para essas operações de API usando as políticas do IAM.

Trabalhar com a taxa de solicitações de APIs de consulta para o Amazon EFS

As solicitações de API do Amazon EFS são limitadas para cada uma, por região, para ajudar Conta da AWS no desempenho do serviço. Todas as chamadas de API do Amazon EFS juntas, sejam elas originárias de um aplicativo, do console do AWS CLI Amazon EFS ou do console do Amazon EFS, não devem exceder a taxa máxima permitida de solicitações de API. A taxa máxima de solicitação de API pode variar de acordo com o outro Regiões da AWS. As solicitações de API feitas são atribuídas ao subjacente Conta da AWS.

Se uma solicitação de API exceder a taxa de solicitações de API da respectiva categoria, a solicitação retornará o código de erro ThrottlingException. Para evitar esse erro, verifique se o aplicativo não repete solicitações de API a uma taxa alta. Para fazer isso, tenha cuidado ao fazer a sondagem e use repetições de recuo exponencial.

Sondagem

O aplicativo pode precisar chamar uma operação da API várias vezes para verificar se há uma atualização no status. Antes de iniciar a sondagem, aguarde a conclusão da solicitação. Quando você iniciar a sondagem, use um intervalo de latência apropriado entre as solicitações sucessivas. Para obter os melhores resultados, use um intervalo de latência crescente.

Tentativas ou processamento em lote

O aplicativo pode precisar repetir uma solicitação de API depois que ela falhar ou processar vários recursos (por exemplo, todos os seus sistemas de arquivos do Amazon EFS). Para reduzir a taxa de solicitações de API, use um intervalo de latência apropriado entre as solicitações sucessivas. Para obter os melhores resultados, use um intervalo de latência crescente ou variável.

Calcular o intervalo de repouso

Quando você precisar fazer a sondagem ou repetir uma solicitação de API, é recomendável usar um algoritmo de recuo exponencial para calcular o intervalo de latência entre as chamadas de API. A ideia por trás do recuo exponencial é usar esperas progressivamente mais longas entre as novas tentativas para respostas de erro consecutivas. Para obter mais informações e exemplos de implementação desse algoritmo, consulte Comportamento de repetição no Referência geral da Amazon Web Services.