Menggunakan HeadBucket untuk menentukan apakah bucket S3 di Outposts ada dan Anda memiliki izin akses - Amazon S3 di Outposts

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan HeadBucket untuk menentukan apakah bucket S3 di Outposts ada dan Anda memiliki izin akses

Objek adalah entitas dasar yang disimpan di Amazon S3 di Outposts. Setiap objek dimuat dalam bucket. Anda harus menggunakan titik akses untuk mengakses objek apa pun dalam bucket Outposts. Saat menentukan bucket untuk operasi objek, Anda menggunakan titik akses Amazon Resource Name (ARN) atau alias titik akses. Untuk informasi selengkapnya tentang alias titik akses, lihat Menggunakan alias gaya bucket untuk titik akses bucket S3 di Outposts.

Contoh berikut menunjukkan ARN format untuk S3 pada jalur akses Outposts, yang mencakup Wilayah AWS kode untuk Wilayah tempat Pos Luar berada, Akun AWS ID, ID Outpost, dan nama titik akses:

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

Untuk informasi lebih lanjut tentang S3 di ARNs Outposts, lihat. Sumber daya ARNs untuk S3 di Outposts

catatan

Dengan Amazon S3 di Outposts, data objek selalu disimpan di Outpost. Saat AWS memasang rak Outpost, data Anda tetap lokal di Outpost Anda untuk memenuhi persyaratan residensi data. Objek Anda tidak akan meninggalkan Outpost dan tidak berada di Wilayah AWS. Karena di-host In-region, Anda tidak dapat menggunakan konsol untuk mengunggah atau mengelola objek di Outpost Anda. AWS Management Console Namun, Anda dapat menggunakan RESTAPI, AWS Command Line Interface (AWS CLI), dan AWS SDKs untuk mengunggah dan mengelola objek Anda melalui titik akses Anda.

Berikut AWS Command Line Interface (AWS CLI) dan AWS SDK for Java contoh menunjukkan cara menggunakan HeadBucket API operasi untuk menentukan apakah bucket Amazon S3 di Outposts ada dan apakah Anda memiliki izin untuk mengaksesnya. Untuk informasi selengkapnya, lihat HeadBucketdi APIReferensi Layanan Penyimpanan Sederhana Amazon.

Contoh S3 di AWS CLI Outposts berikut menggunakan head-bucket perintah untuk menentukan apakah ada bucket dan Anda memiliki izin untuk mengaksesnya. Untuk menggunakan perintah ini, ganti masing-masing user input placeholder dengan informasi Anda sendiri. Untuk informasi selengkapnya tentang perintah ini, lihat head-bucket dalam Referensi AWS CLI .

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

Contoh S3 di Outposts berikut menujukkan cara menentukan jika terdapat bucket dan jika Anda memiliki izin untuk mengaksesnya. Untuk menggunakan contoh ini, tentukan titik akses ARN untuk Outpost. Untuk informasi selengkapnya, lihat HeadBucketdi APIReferensi Layanan Penyimpanan Sederhana Amazon.

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