Utilizzato HeadBucket per determinare se esiste un bucket S3 on Outposts e disponi delle autorizzazioni di accesso - Amazon S3 su Outposts

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzato HeadBucket per determinare se esiste un bucket S3 on Outposts e disponi delle autorizzazioni di accesso

Gli oggetti sono le entità fondamentali archiviate in Amazon S3 su Outposts. Ogni oggetto è contenuto in un bucket. È necessario utilizzare i punti di accesso per accedere a qualsiasi oggetto in un bucket Outpost. Quando specifichi il bucket per le operazioni sugli oggetti, usi il punto di accesso Amazon Resource Name (ARN) o l'alias del punto di accesso. Per ulteriori informazioni sugli alias del punto di accesso, consulta Utilizzo di un alias in stile bucket per il punto di accesso del bucket S3 su Outposts.

L'esempio seguente mostra il ARN formato per S3 sui punti di accesso Outposts, che include Regione AWS il codice per la regione in cui risiede l'Outpost, l'ID, Account AWS l'ID Outpost e il nome del punto di accesso:

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

Per ulteriori informazioni su S3 on ARNs Outposts, consulta. Risorsa ARNs per S3 su Outposts

Nota

Con Amazon S3 su Outposts, i dati degli oggetti vengono sempre archiviati nell'Outpost. Quando si AWS installa un rack Outpost, i dati rimangono locali rispetto a Outpost per soddisfare i requisiti di residenza dei dati. I tuoi oggetti non lasciano mai il tuo Outpost e non sono in una Regione AWS. Poiché AWS Management Console è ospitato in una regione, non puoi utilizzare la console per caricare o gestire oggetti in Outpost. Tuttavia, puoi usare RESTAPI, AWS Command Line Interface (AWS CLI) e AWS SDKs per caricare e gestire i tuoi oggetti tramite i tuoi punti di accesso.

I seguenti AWS Command Line Interface (AWS CLI) ed AWS SDK for Java esempi mostrano come utilizzare l' HeadBucketAPIoperazione per determinare se esiste un bucket Amazon S3 on Outposts e se disponi dell'autorizzazione per accedervi. Per ulteriori informazioni, consulta HeadBucketAmazon Simple Storage Service API Reference.

Il seguente esempio di S3 on AWS CLI Outposts utilizza head-bucket il comando per determinare se esiste un bucket e se si dispone delle autorizzazioni per accedervi. Per eseguire questo comando, sostituire user input placeholder con le proprie informazioni. Per ulteriori informazioni su questo comando, consulta head-bucket nella Guida di riferimento di AWS CLI .

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

Nell'esempio S3 su Outposts seguente viene illustrato come determinare se esiste un bucket e sono disponibili le autorizzazioni per accedervi. Per utilizzare questo esempio, specifica il punto ARN di accesso per Outpost. Per ulteriori informazioni, consulta HeadBucketAmazon Simple Storage Service API Reference.

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();
        }
    }
}