

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

# Mengelola tag untuk Hibah Akses S3
<a name="access-grants-tagging"></a>

Tag di Amazon S3 Access Grants memiliki karakteristik yang mirip dengan [tag objek](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) di Amazon S3. Setiap tag adalah pasangan nilai kunci. Sumber daya di S3 Access Grants yang dapat Anda tag adalah [instans](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-instance.html), [lokasi](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-location.html), dan [pemberian](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-grant.html) S3 Access Grants. 

**catatan**  
Penandaan di S3 Access Grants menggunakan operasi API yang berbeda dari penandaan objek. S3 Access Grants menggunakan operasi [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html), dan [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html)API, di mana sumber daya dapat berupa instance S3 Access Grants, lokasi terdaftar, atau hibah akses.

Mirip dengan [tag objek](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html), batasan berikut berlaku:
+ Anda dapat menambahkan tag ke sumber daya baru S3 Access Grants saat Anda membuatnya, atau Anda dapat menambahkan tag ke sumber daya yang sudah ada.
+ Anda dapat mengaitkan hingga 10 tag dengan sumber daya. Jika beberapa tag terkait dengan sumber daya yang sama, mereka harus memiliki kunci tag unik.
+ Kunci tanda dapat terdiri dari hingga 128 karakter Unicode, dan nilai tanda dapat terdiri dari hingga 256 karakter Unicode. Tag diwakili secara internal dalam UTF-16. Dalam UTF-16, karakter mengkonsumsi 1 atau 2 posisi karakter.
+ Kunci dan nilainya peka huruf besar/kecil.

Untuk informasi selengkapnya tentang pembatasan tag, lihat [Pembatasan tag yang ditentukan pengguna](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html) di *AWS Billing Panduan Pengguna*.

Anda dapat menandai resource di S3 Access Grants dengan menggunakan AWS Command Line Interface (AWS CLI), Amazon S3 REST API, atau file. AWS SDKs

## Menggunakan AWS CLI
<a name="access-grants-tagging-cli"></a>

Untuk menginstal AWS CLI, lihat [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) di *Panduan AWS Command Line Interface Pengguna*. 

Anda dapat menandai sumber daya S3 Access Grants saat Anda membuatnya atau setelah Anda membuatnya. Contoh berikut menunjukkan bagaimana Anda menandai atau menghapus tag instans S3 Access Grants. Anda dapat melakukan operasi serupa untuk lokasi terdaftar dan pemberian akses. 

Untuk menggunakan perintah contoh berikut, ganti `user input placeholders` dengan informasi Anda sendiri.

**Example — Buat instance S3 Access Grants dengan tag**  

```
aws s3control create-access-grants-instance \
 --account-id 111122223333 \
 --profile access-grants-profile \
 --region us-east-2 \
 --tags Key=tagKey1,Value=tagValue1
```
Respons:  

```
 {
    "CreatedAt": "2023-10-25T01:09:46.719000+00:00",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}
```

**Example — Tandai instance S3 Access Grants yang sudah dibuat**  

```
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey2,Value=tagValue2
```

**Example — Daftar tag untuk instance S3 Access Grants**  

```
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2
```
Respons:  

```
{
    "Tags": [
        {
            "Key": "tagKey1",
            "Value": "tagValue1"
        },
        {
            "Key": "tagKey2",
            "Value": "tagValue2"
        }
    ]
}
```

**Example — Hapus tag instance Hibah Akses S3**  

```
aws s3control untag-resource \
 --account-id 111122223333 \
 --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
 --profile access-grants-profile \
 --region us-east-2 \
 --tag-keys "tagKey2"
```

## Penggunaan API REST
<a name="access-grants-tagging-rest-api"></a>

Anda dapat menggunakan Amazon S3 API untuk menandai, menghapus tag, atau mencantumkan tag untuk instance S3 Access Grants, lokasi terdaftar, atau hibah akses. Untuk informasi tentang dukungan REST API untuk mengelola tag S3 Access Grants, lihat bagian berikut di Referensi *API Amazon Simple Storage Service*:
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html) 
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html) 
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html)