Markieren von Sammlungen

Sie können Amazon-Rekognition-Sammlungen mithilfe von Tags identifizieren, organisieren, suchen und filtern. Jedes Tag ist eine Bezeichnung, die aus einem benutzerdefinierten Schlüssel und Wert besteht.

Sie können Tags auch verwenden, um den Zugriff auf eine Sammlung mithilfe von Identity and Access Management (IAM) zu steuern. Weitere Informationen finden Sie unter Steuern des Zugriffs auf AWS Ressourcen mithilfe von Ressourcen-Tags.

Hinzufügen von Tags zu einer neuen Sammlung

Sie können Tags zu einer Sammlung hinzufügen, während Sie sie mit der CreateCollection Operation erstellen. Geben Sie ein oder mehrere Tags im Tags-Array-Eingabeparameter an.

AWS CLI

Ersetzen Sie den Wert von profile_name mit dem Namen Ihres Entwicklerprofils.

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

Für Windows-Geräte:

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

Python

Ersetzen Sie den Wert von profile_name in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.

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()

Hinzufügen von Tags zu einer vorhandenen Sammlung

Um eine oder mehrere Tags zu einer bestehenden Sammlung hinzuzufügen, verwenden Sie die TagResource-Operation. Geben Sie den Amazon-Ressourcennamen (ARN) (ResourceArn) der Sammlung und die Tags (Tags) an, die Sie hinzufügen möchten. Das folgende Beispiel zeigt, wie zwei Tags hinzugefügt werden.

AWS CLI

Ersetzen Sie den Wert von profile_name mit dem Namen Ihres Entwicklerprofils.

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

Für Windows-Geräte:

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

Python

Ersetzen Sie den Wert von profile_name in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.

# 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()

Anmerkung

Wenn Sie den Amazon-Ressourcennamen der Sammlung nicht kennen, können Sie die DescribeCollection-Operation verwenden.

Stichwörter in einer Sammlung auflisten

Um die an eine Sammlung angehängten Tags aufzulisten, verwenden Sie die ListTagsForResource-Operation und geben Sie den ARN der Sammlung (ResourceArn) an. Die Antwort ist eine Zuordnung von Tag-Schlüsseln und -Werten, die mit der angegebenen Sammlung verknüpft sind.

AWS CLI

Ersetzen Sie den Wert von profile_name mit dem Namen Ihres Entwicklerprofils.

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

Python

Ersetzen Sie den Wert von profile_name in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.

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()

Die Ausgabe zeigt eine Liste der an die Sammlung angehängten Tags:

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

Löschen von Tags aus einer Sammlung

Verwenden Sie die UntagResource-Operation, um mindestens ein Tag aus einer Sammlung zu entfernen. Geben Sie den ARN des Modells (ResourceArn) und die Tag-Schlüssel (Tag-Keys) an, die Sie entfernen möchten.

AWS CLI

Ersetzen Sie den Wert von profile_name mit dem Namen Ihres Entwicklerprofils.

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

Alternativ können Sie Tag-Schlüssel in diesem Format angeben:

--tag-keys key1,key2

Python

Ersetzen Sie den Wert von profile_name in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.

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()