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 AWS CLI et SDK 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 Amazon S3 APIs et est conçue pour stocker des données de manière durable et redondante sur plusieurs appareils et serveurs de votre entreprise. AWS Outposts Vous communiquez avec votre bucket Outpost en utilisant un point d'accès et une connexion de point de terminaison via un cloud privé virtuel (VPC). Vous pouvez utiliser les mêmes fonctionnalités sur APIs les compartiments Outpost que sur les compartiments Amazon S3, notamment les politiques d'accès, le chiffrement et le balisage. Vous pouvez utiliser S3 sur les Outposts via le AWS Management Console, AWS Command Line Interface (AWS CLI) AWS SDKs, ou. REST API Pour plus d’informations, consultez 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 en utilisant AWS CLI et SDK pour Java. Pour commencer à utiliser la console, veuillez consulter Commencer par utiliser le AWS Management Console.
Étape 1 : Créer un compartiment
Les exemples suivants, AWS CLI ainsi que ceux SDK relatifs à 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 bucket S3 on Outposts (s3-outposts:CreateBucket) à l'aide de 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 de AWS CLI et 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-styleadressage.
- 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 suivant SDK pour Java crée un point d'accès pour un bucket 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) de votre Outpost peut être associé à un point de terminaison. 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 de plus amples informations, veuillez consulter Points de terminaison.
Ces exemples vous montrent comment créer un point de terminaison à l'aide de AWS CLI et 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 avant-poste en utilisant le type d'accès aux VPC ressources. 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 suivant SDK pour Java crée 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
