Endpoints IPv4 Dual-stack Pontos de extremidade (IPv4 e IPv6)Endpoints de serviço por região Especificar endpoints

Endpoints de serviço do Amazon EC2

Um endpoint é uma URL que serve como ponto de entrada para um serviço AWS web. O Amazon EC2 comporta os seguintes tipos de endpoint:

Endpoints IPv4
Dual-stack endpoints (suportam IPv4 e IPv6)
Endpoints do FIPS

Ao fazer uma solicitação, você pode especificar o endpoint a ser usado. Se você não especificar um endpoint, o endpoint IPv4 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 ver uma tabela de endpoints disponíveis, consulte Endpoints de serviço por região.

Endpoints IPv4

Endpoints IPv4 só são compatíveis com tráfego IPv4. Os endpoints IPv4 estão disponíveis em todas as regiões.

Se você especificar o endpoint geral, ec2.amazonaws.com, usaremos o endpoint para us-east-1. Para usar uma região diferente, especifique o endpoint associado a ela. Por exemplo, se você especificar ec2.us-east-2.amazonaws.com como endpoint, direcionaremos sua solicitação para o endpoint us-east-2.

Os nomes de endpoints IPv4 usam a seguinte convenção de nomenclatura:

service.region.amazonaws.com

Por exemplo, o nome do endpoint IPv4 para a região eu-west-1 é ec2.eu-west-1.amazonaws.com.

Dual-stack Pontos de extremidade (IPv4 e IPv6)

Dual-stack os endpoints suportam tráfego IPv4 e IPv6. Quando você realiza uma solicitação para um endpoint de pilha dupla, o URL do endpoint decide por um endereço IPv6 ou IPv4, dependendo do protocolo usado pela rede e pelo cliente.

O Amazon EC2 suporta somente endpoints regionais de pilha dupla, o que significa que você deve especificar a região como parte do nome do endpoint. Dual-stack os nomes de endpoints usam a seguinte convenção de nomenclatura:

ec2.region.api.aws

Por exemplo, o nome do endpoint de pilha dupla para a região eu-west-1 é ec2.eu-west-1.api.aws.

Endpoints de serviço por região

Veja a seguir os endpoints de serviço para o Amazon EC2. Para obter mais informações sobre regiões, consulte Regiões e zonas de disponibilidade no Manual do usuário do Amazon EC2.

Nome da região	Região	Endpoint	Protocolo
Leste dos EUA (Ohio)	us-east-2	ec2.us-east-2.amazonaws.com ec2-fips.us-east-2.amazonaws.com ec2.us-east-2.api.aws	HTTP e HTTPS HTTPS HTTPS
Leste dos EUA (Norte da Virgínia)	us-east-1	ec2.us-east-1.amazonaws.com ec2-fips.us-east-1.amazonaws.com ec2.us-east-1.api.aws	HTTP e HTTPS HTTPS HTTPS
Oeste dos EUA (N. da Califórnia)	us-west-1	ec2.us-west-1.amazonaws.com ec2-fips.us-west-1.amazonaws.com ec2.us-west-1.api.aws	HTTP e HTTPS HTTPS HTTPS
Oeste dos EUA (Oregon)	us-west-2	ec2.us-west-2.amazonaws.com ec2-fips.us-west-2.amazonaws.com ec2.us-west-2.api.aws	HTTP e HTTPS HTTPS HTTPS
África (Cidade do Cabo)	af-south-1	ec2.af-south-1.amazonaws.com ec2.af-south-1.api.aws	HTTP e HTTPS HTTPS
Ásia-Pacífico (Hong Kong)	ap-east-1	ec2.ap-east-1.amazonaws.com ec2.ap-east-1.api.aws	HTTP e HTTPS HTTPS
Ásia-Pacífico (Hyderabad)	ap-south-2	ec2.ap-south-2.amazonaws.com	HTTPS
Ásia-Pacífico (Jacarta)	ap-southeast-3	ec2.ap-southeast-3.amazonaws.com	HTTPS
Ásia-Pacífico (Malásia)	ap-southeast-5	ec2.ap-southeast-5.amazonaws.com	HTTPS
Ásia-Pacífico (Melbourne)	ap-southeast-4	ec2.ap-southeast-4.amazonaws.com	HTTPS
Ásia-Pacífico (Mumbai)	ap-south-1	ec2.ap-south-1.amazonaws.com ec2.ap-south-1.api.aws	HTTP e HTTPS HTTPS
Ásia-Pacífico (Nova Zelândia)	ap-southeast-6	ec2.ap-southeast-6.amazonaws.com	HTTPS
Ásia-Pacífico (Osaka)	ap-northeast-3	ec2.ap-northeast-3.amazonaws.com	HTTP e HTTPS
Ásia-Pacífico (Seul)	ap-northeast-2	ec2.ap-northeast-2.amazonaws.com ec2.ap-northeast-2.api.aws	HTTP e HTTPS HTTPS
Ásia-Pacífico (Singapura)	ap-southeast-1	ec2.ap-southeast-1.amazonaws.com ec2.ap-southeast-1.api.aws	HTTP e HTTPS HTTPS
Ásia-Pacífico (Sydney)	ap-southeast-2	ec2.ap-southeast-2.amazonaws.com ec2.ap-southeast-2.api.aws	HTTP e HTTPS HTTPS
Ásia-Pacífico (Taipei)	ap-east-2	ec2.ap-east-2.amazonaws.com	HTTPS
Ásia-Pacífico (Tailândia)	ap-southeast-7	ec2.ap-southeast-7.amazonaws.com	HTTPS
Ásia-Pacífico (Tóquio)	ap-northeast-1	ec2.ap-northeast-1.amazonaws.com ec2.ap-northeast-1.api.aws	HTTP e HTTPS HTTPS
Canadá (Central)	ca-central-1	ec2.ca-central-1.amazonaws.com ec2-fips.ca-central-1.amazonaws.com ec2.ca-central-1.api.aws	HTTP e HTTPS HTTPS HTTPS
Oeste do Canadá (Calgary)	ca-west-1	ec2.ca-west-1.amazonaws.com ec2-fips.ca-west-1.amazonaws.com	HTTPS HTTPS
Europa (Frankfurt)	eu-central-1	ec2.eu-central-1.amazonaws.com ec2.eu-central-1.api.aws	HTTP e HTTPS HTTPS
Europa (Irlanda)	eu-west-1	ec2.eu-west-1.amazonaws.com ec2.eu-west-1.api.aws	HTTP e HTTPS HTTPS
Europa (Londres)	eu-west-2	ec2.eu-west-2.amazonaws.com ec2.eu-west-2.api.aws	HTTP e HTTPS HTTPS
Europa (Milão)	eu-south-1	ec2.eu-south-1.amazonaws.com ec2.eu-south-1.api.aws	HTTP e HTTPS HTTPS
Europa (Paris)	eu-west-3	ec2.eu-west-3.amazonaws.com ec2.eu-west-3.api.aws	HTTP e HTTPS HTTPS
Europa (Espanha)	eu-south-2	ec2.eu-south-2.amazonaws.com	HTTPS
Europa (Estocolmo)	eu-north-1	ec2.eu-north-1.amazonaws.com ec2.eu-north-1.api.aws	HTTP e HTTPS HTTPS
Europa (Zurique)	eu-central-2	ec2.eu-central-2.amazonaws.com	HTTPS
Israel (Tel Aviv)	il-central-1	ec2.il-central-1.amazonaws.com	HTTPS
México (Central)	mx-central-1	ec2.mx-central-1.amazonaws.com	HTTPS
Oriente Médio (Barém)	me-south-1	ec2.me-south-1.amazonaws.com ec2.me-south-1.api.aws	HTTP e HTTPS HTTPS
Oriente Médio (Emirados Árabes Unidos)	me-central-1	ec2.me-central-1.amazonaws.com	HTTPS
América do Sul (São Paulo)	sa-east-1	ec2.sa-east-1.amazonaws.com ec2.sa-east-1.api.aws	HTTP e HTTPS HTTPS
AWS GovCloud (US-East)	us-gov-east-1	ec2.us-gov-east-1.amazonaws.com ec2.us-gov-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (US-West)	us-gov-west-1	ec2.us-gov-west-1.amazonaws.com ec2.us-gov-west-1.api.aws	HTTPS HTTPS

Especificar endpoints

Esta seção fornece alguns exemplos de como especificar um endpoint ao fazer uma solicitação.

AWS CLI

Os exemplos a seguir mostram como especificar um endpoint para a região us-east-2 usando o AWS CLI.

Dual-stack


aws ec2 describe-regions --region us-east-2 --endpoint-url https://ec2.us-east-2.api.aws

IPv4


aws ec2 describe-regions --region us-east-2 --endpoint-url https://ec2.us-east-2.amazonaws.com

AWS SDK for Java 2.x

Os exemplos a seguir mostram como especificar um endpoint para a região us-east-2 usando o AWS SDK for Java 2.x.

Dual-stack


Ec2Client client = Ec2Client.builder()
    .region(Region.US_EAST_2)
    .endpointOverride(URI.create("https://ec2.us-east-2.api.aws"))
    .build();

IPv4


Ec2Client client = Ec2Client.builder()
    .region(Region.US_EAST_2)
    .endpointOverride(URI.create("https://ec2.us-east-2.amazonaws.com"))
    .build();

AWS SDK para Java 1.x

Os exemplos a seguir mostram como especificar um endpoint para a eu-west-1 região usando o AWS SDK para Java 1.x.

Dual-stack


AmazonEC2 s3 = AmazonEC2ClientBuilder.standard()
     .withEndpointConfiguration(new EndpointConfiguration(
          "https://ec2.eu-west-1.api.aws",
          "eu-west-1"))
     .build();

IPv4


AmazonEC2 s3 = AmazonEC2ClientBuilder.standard()
     .withEndpointConfiguration(new EndpointConfiguration(
          "https://ec2.eu-west-1.amazonaws.com",
          "eu-west-1"))
     .build();

AWS SDK for Go

Os exemplos a seguir mostram como especificar um endpoint para a região us-east-1 usando o AWS SDK para Go.

Dual-stack


sess := session.Must(session.NewSession())
svc := ec2.New(sess, &aws.Config{
    Region: aws.String(endpoints.UsEast1RegionID),
    Endpoint: aws.String("https://ec2.us-east-1.api.aws")
})

IPv4


sess := session.Must(session.NewSession())
svc := ec2.New(sess, &aws.Config{
    Region: aws.String(endpoints.UsEast1RegionID),
    Endpoint: aws.String("https://ec2.us-east-1.amazonaws.com")
})

Convenções do documento

Acesso programático ao Amazon EC2

Consistência eventual