Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. En savoir plus »

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.

Balisage des ressources Amazon Forecast

Une balise est une étiquette que vous pouvez éventuellement définir et associer à AWS des ressources, notamment à certains types de ressources Amazon Forecast. Les balises peuvent vous aider à classer et à gérer ces types de ressources de différentes façons, notamment par objectif, par propriétaire, par environnement ou selon d'autres critères. Par exemple, vous pouvez utiliser des balises pour appliquer des stratégies ou une automatisation, ou pour identifier les ressources qui sont soumises à certaines exigences en matière de conformité. Vous pouvez ajouter des balises aux types de ressources Forecast suivants :

Une ressource peut avoir jusqu'à 50 balises.

Gestion des balises

Chaque balise est constituée d'une clé de balise obligatoire et d'une valeur de balise facultative que vous définissez. Une clé de balise est une étiquette générale qui fait office de catégorie pour des valeurs de balise plus spécifiques. Une valeur de balise tient lieu de descripteur pour une clé de balise. Par exemple, si vous disposez de deux versions d'une tâche d'importation de jeux de données Forecast (l'une pour les tests internes et l'autre pour la production), vous pouvez attribuer une clé de Environment balise aux deux projets. La valeur de la clé de Environment balise peut correspondre Test à une version de la tâche d'importation de l'ensemble de données et Production à l'autre version.

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 Unicode, des chiffres un espace ou l'une des symboles suivants : _ . : / = + -. Les restrictions supplémentaires suivantes s'appliquent aux balises :

Pour ajouter, afficher, mettre à jour et supprimer des clés et des valeurs de balise dans les ressources Forecast, vous pouvez utiliser le AWS Command Line Interface (AWS CLI), l'API Forecast ou un AWS SDK.

Utilisation de balises dans les politiques IAM

Après avoir commencé à implémenter des balises, vous pouvez appliquer des autorisations de niveau ressource basées sur des balises aux politiques AWS Identity and Access Management (IAM) et aux opérations d'API. Cela inclut les opérations qui prennent en charge l'ajout de balises aux ressources lors de la création de ressources. En utilisant les balises de cette manière, vous pouvez mettre en œuvre un contrôle granulaire des groupes et utilisateurs autorisés à créer et à étiqueter des ressources, et des groupes et utilisateurs autorisés à créer, mettre à jour et supprimer des balises de manière plus générale. Compte AWS

Par exemple, vous pouvez créer une politique qui permet à un utilisateur d'avoir un accès complet à toutes les ressources Forecast dont le nom est une valeur dans le Owner tag de la ressource.

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Sid": "ModifyResourceIfOwner",
         "Effect": "Allow",
         "Action": "forecast:*",
         "Resource": "*",
         "Condition": {
            "StringEqualsIgnoreCase": {
               "aws:ResourceTag/Owner": "${aws:username}"
            }
         }
      }
   ]
}

L'exemple suivant montre comment créer une politique permettant de créer et de supprimer un ensemble de données. Ces opérations ne sont autorisées que si le nom d'utilisateur estjohndoe.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "forecast:CreateDataset",
                "forecast:DeleteDataset"
            ],
            "Resource": "arn:aws:forecast:*:*:dataset/*",
            "Condition": {
                "StringEquals": {"aws:username" : "johndoe"}
            }
        },
        {
            "Effect": "Allow",
            "Action": "forecast:DescribeDataset",
            "Resource": "*"
        }
    ]
}

Si vous définissez des autorisations au niveau des ressources basées sur des balises, les autorisations prennent effet immédiatement. Vos ressources sont ainsi plus sécurisées dès leur création et vous pouvez rapidement commencer à appliquer l'utilisation des balises pour les nouvelles ressources. Vous pouvez également utiliser des autorisations au niveau des ressources afin de contrôler les clés et les valeurs de balise qui peuvent être associés à des ressources nouvelles et existantes. Pour plus d'informations, consultez Contrôle de l'accès à l'aide de balises dans le Guide de l'utilisateur AWS IAM.

Ajout de balises à des ressources

Les exemples suivants montrent comment ajouter une balise aux ressources Forecast en utilisant le AWS CLIet le AWS Management Console.

AWS CLI

Pour ajouter une balise lors de la création d'une nouvelle ressource Forecast avec le AWS CLI, utilisez la create commande appropriée pour la ressource et incluez le tags paramètre et les valeurs. Par exemple, la commande suivante de crée un nouveau groupe de jeux de données nommé myDatasetGroup d'après un domaine PERSONNALISÉ et ajoute les balises suivantes : une clé de Environment balise avec une valeur de Test balise, et une clé de Owner balise et une xyzCorp valeur.

aws forecast create-dataset-group \
--dataset-group-name myDatasetGroup \
--dataset-arns arn:aws:forecast:region:acct-id:dataset/dataset_name \
--domain CUSTOM \
--tags Key=Environment,Value=Test Key=Owner,Value=xyzCorp

Pour plus d'informations sur les commandes que vous pouvez utiliser pour créer une ressource Forecast, consultez le Forecast AWS CLI Command Reference.

Pour ajouter une balise à une ressource existante, utilisez la tag-resource commande, spécifiez l'ARN de la ressource et indiquez la clé et la valeur de la balise dans le tags-model paramètre.

aws forecast tag-resource \
--resource-arn resource ARN \
--tags Key=key,Value=value

AWS Management Console

Lorsque vous créez une ressource dans Forecast, vous pouvez ajouter des balises facultatives. L'exemple suivant ajoute une balise à un groupe de jeux de données. L'ajout de balises à d'autres ressources suit un schéma similaire.

Pour ajouter des balises à un nouveau groupe de jeux de données

1. Connectez-vous à la console Amazon Forecast AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/forecast/.

2. Choisissez Create dataset group (Créer un groupe d'ensembles de données).

3. Pour le nom du groupe de jeux de données, entrez un nom.

4. Pour Domaine de prévision, choisissez un domaine.

5. Sélectionnez Ajouter une nouvelle balise.

6. Pour Clé et Valeur, entrez les valeurs appropriées.

   Par exemple, respectivement, Environment et Test.

7. Pour ajouter d'autres balises, choisissez Ajouter une nouvelle étiquette.

   Vous pouvez ajouter jusqu'à 50 balises à une ressource.

8. Choisissez Next pour continuer à créer votre ressource.

Informations supplémentaires

Pour plus d'informations sur le balisage, consultez les ressources suivantes.