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

Mengelola tag kunci dengan operasi API

Anda dapat menggunakan API Kriptografi Pembayaran untuk menambahkan, menghapus, dan mencantumkan tag untuk kunci yang Anda kelola. AWS Contoh-contoh ini menggunakan AWS Command Line Interface (AWS CLI), tetapi Anda dapat menggunakan bahasa pemrograman yang didukung. Anda tidak dapat menandai Kunci yang dikelola AWS.

Untuk menambah, mengedit, melihat, dan menghapus tag untuk kunci, Anda harus memiliki izin yang diperlukan. Lihat perinciannya di Pengontrolan akses ke tanda.

CreateKey: Menambahkan tag ke kunci baru

Anda dapat menambahkan tag saat Anda membuat kunci. Untuk menentukan tag, gunakan Tags parameter CreateKey operasi.

Untuk menambahkan tag saat membuat kunci, pemanggil harus memiliki payment-cryptography:TagResource izin dalam kebijakan IAM. Minimal, izin harus mencakup semua kunci di akun dan Wilayah. Lihat perinciannya di Pengontrolan akses ke tanda.

Nilai dari parameter Tags dari CreateKey adalah kumpulan kunci tanda peka huruf besar/kecil dan pasangan nilai kunci. Setiap tag pada kunci harus memiliki nama tag yang berbeda. Nilai tanda bisa berupa string kosong atau null.

Misalnya, AWS CLI perintah berikut membuat kunci enkripsi simetris dengan Project:Alpha tag. Saat menentukan lebih dari satu pasangan nilai kunci, gunakan spasi untuk memisahkan setiap pasangan.

$ aws payment-cryptography create-key --exportable --key-attributes KeyAlgorithm=TDES_2KEY, \
        KeyUsage=TR31_C0_CARD_VERIFICATION_KEY,KeyClass=SYMMETRIC_KEY, \
        KeyModesOfUse='{Generate=true,Verify=true}' \
        --tags '[{"Key":"Project","Value":"Alpha"},{"Key":"BIN","Value":"123456"}]'

Ketika perintah ini berhasil, ia mengembalikan Key objek dengan informasi tentang kunci baru. Namun, Key tidak termasuk tanda. Untuk mendapatkan tag, gunakan ListResourceTags operasi.

TagResource: Menambahkan atau mengubah tag untuk kunci

TagResourceOperasi menambahkan satu atau lebih tag ke kunci. Anda tidak dapat menggunakan operasi ini untuk menambah atau mengedit tanda dalam Akun AWS berbeda.

Untuk menambahkan tanda, tentukan kunci tanda baru dan nilai tanda. Untuk mengedit tanda, tentukan kunci tanda yang sudah ada dan nilai tanda baru. Setiap tag pada kunci harus memiliki kunci tag yang berbeda. Nilai tanda bisa berupa string kosong atau null.

Misalnya, perintah berikut menambahkan UseCase dan memberi BIN tag ke kunci contoh.

$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tags '[{"Key":"UseCase","Value":"Acquiring"},{"Key":"BIN","Value":"123456"}]' 

Ketika perintah ini berhasil, maka tidak mengembalikan output apa pun. Untuk melihat tag pada kunci, gunakan ListResourceTags operasi.

Anda juga dapat menggunakan TagResource untuk mengubah nilai tanda dari tanda yang ada. Untuk mengganti nilai tanda, tentukan kunci tanda yang sama dengan nilai yang berbeda. Tag yang tidak tercantum dalam perintah modifikasi tidak diubah atau dihapus.

Sebagai contoh, perintah ini mengubah nilai tanda Project dari Alpha ke Noe.

Perintah akan kembali http/200 tanpa konten. Untuk melihat perubahan Anda, gunakan ListTagsForResource

$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h \ 
        --tags '[{"Key":"Project","Value":"Noe"}]' 

ListResourceTags: Dapatkan tag untuk kunci

ListResourceTagsOperasi mendapatkan tag untuk kunci. Parameter ResourceArn (KeyYarn atau KeyAlias) diperlukan. Anda tidak dapat menggunakan operasi ini untuk melihat tag pada tombol yang berbeda Akun AWS.

Misalnya, perintah berikut mendapatkan tag untuk kunci contoh.

$ aws payment-cryptography list-tags-for-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h
       
  {
    "Tags": [
        {
            "Key": "BIN",
            "Value": "20151120"
        },
        {
            "Key": "Project",
            "Value": "Production"
        }
    ]
}

UntagResource: Menghapus tag dari kunci

UntagResourceOperasi menghapus tag dari kunci. Untuk mengidentifikasi tanda yang akan dihapus, tentukan kunci tanda. Anda tidak dapat menggunakan operasi ini untuk menghapus tag dari kunci yang berbeda Akun AWS.

Ketika berhasil, operasi UntagResource tidak mengembalikan output apa pun. Juga, jika kunci tag yang ditentukan tidak ditemukan pada kunci, itu tidak menimbulkan pengecualian atau mengembalikan respons. Untuk mengonfirmasi bahwa operasi berhasil, gunakan ListResourceTags operasi.

Misalnya, perintah ini menghapus Purpose tag dan nilainya dari kunci yang ditentukan.

$ aws payment-cryptography untag-resource \ 
        --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tag-keys Project