Obter um bucket do S3 on Outposts usando a AWS CLI e o SDK para Java

Com o Amazon S3 on Outposts, é possível criar buckets do S3 no AWS Outposts, além de armazenar e recuperar facilmente objetos no local para aplicações que exigem acesso a dados locais, processamento de dados local e residência de dados. O S3 on Outposts fornece uma nova classe de armazenamento, o S3 Outposts (OUTPOSTS), que usa as APIs do Amazon S3 e é projetado para armazenar dados de forma duradoura e redundante em vários dispositivos e servidores em seu AWS Outposts. Você se comunica com o bucket do Outposts usando um ponto de acesso e uma conexão de endpoint em uma nuvem privada virtual (VPC). É possível usar os mesmos recursos e APIs nos buckets do Outposts da mesma maneira que em buckets do Amazon S3, incluindo políticas de acesso, criptografia e marcação. Só é possível usar o S3 on Outposts por meio do AWS Management Console, da AWS Command Line Interface (AWS CLI), de AWS SDKs ou da API REST. Para obter mais informações, consulte O que é o Amazon S3 on Outposts?

Os exemplos a seguir mostram como obter um bucket do S3 on Outposts usando a AWS CLI e o AWS SDK para Java.

nota

Ao trabalhar com o Amazon S3 on Outposts por meio da AWS CLI ou de AWSSDKs, forneça o ARN do ponto de acesso do Outpost no lugar do nome do bucket. O ARN do ponto de acesso assume a forma a seguir, em que region é o código da Região da AWS em que se encontra o Outpost:

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

Para obter mais informações sobre o S3 on Outposts, consulte ARNs de recurso para S3 no Outposts.

Uso do AWS CLI

O exemplo do S3 on Outposts a seguir obtém um bucket usando a AWS CLI. Para usar esse comando, substitua cada user input placeholder por suas próprias informações. Para obter mais informações sobre esse comando, consulte get-bucket na Referência da AWS CLI.

aws s3control get-bucket --account-id 123456789012 --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket"

Usar o AWS SDK para Java

O exemplo do S3 no Outposts a seguir obtém um bucket usando o SDK para Java. Para obter mais informações, consulte GetBucket na Referência da API do Amazon Simple Storage Service.

import com.amazonaws.services.s3control.model.*;

public void getBucket(String bucketArn) {

    GetBucketRequest reqGetBucket = new GetBucketRequest()
            .withBucket(bucketArn)
            .withAccountId(AccountId);

    GetBucketResult respGetBucket = s3ControlClient.getBucket(reqGetBucket);
    System.out.printf("GetBucket Response: %s%n", respGetBucket.toString());

}