HeadBucket À utiliser pour déterminer si un bucket S3 on Outposts existe et si vous disposez d'autorisations d'accès - Amazon S3 sur Outposts

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.

HeadBucket À utiliser pour déterminer si un bucket S3 on Outposts existe et si vous disposez d'autorisations d'accès

Les objets sont les entités fondamentales stockées dans Amazon S3 on Outposts. Chaque objet est contenu dans un compartiment. Vous devez utiliser des points d’accès pour accéder à tout objet dans un compartiment Outpost. Lorsque vous spécifiez le compartiment pour les opérations d’objet, vous utilisez l’Amazon Resource Name (ARN) du point d’accès ou l’alias de point d’accès. Pour plus d’informations sur les alias de point d’accès, consultez Utilisation d'un alias de type compartiment pour le point d'accès de votre compartiment S3 sur Outposts.

L'exemple suivant montre le format ARN pour les points d'accès S3 sur les Outposts, qui inclut le Région AWS code de la région dans laquelle l'Outpost est hébergé, l'ID, l' Compte AWS ID de l'Outpost et le nom du point d'accès :

arn:aws:s3-outposts:region:account-id:outpost/outpost-id/accesspoint/accesspoint-name

Pour plus d'informations sur S3 on Outposts ARNs, consultez. Ressource ARNs pour S3 sur les Outposts

Note

Avec Amazon S3 sur Outposts, les données des objets sont toujours stockées sur l’Outpost. Lorsque vous AWS installez un rack Outpost, vos données restent locales dans votre Outpost afin de répondre aux exigences de résidence des données. Vos objets ne quittent jamais votre Outpost et ne se trouvent pas dans un Région AWS. Comme il AWS Management Console est hébergé dans la région, vous ne pouvez pas utiliser la console pour télécharger ou gérer des objets dans votre Outpost. Cependant, vous pouvez utiliser l'API REST, AWS Command Line Interface (AWS CLI), et AWS SDKs pour télécharger et gérer vos objets via vos points d'accès.

Les AWS SDK pour Java exemples suivants AWS Command Line Interface (AWS CLI) vous montrent comment utiliser l'opération d' HeadBucketAPI pour déterminer si un bucket Amazon S3 on Outposts existe et si vous êtes autorisé à y accéder. Pour plus d’informations, consultez HeadBucket dans la Référence d’API Amazon Simple Storage Service.

L' AWS CLI exemple suivant de S3 on Outposts utilise la head-bucket commande pour déterminer si un bucket existe et si vous êtes autorisé à y accéder. Pour utiliser cette commande, remplacez chaque user input placeholder par vos propres informations. Pour de plus amples informations sur cette commande, veuillez consulter head-bucket dans le document AWS CLI Reference.

aws s3api head-bucket --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point

L'exemple suivant de S3 on Outposts montre comment déterminer si un compartiment existe et si vous avez l'autorisation d'y accéder. Pour utiliser cet exemple, spécifiez l'ARN du point d'accès pour l'Outpost. Pour plus d’informations, consultez HeadBucket dans la Référence d’API Amazon Simple Storage Service.

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.HeadBucketRequest;

public class HeadBucket {
    public static void main(String[] args) {
        String accessPointArn = "*** access point ARN ***";

        try {
            // This code expects that you have AWS credentials set up per:
            // https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html
            AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
                    .enableUseArnRegion()
                    .build();

            s3Client.headBucket(new HeadBucketRequest(accessPointArn));
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it, so it returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}