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.
Commencer à utiliser le SDK AWS CLI and pour Java
Avec Amazon S3 on Outposts, vous pouvez créer des compartiments S3 sur vos AWS Outposts et stocker et récupérer facilement des objets sur site pour les applications qui nécessitent un accès aux données locales, un traitement local des données et une résidence des données. S3 on Outposts fournit une nouvelle classe de stockage, S3 Outposts (OUTPOSTS), qui utilise les API Amazon S3 et est conçue pour stocker les données de manière durable et redondante sur plusieurs appareils et serveurs de votre entreprise. AWS Outposts Vous communiquez avec votre compartiment Outpost à l'aide d'un point d'accès et d'une connexion de point de terminaison via un cloud privé virtuel (VPC). Vous pouvez utiliser les mêmes API et fonctions sur vos compartiments Outpost que sur les compartiments Amazon S3, telles que les stratégies d'accès, le chiffrement et le balisage. Vous pouvez utiliser S3 sur Outposts via l'API AWS Management Console, AWS Command Line Interface (AWS CLI), les AWS SDK ou l'API REST. Pour de plus amples informations, veuillez consulter Qu'est-ce que Amazon S3 sur Outposts ?.
Pour démarrer avec S3 on Outposts, vous devez créer un compartiment, un point d'accès et un point de terminaison. Ensuite, vous pouvez charger des objets dans votre compartiment. Les exemples suivants vous montrent comment démarrer avec S3 sur Outposts à l'aide du SDK AWS CLI and pour Java. Pour commencer à utiliser la console, veuillez consulter Démarrage à l’aide de la AWS Management Console.
Étape 1 : Créer un compartiment
Les exemples suivants, AWS CLI ainsi que ceux du SDK pour Java, vous montrent comment créer un bucket S3 on Outposts.
- AWS CLI
-
L'exemple suivant crée un compartiment S3 on Outposts (s3-outposts:CreateBucket) à l'aide d' AWS CLI. Pour exécuter cette commande, remplacez user input
placeholders
aws s3control create-bucket --bucket example-outposts-bucket --outpost-id op-01ac5d28a6a232904
- SDK for Java
-
L'exemple suivant crée un compartiment S3 on Outposts (s3-outposts:CreateBucket) à l'aide du kit SDK for Java.
import com.amazonaws.services.s3control.model.*;
public String createBucket(String bucketName) {
CreateBucketRequest reqCreateBucket = new CreateBucketRequest()
.withBucket(bucketName)
.withOutpostId(OutpostId)
.withCreateBucketConfiguration(new CreateBucketConfiguration());
CreateBucketResult respCreateBucket = s3ControlClient.createBucket(reqCreateBucket);
System.out.printf("CreateBucket Response: %s%n", respCreateBucket.toString());
return respCreateBucket.getBucketArn();
}
Étape 2 : Créer un point d'accès
Pour accéder à votre compartiment Amazon S3 on Outposts, vous devez créer et configurer un point d'accès. Ces exemples vous montrent comment créer un point d'accès à l'aide du SDK AWS CLI et du SDK pour Java.
Les points d'accès simplifient la gestion de l'accès aux données à grande échelle pour les ensembles de données partagés dans Amazon S3. Les points d'accès sont des points de terminaison réseau associés à des compartiments que vous pouvez utiliser pour effectuer des opérations d'objet Amazon S3, notamment GetObject et PutObject. Avec S3 on Outposts, vous devez utiliser des points d'accès pour accéder à tout objet dans un compartiment Outposts. Les points d'accès ne prennent en charge que l' virtual-host-style adressage.
- AWS CLI
-
L' AWS CLI exemple suivant crée un point d'accès pour un bucket Outposts. Pour exécuter cette commande, remplacez user input placeholders
aws s3control create-access-point --account-id 123456789012 --name example-outposts-access-point --bucket "arn:aws:s3-outposts:region123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket" --vpc-configuration VpcId=example-vpc-12345
- SDK for Java
-
L'exemple de kit SDK pour Java suivant illustre la création d'un point d'accès pour un compartiment Outposts. Pour utiliser cet exemple, remplacez user input placeholders
import com.amazonaws.services.s3control.model.*;
public String createAccessPoint(String bucketArn, String accessPointName) {
CreateAccessPointRequest reqCreateAP = new CreateAccessPointRequest()
.withAccountId(AccountId)
.withBucket(bucketArn)
.withName(accessPointName)
.withVpcConfiguration(new VpcConfiguration().withVpcId("vpc-12345"));
CreateAccessPointResult respCreateAP = s3ControlClient.createAccessPoint(reqCreateAP);
System.out.printf("CreateAccessPoint Response: %s%n", respCreateAP.toString());
return respCreateAP.getAccessPointArn();
}
Étape 3 : Créer un point de terminaison
Pour acheminer les demandes vers un point d'accès Amazon S3 on Outposts, vous devez créer et configurer un point de terminaison S3 on Outposts. Pour créer un point de terminaison, vous devrez disposer d'une connexion active avec votre lien de service vers votre région d'accueil Outpost. Chaque cloud privé virtuel (VPC) sur votre Outpost peut avoir un point de terminaison associé. Pour plus d'informations sur les quotas de points de terminaison, consultez Exigences réseau de S3 on Outposts. Vous devez créer un point de terminaison pour pouvoir accéder à vos compartiments Outpost et effectuer des opérations d'objet. Pour plus d’informations, consultez Points de terminaison.
Ces exemples vous montrent comment créer un point de terminaison à l'aide du SDK AWS CLI et du SDK pour Java. Pour de plus amples informations sur les autorisations requises pour créer et gérer des points de terminaison, veuillez consulter Autorisations pour les points de terminaison S3 on Outposts.
- AWS CLI
-
L' AWS CLI exemple suivant crée un point de terminaison pour un Outpost en utilisant le type d'accès aux ressources VPC. Le VPC est dérivé du sous-réseau. Pour exécuter cette commande, remplacez user input placeholders
aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1
L' AWS CLI exemple suivant crée un point de terminaison pour un Outpost en utilisant le type d'accès au pool d'adresses IP (pool CoIP) appartenant au client. Pour exécuter cette commande, remplacez user input placeholders
aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1 --access-type CustomerOwnedIp --customer-owned-ipv4-pool ipv4pool-coip-12345678901234567
- SDK for Java
-
L'exemple de kit SDK pour Java suivant illustre la création d'un point de terminaison pour un Outpost. Pour utiliser cet exemple, remplacez user input placeholders
import com.amazonaws.services.s3outposts.AmazonS3Outposts;
import com.amazonaws.services.s3outposts.AmazonS3OutpostsClientBuilder;
import com.amazonaws.services.s3outposts.model.CreateEndpointRequest;
import com.amazonaws.services.s3outposts.model.CreateEndpointResult;
public void createEndpoint() {
AmazonS3Outposts s3OutpostsClient = AmazonS3OutpostsClientBuilder
.standard().build();
CreateEndpointRequest createEndpointRequest = new CreateEndpointRequest()
.withOutpostId("op-0d79779cef3c30a40")
.withSubnetId("subnet-8c7a57c5")
.withSecurityGroupId("sg-ab19e0d1")
.withAccessType("CustomerOwnedIp")
.withCustomerOwnedIpv4Pool("ipv4pool-coip-12345678901234567");
// Use .withAccessType and .withCustomerOwnedIpv4Pool only when the access type is
// customer-owned IP address pool (CoIP pool)
CreateEndpointResult createEndpointResult = s3OutpostsClient.createEndpoint(createEndpointRequest);
System.out.println("Endpoint is created and its ARN is " + createEndpointResult.getEndpointArn());
}
Étape 4 : Charger un objet dans un compartiment S3 on Outposts
Pour charger un objet, consultez Charger un objet dans un compartiment S3 on Outposts
