Utilizzo dei AWS tag con S3 Access Grants

I tag in Amazon S3 Access Grants hanno caratteristiche simili ai tag degli oggetti in Amazon S3. Ogni tag è una coppia chiave-valore. Le risorse in S3 Access Grants alle quali puoi aggiungere tag sono istanze, posizioni e concessioni di S3 Access Grants.

Nota

L'etichettatura in S3 Access Grants utilizza operazioni diverse rispetto API alla codifica degli oggetti. S3 Access Grants utilizza le ListTagsForResourceAPIoperazioni, e TagResourceUntagResource, in cui una risorsa può essere un'istanza di S3 Access Grants, una posizione registrata o una concessione di accesso.

Analogamente ai tag degli oggetti, si applicano le seguenti limitazioni:

• Puoi aggiungere tag alle nuove risorse S3 Access Grants al momento della loro creazione oppure puoi aggiungere tag alle risorse esistenti.

• Puoi associare fino a un massimo di 10 tag a ciascuna risorsa. Se alla stessa risorsa sono associati più tag, questi devono avere chiavi di tag univoche.

• Una chiave di tag può essere composta da un massimo di 128 caratteri Unicode e i valori di tag possono essere composti da un massimo di 256 caratteri Unicode. I tag sono rappresentati internamente in -16. UTF In UTF -16, i caratteri occupano 1 o 2 posizioni di caratteri.

• Per chiavi e valori viene fatta distinzione tra maiuscole e minuscole.

Per ulteriori informazioni sulle restrizioni sui tag, consulta Restrizioni sui tag definiti dall'utente nella Guida per l'utente di AWS Billing .

Puoi taggare le risorse in S3 Access Grants utilizzando AWS Command Line Interface (AWS CLI), Amazon REST API S3 o. AWS SDKs

Utilizzando il AWS CLI

Per installare AWS CLI, vedere Installazione di AWS CLI nella Guida per l'AWS Command Line Interface utente.

Puoi aggiungere tag a una risorsa S3 Access Grants quando la crei o dopo averla creata. Di seguito sono riportati esempi che mostrano come aggiungere tag a un'istanza S3 Access Grants o rimuoverli da essa. Puoi eseguire operazioni simili per le posizioni registrate e le concessioni di accesso.

Per utilizzare i seguenti comandi di esempio, sostituisci user input placeholders con le tue informazioni.

Esempio – Crea un'istanza S3 Access Grants con tag

aws s3control create-access-grants-instance \
 --account-id 111122223333 \
 --profile access-grants-profile \
 --region us-east-2 \
 --tags Key=tagKey1,Value=tagValue1

Risposta:

 {
    "CreatedAt": "2023-10-25T01:09:46.719000+00:00",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}

Esempio – Aggiungi un tag a un'istanza S3 Access Grants già creata

aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey2,Value=tagValue2

Esempio – Elenca i tag per l'istanza S3 Access Grants

aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2

Risposta:

{
    "Tags": [
        {
            "Key": "tagKey1",
            "Value": "tagValue1"
        },
        {
            "Key": "tagKey2",
            "Value": "tagValue2"
        }
    ]
}

Esempio – Rimuovi tag dall'istanza S3 Access Grants

aws s3control untag-resource \
 --account-id 111122223333 \
 --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
 --profile access-grants-profile \
 --region us-east-2 \
 --tag-keys "tagKey2"

Usando il REST API

Puoi utilizzare Amazon S3 API per etichettare, rimuovere i tag o elencare i tag per un'istanza S3 Access Grants, una sede registrata o una concessione di accesso. Per informazioni sul REST API supporto per la gestione dei tag S3 Access Grants, consulta le seguenti sezioni in Amazon Simple Storage Service API Reference:

• TagResource

• UntagResource

• ListTagsForResource