Membuat bucket direktori di Zona Lokal - Amazon Simple Storage Service

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

Membuat bucket direktori di Zona Lokal

Di Zona Lokal Khusus, Anda dapat membuat bucket direktori untuk menyimpan dan mengambil objek dalam perimeter data tertentu untuk membantu memenuhi kasus penggunaan residensi data dan isolasi data Anda. Bucket direktori S3 adalah satu-satunya jenis bucket yang didukung di Local Zones, dan berisi tipe lokasi bucket yang disebut. LocalZone Nama bucket direktori terdiri dari nama dasar yang Anda berikan dan akhiran yang berisi ID Zona lokasi bucket Anda dan--x-s3. Anda dapat memperoleh daftar Local Zone IDs dengan menggunakan operasi DescribeAvailabilityZonesAPI. Untuk informasi selengkapnya, lihat Aturan penamaan bucket direktori.

catatan
  • Untuk semua layanan di AWS Dedicated Local Zones (Dedicated Local Zones), termasuk S3, administrator Anda harus mengaktifkan Akun AWS sebelum Anda dapat membuat atau mengakses sumber daya apa pun di Zona Lokal Khusus. Untuk informasi selengkapnya, lihat Aktifkan akun untuk Local Zones.

  • Untuk persyaratan residensi data, sebaiknya aktifkan akses ke bucket Anda hanya dari titik akhir VPC gateway. Untuk informasi selengkapnya, lihat Konektivitas pribadi dari VPC Anda.

  • Untuk membatasi akses hanya dalam grup perbatasan jaringan Zona Lokal, Anda dapat menggunakan kunci kondisi s3express:AllAccessRestrictedToLocalZoneGroup dalam kebijakan IAM Anda. Untuk informasi selengkapnya, lihat Mengautentikasi dan mengotorisasi bucket direktori di Local Zones.

Berikut ini menjelaskan cara membuat bucket direktori dalam satu Zona Lokal dengan AWS Management Console, AWS CLI, dan AWS SDKs.

  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Di bilah navigasi di bagian atas halaman, pilih nama yang saat ini ditampilkan Wilayah AWS. Selanjutnya, pilih Wilayah induk dari Zona Lokal tempat Anda ingin membuat bucket direktori.

    catatan

    Untuk informasi selengkapnya tentang Wilayah induk, lihatKonsep untuk bucket direktori di Local Zones.

  3. Di panel navigasi kiri, pilih Bucket.

  4. Pilih Buat bucket.

    Halaman Buat bucket terbuka.

  5. Di bawah Konfigurasi umum, lihat Wilayah AWS tempat bucket Anda akan dibuat.

  6. Di bawah Jenis Bucket, pilih Direktori.

    catatan
    • Jika Anda telah memilih Region yang tidak mendukung bucket direktori, jenis bucket default ke bucket tujuan umum. Untuk membuat bucket direktori, Anda harus memilih Region yang didukung. Untuk daftar Wilayah yang mendukung bucket direktori, lihatTitik akhir regional dan Zonal untuk bucket direktori.

    • Setelah membuat bucket, Anda tidak dapat mengubah tipe bucket.

  7. Di bawah Lokasi Bucket, pilih Zona Lokal yang ingin Anda gunakan.

    catatan

    Zona Lokal tidak dapat diubah setelah bucket dibuat.

  8. Di bawah Lokasi Bucket, pilih kotak centang untuk mengetahui bahwa jika terjadi pemadaman Zona Lokal, data Anda mungkin tidak tersedia atau hilang.

    penting

    Meskipun bucket direktori disimpan di beberapa perangkat dalam satu Zona Lokal, bucket direktori tidak menyimpan data secara berlebihan di seluruh Local Zones.

  9. Untuk Nama bucket, masukkan nama untuk bucket direktori Anda.

    Untuk informasi selengkapnya tentang aturan penamaan untuk bucket direktori, lihatAturan penamaan ember tujuan umum. Sufiks secara otomatis ditambahkan ke nama dasar yang Anda berikan saat membuat bucket direktori menggunakan konsol. Akhiran ini mencakup ID Zona dari Zona Lokal yang Anda pilih.

    Setelah membuat bucket, Anda tidak dapat mengubah namanya.

    penting

    Jangan sertakan informasi sensitif, seperti nomor akun, dalam nama bucket. Nama ember terlihat di titik URLs itu ke objek di ember.

  10. Di bawah Kepemilikan Objek, setelan yang diberlakukan pemilik Bucket diaktifkan secara otomatis, dan semua daftar kontrol akses (ACLs) dinonaktifkan. Untuk bucket direktori, ACLs dinonaktifkan dan tidak dapat diaktifkan.

    Dengan mengaktifkan pengaturan yang diberlakukan oleh pemilik Bucket, pemilik bucket secara otomatis memiliki dan memiliki kontrol penuh atas setiap objek di bucket. ACLs tidak lagi memengaruhi izin akses ke data di bucket S3. Bucket menggunakan kebijakan secara eksklusif untuk menentukan kontrol akses. Mayoritas kasus penggunaan modern di Amazon S3 tidak lagi memerlukan penggunaan. ACLs Untuk informasi selengkapnya, lihat Mengontrol kepemilikan objek dan menonaktifkan ACLs bucket.

  11. Di bawah pengaturan Blokir Akses Publik untuk bucket ini, semua setelan Blokir Akses Publik untuk bucket direktori Anda diaktifkan secara otomatis. Pengaturan ini tidak dapat dimodifikasi untuk bucket direktori. Untuk informasi lebih lanjut tentang pemblokiran akses publik, lihat Melakukan blok akses publik ke penyimpanan Amazon S3 Anda.

  12. Di bawah enkripsi Default, bucket direktori menggunakan enkripsi sisi Server dengan kunci terkelola Amazon S3 (SSE-S3) untuk mengenkripsi data secara default. Anda juga memiliki opsi untuk mengenkripsi data dalam bucket direktori dengan enkripsi sisi Server dengan kunci (SSE-KMS). AWS Key Management Service

  13. Pilih Buat bucket.

    Setelah membuat bucket, Anda dapat menambahkan file dan folder ke bucket. Untuk informasi selengkapnya, lihat Bekerja dengan objek di dalam bucket direktori.

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS CLI. Untuk menggunakan perintah, ganti user input placeholders dengan informasi Anda sendiri.

Saat membuat bucket direktori, Anda harus memberikan detail konfigurasi dan menggunakan konvensi penamaan berikut:bucket-base-name--zone-id--x-s3.

aws s3api create-bucket --bucket bucket-base-name--zone-id--x-s3 --create-bucket-configuration 'Location={Type=LocalZone,Name=local-zone-id},Bucket={DataRedundancy=SingleLocalZone,Type=Directory}' --region parent-region-code

Untuk informasi selengkapnya tentang ID Zona Lokal dan Kode Wilayah Induk, lihatKonsep untuk bucket direktori di Local Zones. Untuk informasi selengkapnya tentang AWS CLI perintah, lihat create-bucket di Command Reference.AWS CLI

SDK for Go

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS SDK untuk Go.

var bucket = "bucket-base-name--zone-id--x-s3" // The full directory bucket name func runCreateBucket(c *s3.Client) { resp, err := c.CreateBucket(context.Background(), &s3.CreateBucketInput{ Bucket: &bucket, CreateBucketConfiguration: &types.CreateBucketConfiguration{ Location: &types.LocationInfo{ Name: aws.String("local-zone-id"), Type: types.LocationTypeLocalZone, }, Bucket: &types.BucketInfo{ DataRedundancy: types.DataRedundancySingleLocalZone, Type: types.BucketTypeDirectory, }, }, }) var terr *types.BucketAlreadyOwnedByYou if errors.As(err, &terr) { fmt.Printf("BucketAlreadyOwnedByYou: %s\n", aws.ToString(terr.Message)) fmt.Printf("noop...\n") // No operation performed, just printing a message return } if err != nil { log.Fatal(err) } fmt.Printf("bucket created at %s\n", aws.ToString(resp.Location)) }
SDK for Java 2.x

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS SDK for Java 2.x.

public static void createBucket(S3Client s3Client, String bucketName) { //Bucket name format is {base-bucket-name}--{local-zone-id}--x-s3 //example: doc-example-bucket--local-zone-id--x-s3 is a valid name for a directory bucket created in a Local Zone. CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder() .location(LocationInfo.builder() .type(LocationType.LOCAL_ZONE) .name("local-zone-id").build()) //this must match the Local Zone ID in your bucket name .bucket(BucketInfo.builder() .type(BucketType.DIRECTORY) .dataRedundancy(DataRedundancy.SINGLE_LOCAL_ZONE) .build()).build(); try { CreateBucketRequest bucketRequest = CreateBucketRequest.builder().bucket(bucketName).createBucketConfiguration(bucketConfiguration).build(); CreateBucketResponse response = s3Client.createBucket(bucketRequest); System.out.println(response); } catch (S3Exception e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } }
AWS SDK untuk JavaScript

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS SDK untuk JavaScript.

// file.mjs, run with Node.js v16 or higher // To use with the preview build, place this in a folder // inside the preview build directory, such as /aws-sdk-js-v3/workspace/ import { S3 } from "@aws-sdk/client-s3"; const region = "parent-region-code"; const zone = "local-zone-id"; const suffix = `${zone}--x-s3`; const s3 = new S3({ region }); const bucketName = `bucket-base-name--${suffix}`; // Full directory bucket name const createResponse = await s3.createBucket( { Bucket: bucketName, CreateBucketConfiguration: {Location: {Type: "LocalZone", Name: "local-zone-id"}, Bucket: { Type: "Directory", DataRedundancy: "SingleLocalZone" }} } );
SDK untuk .NET

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan SDK untuk .NET.

using (var amazonS3Client = new AmazonS3Client()) { var putBucketResponse = await amazonS3Client.PutBucketAsync(new PutBucketRequest { BucketName = "bucket-base-name--local-zone-id--x-s3", PutBucketConfiguration = new PutBucketConfiguration { BucketInfo = new BucketInfo { DataRedundancy = DataRedundancy.SingleLocalZone, Type = BucketType.Directory }, Location = new LocationInfo { Name = "local-zone-id", Type = LocationType.LocalZone } } }).ConfigureAwait(false); }
SDK for PHP

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS SDK for PHP.

require 'vendor/autoload.php'; $s3Client = new S3Client([ 'region' => 'parent-region-code', ]); $result = $s3Client->createBucket([ 'Bucket' => 'bucket-base-name--local-zone-id--x-s3', 'CreateBucketConfiguration' => [ 'Location' => ['Name'=> 'local-zone-id', 'Type'=> 'LocalZone'], 'Bucket' => ["DataRedundancy" => "SingleLocalZone" ,"Type" => "Directory"] ], ]);
SDK for Python

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS SDK untuk Python (Boto3).

import logging import boto3 from botocore.exceptions import ClientError def create_bucket(s3_client, bucket_name, local_zone): ''' Create a directory bucket in a specified Local Zone :param s3_client: boto3 S3 client :param bucket_name: Bucket to create; for example, 'bucket-base-name--local-zone-id--x-s3' :param local_zone: String; Local Zone ID to create the bucket in :return: True if bucket is created, else False ''' try: bucket_config = { 'Location': { 'Type': 'LocalZone', 'Name': local_zone }, 'Bucket': { 'Type': 'Directory', 'DataRedundancy': 'SingleLocalZone' } } s3_client.create_bucket( Bucket = bucket_name, CreateBucketConfiguration = bucket_config ) except ClientError as e: logging.error(e) return False return True if __name__ == '__main__': bucket_name = 'BUCKET_NAME' region = 'parent-region-code' local_zone = 'local-zone-id' s3_client = boto3.client('s3', region_name = region) create_bucket(s3_client, bucket_name, local_zone)
SDK for Ruby

Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS SDK untuk Ruby.

s3 = Aws::S3::Client.new(region:'parent-region-code') s3.create_bucket( bucket: "bucket-base-name--local-zone-id--x-s3", create_bucket_configuration: { location: { name: 'local-zone-id', type: 'LocalZone' }, bucket: { data_redundancy: 'SingleLocalZone', type: 'Directory' } } )