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.
# Modification des balises pour les ressources Amazon Security Lake
Pour modifier les balises (clés de balise ou valeurs de balise) d'une ressource Amazon Security Lake, vous pouvez utiliser la console Security Lake ou l'API Security Lake.
**Important**
La modification des balises d'une ressource peut affecter l'accès à cette ressource. Avant de modifier une clé ou une valeur de balise pour une ressource, passez en revue les politiques Gestion des identités et des accès AWS (IAM) susceptibles d'utiliser la balise pour contrôler l'accès aux ressources.
------
#### [ Console ]
Procédez comme suit pour modifier les balises d'une ressource à l'aide de la console Security Lake.
**Pour modifier les balises d'une ressource**
1. Ouvrez la console Security Lake à l'adresse [https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/).
1. Selon le type de ressource dont vous souhaitez modifier les balises, effectuez l'une des opérations suivantes :
+ Pour une configuration de lac de données, choisissez **Regions** dans le volet de navigation. Ensuite, dans le tableau **Régions**, sélectionnez la Région.
+ Pour un abonné, choisissez **Subscribers** dans le volet de navigation. Ensuite, dans le tableau **Mes abonnés**, sélectionnez l'abonné.
Si l'abonné n'apparaît pas dans le tableau, utilisez le Région AWS sélecteur dans le coin supérieur droit de la page pour sélectionner la région dans laquelle vous l'avez créé. Le tableau répertorie les abonnés existants uniquement pour la région actuelle.
1. Choisissez **Modifier**.
1. Développez la section **identification**. La section **Balises** répertorie toutes les balises actuellement attribuées à la ressource.
1. Effectuez l’une des actions suivantes :
+ Pour ajouter une valeur de balise à une clé de balise existante, entrez la valeur dans le champ **Valeur** à côté de la clé de balise.
+ Pour modifier une clé de balise existante, choisissez **Supprimer** à côté de la balise. Choisissez ensuite **Ajouter une nouvelle étiquette**. Dans le champ **Clé** qui apparaît, entrez la nouvelle clé de balise. Entrez éventuellement une valeur de balise associée dans le champ **Valeur**.
+ Pour modifier la valeur d'une balise existante, choisissez **X** dans la zone **Valeur** qui contient la valeur. Entrez ensuite la nouvelle valeur de balise dans le champ **Valeur**.
+ Pour supprimer une valeur de balise existante, choisissez **X** dans la zone **Valeur** qui contient la valeur.
+ Pour supprimer une balise existante (à la fois la clé et la valeur de la balise), choisissez **Supprimer** à côté de la balise.
Une ressource peut avoir jusqu'à 50 balises. Une clé de balise peut contenir jusqu'à 128 caractères. Une valeur de balise peut contenir jusqu'à 256 caractères. Les caractères peuvent être des lettres, des chiffres, des espaces ou les symboles suivants : \$1. :/= \$1 - @
1. Lorsque vous avez terminé de modifier les balises, choisissez **Enregistrer**.
------
#### [ API ]
Lorsque vous modifiez une balise pour une ressource par programmation, vous remplacez la balise existante par de nouvelles valeurs. Par conséquent, la meilleure façon de modifier une balise dépend de la modification d'une clé de balise, d'une valeur de balise ou des deux. Pour modifier une clé de balise, [supprimez la balise actuelle](tags-remove.md) et [ajoutez-en une nouvelle](tags-add.md).
Pour modifier ou supprimer uniquement la valeur de balise associée à une clé de balise, remplacez la valeur existante à l'aide [TagResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_TagResource.html)de l'API Security Lake. Si vous utilisez le AWS Command Line Interface (AWS CLI), exécutez la commande [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/tag-resource.html). Dans votre demande, spécifiez le Amazon Resource Name (ARN) de la ressource dont vous souhaitez modifier ou supprimer la valeur de balise.
Pour modifier la valeur d'une balise, utilisez le `tags` paramètre pour spécifier la clé de balise dont vous souhaitez modifier la valeur de balise. Spécifiez également la nouvelle valeur de balise pour la clé. Par exemple, la AWS CLI commande suivante modifie la valeur de balise de `Cloud` à `On-Premises` pour la clé de `Environment` balise attribuée à l'abonné spécifié. Cet exemple est formaté pour Linux, macOS ou Unix et utilise le caractère de continuation de ligne barre oblique inverse (\$1) pour améliorer la lisibilité.
```
$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Environment,value=On-Premises
```
Où :
+ `resource-arn`spécifie l'ARN de l'abonné.
+ `Environment`est la clé de balise associée à la valeur de balise à modifier.
+ `On-Premises`est la nouvelle valeur de balise pour la clé de balise spécifiée (`Environment`).
Pour supprimer une valeur de balise d'une clé de balise, ne spécifiez pas de valeur pour l'`value`argument de la clé dans le `tags` paramètre. Par exemple :
```
$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Owner,value=
```
Si l'opération réussit, Security Lake renvoie une réponse HTTP 200 vide. Sinon, Security Lake renvoie une réponse HTTP 4 *xx* ou 500 indiquant pourquoi l'opération a échoué.
------
## Révision des balises pour les ressources Amazon Security Lake
Vous pouvez consulter les balises (clés de balise et valeurs de balise) d'une ressource Amazon Security Lake à l'aide de la console Security Lake ou de l'API Security Lake.
------
#### [ Console ]
Procédez comme suit pour consulter les balises d'une ressource à l'aide de la console Security Lake.
**Pour consulter les balises d'une ressource**
1. Ouvrez la console Security Lake à l'adresse [https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/).
1. Selon le type de ressource dont vous souhaitez vérifier les balises, effectuez l'une des opérations suivantes :
+ Pour une configuration de lac de données, choisissez **Regions** dans le volet de navigation. Dans le tableau **Régions**, sélectionnez la région, puis choisissez **Modifier**. Développez ensuite la section **Tags**.
+ Pour un abonné, choisissez **Subscribers** dans le volet de navigation. Ensuite, dans le tableau **Mes abonnés**, choisissez le nom de l'abonné.
Si l'abonné n'apparaît pas dans le tableau, utilisez le Région AWS sélecteur dans le coin supérieur droit de la page pour sélectionner la région dans laquelle vous l'avez créé. Le tableau répertorie les abonnés existants uniquement pour la région actuelle.
La section **Balises** répertorie toutes les balises actuellement attribuées à la ressource.
------
#### [ API ]
Pour récupérer et examiner les balises d'une ressource existante par programmation, utilisez le [ListTagsForResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_ListTagsForResource.html)fonctionnement de l'API Security Lake. Dans votre demande, utilisez le `resourceArn` paramètre pour spécifier le nom de ressource Amazon (ARN) de la ressource.
Si vous utilisez le AWS Command Line Interface (AWS CLI), exécutez la [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/list-tags-for-resource.html)commande et utilisez le `resource-arn` paramètre pour spécifier l'ARN de la ressource. Par exemple :
```
$ aws securitylake list-tags-for-resource --resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab
```
Dans l'exemple précédent, *arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab* il s'agit de l'ARN d'un abonné existant.
Si l'opération aboutit, Security Lake renvoie un `tags` tableau. Chaque objet du tableau spécifie une balise (clé de balise et valeur de balise) actuellement attribuée à la ressource. Par exemple :
```
{
"tags": [
{
"key": "Environment",
"value": "Cloud"
},
{
"key": "CostCenter",
"value": "12345"
},
{
"key": "Owner",
"value": ""
}
]
}
```
Où `Environment``CostCenter`, et `Owner` sont les clés de balise attribuées à la ressource. `Cloud`est la valeur de balise associée à la clé de `Environment` balise. `12345`est la valeur de balise associée à la clé de `CostCenter` balise. Aucune valeur de `Owner` balise n'est associée à la clé de balise.
------