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 de API do Amazon EFS
A API do Amazon EFS é um protocolo de rede baseado em HTTP (RFC 2616)
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 específica do Amazon EFS para a qual uma determinada solicitação é mapeada é determinada por uma combinação do método da solicitação (GET, PUT, POST ou DELETE) e a qual dos vários padrões seu URI de solicitação corresponde. Se a operação for PUT ou POST, o Amazon EFS extrai argumentos de chamada do segmento de caminho do URI da solicitação, dos parâmetros da consulta e do objeto JSON no corpo da solicitação.
nota
Embora os nomes de operação, como CreateFileSystem, não apareçam na rede, eles são significativos nas políticas do AWS Identity and Access Management (IAM). Para obter mais informações, consulte Gerenciamento de identidade e acesso para a Amazon EFS.
O nome da operação também é usado para nomear comandos em ferramentas de linha de comando e elementos das APIs doAWS SDK. Por exemplo, há um comando da AWS CLI chamado create-file-system que mapeia para a operação CreateFileSystem.
O nome da operação também aparece nosAWS CloudTrail registros das chamadas de API do Amazon EFS.
Endpoint de API
O endpoint da API é o nome DNS usado como um host no URI de HTTP para as chamadas de API. Esses endpoints de API são específicosRegiões da AWS e assumem o seguinte formato.
elasticfilesystem.aws-region.amazonaws.com
Por exemplo, o endpoint de API do Amazon EFS para a região Oeste dos EUA (Oregon) é o seguinte.
elasticfilesystem.us-west-2.amazonaws.com
Para obter uma lista dosRegião da AWS suportados pelo Amazon EFS (onde você pode criar e gerenciar sistemas de arquivos), consulte Amazon Elastic File System no Referência geral da AWS.
O endpoint de API específico da região define o escopo dos recursos do Amazon EFS que podem ser acessados quando você faz uma chamada de API. Por exemplo, ao chamar aDescribeFileSystems operação usando o endpoint anterior, você obtém uma lista de sistemas de arquivos na região Oeste dos EUA (Oregon) que foram criados em sua conta.
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.
Trabalhando com a taxa de solicitação da API de consulta para o Amazon EFS
As solicitações de API do Amazon EFS são limitadas para cada região para ajudarConta da AWS no desempenho do serviço. Todas as chamadas de API do Amazon EFS juntas, sejam elas originárias de um aplicativoAWS CLI, do console ou do Amazon EFS, não devem exceder a taxa máxima de solicitação de API permitida. A taxa máxima de solicitação de API pode variar entreRegiões da AWS. As solicitações de API feitas são atribuídas ao subjacenteConta 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 novas ou processamento em lote
Talvez seu aplicativo precise repetir uma solicitação de API depois de 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.
Cálculo do.
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 backoff 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 Tentativas de erro e recuo exponencialAWS noReferência geral da Amazon Web Services.
