Balises

Amazon SWF prend en charge le balisage de l'exécution d'un flux de travail. Cette approche est utile lorsque vous avez un grand nombre de ressources.

Amazon SWF prend en charge le balisage d'une exécution de flux de travail avec un maximum de cinq balises. Chaque balise est une chaîne de forme libre qui peut contenir jusqu'à 256 caractères. Si vous souhaitez utiliser des balises, vous devez les attribuer lorsque vous lancez une exécution de flux de travail. Vous ne pouvez pas ajouter de balises à une exécution de flux de travail une fois que celle-ci a commencé. Vous ne pouvez pas non plus supprimer ou modifier les balises déjà attribuées.

IAM prend en charge le contrôle de l'accès aux domaines Amazon SWF sur la base de balises. Pour contrôler l'accès basé sur des balises, vous devez fournir des informations sur vos balises dans l'élément de condition d'une stratégie IAM.

Gérer les balises

Gérez les balises Amazon Simple Workflow Service à l'aide AWS des SDK ou en interagissant directement avec l'API Amazon SWF. L'API vous permet d'ajouter des balises lors de l'enregistrement d'un domaine, de répertorier des balises pour un domaine existant ainsi que d'ajouter ou de supprimer des balises pour un domaine existant.

Note

La limite est de 50 balises par ressource. Consultez Quotas de compte généraux pour Amazon SWF.

• RegisterDomain

• ListTagsForResource

• TagResource

• UntagResource

Pour plus d'informationsUtilisation des API Amazon SWF, consultez et le manuel Amazon Simple Workflow Service API Reference.

Étiqueter les exécutions de workflows

Avec Amazon SWF, vous pouvez associer des balises à des exécutions de flux de travail, puis demander des exécutions de flux de travail en fonction de ces balises. Vous pouvez filtrer la liste lorsque vous utilisez les opérations de visibilité. En sélectionnant soigneusement les balises que vous attribuez à une exécution, vous pouvez les utiliser pour créer des listes pertinentes.

Par exemple, supposons que vous exécutiez plusieurs centres de traitement. À l'aide de balises, vous pouvez répertorier les processus en cours dans un centre de distribution spécifique. Ou, si un client convertit différents types de fichiers multimédia, les balises peuvent indiquer différents processus lors de la conversion de fichiers vidéo, audio et image.

Vous pouvez associer jusqu'à cinq balises à une exécution de flux de travail à l'aide de l'action StartWorkflowExecution, de la décision StartChildWorkflowExecution ou de la décision ContinueAsNewWorkflowExecution. Lorsque vous utilisez des actions de visibilité pour répertorier ou compter les exécutions de flux de travail, vous pouvez filtrer les résultats en fonction de vos balises.

Pour utiliser le balisage

1. Concevez une stratégie de balisage. Pensez aux besoins de votre entreprise et créez une liste des balises qui ont un intérêt pour vous. Déterminer les exécutions qui recevront des balises. Même si un maximum de cinq balises peuvent être assignés à une exécution, votre bibliothèque peut contenir autant de balises que vous le souhaitez. Comme une balise peut être une valeur de chaîne comprenant jusqu'à 256 caractères, elle permet de décrire presque n'importe quel concept d'entreprise.

2. Identifiez une exécution avec jusqu'à cinq balises lors de sa création.

3. Pour répertorier ou comptabiliser les exécutions qui contiennent une balise spécifique, définissez le paramètre tagFilter avec les actions ListOpenWorkflowExecutions, ListClosedWorkflowExecutions, CountOpenWorkflowExecutions et CountClosedWorkflowExecutions. L'action filtrera les exécutions en fonction des balises spécifiées.

L'association d'une balise à une exécution de flux de travail est irréversible.

Vous ne pouvez spécifier qu'une seule balise dans le paramètre tagFilter avec ListWorkflowExecutions. En outre, la mise en correspondance des balises est sensible à la casse. Seules les correspondances exactes renvoient des résultats.

Supposons que vous ayez déjà configuré deux exécutions avec les balises suivantes.

Nom de l'exécution	Balises attribuées
Exécution 1	Consommateur, février 2011
Exécution 2	Vente en gros, mars 2011

Vous pouvez filtrer la liste des exécutions renvoyées par ListOpenWorkflowExecutions au niveau de la balise Consumer. Les valeurs oldestDate et latestDate sont définies en tant que valeurs horaires Unix.

https://swf.us-east-1.amazonaws.com
  RespondDecisionTaskCompleted
  {
    "domain":"867530901",
    "startTimeFilter":{
        "oldestDate":1262332800,
        "latestDate":1325348400
    },
    "tagFilter":{
      "tag":"Consumer"
      }
  }

Contrôlez l'accès aux domaines à l'aide de tags

Vous pouvez contrôler l'accès aux domaines Amazon Simple Workflow Service en référençant les balises associées aux domaines Amazon SWF dans IAM. Par exemple, vous pouvez restreindre les domaines qui incluent une balise dont la clé environment et la valeur sont production :

{
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Deny",
              "Action": "swf:*",
              "Resource": "arn:aws:swf:*:123456789012:/domain/*",
              "Condition": {
                  "StringEquals": {"aws:ResourceTag/environment": "production"}
              }
          }
      ]
  }

Cette stratégie permettra de Deny l'accès à n'importe quel domaine qui a été balisé environment/production.

Pour plus d’informations, consultez :

• Contrôle de l'accès à l'aide de balises IAM

• Stratégies basées sur des balises