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á.
AWS endpoints de serviço
Para se conectar programaticamente a um AWS serviço, você usa um endpoint. Um endpoint é a URL do ponto de entrada de um serviço AWS web. O AWS SDKs e o AWS Command Line Interface (AWS CLI) usam automaticamente o endpoint padrão para cada serviço em uma AWS região. No entanto, é possível especificar um endpoint alternativo para suas solicitações de API.
Se um serviço é compatível com regiões, os recursos em cada região são independentes de recursos semelhantes em outras regiões. Por exemplo, é possível criar uma instância do Amazon EC2 ou uma fila do Amazon SQS em uma região. Ao fazer isso, a instância ou a fila é independente de instâncias ou filas em todas as outras regiões.
Conteúdo
Endpoints regionais do
A maioria dos serviços da Amazon Web oferece um endpoint regional que pode ser usado para fazer suas solicitações. Em geral, esses endpoints oferecem suporte ao IPv4 tráfego e usam a seguinte sintaxe.
protocol://service-code.region-code.amazonaws.comPor exemplo, https://dynamodb.us-west-2.amazonaws.com é o endpoint do serviço Amazon DynamoDB na região Oeste dos EUA (Oregon).
A tabela a seguir lista o nome e o código de cada região.
| Nome | Código |
|---|---|
| Leste dos EUA (Ohio) | us-east-2 |
| Leste dos EUA (Norte da Virgínia) | us-east-1 |
| Oeste dos EUA (N. da Califórnia) | us-west-1 |
| Oeste dos EUA (Oregon) | us-west-2 |
| África (Cidade do Cabo) | af-south-1 |
| Ásia-Pacífico (Hong Kong) | ap-east-1 |
| Ásia-Pacífico (Hyderabad) | ap-south-2 |
| Ásia-Pacífico (Jacarta) | ap-southeast-3 |
| Ásia-Pacífico (Malásia) | ap-southeast-5 |
| Ásia-Pacífico (Melbourne) | ap-southeast-4 |
| Ásia-Pacífico (Mumbai) | ap-south-1 |
| Ásia-Pacífico (Nova Zelândia) | ap-southeast-6 |
| Ásia-Pacífico (Osaka) | ap-northeast-3 |
| Ásia-Pacífico (Seul) | ap-northeast-2 |
| Ásia-Pacífico (Singapura) | ap-southeast-1 |
| Ásia-Pacífico (Sydney) | ap-southeast-2 |
| Ásia-Pacífico (Taipei) | ap-east-2 |
| Ásia-Pacífico (Tailândia) | ap-southeast-7 |
| Ásia-Pacífico (Tóquio) | ap-northeast-1 |
| Canadá (Central) | ca-central-1 |
| Oeste do Canadá (Calgary) | ca-west-1 |
| Europa (Frankfurt) | eu-central-1 |
| Europa (Irlanda) | eu-west-1 |
| Europa (Londres) | eu-west-2 |
| Europa (Milão) | eu-south-1 |
| Europe (Paris) | eu-west-3 |
| Europa (Espanha) | eu-south-2 |
| Europa (Estocolmo) | eu-north-1 |
| Europa (Zurique) | eu-central-2 |
| Israel (Tel Aviv) | il-central-1 |
| México (Centro) | mx-central-1 |
| Oriente Médio (Bahrein) | me-south-1 |
| Oriente Médio (Emirados Árabes Unidos) | me-central-1 |
| América do Sul (São Paulo) | sa-east-1 |
| AWS GovCloud (Leste dos EUA) | us-gov-east-1 |
| AWS GovCloud (Oeste dos EUA) | us-gov-west-1 |
Endpoints gerais
Os serviços a seguir são compatíveis com endpoints regionais, mas também sçao compatíveis com um endpoint geral que não inclui uma região. Quando você usa um endpoint geral, AWS encaminha a solicitação de API para o Leste dos EUA (Norte da Virgíniaus-east-1) (), que é a região padrão para chamadas de API.
-
Amazon EC2 — ec2.amazonaws.com
-
Amazon EC2 Auto Scaling — autoscaling.amazonaws.com
-
Amazon EMR — elasticmapreduce.amazonaws.com
Endpoints globais
Cada um dos serviços a seguir tem um endpoint global que abrange regiões AWS :
Observe que alguns desses serviços têm endpoints adicionais, como os endpoints FIPS.
Visualizar os endpoints de serviço
Você pode visualizar os endpoints do AWS serviço usando as seguintes opções:
-
Abra Cotas e endpoints de serviço, procure o nome do serviço e clique no link para abrir a página desse serviço. Para visualizar os endpoints compatívies com todos os serviços da AWS na documentação sem alternar páginas, consulte as informações na página do PDF Endpoints e cotas.
-
Para verificar a disponibilidade do serviço de forma programática usando o SDK para Java, consulte Verificar a disponibilidade do serviço em uma região no Guia do desenvolvedor do AWS SDK para Java .
-
Para visualizar programaticamente as informações de região e serviço usando o Systems Manager, consulte Chamando parâmetros públicos para AWS serviços, regiões, endpoints e zonas no armazenamento de parâmetros no Guia do AWS Systems Manager usuário. Para obter informações sobre como usar parâmetros públicos, consulte Consulta de AWS regiões, endpoints e muito mais usando o AWS Systems Manager Parameter Store
. -
Para ver os AWS serviços suportados em cada região (sem endpoints), consulte a tabela de regiões
de .
Endpoints do FIPS
Alguns AWS serviços oferecem endpoints compatíveis com o Padrão Federal de Processamento de Informações (FIPS) 140 em algumas regiões. Diferentemente dos AWS endpoints padrão, os endpoints FIPS usam uma biblioteca de software TLS compatível com o FIPS 140. Esses endpoints podem ser necessários por empresas que interagem com o governo dos Estados Unidos.
Para especificar um endpoint FIPS ao chamar uma AWS operação, use um mecanismo fornecido pela ferramenta que você está usando para fazer a chamada. Por exemplo, eles AWS SDKs fornecem os seguintes mecanismos para usar endpoints FIPS:
-
Definir a variável de ambiente
AWS_USE_FIPS_ENDPOINTcomotrue. -
Adicionar
use_fips_endpoint=trueao seu arquivo~/.aws/config
Para obter informações sobre o suporte a endpoints FIPS em AWS SDKs, consulte endpoints de pilha dupla e FIPS no Guia de referência de ferramentas.AWS SDKs
AWS Command Line Interface Ele suporta os mecanismos anteriores e também fornece a --endpoint-url opção. O exemplo a seguir é usado --endpoint-url para especificar o endpoint FIPS para AWS Key Management Service (AWS KMS) na região Oeste dos EUA (Oregon).
aws kms create-key --endpoint-url https://kms-fips.us-west-2.amazonaws.comPara obter uma lista de endpoints FIPS, consulte Endpoints FIPS por serviço
Versão mínima do TLS para endpoints FIPS
Com endpoints FIPS, o requisito mínimo é o TLS 1.2. Recomendamos o TLS 1.3. Para determinar se seus aplicativos foram afetados por essa alteração, consulte esta postagem no blog AWS
de segurança
Endpoints de pilha dupla
Alguns Serviços da AWS oferecem endpoints de pilha dupla, para que você possa acessá-los usando uma IPv4 ou IPv6 mais solicitações. Em geral, a sintaxe de um endpoint de pilha dupla é a seguinte:
protocol://service-code.region-code.api.awsNo entanto, o Amazon S3 usa a seguinte sintaxe para endpoints de pilha dupla do Amazon S3:
protocol://service-code.dualstack.region-code.amazonaws.comPara fazer uma solicitação para um endpoint de pilha dupla, use o mecanismo fornecido pela ferramenta ou pelo AWS SDK para especificar o endpoint. Para obter informações sobre o suporte a endpoints de pilha dupla em AWS SDKs, consulte endpoints de pilha dupla e FIPS no Guia de referência de ferramentas.AWS SDKs
O AWS CLI fornece a --endpoint-url opção. O exemplo a seguir usa --endpoint-url para especificar o endpoint de pilha dupla para o Amazon EC2 na região Oeste dos EUA (Oregon).
aws ec2 describe-regions --region us-west-2 --endpoint-url https://ec2.us-west-2.api.awsPara usar o AWS CLI para configurar endpoints de pilha dupla para todos Serviços da AWS, consulte Configurar para usar endpoints de pilha dupla para todos no Guia do usuário. Serviços da AWSAWS Command Line Interface
Para obter uma lista de serviços que oferecem suporte a endpoints de pilha dupla, consulte Serviços da AWS esse suporte. IPv6
Saiba mais
É possível encontrar informações sobre os endpoints nas seguintes fontes:
-
Para ativar regiões que estão desativadas por padrão, consulte Ativar ou desativar Regiões da AWS em sua conta no Guia de AWS Gerenciamento de contas referência.
-
Para obter informações sobre os endpoints Serviços da AWS e disponíveis nas regiões da China, consulte Endpoints da região da China (Pequim) e Endpoints da região
da China (Ningxia) .
