Menggunakan AWS tag dengan S3 Access Grants

Tag di Amazon S3 Access Grants memiliki karakteristik yang mirip dengan tag objek di Amazon S3. Setiap tag adalah pasangan nilai kunci. Sumber daya di S3 Access Grants yang dapat Anda tag adalah instans, lokasi, dan pemberian S3 Access Grants.

catatan

Penandaan di S3 Access Grants menggunakan API operasi yang berbeda dari penandaan objek. Hibah Akses S3 menggunakan TagResource, UntagResource, dan ListTagsForResourceAPIoperasi, di mana sumber daya dapat berupa instance S3 Access Grants, lokasi terdaftar, atau hibah akses.

Mirip dengan tag objek, 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 di AWS Billing Panduan Pengguna.

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

Menggunakan AWS CLI

Untuk menginstal AWS CLI, lihat Menginstal AWS CLI 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.

contoh — 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"
}

contoh — 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

contoh — 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"
        }
    ]
}

contoh — 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"

Menggunakan REST API

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 REST API dukungan untuk mengelola tag S3 Access Grants, lihat bagian berikut di Referensi Layanan API Penyimpanan Sederhana Amazon:

• TagResource

• UntagResource

• ListTagsForResource