AWS Command Line Interface
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

使用 AWS CLI处理 Amazon SWF 域

您可以使用 AWS Command Line Interface (AWS CLI) 管理您的 Amazon Simple Workflow Service (Amazon SWF) 域。

列出您的域

要列出已为您的 AWS 账户注册的 Amazon SWF 域,可以使用 swf list-domains。您必须包含 --registration-status 并指定 REGISTEREDDEPRECATED

下面是一个最简单的示例。

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

注意

有关使用 DEPRECATED 的示例,请参阅弃用域

获取有关域的信息

要获取有关特定域的详细信息,请使用 swf describe-domain 。有一个必需参数 --name,此参数用于指定您要获取其信息的域的名称。例如:

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

注册域

要注册新域,请使用 swf register-domain

有两个必需参数:--name--workflow-execution-retention-period-in-days,前者指定要注册的域名,后者使用一个整数指定在该域上保留工作流程执行数据的天数,最长 90 天(有关更多信息,请参阅 Amazon SWF 常见问题)。

如果您为此值指定零 (0),则保留期自动设置为最长持续时间。否则,在指定的天数过后,不会保留工作流程执行数据。以下示例说明如何注册新域。

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

该命令不返回任何输出,但您可以使用 swf describe-domainswf list-domains 查看新域。例如:

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

弃用域

要弃用域(您仍可以看到它,但不能在它上面创建新工作流程执行或注册类型),请使用 swf deprecate-domain。它只有一个必需参数 --name,此参数用于指定要弃用的域的名称。

$ aws swf deprecate-domain --name MyNeatNewDomain

register-domain 一样,不会返回任何输出。不过,如果您使用 list-domains 查看已注册的域,则会看到该域不会再显示出来。您还可以使用 --registration-status DEPRECATED

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

另请参阅