Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Assegnazione di tag alle raccolte
È possibile identificare, organizzare, cercare e filtrare le raccolte Amazon Rekognition utilizzando i tag. Ogni tag è un’etichetta composta da una chiave e da un valore definiti dall’utente.
Puoi anche utilizzare i tag per controllare l'accesso a una raccolta utilizzando Identity and Access Management (IAM). Per ulteriori informazioni, vedere [Controllo dell'accesso alle AWS risorse mediante i tag delle risorse](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
**Topics**
+ [Aggiunta di tag a una nuova raccolta](#add-tag-new-collection)
+ [Aggiunta di tag a una raccolta esistente](#add-tag-existing-collection)
+ [Creazione dell'elenco dei tag di una raccolta](#list-tags-collection)
+ [Eliminazione dei tag da una raccolta](#delete-tag-collection)
## Aggiunta di tag a una nuova raccolta
Puoi aggiungere tag a una raccolta al momento della creazione utilizzando l'operazione `CreateCollection`. Specifica uno o più tag nel parametro di input dell'array `Tags`.
------
#### [ AWS CLI ]
Sostituisci il valore di `profile_name` con il nome del tuo profilo di sviluppatore.
```
aws rekognition create-collection --collection-id "collection-name" --tags "{"key1":"value1","key2":"value2"}" --profile profile-name
```
Per i dispositivi Windows:
```
aws rekognition create-collection --collection-id "collection-name" --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
```
------
#### [ Python ]
Sostituisci il valore di `profile_name` nella riga che crea la sessione di Rekognition con il nome del tuo profilo di sviluppatore.
```
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()
```
------
## Aggiunta di tag a una raccolta esistente
Per aggiungere uno o più tag a una raccolta esistente, utilizza l'operazione `TagResource`. Specifica il nome della risorsa Amazon (ARN) (`ResourceArn`) della raccolta e i tag (`Tags`) che intendi aggiungere. L'esempio seguente mostra come aggiungere due tag.
------
#### [ AWS CLI ]
Sostituisci il valore di `profile_name` con il nome del tuo profilo di sviluppatore.
```
aws rekognition tag-resource --resource-arn collection-arn --tags "{"key1":"value1","key2":"value2"}" --profile profile-name
```
Per i dispositivi Windows:
```
aws rekognition tag-resource --resource-arn collection-arn --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
```
------
#### [ Python ]
Sostituisci il valore di `profile_name` nella riga che crea la sessione di Rekognition con il nome del tuo profilo di sviluppatore.
```
# 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()
```
------
**Nota**
Se non conosci il nome della risorsa Amazon della raccolta, puoi utilizzare l'operazione `DescribeCollection`.
## Creazione dell'elenco dei tag di una raccolta
Per elencare i tag associati a una raccolta, utilizza l'operazione `ListTagsForResource` e specifica l'ARN della raccolta (`ResourceArn`). La risposta è una mappa di chiavi e valori dei tag associati alla raccolta specificata.
------
#### [ AWS CLI ]
Sostituisci il valore di `profile_name` con il nome del tuo profilo di sviluppatore.
```
aws rekognition list-tags-for-resource --resource-arn resource-arn --profile profile-name
```
------
#### [ Python ]
Sostituisci il valore di `profile_name` nella riga che crea la sessione di Rekognition con il nome del tuo profilo di sviluppatore.
```
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()
```
------
L'output mostra un elenco di tag associati alla raccolta:
```
{
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
```
## Eliminazione dei tag da una raccolta
Per rimuovere uno o più tag da una raccolta, utilizza l'operazione `UntagResource`. Specifica l'ARN del modello (`ResourceArn`) e le chiavi di tag (`Tag-Keys`) che desideri rimuovere.
------
#### [ AWS CLI ]
Sostituisci il valore di `profile_name` con il nome del tuo profilo di sviluppatore.
```
aws rekognition untag-resource --resource-arn resource-arn --profile profile-name --tag-keys "key1" "key2"
```
In alternativa, puoi specificare le chiavi di tag in questo formato:
```
--tag-keys key1,key2
```
------
#### [ Python ]
Sostituisci il valore di `profile_name` nella riga che crea la sessione di Rekognition con il nome del tuo profilo di sviluppatore.
```
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()
```
------