Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menandai model
Anda dapat mengidentifikasi, mengatur, mencari, dan memfilter model Rekognition Amazon Anda dengan menggunakan tag. Setiap tag adalah label yang terdiri dari kunci dan nilai yang ditentukan pengguna. Misalnya, untuk membantu menentukan penagihan untuk model Anda, beri tag model Anda dengan `Cost center` kunci dan tambahkan nomor pusat biaya yang sesuai sebagai nilai. Untuk informasi selengkapnya, lihat [Menandai sumber daya AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
Gunakan tag untuk:
+ Lacak penagihan untuk model dengan menggunakan tag alokasi biaya. Untuk informasi selengkapnya, lihat [Menggunakan Tag Alokasi Biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).
+ Kontrol akses ke model dengan menggunakan Identity and Access Management (IAM) Untuk informasi selengkapnya, lihat [Mengontrol akses ke sumber daya AWS menggunakan tanda sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
+ Mengotomatiskan manajemen model. Misalnya, Anda dapat menjalankan skrip start atau stop otomatis yang mematikan model pengembangan selama jam non-bisnis untuk mengurangi biaya. Untuk informasi selengkapnya, lihat [Menjalankan model Label Kustom Rekognition Amazon yang terlatih](running-model.md).
Anda dapat menandai model dengan menggunakan konsol Amazon Rekognition atau dengan menggunakan. AWS SDKs
**Topics**
+ [Model penandaan (konsol)](#tm-tagging-model-console)
+ [Melihat tag model](#tm-tagging-model-viewing-console)
+ [Model penandaan (SDK)](#tm-tagging-model-sdk)
## Model penandaan (konsol)
Anda dapat menggunakan konsol Rekognition untuk menambahkan tag ke model, melihat tag yang dilampirkan ke model, dan menghapus tag.
### Menambah atau menghapus tag
Prosedur ini menjelaskan cara menambahkan tag ke, atau menghapus tag dari, model yang ada. Anda juga dapat menambahkan tag ke model baru saat dilatih. Untuk informasi selengkapnya, lihat [Melatih model Label Kustom Rekognition Amazon](training-model.md).
**Untuk menambahkan tag ke, atau menghapus tag dari, model yang ada menggunakan konsol**
1. Buka konsol Amazon Rekognition di. [ https://console.aws.amazon.com/rekognition/]( https://console.aws.amazon.com/rekognition/)
1. Pilih **Mulai**.
1. Di panel navigasi, pilih **Proyek**.
1. Pada halaman Sumber daya **proyek**, pilih proyek yang berisi model yang ingin Anda tag.
1. Di panel navigasi, di bawah proyek yang Anda pilih sebelumnya, pilih **Model**.
1. Di bagian **Model**, pilih model yang ingin Anda tambahkan tag.
1. Pada halaman detail model, pilih tab **Tag**.
1. Di bagian **Tag**, pilih **Kelola tag**.
1. Pada halaman **Kelola tag**, pilih **Tambahkan tag baru**.
1. Masukkan kunci dan nilai.
1. Untuk **Key**, masukkan nama untuk kunci tersebut.
1. Untuk **Nilai**, masukkan nilai.
1. Untuk menambahkan lebih banyak tag, ulangi langkah 9 dan 10.
1. (Opsional) Untuk menghapus tag, pilih **Hapus** di samping tag yang ingin Anda hapus. Jika Anda menghapus tag yang disimpan sebelumnya, tag tersebut akan dihapus saat Anda menyimpan perubahan.
1. Pilih **Simpan perubahan** untuk menyimpan perubahan Anda.
## Melihat tag model
Anda dapat menggunakan konsol Amazon Rekognition untuk melihat tag yang dilampirkan ke model.
Untuk melihat tag yang dilampirkan ke *semua model dalam proyek*, Anda harus menggunakan AWS SDK. Untuk informasi selengkapnya, lihat [Daftar tag model](#listing-model-tags-sdk).
**Untuk melihat tag yang dilampirkan ke model**
1. Buka konsol Amazon Rekognition di. [ https://console.aws.amazon.com/rekognition/]( https://console.aws.amazon.com/rekognition/)
1. Pilih **Mulai**.
1. Di panel navigasi, pilih **Proyek**.
1. Pada halaman Sumber daya **proyek**, pilih proyek yang berisi model yang tagnya ingin Anda lihat.
1. Di panel navigasi, di bawah proyek yang Anda pilih sebelumnya, pilih **Model**.
1. Di bagian **Model**, pilih model yang tagnya ingin Anda lihat.
1. Pada halaman detail model, pilih tab **Tag**. Tag ditampilkan di bagian **Tag**.
## Model penandaan (SDK)
Anda dapat menggunakan AWS SDK untuk:
+ Tambahkan tag ke model baru
+ Tambahkan tag ke model yang ada
+ Buat daftar tag yang dilampirkan pada model
+ Hapus tag dari model
Tag dalam AWS CLI contoh berikut adalah dalam format berikut.
```
--tags '{"{{key1}}":"{{value1}}","{{key2}}":"{{value2}}"}'
```
Atau, Anda dapat menggunakan format ini.
```
--tags {{key1}}={{value1}},{{key2}}={{value2}}
```
Jika Anda belum menginstal AWS CLI, lihat[Langkah 4: Mengatur AWS CLI and AWS SDK](su-awscli-sdk.md).
### Menambahkan tag ke model baru
Anda dapat menambahkan tag ke model saat Anda membuatnya menggunakan [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)operasi. Tentukan satu tanda atau lebih dalam parameter input array `Tags`.
```
aws rekognition create-project-version --project-arn {{project arn}} \
--version-name {{version_name}} \
--output-config '{ "S3Location": { "Bucket": "{{output bucket}}", "Prefix": "{{output folder}}" } }' \
--tags '{"{{key1}}":"{{value1}}","{{key2}}":"{{value2}}"}' \
--profile custom-labels-access
```
Untuk informasi tentang membuat dan melatih model, lihat[Melatih model (SDK)](training-model.md#tm-sdk).
### Menambahkan tag ke model yang ada
Untuk menambahkan satu atau beberapa tag ke model yang ada, gunakan [TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource)operasi. Tentukan Amazon Resource Name (ARN) (`ResourceArn`) model dan tag (`Tags`) yang ingin Anda tambahkan. Contoh berikut menunjukkan cara menambahkan dua tanda.
```
aws rekognition tag-resource --resource-arn {{resource-arn}} \
--tags '{"{{key1}}":"{{value1}}","{{key2}}":"{{value2}}"}' \
--profile custom-labels-access
```
Anda bisa mendapatkan ARN untuk model dengan menelepon. [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion)
### Daftar tag model
Untuk membuat daftar tag yang dilampirkan pada model, gunakan [ListTagsForResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListTagsForResource)operasi dan tentukan ARN model ()`ResourceArn`. Responsnya adalah peta kunci tag dan nilai yang dilampirkan ke model yang ditentukan.
```
aws rekognition list-tags-for-resource --resource-arn {{resource-arn}} \
--profile custom-labels-access
```
Output menampilkan daftar tag yang dilampirkan pada model.
```
{
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
```
Untuk melihat model mana dalam proyek yang memiliki tag tertentu, hubungi `DescribeProjectVersions` untuk mendapatkan daftar model. Kemudian panggil `ListTagsForResource` setiap model dalam tanggapan dari`DescribeProjectVersions`. Periksa respons dari `ListTagsForResource` untuk melihat apakah tag yang diperlukan ada.
Contoh Python 3 berikut menunjukkan kepada Anda bagaimana mencari semua proyek Anda untuk kunci dan nilai tag tertentu. Outputnya mencakup proyek ARN dan model ARN di mana kunci yang cocok ditemukan.
**Untuk mencari nilai tag**
1. Simpan kode berikut ke file bernama`find_tag.py`.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to find a tag value that's associated with models within
your Amazon Rekognition Custom Labels projects.
"""
import logging
import argparse
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
def find_tag_in_projects(rekognition_client, key, value):
"""
Finds Amazon Rekognition Custom Label models tagged with the supplied key and key value.
:param rekognition_client: An Amazon Rekognition boto3 client.
:param key: The tag key to find.
:param value: The value of the tag that you want to find.
return: A list of matching model versions (and model projects) that were found.
"""
try:
found_tags = []
found = False
projects = rekognition_client.describe_projects()
# Iterate through each project and models within a project.
for project in projects["ProjectDescriptions"]:
logger.info("Searching project: %s ...", project["ProjectArn"])
models = rekognition_client.describe_project_versions(
ProjectArn=(project["ProjectArn"])
)
for model in models["ProjectVersionDescriptions"]:
logger.info("Searching model %s", model["ProjectVersionArn"])
tags = rekognition_client.list_tags_for_resource(
ResourceArn=model["ProjectVersionArn"]
)
logger.info(
"\tSearching model: %s for tag: %s value: %s.",
model["ProjectVersionArn"],
key,
value,
)
# Check if tag exists.
if key in tags["Tags"]:
if tags["Tags"][key] == value:
found = True
logger.info(
"\t\tMATCH: Project: %s: model version %s",
project["ProjectArn"],
model["ProjectVersionArn"],
)
found_tags.append(
{
"Project": project["ProjectArn"],
"ModelVersion": model["ProjectVersionArn"],
}
)
if found is False:
logger.info("No match for Tag %s with value %s.", key, value)
return found_tags
except ClientError as err:
logger.info("Problem finding tags: %s. ", format(err))
raise
def main():
"""
Entry point for example.
"""
logging.basicConfig(level=logging.INFO,
format="%(levelname)s: %(message)s")
# Set up command line arguments.
parser = argparse.ArgumentParser(usage=argparse.SUPPRESS)
parser.add_argument("tag", help="The tag that you want to find.")
parser.add_argument("value", help="The tag value that you want to find.")
args = parser.parse_args()
key = args.tag
value = args.value
print(f"Searching your models for tag: {key} with value: {value}.")
session = boto3.Session(profile_name='custom-labels-access')
rekognition_client = session.client("rekognition")
# Get tagged models for all projects.
tagged_models = find_tag_in_projects(rekognition_client, key, value)
print("Matched models\n--------------")
if len(tagged_models) > 0:
for model in tagged_models:
print(
"Project: {project}\nModel version: {version}\n".format(
project=model["Project"], version=model["ModelVersion"]
)
)
else:
print("No matches found.")
print("Done.")
if __name__ == "__main__":
main()
```
1. Di prompt perintah, masukkan perintah berikut. Ganti {{key}} dan {{value}} dengan nama kunci dan nilai kunci yang ingin Anda temukan.
```
python find_tag.py {{key}} {{value}}
```
### Menghapus tag dari model
Untuk menghapus satu atau lebih tag dari model, gunakan [UntagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UntagResource)operasi. Tentukan ARN dari model (`ResourceArn`) dan tombol tanda (`Tag-Keys`) yang ingin Anda hapus.
```
aws rekognition untag-resource --resource-arn {{resource-arn}} \
--tag-keys '["{{key1}}","{{key2}}"]' \
--profile custom-labels-access
```
Atau, Anda dapat menentukan `tag-keys` dalam format ini.
```
--tag-keys {{key1}},{{key2}}
```