Etiquetas

Amazon SWF permite etiquetar una ejecución de flujo de trabajo. Esto es útil especialmente cuando dispone de muchos recursos.

Amazon SWF admite el etiquetado de una ejecución de flujo de trabajo con hasta cinco etiquetas. Cada etiqueta es una cadena de formato libre y puede tener una longitud de hasta 256 caracteres. Si desea usar etiquetas, debe asignarlas al iniciar una ejecución de flujo de trabajo. No puede añadir etiquetas a una ejecución de flujo de trabajo una vez que se haya iniciado ni tampoco editar o quitar etiquetas que se hayan asignado a una ejecución de flujo de trabajo.

IAM permite controlar el acceso a los dominios de Amazon SWF en función de las etiquetas. Para controlar el acceso según las etiquetas, proporcione información sobre las etiquetas en el elemento de condición de una política de IAM.

Administración de etiquetas

Gestione las etiquetas de Amazon Simple Workflow Service mediante AWS los SDK o interactuando directamente con la API de Amazon SWF. Si utiliza la API, puede añadir etiquetas cuando registre un dominio, muestre las etiquetas de un dominio actual y las añada o elimine.

nota

Cada recurso puede tener un máximo de 50 etiquetas. Consulte Cuotas de cuentas generales para Amazon SWF

• RegisterDomain

• ListTagsForResource

• TagResource

• UntagResource

Para obtener más información, consulte Cómo trabajar con las API de Amazon SWF y la Referencia de la API de Amazon Simple Email Service.

Etiqueta las ejecuciones del flujo de trabajo

Con Amazon SWF, puede asociar etiquetas a las ejecuciones del flujo de trabajo y, a continuación, consultar las ejecuciones del flujo de trabajo en función de estas etiquetas. Puede filtrar las listas cuando utilice las operaciones de visibilidad. Al seleccionar cuidadosamente las etiquetas que asigne a una ejecución, podrá utilizarlas para proporcionar listados significativos.

Suponga, por ejemplo, que ejecuta varios centros logísticos. Con las etiquetas, puedes enumerar los procesos que se llevan a cabo en un centro logístico específico. O bien, si un cliente está convirtiendo diferentes tipos de archivos multimedia, las etiquetas podrían indicar distintos procesos al convertir archivos de vídeo, audio e imagen.

Puede asociar hasta cinco etiquetas a una ejecución de flujo de trabajo cuando comienza la ejecución con la acción StartWorkflowExecution, la decisión StartChildWorkflowExecution o la decisión ContinueAsNewWorkflowExecution. Cuando utilizas acciones de visibilidad para enumerar o contar las ejecuciones del flujo de trabajo, puedes filtrar los resultados en función de tus etiquetas.

Para utilizar el etiquetado

1. Idee una estrategia de etiquetado. Piense en los requisitos de su compañía y cree una lista de etiquetas que tengan sentido para usted. Determine las ejecuciones que irán con las etiquetas. Aunque es posible asignar un máximo de cinco etiquetas a una ejecución, su biblioteca de etiquetas puede incluir el número de etiquetas que desee. Puesto que cada etiqueta puede incluir cualquier valor de cadena hasta 256 caracteres, una etiqueta puede describir casi cualquier concepto de negocio.

2. Etiquete la ejecución con un máximo de cinco etiquetas cuando la cree.

3. Para enumerar o contar las ejecuciones que están etiquetadas con una etiqueta en concreto, especifique el parámetro tagFilter con las acciones ListOpenWorkflowExecutions, ListClosedWorkflowExecutions, CountOpenWorkflowExecutions y CountClosedWorkflowExecutions. La acción filtrará las ejecuciones en función de las etiquetas especificadas.

Al asociar una etiqueta con una ejecución de flujo de trabajo, queda permanentemente asociada a esa ejecución y no se puede quitar.

Puede especificar una sola etiqueta en el parámetro tagFilter con ListWorkflowExecutions. Además, el establecimiento de correspondencia de etiquetas no distingue entre minúsculas y mayúsculas y solo muestra las coincidencias exactas.

Suponga que ya ha configurado dos ejecuciones con las siguientes etiquetas.

Nombre de la ejecución	Etiquetas asignadas
Ejecución uno	Consumidor, febrero de 2011
Ejecución dos	Venta al por mayor, marzo de 2011

Puede filtrar la lista de ejecuciones devueltas por ListOpenWorkflowExecutions en la etiqueta Consumidor. Los valores oldestDate y latestDate están especificados como valores de tiempo Unix.

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

Controle el acceso a los dominios con etiquetas

Para controlar el acceso a los dominios de Amazon Simple Workflow Service, puede hacer referencia a las etiquetas asociadas a dichos dominios de Amazon SWF en IAM. Por ejemplo, puedes restringir los dominios que incluyan una etiqueta en la que la clave esté environment y el valor seaproduction:

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

Esta política denegará (Deny) el acceso a cualquier dominio que tenga la etiqueta environment/production.

Para obtener más información, consulte:

• Control del acceso mediante etiquetas de IAM

• Políticas basadas en etiquetas