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

# Mengelola cakupan titik akses Anda untuk bucket direktori
<a name="access-points-directory-buckets-manage-scope"></a>

Bagian ini menjelaskan cara melihat dan memodifikasi cakupan titik akses Anda untuk bucket direktori menggunakan AWS Command Line Interface, REST API, atau AWS SDKs. Anda dapat menggunakan cakupan titik akses untuk membatasi akses ke awalan atau operasi API tertentu.

**Topics**
+ [Lihat cakupan titik akses Anda untuk bucket direktori](#access-points-directory-buckets-view-scope)
+ [Ubah cakupan titik akses Anda untuk bucket direktori](#access-points-directory-buckets-modify-scope)
+ [Hapus cakupan titik akses Anda untuk bucket direktori](#access-points-directory-buckets-delete-scope)

## Lihat cakupan titik akses Anda untuk bucket direktori
<a name="access-points-directory-buckets-view-scope"></a>

Anda dapat menggunakan Konsol Manajemen AWS, AWS Command Line Interface, REST API, atau AWS SDKs untuk melihat cakupan titik akses Anda untuk bucket direktori.

### Menggunakan konsol S3
<a name="access-points-directory-buckets-view-scope-console"></a>

**Untuk melihat cakupan titik akses Anda untuk bucket direktori**

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 yang ingin Anda daftarkan titik akses. 

1. Di panel navigasi di sisi kiri konsol, pilih **Titik akses untuk bucket direktori**.

1. (Opsional) Cari titik akses berdasarkan nama. Hanya titik akses yang Anda pilih yang Wilayah AWS akan muncul di sini.

1. Pilih nama titik akses yang ingin Anda kelola.

1. Pilih tab **Izin**.

1. Dalam **cakupan titik akses**, Anda dapat melihat awalan dan izin yang diterapkan ke titik akses.

### Menggunakan AWS CLI
<a name="access-points-directory-buckets-view-scope-cli"></a>

`get-access-point-scope`Contoh perintah berikut menunjukkan bagaimana Anda dapat menggunakan AWS CLI untuk melihat ruang lingkup titik akses Anda.

Perintah berikut menunjukkan ruang lingkup titik akses **my-access-point** -- *zoneID* --xa-s3 untuk. Akun AWS *111122223333*

```
aws s3control get-access-point-scope --name my-access-point--zoneID--xa-s3 --account-id 111122223333      
```

Untuk informasi dan contoh selengkapnya, lihat [get-access-point-scope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/get-access-point-scope.html)di AWS CLI Command Reference.

**Example hasil dari `get-access-point-scope`**  

```
{
    "Scope": {
        "Permissions": [
            "ListBucket",
            "PutObject"
        ]
  "Prefixes": [
            "Prefix": "MyPrefix1*",
            "Prefix": "MyObjectName.csv"
        ]
    }
}
```

### Penggunaan API REST
<a name="access-points-directory-buckets-view-scope-rest-api"></a>

`GetAccessPointScope`Contoh permintaan berikut menunjukkan bagaimana Anda dapat menggunakan REST API untuk melihat cakupan titik akses Anda.

Permintaan berikut menunjukkan ruang lingkup titik akses **my-access-point** -- *region* - *zoneID* --xa-s3 untuk. Akun AWS *111122223333*

```
GET /v20180820/accesspoint/my-access-point--zoneID--xa-s3/scope HTTP/1.1 
Host: s3express-control.region.amazonaws.com 
x-amz-account-id: 111122223333
```

**Example hasil dari `GetAccessPointScope`**  

```
      HTTP/1.1 200
      <?xml version="1.0" encoding="UTF-8"?>
      <GetAccessPointScopeResult>    
          <Scope>            
              <Prefixes>                
                  <Prefix>MyPrefix1*</Prefix>
                  <Prefix>MyObjectName.csv</Prefix>
              </Prefixes>            
              <Permissions>                 
                  <Permission>ListBucket</Permission>                 
                  <Permission>PutObject</Permission>
              </Permissions>     
              <Scope>
      </GetAccessPointScopeResult>
```

### Menggunakan AWS SDKs
<a name="access-points-directory-buckets-view-scope-sdk"></a>

Anda dapat menggunakan AWS SDKs untuk melihat ruang lingkup titik akses Anda. Untuk informasi selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointScope.html#API_control_GetAccessPointScope_SeeAlso) di Referensi API Amazon Simple Storage Service.

## Ubah cakupan titik akses Anda untuk bucket direktori
<a name="access-points-directory-buckets-modify-scope"></a>

Anda dapat menggunakan Konsol Manajemen AWS, AWS Command Line Interface, REST API, atau AWS SDKs untuk memodifikasi cakupan titik akses Anda untuk bucket direktori. Cakupan titik akses digunakan untuk membatasi akses ke prefiks tertentu, operasi API tertentu, atau kombinasi keduanya.

Anda dapat menyertakan satu atau beberapa operasi API berikut sebagai izin:
+ `PutObject`
+ `GetObject`
+ `DeleteObject`
+ `ListBucket`(diperlukan untuk`ListObjectsV2`)
+ `GetObjectAttributes`
+ `AbortMultipartUploads`
+ `ListBucketMultipartUploads`
+ `ListMultipartUploadParts`

**catatan**  
Anda dapat menentukan jumlah awalan, tetapi panjang total karakter dari semua awalan harus berukuran kurang dari 256 byte.

### Menggunakan konsol S3
<a name="access-points-directory-buckets-modify-scope-console"></a>

**Untuk memodifikasi cakupan titik akses**

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 yang ingin Anda daftarkan titik akses. 

1. Di panel navigasi di sisi kiri konsol, pilih **Titik akses untuk bucket direktori**.

1. (Opsional) Cari titik akses berdasarkan nama. Hanya titik akses yang Anda pilih yang Wilayah AWS akan muncul di sini.

1. Pilih nama titik akses yang ingin Anda kelola.

1. Pilih tab **Izin**.

1. Di bagian **cakupan titik akses**, pilih **Edit**.

1. Untuk menambah atau menghapus awalan:

   1. Untuk menambahkan awalan, pilih **Tambah awalan**. Di bidang **Awalan**, masukkan awalan bucket direktori. Ulangi untuk menambahkan lebih banyak awalan.

   1. Untuk menghapus awalan, pilih **Hapus**.

1. Untuk menambah atau menghapus izin:

   1. Untuk menambahkan izin, di bidang **Pilih operasi data**, pilih izin.

   1. Untuk menghapus izin, pilih **X** di sebelah izin.

1. Pilih **Simpan perubahan**.

### Menggunakan AWS CLI
<a name="access-points-directory-buckets-modify-scope-cli"></a>

`put-access-point-scope`Contoh perintah berikut menunjukkan bagaimana Anda dapat menggunakan AWS CLI untuk memodifikasi ruang lingkup titik akses Anda.

Perintah berikut memodifikasi cakupan titik akses **my-access-point** -- *zoneID* --xa-s3 untuk. Akun AWS *111122223333*

**catatan**  
Anda dapat menggunakan wildcard dalam awalan dengan menggunakan karakter asterisk (\$1). Jika Anda ingin menggunakan karakter tanda bintang sebagai literal, tambahkan karakter garis miring terbalik (\$1) sebelum itu untuk menghindarinya.  
Semua awalan memiliki akhiran '\$1' implisit, yang berarti semua jalur dengan awalan akan disertakan.  
Saat Anda memodifikasi cakupan titik akses dengan AWS CLI, Anda mengganti cakupan yang ada.

```
aws s3control put-access-point-scope --name my-access-point--zoneID--xa-s3 --account-id 111122223333 --scope Prefixes=string,Permissions=string
```

Untuk informasi dan contoh selengkapnya, lihat [put-access-point-scope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/put-access-point-scope.html)di AWS CLI Command Reference.

### Penggunaan API REST
<a name="access-points-directory-buckets-modify-scope-rest-api"></a>

`PutAccessPointScope`Contoh permintaan berikut menunjukkan bagaimana Anda dapat menggunakan REST API untuk memodifikasi cakupan titik akses Anda.

Permintaan berikut memodifikasi cakupan titik akses **my-access-point** -- *zoneID* --xa-s3 untuk. Akun AWS *111122223333*

**catatan**  
Anda dapat menggunakan wildcard dalam awalan dengan menggunakan karakter asterisk (\$1). Jika Anda ingin menggunakan karakter tanda bintang sebagai literal, tambahkan karakter garis miring terbalik (\$1) sebelum itu untuk menghindarinya.  
Semua awalan memiliki akhiran '\$1' implisit, yang berarti semua jalur dengan awalan akan disertakan.  
Saat Anda memodifikasi cakupan titik akses dengan API, Anda mengganti cakupan yang ada.

```
PUT /v20180820/accesspoint/my-access-point--zoneID--xa-s3/scope HTTP/1.1 
Host: s3express-control.region.amazonaws.com 
x-amz-account-id: 111122223333
<?xml version="1.0" encoding="UTF-8"?>
<PutAccessPointScopeRequest>   
        <Scope>        
            <Prefixes>        
                <Prefix>Jane/*</Prefix>              
            </Prefixes>       
            <Permissions>        
                <Permission>PutObject</Permission>
                <Permission>GetObject</Permission>
            </Permissions>   
            <Scope>
    </PutAccessPointScopeRequest>
```

### Menggunakan AWS SDKs
<a name="access-points-directory-buckets-modify-scope-sdk"></a>

Anda dapat menggunakan AWS CLI, AWS SDKs, atau REST API untuk memodifikasi cakupan titik akses Anda. Untuk informasi selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointScope.html#API_control_PutAccessPointScope_SeeAlso) di Referensi API Amazon Simple Storage Service.

## Hapus cakupan titik akses Anda untuk bucket direktori
<a name="access-points-directory-buckets-delete-scope"></a>

Anda dapat menggunakan Konsol Manajemen AWS, AWS Command Line Interface, REST API, atau AWS SDKs untuk menghapus cakupan titik akses Anda untuk bucket direktori.

**catatan**  
Saat Anda menghapus cakupan titik akses, semua awalan dan izin dihapus.

### Menggunakan konsol S3
<a name="access-points-directory-buckets-delete-scope-console"></a>

**Untuk menghapus cakupan titik akses**

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 yang ingin Anda daftarkan titik akses. 

1. Di panel navigasi di sisi kiri konsol, pilih **Titik akses untuk bucket direktori**.

1. (Opsional) Cari titik akses berdasarkan nama. Hanya titik akses yang Anda pilih yang Wilayah AWS akan muncul di sini.

1. Pilih nama titik akses yang ingin Anda kelola.

1. Pilih tab **Izin**.

1. Dalam **cakupan titik akses**, pilih **Hapus**.

1. Dalam **untuk mengkonfirmasi penghapusan ini, ketik “konfirmasi”**. bidang, masukkan**confirm**.

1. Pilih **Hapus**.

### Menggunakan AWS CLI
<a name="access-points-directory-buckets-delete-scope-cli"></a>

`delete-access-point-scope`Contoh perintah berikut menunjukkan bagaimana Anda dapat menggunakan AWS CLI untuk menghapus ruang lingkup titik akses Anda.

Perintah berikut menghapus ruang lingkup titik akses **my-access-point** -- *zoneID* --xa-s3 untuk. Akun AWS *111122223333*

```
aws s3control delete-access-point-scope --name my-access-point--region-zoneID--xa-s3 --account-id 111122223333
```

Untuk informasi dan contoh selengkapnya, lihat [delete-access-point-scope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/delete-access-point-scope.html)di AWS CLI Command Reference.

### Penggunaan API REST
<a name="access-points-directory-buckets-delete-scope-rest-api"></a>

Permintaan berikut menghapus cakupan titik akses **my-access-point** -- *zoneID* --xa-s3 untuk. Akun AWS *111122223333*

```
DELETE /v20180820/accesspoint/my-access-point--zoneID--xa-s3/scope HTTP/1.1 
Host: s3express-control.region.amazonaws.com 
x-amz-account-id: 111122223333
```

### Menggunakan AWS SDKs
<a name="access-points-directory-buckets-delete-scope-sdk"></a>

Anda dapat menggunakan AWS SDKs untuk menghapus ruang lingkup jalur akses Anda. Untuk informasi selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointScope.html#API_control_DeleteAccessPointScope_SeeAlso) di Referensi API Amazon Simple Storage Service.