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

# Penandaan koleksi
<a name="tag-collections"></a>

Anda dapat mengidentifikasi, mengatur, mencari, dan memfilter koleksi Amazon Rekognition menggunakan tanda. Setiap tanda adalah label yang terdiri dari kunci dan nilai yang ditentukan pengguna.

Anda juga dapat menggunakan tanda untuk mengendalikan akses untuk koleksi dengan menggunakan Identity and Access Management (IAM). Untuk informasi selengkapnya, lihat [Mengontrol akses ke AWS sumber daya menggunakan tag sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).

**Topics**
+ [Tambahkan tanda ke koleksi baru](#add-tag-new-collection)
+ [Tambahkan tanda ke koleksi yang sudah ada](#add-tag-existing-collection)
+ [Daftar tanda dalam koleksi](#list-tags-collection)
+ [Hapus tanda dari koleksi](#delete-tag-collection)

## Tambahkan tanda ke koleksi baru
<a name="add-tag-new-collection"></a>

Anda dapat menambahkan tanda ke koleksi karena Anda membuatnya menggunakan operasi `CreateCollection`. Tentukan satu tanda atau lebih di parameter input array `Tags`.

------
#### [ AWS CLI ]

 Ganti nilai `profile_name` dengan nama profil pengembang Anda. 

```
aws rekognition create-collection --collection-id "collection-name" --tags "{"key1":"value1","key2":"value2"}" --profile profile-name 
```

Untuk perangkat Windows:

```
aws rekognition create-collection --collection-id "collection-name" --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
```

------
#### [ Python ]

 Ganti nilai `profile_name` di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda. 

```
import boto3

def create_collection(collection_id):
    client = boto3.client('rekognition')

    # Create a collection
    print('Creating collection:' + collection_id)
    response = client.create_collection(CollectionId=collection_id)
    print('Collection ARN: ' + response['CollectionArn'])
    print('Status code: ' + str(response['StatusCode']))
    print('Done...')

def main():
    collection_id = 'NewCollectionName'
    create_collection(collection_id)

if __name__ == "__main__":
    main()
```

------

## Tambahkan tanda ke koleksi yang sudah ada
<a name="add-tag-existing-collection"></a>

Untuk menambahkan satu tanda atau lebih ke koleksi yang sudah ada, gunakan operasi `TagResource`. Tentukan Amazon Resource Name (ARN) koleksi (`ResourceArn`) dan tanda (`Tags`) yang ingin Anda tambahkan. Contoh berikut menunjukkan cara menambahkan dua tanda.

------
#### [ AWS CLI ]

 Ganti nilai `profile_name` dengan nama profil pengembang Anda. 

```
aws rekognition tag-resource --resource-arn collection-arn --tags "{"key1":"value1","key2":"value2"}" --profile profile-name 
```

 Untuk perangkat Windows: 

```
aws rekognition tag-resource --resource-arn collection-arn --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
```

------
#### [ Python ]

 Ganti nilai `profile_name` di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda. 

```
# Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
# PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)

import boto3

def create_tag(collection_id):
    session = boto3.Session(profile_name='default')
    client = session.client('rekognition')
    response = client.tag_resource(ResourceArn=collection_id,
                                   Tags={
                                       "KeyName": "ValueName"
                                   })
    print(response)
    if "'HTTPStatusCode': 200" in str(response):
        print("Success!!")

def main():
    collection_arn = "collection-arn"
    create_tag(collection_arn)

if __name__ == "__main__":
    main()
```

------

**catatan**  
Jika Anda tidak tahu koleksi Nama Sumber Daya Amazon, Anda dapat menggunakan operasi `DescribeCollection`.

## Daftar tanda dalam koleksi
<a name="list-tags-collection"></a>

Untuk mencamtumkan tanda terlampir di koleksi, gunakan operasi `ListTagsForResource` dan tentukan ARN koleksi (`ResourceArn`). Respons adalah peta kunci dan nilai-nilai tanda yang terlampir pada koleksi tertentu.

------
#### [ AWS CLI ]

 Ganti nilai `profile_name` dengan nama profil pengembang Anda. 

```
aws rekognition list-tags-for-resource --resource-arn resource-arn --profile profile-name
```

------
#### [ Python ]

 Ganti nilai `profile_name` di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda. 

```
import boto3

def list_tags():
    client = boto3.client('rekognition')
    response = client.list_tags_for_resource(ResourceArn="arn:aws:rekognition:region-name:5498347593847598:collection/NewCollectionName")
    print(response)

def main():
    list_tags()

if __name__ == "__main__":
    main()
```

------

Output menampilkan daftar tanda yang terlampir pada koleksi:

```
                {
    "Tags": {
        "Dept": "Engineering",
        "Name": "Ana Silva Carolina",
        "Role": "Developer"
    }
}
```

## Hapus tanda dari koleksi
<a name="delete-tag-collection"></a>

Untuk menghapus satu tanda atau lebih dari koleksi, gunakan operasi `UntagResource`. Tentukan ARN (`ResourceArn`) model dan kunci tanda (`Tag-Keys`) yang ingin Anda hapus.

------
#### [ AWS CLI ]

Ganti nilai `profile_name` dengan nama profil pengembang Anda.

```
aws rekognition untag-resource --resource-arn resource-arn --profile profile-name --tag-keys "key1" "key2"
```

Atau, Anda dapat menentukan tanda-kunci dalam format ini:

```
--tag-keys key1,key2
```

------
#### [ Python ]

 Ganti nilai `profile_name` di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda. 

```
import boto3

def list_tags():
    client = boto3.client('rekognition')
    response = client.untag_resource(ResourceArn="arn:aws:rekognition:region-name:5498347593847598:collection/NewCollectionName", TagKeys=['KeyName'])
    print(response)

def main():
    list_tags()

if __name__ == "__main__":
    main()
```

------