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

# Menggunakan perintah API-level (s3api) di AWS CLI
<a name="cli-services-s3-apicommands"></a>

Perintah API-level (terkandung dalam set `s3api` perintah) menyediakan akses langsung ke Amazon Simple Storage Service (Amazon APIs S3), dan mengaktifkan beberapa operasi yang tidak diekspos dalam perintah tingkat tinggi. `s3` Perintah ini setara dengan AWS layanan lain yang menyediakan akses tingkat API ke fungsionalitas layanan. Untuk informasi selengkapnya tentang `s3` perintah, lihat [Menggunakan perintah tingkat tinggi (s3) di AWS CLI](cli-services-s3-commands.md)

Topik ini memberikan contoh yang menunjukkan cara menggunakan perintah tingkat rendah yang dipetakan ke Amazon S3. APIs Selain itu, Anda dapat menemukan contoh untuk setiap perintah API S3 di `s3api` bagian [referensi](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html).

**Topics**
+ [Prasyarat](#cli-services-s3-apicommands-prereqs)
+ [Menerapkan ACL kustom](#cli-services-s3-apicommands-acls)
+ [Konfigurasikan kebijakan pencatatan](#cli-services-s3-apicommands-logpol)
+ [Sumber daya](#cli-services-s3-apicommands-resources)

## Prasyarat
<a name="cli-services-s3-apicommands-prereqs"></a>

Untuk menjalankan `s3api` perintah, Anda perlu:
+ Instal dan konfigurasikan AWS CLI. Untuk informasi selengkapnya, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md) dan [Otentikasi dan akses kredensional untuk AWS CLI](cli-chap-authentication.md).
+ Profil yang Anda gunakan harus memiliki izin yang memungkinkan AWS operasi dilakukan oleh contoh.
+ Pahami istilah Amazon S3 ini:
  + **Bucket** - Folder Amazon S3 tingkat atas.
  + **Awalan** - Folder Amazon S3 dalam ember.
  + **Objek** - Item apa pun yang di-host di ember Amazon S3.

## Menerapkan ACL kustom
<a name="cli-services-s3-apicommands-acls"></a>

Dengan perintah tingkat tinggi, Anda dapat menggunakan `--acl` opsi untuk menerapkan daftar kontrol akses (ACLs) yang telah ditentukan sebelumnya ke objek Amazon S3. Tetapi Anda tidak dapat menggunakan perintah itu untuk mengatur lebar ember ACLs. Namun, Anda dapat melakukan ini dengan menggunakan perintah `` `[put-bucket-acl](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-acl.html)` API-level. 

Contoh berikut menunjukkan cara memberikan kontrol penuh kepada dua AWS pengguna (*user1@example.com* dan *user2@example.com*) dan izin baca untuk semua orang. Pengidentifikasi untuk “semua orang” berasal dari URI khusus yang Anda lewati sebagai parameter.

```
$ aws s3api put-bucket-acl --bucket {{amzn-s3-demo-bucket}} --grant-full-control 'emailaddress="{{user1@example.com}}",emailaddress="{{user2@example.com}}"' --grant-read 'uri="http://acs.amazonaws.com/groups/global/AllUsers"'
```

Untuk detail tentang cara membuat ACLs, lihat [PUT Bucket acl](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html) di Referensi *API Amazon Simple Storage Service*. Perintah `s3api` ACL di CLI, `put-bucket-acl` seperti, menggunakan notasi argumen [singkatan yang sama](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-shorthand.html).

## Konfigurasikan kebijakan pencatatan
<a name="cli-services-s3-apicommands-logpol"></a>

Perintah API `put-bucket-logging` mengonfigurasi kebijakan pencatatan bucket. 

Dalam contoh berikut, AWS pengguna *user@example.com* diberikan kontrol penuh atas file log, dan semua pengguna telah membaca akses ke file tersebut. Perhatikan bahwa `put-bucket-acl` perintah juga diperlukan untuk memberikan sistem pengiriman log Amazon S3 (ditentukan oleh URI) izin yang diperlukan untuk membaca dan menulis log ke bucket.

```
$ aws s3api put-bucket-acl --bucket {{amzn-s3-demo-bucket}} --grant-read-acp 'URI="http://acs.amazonaws.com/groups/s3/LogDelivery"' --grant-write 'URI="http://acs.amazonaws.com/groups/s3/LogDelivery"'
$ aws s3api put-bucket-logging --bucket {{amzn-s3-demo-bucket}} --bucket-logging-status file://logging.json
```

`logging.json`File dalam perintah sebelumnya memiliki konten berikut.

```
{
  "LoggingEnabled": {
    "TargetBucket": "amzn-s3-demo-bucket",
    "TargetPrefix": "amzn-s3-demo-bucketLogs/",
    "TargetGrants": [
      {
        "Grantee": {
          "Type": "AmazonCustomerByEmail",
          "EmailAddress": "{{user@example.com}}"
        },
        "Permission": "FULL_CONTROL"
      },
      {
        "Grantee": {
          "Type": "Group",
          "URI": "http://acs.amazonaws.com/groups/global/AllUsers"
        },
        "Permission": "READ"
      }
    ]
  }
}
```

## Sumber daya
<a name="cli-services-s3-apicommands-resources"></a>

**AWS CLI Referensi:**
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-acl.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-acl.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-logging.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-logging.html)

**Referensi layanan:**
+ [Bekerja dengan bucket Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/UsingBucket.html) *di Panduan Pengguna Amazon S3*
+ [Bekerja dengan objek Amazon S3 di Panduan](https://docs.aws.amazon.com//AmazonS3/latest/userguide/UsingObjects.html) Pengguna *Amazon S3*
+ [Kunci daftar secara hierarkis menggunakan awalan dan pembatas dalam Panduan Pengguna](https://docs.aws.amazon.com//AmazonS3/latest/userguide/ListingKeysHierarchy.html) *Amazon S3*
+ [https://docs.aws.amazon.com//AmazonS3/latest/userguide/LLAbortMPUnet.html](https://docs.aws.amazon.com//AmazonS3/latest/userguide/LLAbortMPUnet.html)