Endpoint di servizio delle API dirette EBS

Un endpoint è un URL che funge da punto di ingresso per un servizio Web. AWS Le API dirette EBS supportano i seguenti tipi di endpoint:

• Endpoint IPv4

• Endpoint dual-stack che supportano sia IPv4 sia IPv6

• Endpoint FIPS

Quando si effettua una richiesta, è possibile specificare l'endpoint e la Regione da utilizzare. Se non specifichi un endpoint, per impostazione predefinita viene utilizzato l'endpoint IPv4. Per utilizzare un tipo di endpoint diverso, devi specificarlo nella richiesta. Per esempi su come eseguire questa operazione, consulta Specificazione degli endpoint.

Per maggiori informazioni sulle Regioni, consulta la pagina Regioni e zone di disponibilità nella Guida per l'utente di Amazon EC2 per le istanze Linux. Per un elenco degli endpoint per le API dirette EBS, consulta la sezione Endpoint per le API dirette EBS nella Riferimenti generali di Amazon Web Services.

Endpoint IPv4

Gli endpoint IPv4 supportano solo il traffico IPv4. Gli endpoint IPv4 sono disponibili per tutte le Regioni.

Se specifichi l'endpoint generico, ebs.amazonaws.com, utilizziamo l'endpoint per us-east-1. Per utilizzare una Regione diversa, specifica l'endpoint associato. Ad esempio, se specifichi ebs.us-east-2.amazonaws.com come endpoint, indirizzeremo la tua richiesta all'endpoint us-east-2.

I nomi degli endpoint IPv4 usano la seguente convenzione di denominazione:

• ebs.region.amazonaws.com

Ad esempio, il nome dell'endpoint IPv4 per la Regione us-west-1 è ebs.us-west-1.amazonaws.com. Per un elenco degli endpoint per le API dirette EBS, consulta la sezione Endpoint per le API dirette EBS nella Riferimenti generali di Amazon Web Services.

Prezzi

Per i dati trasferiti direttamente tra le API dirette EBS e le istanze Amazon EC2 utilizzando un endpoint IPv4 all'interno della stessa Regione non ti vengono addebitati costi. Tuttavia, se sono presenti servizi intermedi, come AWS PrivateLink endpoint, NAT Gateway o Amazon VPC Transit Gateway, ti verranno addebitati i relativi costi associati.

Endpoint dual-stack (IPv4 e IPv6)

Gli endpoint dual-stack supportano sia il traffico IPv4 sia il traffico IPv6. Gli endpoint dual-stack sono disponibili per tutte le Regioni.

Per utilizzare IPv6, è necessario utilizzare un endpoint dual-stack. Quando effettui una richiesta a un endpoint dual-Stack, l'URL dell'endpoint risolve a un indirizzo IPv6 o IPv4 a seconda del protocollo utilizzato dalla rete e dal client.

Le API dirette EBS supportano solo i nomi di endpoint dual-stack regionali, il che significa che è necessario specificare la Regione come parte del nome dell'endpoint. I nomi degli endpoint dual-stack usano la seguente convenzione di denominazione:

• ebs.region.api.aws

Ad esempio, il nome dell'endpoint dual-stack per la Regione eu-west-1 è ebs.eu-west-1.api.aws. Per un elenco degli endpoint per le API dirette EBS, consulta la sezione Endpoint per le API dirette EBS nella Riferimenti generali di Amazon Web Services.

Prezzi

Per i dati trasferiti direttamente tra le API dirette EBS e le istanze Amazon EC2 utilizzando un endpoint dual-stack all'interno della stessa Regione non ti vengono addebitati costi. Tuttavia, se sono presenti servizi intermedi, come AWS PrivateLink endpoint, NAT Gateway o Amazon VPC Transit Gateway, ti verranno addebitati i relativi costi associati.

Endpoint FIPS

Le API dirette EBS forniscono endpoint IPv4 e dual-stack (IPv4 e IPv6) convalidati FIPS per le seguenti Regioni:

• us-east-1: Stati Uniti orientali (Virginia settentrionale)

• us-east-2: Stati Uniti orientali (Ohio)

• us-west-1: Stati Uniti occidentali (California settentrionale)

• us-west-2: Stati Uniti occidentali (Oregon)

• ca-central-1: Canada (Centrale)

Gli endpoint IPv4 FIPS usano la seguente convenzione di denominazione: ebs-fips.region.amazonaws.com. Ad esempio, l'endpoint IPv4 FIPS per us-east-1 è ebs-fips.us-east-1.amazonaws.com.

Gli endpoint dual-stack FIPS usano la seguente convenzione di denominazione: ebs-fips.region.api.aws. Ad esempio, l'endpoint dual-stack FIPS per us-east-1 è ebs-fips.us-east-1.api.aws.

Per ulteriori informazioni sugli endpoint FIPS, consulta Endpoint FIPS nella Riferimenti generali di Amazon Web Services.

Specificazione degli endpoint

Questa sezione fornisce alcuni esempi di come specificare un endpoint quando si effettua una richiesta.

AWS CLI

Gli esempi seguenti mostrano come specificare un endpoint per la Regione us-east-2 utilizzando AWS CLI.

• Dual-stack

  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

Gli esempi seguenti mostrano come specificare un endpoint per la Regione us-east-2 utilizzando AWS SDK for Java 2.x.

• Dual-stack

  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

Gli esempi seguenti mostrano come specificare un endpoint per la Regione us-east-2 utilizzando AWS SDK for Go.

• Dual-stack

  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")
  })