Utilisation de S3 sur les points de terminaison à double pile d'Outposts - Amazon S3 on Outposts
Points de terminaison Dual-StackUtilisation des points de terminaison Dual-Stack (AWS CLI)Utilisation des points de terminaison Dual-Stack (AWS SDKs)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de S3 sur les points de terminaison à double pile d'Outposts

Les points de terminaison à double pile S3 on Outposts prennent en charge les demandes adressées à S3 on Outposts sur et. IPv6 IPv4 Cette section décrit comment utiliser S3 sur les points de terminaison à double pile d'Outposts.

Points de terminaison à double pile S3 on Outposts

Lorsque vous envoyez une demande à un point de terminaison à double pile, le compartiment S3 on Outposts URL est résolu en IPv6 une ou IPv4 une adresse. Pour plus d'informations sur l'accès à un bucket S3 on Outposts viaIPv6, consultez. Envoyer des requêtes à S3 sur Outposts over IPv6

Pour accéder à un bucket S3 on Outposts via un point de terminaison à double pile, utilisez un nom de point de terminaison de type chemin. S3 on Outposts ne prend en charge que les noms de point de terminaison régionaux à double pile, ce qui signifie que vous devez spécifier la région dans le nom.

Pour un point de FIPs terminaison de type chemin à double pile, utilisez la convention de dénomination suivante :

s3-outposts-fips.region.api.aws

Pour les appareils non FIPS terminaux à double pile, utilisez la convention de dénomination suivante :

s3-outposts.region.api.aws
Note

Les noms de point de terminaison de type hébergé virtuel ne sont pas pris en charge dans S3 sur Outposts.

En utilisant des points de terminaison à double pile à partir du AWS CLI

Cette section fournit des exemples de AWS CLI commandes utilisées pour envoyer des demandes à un point de terminaison à double pile. Pour obtenir des instructions sur la configuration du AWS CLI, voirCommencer à utiliser AWS CLI et SDK pour Java.

Vous définissez la valeur de configuration use_dualstack_endpoint sur true dans un profil de votre AWS Config fichier pour diriger toutes les demandes Amazon S3 effectuées par les s3api AWS CLI commandes s3 and vers le point de terminaison à double pile pour la région spécifiée. Vous spécifiez la région dans le fichier de configuration ou dans une commande à l'aide de l'--regionoption.

Lorsque vous utilisez des points de terminaison à double pile avec le style d'adressage AWS CLI, seul le style d'pathadressage est pris en charge. Le style d'adressage, défini dans le fichier de configuration, détermine si le nom du bucket se trouve dans le nom d'hôte ou dans leURL. Pour plus d’informations, consultez .s3outposts dans le guide de l'utilisateur AWS CLI .

Pour utiliser un point de terminaison à double pile via le AWS CLI, utilisez le --endpoint-url paramètre avec le point de https://s3-outposts-fips.region.api.aws terminaison http://s3.dualstack.region.amazonaws.com ou pour toute s3outposts commande s3control or.

Par exemple :

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

Utilisation de S3 sur les points de terminaison à double pile d'Outposts à partir du AWS SDKs

Cette section fournit des exemples de la manière d'accéder à un point de terminaison à double pile à l'aide du AWS SDKs.

AWS SDK for Java 2.x Exemple de point de terminaison Dual-Stack (double pile) avec le kit

Les exemples suivants montrent comment utiliser les S3OutpostsClient classes S3ControlClient et pour activer les points de terminaison à double pile lors de la création d'un client S3 on Outposts à l'aide du. AWS SDK for Java 2.x Pour obtenir des instructions sur la création et le test d'un exemple Java fonctionnel pour Amazon S3 on Outposts, consultez. Commencer à utiliser AWS CLI et SDK pour Java

Exemple — Créez une S3ControlClient classe avec des points de terminaison à double pile activés
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();
        }
    }
}
Exemple — Créez un S3OutpostsClient avec des points de terminaison à double pile activés
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();
        }
    }
}

Si vous utilisez AWS SDK for Java 2.x le sous Windows, vous devrez peut-être définir la propriété de machine virtuelle Java (JVM) suivante : 

java.net.preferIPv6Addresses=true