Etichettare le risorse di Macie

Quando crei un elenco di dati consentiti, un identificatore di dati personalizzato o un processo di rilevamento di dati sensibili, la console Amazon Macie offre opzioni per aggiungere tag alla risorsa. Segui le istruzioni sulla console per aggiungere tag a questi tipi di risorse al momento della creazione delle risorse. Per aggiungere tag a una regola di filtro o di soppressione o a un account membro di un'organizzazione, devi creare la risorsa prima di potervi aggiungere tag.

Per aggiungere uno o più tag a una risorsa esistente utilizzando la console Amazon Macie, segui questi passaggi.

Per creare una risorsa e aggiungervi uno o più tag a livello di codice, utilizzate l'Createoperazione appropriata per il tipo di risorsa che desiderate creare:

Nella richiesta, utilizzate il tags parametro per specificare la chiave del tag (key) e il valore opzionale del tag (value) per ogni tag da aggiungere alla risorsa. Il tags parametro specifica una string-to-string mappa delle chiavi dei tag e dei valori dei tag associati.

Per aggiungere uno o più tag a una risorsa esistente, usa il TagResourcefunzionamento di Amazon Macie API o, se utilizzi il AWS CLI, esegui il comando tag-resource. Nella richiesta, specifica l'Amazon Resource Name (ARN) della risorsa a cui desideri aggiungere un tag. Utilizza il tags parametro per specificare il tag key (key) e il tag value opzionale (value) per ogni tag da aggiungere alla risorsa. Come nel caso delle Create operazioni e dei comandi, il tags parametro specifica una string-to-string mappa delle chiavi dei tag e dei valori dei tag associati.

Ad esempio, il AWS CLI comando seguente aggiunge una chiave di Stack tag con un valore di Production tag al processo specificato. Questo esempio è formattato per Microsoft Windows e utilizza il carattere di continuazione di riga (^) per migliorare la leggibilità.

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\"}

Dove:

Nell'esempio seguente, il comando aggiunge diversi tag al job:

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\",\"CostCenter\":\"12345\",\"Owner\":\"jane-doe\"}

Per ogni tag in una tags mappa, sono obbligatori key sia gli value argomenti che. Tuttavia, il valore dell'valueargomento può essere una stringa vuota. Se non desiderate associare un valore di tag a una chiave di tag, non specificate un valore per l'valueargomento. Ad esempio, il AWS CLI comando seguente aggiunge una chiave di Owner tag senza alcun valore di tag associato:

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Owner\":\"\"}

Se un'operazione di etichettatura ha esito positivo, Macie restituisce una risposta 204 vuotaHTTP. Altrimenti, Macie restituisce una risposta HTTP 4 xx o 500 che indica il motivo per cui l'operazione non è riuscita.

Segui questi passaggi per esaminare i tag di una risorsa utilizzando la console Amazon Macie.

Per recuperare e rivedere i tag di una risorsa esistente a livello di codice, puoi utilizzare l'Describeoperazione Get OR appropriata per il tipo di risorsa per cui desideri rivedere i tag. Ad esempio, se si utilizza l'GetCustomDataIdentifieroperazione o si esegue il get-custom-data-identifiercomando da AWS Command Line Interface (AWS CLI), la risposta include un oggetto. tags L'oggetto elenca tutti i tag (sia le chiavi che i valori dei tag) attualmente assegnati alla risorsa.

Puoi anche utilizzare il ListTagsForResourcefunzionamento di Amazon MacieAPI. Nella tua richiesta, utilizza il resourceArn parametro per specificare l'Amazon Resource Name (ARN) della risorsa. Se utilizzi il AWS CLI, esegui il list-tags-for-resourcecomando e usa il resource-arn parametro per specificare ARN la risorsa. Per esempio:

C:\> aws macie2 list-tags-for-resource --resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample

Nell'esempio precedente, arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample è il risultato ARN di un processo di rilevamento di dati sensibili esistente.

Se l'operazione ha esito positivo, Macie restituisce un tags oggetto che elenca tutti i tag (sia le chiavi che i valori dei tag) attualmente assegnati alla risorsa. Per esempio:

{
    "tags": {
        "Stack": "Production",
        "CostCenter": "12345",
        "Owner": ""
    }
}

Dove StackCostCenter, e Owner sono le chiavi dei tag assegnate alla risorsa. Productionè il valore del tag associato alla chiave del Stack tag. 12345è il valore del tag associato alla chiave del CostCenter tag. La chiave Owner tag non ha un valore di tag associato.

Per recuperare un elenco di tutte le risorse Macie dotate di tag e di tutti i tag assegnati a ciascuna di tali risorse, usa l'GetResourcesoperazione Tagging. AWS Resource Groups API Nella richiesta, imposta il valore del parametro su. ResourceTypeFilters macie2 A tale scopo AWS CLI, eseguite il comando get-resources e impostate il valore del resource-type-filters parametro su. macie2 Per esempio:

C:\> aws resourcegroupstaggingapi get-resources --resource-type-filters "macie2"

Se l'operazione ha esito positivo, Resource Groups restituisce un ResourceTagMappingList array che contiene tutte le risorse Macie dotate ARNs di tag e le chiavi e i valori dei tag assegnati a ciascuna di tali risorse.

Segui questi passaggi per modificare i tag di una risorsa utilizzando la console Amazon Macie.

Quando modifichi un tag per una risorsa a livello di codice, sovrascrivi il tag esistente con nuovi valori. Pertanto, il modo migliore per modificare un tag dipende dal fatto che si desideri modificare una chiave di tag, un valore di tag o entrambi. Per modificare una chiave di tag, rimuovi il tag corrente e aggiungi un nuovo tag.

Per modificare o rimuovere solo il valore del tag associato a una chiave di tag, sovrascrivi il valore esistente utilizzando il TagResourcefunzionamento di Amazon API Macie o, se utilizzi AWS Command Line Interface il AWS CLI(), eseguendo il comando tag-resource. Nella richiesta, specifica l'Amazon Resource Name (ARN) della risorsa di cui desideri modificare o rimuovere il valore del tag.

Per modificare il valore di un tag per una chiave di tag, usa il tags parametro per specificare la chiave di tag di cui desideri modificare il valore del tag e specifica il nuovo valore del tag per la chiave. Ad esempio, il comando seguente modifica il valore del tag da Production a Staging per la chiave di Stack tag assegnata al processo di rilevamento dei dati sensibili specificato. Questo esempio è formattato per Microsoft Windows e utilizza il carattere di continuazione di riga (^) per migliorare la leggibilità.

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Staging\"}

Dove:

Per rimuovere un valore di tag da una chiave di tag, non specificate un valore per l'valueargomento nel tags parametro. Per esempio:

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"\"}

Se l'operazione ha esito positivo, Macie restituisce una risposta HTTP 204 vuota. Altrimenti, Macie restituisce una risposta HTTP 4 xx o 500 che indica il motivo per cui l'operazione non è riuscita.

Segui questi passaggi per rimuovere uno o più tag da una risorsa utilizzando la console Amazon Macie.

Per rimuovere uno o più tag da una risorsa a livello di codice, utilizza il UntagResourcefunzionamento di Amazon Macie. API Nella tua richiesta, utilizza il resourceArn parametro per specificare l'Amazon Resource Name (ARN) della risorsa da cui rimuovere un tag. Usa il tagKeys parametro per specificare la chiave del tag da rimuovere. Per rimuovere solo un valore di tag specifico (non una chiave di tag) da una risorsa, modifica il tag anziché rimuoverlo.

Se stai usando il AWS Command Line Interface (AWS CLI), esegui il comando untag-resource e usa il resource-arn parametro per specificare la ARN risorsa da cui rimuovere un tag. Utilizzate il tag-keys parametro per specificare la chiave del tag da rimuovere. Ad esempio, il comando seguente rimuove il Stack tag (sia la chiave del tag che il valore del tag) dal processo di rilevamento dei dati sensibili specificato:

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack

Dove resource-arn specifica il ARN processo da cui rimuovere un tag ed Stack è la chiave del tag da rimuovere.

Per rimuovere più tag da una risorsa, aggiungete ogni chiave di tag aggiuntiva come argomento per il tag-keys parametro. Per esempio:

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack Owner

Dove resource-arn specifica il ARN processo da cui rimuovere i tag e Stack e Owner sono le chiavi dei tag da rimuovere.

Se l'operazione ha esito positivo, Macie restituisce una risposta 204 vuotaHTTP. Altrimenti, Macie restituisce una risposta HTTP 4 xx o 500 che indica il motivo per cui l'operazione non è riuscita.