Endpoints de serviço de APIs diretas do EBS

Um endpoint é uma URL que funciona como ponto de entrada para um serviço da Web da AWS. As APIs diretas do EBS são compatíveis com os seguintes tipos de endpoint:

• Endpoints IPv4

• Endpoints de pilha dupla que são compatíveis com IPv4 e IPv6

• Endpoints do FIPS

Ao fazer uma solicitação, você pode especificar o endpoint e a região a serem usados. 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 obter mais informações sobre regiões, consulte Regiões e zonas de disponibilidade no Manual do usuário do para instâncias do Linux Amazon EC2. Para obter uma lista de endpoints para APIs diretas do EBS, consulte Endpoints para as APIs diretas do EBS no Referência geral da Amazon Web Services.

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, ebs.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 ebs.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:

• ebs.region.amazonaws.com

Por exemplo, o nome do endpoint IPv4 para a região us-west-1 é ebs.us-west-1.amazonaws.com. Para obter uma lista de endpoints para APIs diretas do EBS, consulte Endpoints para as APIs diretas do EBS no Referência geral da Amazon Web Services.

Definição de preço

Você não é cobrado por dados transferidos diretamente entre APIs diretas do EBS e instâncias do Amazon EC2 usando um endpoint IPv4 na mesma região. No entanto, se houver serviços intermediários, como endpoints AWS PrivateLink, NAT Gateway ou Amazon VPC Transit Gateways, serão cobrados os custos associados.

Endpoints de pilha dupla (IPv4 e IPv6)

Endpoints de pilha dupla são compatíveis com tráfego IPv4 e IPv6. Os endpoints de pilha dupla estão disponíveis em todas as regiões.

Para usar o IPv6, você deve usar um endpoint de pilha dupla. 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.

As APIs diretas do EBS são compatíveis apenas com endpoints de pilha dupla regionais, o que significa que você deve especificar a região como parte do nome do endpoint. Os nomes de endpoints de pilha dupla usam a seguinte convenção de nomenclatura:

• ebs.region.api.aws

Por exemplo, o nome do endpoint de pilha dupla para a região eu-west-1 é ebs.eu-west-1.api.aws. Para obter uma lista de endpoints para APIs diretas do EBS, consulte Endpoints para as APIs diretas do EBS no Referência geral da Amazon Web Services.

Definição de preço

Você não é cobrado por dados transferidos diretamente entre APIs diretas do EBS e instâncias do Amazon EC2 usando um endpoint de pilha dupla na mesma região. No entanto, se houver serviços intermediários, como endpoints AWS PrivateLink, NAT Gateway ou Amazon VPC Transit Gateways, serão cobrados os custos associados.

Endpoints do FIPS

As APIs diretas do EBS fornecem endpoints IPv4 e de pilha dupla (IPv4 e IPv6) validados pelo FIPS para as seguintes regiões:

• us-east-1 - Leste dos EUA (Norte da Virgínia):

• us-east-2 - Leste dos EUA (Ohio)

• us-west-1 - Oeste dos EUA (N. da Califórnia)

• us-west-2 - Oeste dos EUA (Oregon):

• ca-central-1 - Canadá (Central)

Endpoints FIPS IPv4 usam a seguinte convenção de nomenclatura: ebs-fips.region.amazonaws.com. Por exemplo, o endpoint FIPS IPv4 para us-east-1 é ebs-fips.us-east-1.amazonaws.com.

Endpoints FIPS de pilha dupla usam a seguinte convenção de nomenclatura: ebs-fips.region.api.aws. Por exemplo, o endpoint FIPS de pulha dupla para us-east-1 é ebs-fips.us-east-1.api.aws.

Para obter mais informações sobre endpoints do FIPS, consulte Endpoints do FIPS no Referência geral da Amazon Web Services.

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 deus-east-2 usando o AWS CLI.

• Pilha dupla

  aws ebs list-snapshot-blocks --snapshot-id snap-0987654321 --starting-block-index 1000 --endpoint-url https://ebs.us-east-2.api.aws

• IPv4

  aws ebs list-snapshot-blocks --snapshot-id snap-0987654321 --starting-block-index 1000 --endpoint-url https://ebs.us-east-2.amazonaws.com

AWS SDK for Java 2.x

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

• Pilha dupla

  AwsClientBuilder.EndpointConfiguration config = new AwsClientBuilder.EndpointConfiguration("https://ebs.us-east-2.api.aws", "us-east-2");
  AmazonEBS ebs = AmazonEBSClientBuilder.standard()
      .withEndpointConfiguration(config)
      .build();

• IPv4

  AwsClientBuilder.EndpointConfiguration config = new AwsClientBuilder.EndpointConfiguration("https://ebs.us-east-2.amazonaws.com", "us-east-2");
  AmazonEBS ebs = AmazonEBSClientBuilder.standard()
      .withEndpointConfiguration(config)
      .build();

AWS SDK for Go

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

• Pilha dupla

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

• IPv4

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