Endpoints de serviço das 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:

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 as regiões, consulte Regiões e zonas de disponibilidade no Manual do usuário do 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.

As APIs diretas do EBS só são compatíveis com os endpoints IPv4 regionais que você pode usar para fazer suas solicitações. Você deve especificar a região como parte do nome do endpoint. Os nomes de endpoint usam a seguinte convenção de nomenclatura:

Por exemplo, para dirigir suas solicitações para o endpoint IPv4 us-east-2, você deve especificar ebs.us-east-2.amazonaws.com como o endpoint. 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.

Preços

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:

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.

Preços

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:

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 para Go.

• Pilha dupla

  sess := session.Must(session.NewSession())
  svc := ebs.New(sess, &aws.Config{
      Region: aws.String(endpoints.UsEast2RegionID),
      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.UsEast2RegionID),
      Endpoint: aws.String("https://ebs.us-east-2.amazonaws.com")
  })