Cómo trabajar con los dominios de Amazon SWF usando la AWS CLI - AWS Command Line Interface

Python 2.7, 3.4 y 3.5 están obsoletas para la versión 1 de AWS CLI. Para obtener más información, consulte la sección de la versión 1 de AWS CLI de Acerca de las versiones de AWS CLI.

Cómo trabajar con los dominios de Amazon SWF usando la AWS CLI

Puede utilizar la AWS Command Line Interface (AWS CLI) para administrar los dominios de Amazon Simple Workflow Service (Amazon SWF).

Visualización de los dominios

Para obtener una lista de los dominios de Amazon SWF que haya registrado en su cuenta de AWS, puede utilizar swf list-domains. Debe incluir --registration-status y especificar REGISTERED o DEPRECATED.

A continuación se muestra un ejemplo mínimo.

$ aws swf list-domains --registration-status REGISTERED { "domainInfos": [ { "status": "REGISTERED", "name": "ExampleDomain" }, { "status": "REGISTERED", "name": "mytest" } ] }
nota

Para ver un ejemplo del uso de DEPRECATED, consulte Dar de baja un dominio.

Para obtener más información, consulte list-domains en la Referencia de comandos de la AWS CLI.

Obtener información acerca de un dominio

Para obtener información detallada acerca de un determinado dominio, use swf describe-domain. Hay un parámetro obligatorio, --name, que toma el nombre del dominio sobre el que desea obtener información, tal y como se muestra en el siguiente ejemplo.

$ aws swf describe-domain --name ExampleDomain { "domainInfo": { "status": "REGISTERED", "name": "ExampleDomain" }, "configuration": { "workflowExecutionRetentionPeriodInDays": "1" } }

Para obtener más información, consulte describe-domain en la Referencia de comandos de la AWS CLI.

Registrar un dominio

Para registrar nuevos dominios, use swf register-domain.

Hay dos parámetros obligatorios: --name y --workflow-execution-retention-period-in-days. El parámetro --name toma el nombre del dominio para registrarse. El parámetro --workflow-execution-retention-period-in-days toma un número entero para especificar el número de días que se van a conservar los datos de la ejecución del flujo de trabajo de este dominio, hasta un período máximo de 90 días (para obtener más información, consulte las preguntas frecuentes de Amazon SWF).

Si especifica cero (0) para este valor, el periodo de retención se ajusta automáticamente a la duración máxima. De lo contrario, los datos de ejecución de flujo de trabajo no se conservarán después de que haya transcurrido el número especificado de días. En el siguiente ejemplo, se muestra cómo registrar un nuevo dominio.

$ aws swf register-domain --name MyNeatNewDomain --workflow-execution-retention-period-in-days 0

El comando no devuelve ningún resultado, pero se puede utilizar swf list-domains o swf describe-domain para ver el nuevo dominio, tal y como se muestra en el ejemplo siguiente.

$ aws swf describe-domain --name MyNeatNewDomain { "domainInfo": { "status": "REGISTERED", "name": "MyNeatNewDomain" }, "configuration": { "workflowExecutionRetentionPeriodInDays": "0" } }

Para obtener más información, consulte register-domain en la Referencia de comandos de AWS CLI.

Dar de baja un dominio

Para dar de baja un dominio (aunque todavía podrá verlo, no podrá crear nuevas ejecuciones de flujo de trabajo ni tipos de registro en él), use swf deprecate-domain. Solo tiene un parámetro necesario, --name, que toma el nombre del dominio que se va a descartar.

$ aws swf deprecate-domain --name MyNeatNewDomain

Al igual que ocurre con register-domain, no se devuelve ningún resultado. Si usa list-domains para ver los dominios registrados, sin embargo, verá que el dominio ya no aparece entre ellos. También puede utilizar --registration-status DEPRECATED.

$ aws swf list-domains --registration-status DEPRECATED { "domainInfos": [ { "status": "DEPRECATED", "name": "MyNeatNewDomain" } ] }

Para obtener más información, consulte deprecate-domain en la Referencia de comandos de AWS CLI.