Bien démarrer avec l'interface AWS CLI et le kit SDK pour Java - Amazon S3 sur Outposts

Bien démarrer avec l'interface AWS CLI et le kit SDK pour Java

Avec Amazon S3 sur Outposts, vous pouvez créer des compartiments S3 sur votre AWS Outposts afin de stocker et récupérer facilement des objets sur site pour des 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 sur Outposts propose une nouvelle classe de stockage, appelée S3 Outposts (OUTPOSTS), qui utilise les API Amazon S3 et est conçue pour stocker de manière durable et redondante des données sur plusieurs appareils et serveurs sur vos 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 la AWS Management Console, l’AWS Command Line Interface (AWS CLI), des kits AWS SDK ou une API REST. 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 on Outposts en utilisant l’AWS CLI et le kit SDK 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 pour AWS CLI et le kit SDK pour Java vous montrent comment créer un compartiment 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 les user input placeholders par vos propres informations.

aws s3control create-bucket --bucket example-outposts-bucket --outpost-id op-01ac5d28a6a232904
SDK for Java

Pour des exemples de création d’un compartiment S3 Outposts avec le kit AWS SDK pour Java, consultez CreateOutpostsBucket.java dans les Exemples de code du kit AWS SDK pour Java 2.x.

Étape 2 : Créer un point d'accès

Pour accéder à votre compartiment Amazon S3 sur 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 l’AWS CLI et du kit 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 prennent uniquement en charge l’adressage de type hôte virtuel.

AWS CLI

L'exemple AWS CLI suivant crée un point d'accès pour un compartiment Outposts. Pour exécuter cette commande, remplacez les user input placeholders par vos propres informations.

aws s3control create-access-point --account-id 123456789012 --name example-outposts-access-point --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket" --vpc-configuration VpcId=example-vpc-12345
SDK for Java

Pour des exemples de création d’un point d’accès pour un compartiment S3 Outposts avec le kit AWS SDK pour Java, consultez CreateOutpostsAccessPoint.java dans les Exemples de code du kit AWS SDK pour Java 2.x.

Étape 3 : Créer un point de terminaison

Pour acheminer les demandes vers un point d’accès Amazon S3 sur Outposts, vous devez créer et configurer un point de terminaison S3 sur 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 de l’AWS CLI et du kit 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 sur Outposts.

AWS CLI

L’exemple d’AWS CLI suivant crée un point de terminaison pour un Outpost à l’aide du type d’accès aux ressources VPC. Le VPC est dérivé du sous-réseau. Pour exécuter cette commande, remplacez les user input placeholders par vos propres informations.

aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1

L’exemple AWS CLI suivant crée un point de terminaison pour un Outpost à l’aide du type d’accès au groupe d’adresses IP clients (groupe CoIP). Pour exécuter cette commande, remplacez les user input placeholders par vos propres informations.

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

Pour des exemples de création d’un point de terminaison pour un S3 Outpost avec le kit AWS SDK pour Java, consultez CreateOutpostsEndPoint.java dans les Exemples de code du kit AWS SDK pour Java 2.x.

Étape 4 : Charger un objet dans un compartiment S3 on Outposts

Pour charger un objet, consultez Chargement d’un objet dans un compartiment S3 sur Outposts.