Utilizzo degli endpoint dual-stack S3 su Outposts - Amazon S3 su Outposts.
Endpoint dual-stackUtilizzo degli endpoint dual-stack (AWS CLI)Utilizzo degli endpoint dual-stack (SDK AWS)

Utilizzo degli endpoint dual-stack S3 su Outposts

Gli endpoint dual-stack S3 su Outposts supportano le richieste ai bucket S3 su Outposts su IPv6 e IPv4. In questa sezione viene descritto come utilizzare gli endpoint dual-stack S3 su Outposts.

Endpoint dual-stack S3 su Outposts

Quando si effettua una richiesta a un endpoint dual-stack, l'URL del bucket S3 su Outposts restituisce un indirizzo IPv6 o IPv4. Per ulteriori informazioni sull'accesso a un bucket S3 su Outposts su IPv6, consulta Esecuzione di richieste a S3 su Outposts su IPv6.

Per accedere a un bucket S3 su Outposts tramite un endpoint dual-stack, usare un nome di endpoint in stile percorso. S3 su Outposts supporta solo i nomi di endpoint dual-stack regionali, il che significa che è necessario specificare la Regione come parte del nome.

Gli endpoint dual-stack FIPS in stile percorso usano la seguente convenzione di denominazione:

s3-outposts-fips.region.api.aws

Gli endpoint dual-stack non FIPS usano la seguente convenzione di denominazione:

s3-outposts.region.api.aws
Nota

I nomi degli endpoint in stile hosting virtuale non sono supportati in S3 su Outposts.

Utilizzo degli endpoint dual-stack dall AWS CLI

In questa sezione vengono forniti esempi dei comandi dell'AWS CLI utilizzati per effettuare le richieste a un endpoint dual-stack. Per istruzioni sull'impostazione di AWS CLI, consulta Nozioni di base tramite l'utilizzo di AWS CLI e SDK per Java.

Impostare il valore di configurazione use_dualstack_endpoint su true in un profilo nel file AWS Config per indirizzare tutte le richieste Amazon S3 effettuate dai comandi s3 e s3api di AWS CLI all'endpoint dual-stack per la Regione specificata. La Regione va specificata nel file di configurazione o in un comando tramite l'opzione --region.

Quando si utilizzano gli endpoint dual-stack con AWS CLI, è supportato solo lo stile di indirizzamento path. Lo stile di indirizzamento, impostato nel file di configurazione, determina se il nome del bucket si trova nel nome host o nell'URL. Per ulteriori informazioni, consulta s3outposts nella AWS CLI Guida per l'utente.

Per utilizzare un endpoint dual-stack tramite AWS CLI, usare il parametro --endpoint-url con l'endpoint http://s3.dualstack.region.amazonaws.com o https://s3-outposts-fips.region.api.aws per qualsiasi comando s3control o s3outposts.

Ad esempio:

$  aws s3control list-regional-buckets --endpoint-url https://s3-outposts.region.api.aws

Utilizzo degli endpoint dual-stack S3 su Outposts dagli SDK AWS

In questa sezione vengono forniti esempi su come accedere all'endpoint dual-stack tramite gli SDK AWS.

AWS SDK for Java 2.xEsempio di endpoint Dual-Stack con

Negli esempi seguenti viene mostrato come usare le classi S3ControlClient e S3OutpostsClient per abilitare gli endpoint dual-stack durante la creazione di un client S3 su Outposts tramite AWS SDK for Java 2.x. Per istruzioni su come creare e testare un esempio Java funzionante per Amazon S3 su Outposts, consulta Nozioni di base tramite l'utilizzo di AWS CLI e SDK per Java.

Esempio - Creare una classe S3ControlClient con gli endpoint dual-stack abilitati
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListRegionalBucketsRequest;
import software.amazon.awssdk.services.s3control.model.ListRegionalBucketsResponse;
import software.amazon.awssdk.services.s3control.model.S3ControlException;


public class DualStackEndpointsExample1 {

    public static void main(String[] args) {
        Region clientRegion = Region.of("us-east-1");
        String accountId = "111122223333";
        String navyId = "9876543210";

        try {
            // Create an S3ControlClient with dual-stack endpoints enabled.
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                                                             .region(clientRegion)
                                                             .dualstackEnabled(true)
                                                             .build();
            ListRegionalBucketsRequest listRegionalBucketsRequest = ListRegionalBucketsRequest.builder()
                                                                                              .accountId(accountId)
                                                                                              .outpostId(navyId)
                                                                                              .build();

            ListRegionalBucketsResponse listBuckets = s3ControlClient.listRegionalBuckets(listRegionalBucketsRequest);
            System.out.printf("ListRegionalBuckets Response: %s%n", listBuckets.toString());
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 on Outposts couldn't process
            // it, so it returned an error response.
            e.printStackTrace();
        }
        catch (S3ControlException e) {
            // Unknown exceptions will be thrown as an instance of this type.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 on Outposts couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3 on Outposts.
            e.printStackTrace();
        }
    }
}
Esempio - Creare una classe S3OutpostsClient con gli endpoint dual-stack abilitati
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3outposts.S3OutpostsClient;
import software.amazon.awssdk.services.s3outposts.model.ListEndpointsRequest;
import software.amazon.awssdk.services.s3outposts.model.ListEndpointsResponse;
import software.amazon.awssdk.services.s3outposts.model.S3OutpostsException;


public class DualStackEndpointsExample2 {

    public static void main(String[] args) {
        Region clientRegion = Region.of("us-east-1");

        try {
            // Create an S3OutpostsClient with dual-stack endpoints enabled.
            S3OutpostsClient s3OutpostsClient = S3OutpostsClient.builder()
                                                              .region(clientRegion)
                                                              .dualstackEnabled(true)
                                                              .build();
            ListEndpointsRequest listEndpointsRequest = ListEndpointsRequest.builder().build();

            ListEndpointsResponse listEndpoints = s3OutpostsClient.listEndpoints(listEndpointsRequest);
            System.out.printf("ListEndpoints Response: %s%n", listEndpoints.toString());
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 on Outposts couldn't process
            // it, so it returned an error response.
            e.printStackTrace();
        }
        catch (S3OutpostsException e) {
            // Unknown exceptions will be thrown as an instance of this type.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 on Outposts couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3 on Outposts.
            e.printStackTrace();
        }
    }
}

Se si utilizza AWS SDK for Java 2.x in Windows, potrebbe essere necessario impostare la seguente proprietà Java Virtual Machine (JVM): 

java.net.preferIPv6Addresses=true