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 [DescribeAvailabilityZones](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAvailabilityZones.html)API. Untuk informasi selengkapnya, lihat [Aturan penamaan bucket direktori](directory-bucket-naming-rules.md).
**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](opt-in-directory-bucket-lz.md).
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](connectivity-lz-directory-buckets.md).
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](iam-directory-bucket-LZ.md).
Berikut ini menjelaskan cara membuat bucket direktori dalam satu Zona Lokal dengan Konsol Manajemen AWS, AWS CLI, dan AWS SDKs.
## Menggunakan konsol S3
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. 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, lihat[Konsep untuk bucket direktori di Local Zones](s3-lzs-for-directory-buckets.md).
1. Di panel navigasi kiri, pilih **Bucket**.
1. Pilih **Buat bucket**.
Halaman **Buat bucket** terbuka.
1. Di bawah **Konfigurasi umum**, lihat Wilayah AWS tempat bucket Anda akan dibuat.
1. 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, lihat[Titik akhir regional dan Zonal untuk bucket direktori](s3-express-Regions-and-Zones.md).
Setelah membuat bucket, Anda tidak dapat mengubah tipe bucket.
1. Di bawah **Lokasi Bucket**, pilih Zona Lokal yang ingin Anda gunakan.
**catatan**
Zona Lokal tidak dapat diubah setelah bucket dibuat.
1. 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.
1. Untuk **Nama bucket**, masukkan nama untuk bucket direktori Anda.
Untuk informasi selengkapnya tentang aturan penamaan untuk bucket direktori, lihat[Aturan penamaan bucket tujuan umum](bucketnamingrules.md). 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.
1. 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 bucket ACLs Anda](about-object-ownership.md).
1. 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](access-control-block-public-access.md).
1. 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
1. 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](directory-buckets-objects.md).
## Menggunakan AWS CLI
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, lihat[Konsep untuk bucket direktori di Local Zones](s3-lzs-for-directory-buckets.md). *Untuk informasi selengkapnya tentang AWS CLI perintah, lihat [create-bucket di](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) Command Reference.AWS CLI *
## Menggunakan AWS SDKs
------
#### [ SDK for Go ]
Contoh ini menunjukkan cara membuat bucket direktori di Local Zone dengan menggunakan AWS SDK untuk Go.
**Example**
```
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.
**Example**
```
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.
**Example**
```
// 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.
**Example**
```
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.
**Example**
```
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).
**Example**
```
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.
**Example**
```
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' }
}
)
```
------