Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Baliser des collections
Vous pouvez identifier, organiser, rechercher et filtrer les collections Amazon Rekognition à l’aide de balises. Chaque balise est une étiquette composée d’une clé définie par l’utilisateur et d’une valeur.
Vous pouvez également utiliser des balises pour contrôler l’accès à une collection à l’aide de Identity and Access Management (IAM). Pour plus d'informations, consultez la section Contrôle de l'accès aux AWS ressources à l'aide de balises de ressources.
Ajouter des balises à une nouvelle collection
Vous pouvez ajouter des balises à une collection lors de sa création à l’aide de l’opération CreateCollection. Spécifiez une ou plusieurs balises dans le paramètre d’entrée du tableau Tags.
- AWS CLI
-
Remplacez la valeur de profile_name par le nom de votre profil de développeur.
aws rekognition create-collection --collection-id "collection-name" --tags "{"key1":"value1","key2":"value2"}" --profile profile-name
Pour les appareils Windows :
aws rekognition create-collection --collection-id "collection-name" --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
- Python
-
Remplacez la valeur de profile_name dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
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()
Ajouter des balises à une collection existante
Pour ajouter une ou plusieurs balises à une collection existante, utilisez l’opération TagResource. Spécifiez l’Amazon Resource Name (ARN) (ResourceArn) de la collection et les balises (Tags) que vous voulez ajouter. L’exemple suivant vous montre comment ajouter deux balises.
- AWS CLI
-
Remplacez la valeur de profile_name par le nom de votre profil de développeur.
aws rekognition tag-resource --resource-arn collection-arn --tags "{"key1":"value1","key2":"value2"}" --profile profile-name
Pour les appareils Windows :
aws rekognition tag-resource --resource-arn collection-arn --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
- Python
-
Remplacez la valeur de profile_name dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
# 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()
Si vous ne connaissez pas le nom de la ressource Amazon de la collection, vous pouvez utiliser l’opération DescribeCollection.
Pour répertorier les balises attachées à une collection, utilisez l’opération ListTagsForResource et spécifiez l’ARN de la collection (ResourceArn). La réponse est une carte des clés de balise et des valeurs attachées à la collection spécifiée.
- AWS CLI
-
Remplacez la valeur de profile_name par le nom de votre profil de développeur.
aws rekognition list-tags-for-resource --resource-arn resource-arn --profile profile-name
- Python
-
Remplacez la valeur de profile_name dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
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()
La sortie affiche une liste de balises attachées à la collection :
{
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
Supprimer des balises d’une collection
Pour supprimer une ou plusieurs balises d’une collection, utilisez l’opération UntagResource. Spécifiez l’ARN du modèle (ResourceArn) et les clés de balise (Tag-Keys) que vous souhaitez supprimer.
- AWS CLI
-
Remplacez la valeur de profile_name par le nom de votre profil de développeur.
aws rekognition untag-resource --resource-arn resource-arn --profile profile-name --tag-keys "key1" "key2"
Vous pouvez aussi spécifier les clés de balise dans ce format :
--tag-keys key1,key2
- Python
-
Remplacez la valeur de profile_name dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
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()
