View a markdown version of this page

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, Anda dapat membuat bucket direktori untuk menyimpan dan mengambil objek di perimeter data tertentu untuk membantu memenuhi kasus penggunaan tempat tinggal data Anda. Bucket direktori S3 adalah satu-satunya jenis bucket yang didukung di Zona Lokal, dan berisi tipe lokasi bucket yang disebutLocalZone. 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 ID Zona Lokal dengan menggunakan operasi DescribeAvailabilityZones API. Untuk informasi selengkapnya, lihat Aturan penamaan bucket direktori.

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

  • Untuk persyaratan tempat tinggal 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 untuk bucket direktori di Zona Lokal.

Berikut ini menjelaskan cara untuk membuat bucket direktori di Zona Lokal tunggal dengan Konsol Manajemen AWS, AWS CLI, dan AWS SDK.

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

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

    catatan

    Untuk informasi selengkapnya tentang Wilayah induk, lihatKonsep untuk bucket direktori di Zona Lokal.

  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, tipe bucket default ke bucket tujuan umum. Untuk membuat bucket direktori, Anda harus memilih Wilayah 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 redundan di seluruh Zona Lokal.

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

    Untuk informasi selengkapnya tentang aturan penamaan untuk bucket direktori, lihatAturan penamaan bucket tujuan umum. Sufiks ditambahkan secara otomatis ke nama dasar yang Anda berikan saat Anda membuat bucket direktori menggunakan konsol. Sufiks 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 bucket terlihat dalam URL yang menunjuk objek dalam bucket.

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

    Dengan pengaturan yang dipaksakan pemilik Bucket diaktifkan, pemilik bucket secara otomatis memiliki dan memiliki kontrol penuh atas setiap objek dalam bucket. ACL 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 ACL. Untuk informasi selengkapnya, lihat Mengontrol kepemilikan objek dan menonaktifkan ACL untuk bucket Anda.

  11. Di bawah Blokir setelan Akses Publik untuk bucket ini, semua pengaturan 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 Server-side enkripsi dengan kunci terkelola Amazon S3 (SSE-S3) untuk mengenkripsi data secara default. Anda juga memiliki opsi untuk mengenkripsi data dalam bucket direktori dengan Server-side enkripsi dengan AWS Key Management Service kunci (SSE-KMS).

  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 Zona Lokal dengan menggunakan AWS CLI. Untuk menggunakan perintah, ganti user input placeholders dengan informasi Anda sendiri.

Saat Anda 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 Zona Lokal. Untuk informasi selengkapnya tentang AWS CLI perintah, lihat create-bucket di Referensi Per AWS CLI intah.

SDK for Go

Contoh ini menunjukkan cara membuat bucket direktori di Zona Lokal dengan menggunakan AWS SDK untuk Go.

contoh
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 Zona Lokal dengan menggunakan AWS SDK for Java 2.x.

contoh
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 Zona Lokal dengan menggunakan AWS SDK untuk JavaScript.

contoh
// 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 Zona Lokal dengan menggunakan SDK untuk .NET.

contoh
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 Zona Lokal dengan menggunakan AWS SDK for PHP.

contoh
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 Zona Lokal dengan menggunakan AWS SDK untuk Python (Boto3).

contoh
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 Zona Lokal dengan menggunakan AWS SDK untuk Ruby.

contoh
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' } } )