Workflows - Amazon Glue
— 数据类型 —JobNodeDetailsCrawlerNodeDetailsTriggerNodeDetails爬网节点边缘工作流程WorkflowGraphWorkflowRunWorkflowRunStatistics开始事件批处理条件蓝图蓝图详细信息最后定义蓝图— 操作 —CreateWorkflow (create_workflow)UpdateWorkflow (update_workflow)DeleteWorkflow (delete_workflow)GetWorkflow (get_workflow)ListWorkflows (list_workflows)BatchGetWorkflows (batch_get_workflows)GetWorkflowRun (get_workflow_run)GetWorkflowRuns (get_workflow_runs)GetWorkflowRunProperties (get_workflow_run_properties)PutWorkflowRunProperties (put_workflow_run_properties)创建蓝图（创建蓝图）更新蓝图（更新 _ 蓝图）删除蓝图（删除蓝图）列表蓝图（列表 _ 蓝图）批处理蓝图（批处理蓝图）开始蓝图打印（启动 _ 蓝图 _ 运行）获取蓝图打印（获取蓝图 _ 运行）获取蓝图打印机（获取蓝图运行）StartWorkflowRun (start_workflow_run)StopWorkflowRun (stop_workflow_run)恢复工作流运行（恢复 _ 工作流 _ 运行）
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Workflows

工作流程 API 介绍与创建、更新或查看工作流程相关的数据类型和 API。AmazonGlue。

数据类型

JobNodeDetails 结构

工作流程中展示的作业节点的详细信息。

Fields

  • JobRuns – JobRun 对象的数组。

    作业节点表示的作业运行的信息。

CrawlerNodeDetails 结构

工作流程中存在的爬网程序节点的详细信息。

Fields

  • Crawls – 爬网 对象的数组。

    爬网节点表示的爬网的列表。

TriggerNodeDetails 结构

工作流程中存在的触发器节点的详细信息。

Fields

  • Trigger – 一个 Trigger 对象。

    触发器节点表示的触发器的信息。

爬网结构

工作流程中的爬网的详细信息。

Fields

  • State – UTF-8 字符串（有效值：RUNNING | CANCELLING | CANCELLED | SUCCEEDED | FAILED）。

    爬网程序的状态。

  • StartedOn – 时间戳.

    爬网操作的开始日期和时间。

  • CompletedOn – 时间戳.

    爬网操作的完成日期和时间。

  • ErrorMessage – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

    与爬网关联的错误消息。

  • LogGroup – UTF-8 字符串，长度不少于 1 个字节或超过 512 个字节，与 Log group string pattern 匹配。

    与爬网关联的日志组。

  • LogStream – UTF-8 字符串，长度不少于 1 个字节或超过 512 个字节，与 Log-stream string pattern 匹配。

    与爬网关联的日志流。

节点结构

节点表示Amazon Glue组件（触发器、爬虫程序或作业）。

Fields

  • Type – UTF-8 字符串（有效值：CRAWLER | JOB | TRIGGER）。

    的类型Amazon Glue组件表示。

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    对于是必需的Amazon Glue组件表示。

  • UniqueId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    分配给工作流程中的节点的唯一 ID。

  • TriggerDetails – 一个 TriggerNodeDetails 对象。

    触发器的详细信息（当节点表示触发器时）。

  • JobDetails – 一个 JobNodeDetails 对象。

    作业的详细信息（当节点表示作业时）。

  • CrawlerDetails – 一个 CrawlerNodeDetails 对象。

    爬网程序的详细信息（当节点表示爬网程序时）。

边缘结构

边缘表示工作流程图表示两个组件之间的定向连接。

Fields

  • SourceId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    边缘在其中启动的工作流程中节点的唯一 ID。

  • DestinationId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    边缘在其中终止的工作流程中节点的唯一 ID。

工作流程结构

工作流是多个依赖的集合Amazon Glue作业和爬虫程序来完成复杂的 ETL 任务。工作流程管理其所有作业和爬虫程序的执行和监控。

Fields

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    工作流程的名称。

  • Description – UTF-8 字符串。

    工作流程的描述。

  • DefaultRunProperties – 键值对的映射数组。

    每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    每个值是一个 UTF-8 字符串。

    要用作每个工作流程执行的一部分的属性的集合。运行属性可供工作流中的每个作业使用。作业可以修改流程中下一个作业的属性。

  • CreatedOn – 时间戳.

    工作流程的创建日期和时间。

  • LastModifiedOn – 时间戳.

    工作流程的最后修改日期和时间。

  • LastRun – 一个 WorkflowRun 对象。

    有关上次工作流程执行的信息。

  • Graph – 一个 WorkflowGraph 对象。

    表示所有Amazon Glue属于工作流程的组件，并将它们之间的定向连接表示为边缘的组件。

  • CreationStatus – UTF-8 字符串（有效值：CREATING | CREATED | CREATION_FAILED）。

    工作流程的创建状态。

  • MaxConcurrentRuns – 数字 (integer)。

    您可以使用此参数防止对数据进行多次不必要的更新，控制成本，或者在某些情况下，防止超过任何组件作业的最大并发运行次数。如果您将此参数留空，则不限制并发工作流程运行数量。

  • BlueprintDetails – 一个 蓝图详细信息 对象。

    此结构指示创建此特定工作流的蓝图的详细信息。

WorkflowGraph 结构

工作流图表表示包含所有Amazon Glue组件以及它们之间的所有定向连接。

Fields

  • Nodes – 节点 对象的数组。

    列表Amazon Glue组件属于工作流程，表示为节点的工作流程。

  • Edges – 边缘 对象的数组。

    属于工作流程的节点之间的所有定向连接的列表。

WorkflowRun 结构

工作流程运行是提供所有运行时信息的工作流程的执行。

Fields

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    已运行的工作流程的名称。

  • WorkflowRunId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    此工作流程运行的 ID。

  • PreviousRunId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    上次工作流程运行的 ID。

  • WorkflowRunProperties – 键值对的映射数组。

    每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    每个值是一个 UTF-8 字符串。

    运行期间设置的工作流程运行属性。

  • StartedOn – 时间戳.

    工作流程运行的开始日期和时间。

  • CompletedOn – 时间戳.

    工作流程运行的完成日期和时间。

  • Status – UTF-8 字符串（有效值：RUNNING | COMPLETED | STOPPING | STOPPED | ERROR）。

    工作流程运行的状态。

  • ErrorMessage – UTF-8 字符串。

    此错误消息描述了在启动工作流运行时可能发生的任何错误。目前唯一的错误消息是 “超过工作流的并发运行：foo。”

  • Statistics – 一个 WorkflowRunStatistics 对象。

    运行的统计数据。

  • Graph – 一个 WorkflowGraph 对象。

    表示所有Amazon Glue属于工作流程的组件，并将它们之间的定向连接表示为边缘的组件。

  • StartingEventBatchCondition – 一个 开始事件批处理条件 对象。

    启动工作流程运行的批处理条件。

WorkflowRunStatistics 结构

工作流程运行统计数据提供了有关工作流程运行的统计数据。

Fields

  • TotalActions – 数字 (integer)。

    工作流程运行中的操作的总数。

  • TimeoutActions – 数字 (integer)。

    已超时操作的总数。

  • FailedActions – 数字 (integer)。

    失败操作的总数。

  • StoppedActions – 数字 (integer)。

    已停止操作的总数。

  • SucceededActions – 数字 (integer)。

    成功操作的总数。

  • RunningActions – 数字 (integer)。

    处于正在运行状态的操作的总数。

启动事件批次条件结构

启动工作流程运行的批处理条件。批处理大小中的事件数到达（在这种情况下，BatchSize 成员为非零），或批处理窗口已过期，在这种情况下，BatchWindow 成员为非零。

Fields

  • BatchSize – 数字 (integer)。

    批处理中的事件数。

  • BatchWindow – 数字 (integer)。

    批处理窗口持续时间 (秒)。

蓝图结构

蓝图的详细信息。

Fields

  • Name— UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图的名称。

  • Description— UTF-8 字符串，长度不少于 1 个字节或超过 512 个字节。

    蓝图的描述。

  • CreatedOn – 时间戳.

    蓝图的日期和时间。

  • LastModifiedOn – 时间戳.

    上次修改蓝图的日期和时间。

  • ParameterSpec— UTF-8 字符串，长度不少于 1 个字节或超过 131072 个字节。

    指示蓝图参数规范列表的 JSON 字符串。

  • BlueprintLocation – UTF-8 字符串。

    指定 Amazon S3 中发布蓝图的路径。

  • BlueprintServiceLocation – UTF-8 字符串。

    指定 Amazon S3 中的路径，当您调用CreateBlueprint将蓝图注册到Amazon Glue。

  • Status— UTF-8 字符串（有效值：CREATING|ACTIVE|UPDATING|FAILED)。

    蓝图注册的状态。

    • 创建 — 蓝图注册正在进行中。

    • 活动 — 蓝图已成功注册。

    • 更新 — 正在更新蓝图注册。

    • 失败 — 蓝图注册失败。

  • ErrorMessage – UTF-8 字符串。

    错误消息。

  • LastActiveDefinition – 一个 最后定义 对象。

    如果蓝图有多个版本，且最新版本出现一些错误，则此属性指示该服务可用的最后一个成功的蓝图定义。

蓝图详细结构

蓝图的详细信息。

Fields

  • BlueprintName— UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图的名称。

  • InstanceName— UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图实例的名称。

  • RunId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    此蓝图的运行 ID。

LastActiFre义结构

如果蓝图有多个版本，且最新版本出现一些错误，则此属性指示该服务可用的最后一个成功的蓝图定义。

Fields

  • Description— UTF-8 字符串，长度不少于 1 个字节或超过 512 个字节。

    蓝图的描述。

  • LastModifiedOn – 时间戳.

    上次修改蓝图的日期和时间。

  • ParameterSpec— UTF-8 字符串，长度不少于 1 个字节或超过 131072 个字节。

    指定蓝图参数的 JSON 字符串。

  • BlueprintLocation – UTF-8 字符串。

    指定 Amazon S3 中的一个路径，其中蓝图由Amazon Glue开发人员。

  • BlueprintServiceLocation – UTF-8 字符串。

    指定在创建或更新蓝图时在 Amazon S3 中复制蓝图的路径。

蓝图结构

蓝图运行的详细信息。

Fields

  • BlueprintName— UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图的名称。

  • RunId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    此蓝图运行的运行 ID。

  • WorkflowName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    成功运行蓝图后创建的工作流的名称。如果蓝图运行出现错误，则不会创建工作流。

  • State— UTF-8 字符串（有效值：RUNNING|SUCCEEDED|FAILED|ROLLING_BACK)。

    蓝图运行的状态。可能的值有：

    • 正在运行 — 蓝图运行正在进行中。

    • 成功 — 蓝图运行已成功完成。

    • 失败 — 蓝图运行失败且回滚已完成。

    • 回滚 — 蓝图运行失败，正在回滚。

  • StartedOn – 时间戳.

    蓝图运行的日期和时间。

  • CompletedOn – 时间戳.

    蓝图运行的日期和时间。

  • ErrorMessage – UTF-8 字符串。

    表示运行蓝图时出现的任何错误。

  • RollbackErrorMessage – UTF-8 字符串。

    如果在创建工作流实体时出现任何错误，我们会尝试回滚创建的实体，直到该点，然后将它们删除。此属性指示尝试删除创建的实体时出现的错误。

  • Parameters— UTF-8 字符串，长度不少于 1 个字节或超过 131072 个字节。

    以字符串形式显示的蓝图参数。您必须为参数规范中所需的每个键提供一个值，该参数规范在Blueprint$ParameterSpec。

  • RoleArn— UTF-8 字符串，长度不少于 1 个字节或超过 1024 个字节，与匹配。Custom string pattern #17。

    角色 ARN。此角色将由Amazon Glue服务，并将用于创建工作流和工作流的其他实体。

Operations

CreateWorkflow 操作（Python：create_workflow）

创建新的工作流程。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要向工作流程分配的名称。它应在您的账户中是唯一的。

  • Description – UTF-8 字符串。

    工作流程的描述。

  • DefaultRunProperties – 键值对的映射数组。

    每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    每个值是一个 UTF-8 字符串。

    要用作每个工作流程执行的一部分的属性的集合。

  • Tags— 键值对的映射数组，不超过 50 对。

    每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

    每个值是一个 UTF-8 字符串，不超过 256 个字节。

    要用于此工作流程的标签。

  • MaxConcurrentRuns – 数字 (integer)。

    您可以使用此参数防止对数据进行多次不必要的更新，控制成本，或者在某些情况下，防止超过任何组件作业的最大并发运行次数。如果您将此参数留空，则不限制并发工作流程运行数量。

Response

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    作为请求的一部分提供的工作流程的名称。

Errors

  • AlreadyExistsException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

UpdateWorkflow 操作（Python：update_workflow）

更新现有工作流程。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要更新的工作流程的名称。

  • Description – UTF-8 字符串。

    工作流程的描述。

  • DefaultRunProperties – 键值对的映射数组。

    每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    每个值是一个 UTF-8 字符串。

    要用作每个工作流程执行的一部分的属性的集合。

  • MaxConcurrentRuns – 数字 (integer)。

    您可以使用此参数防止对数据进行多次不必要的更新，控制成本，或者在某些情况下，防止超过任何组件作业的最大并发运行次数。如果您将此参数留空，则不限制并发工作流程运行数量。

Response

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    输入中指定的工作流程的名称。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

DeleteWorkflow 操作（Python：delete_workflow）

删除工作流程。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要删除的工作流程的名称。

Response

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    输入中指定的工作流程的名称。

Errors

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

GetWorkflow 操作（Python：get_workflow）

检索工作流程的资源元数据。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要检索的工作流程的名称。

  • IncludeGraph – Boolean.

    指定在返回工作流程资源元数据时是否包含图表。

Response

  • Workflow – 一个 工作流程 对象。

    工作流程的资源元数据。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

ListWorkflows 操作（Python：list_workflows）

列出账户中创建的工作流程的名称。

Request

  • NextToken – UTF-8 字符串。

    延续令牌 (如果这是延续请求)。

  • MaxResults – 数字（整数），不小于 1 或大于 1000。

    要返回的列表的最大大小。

Response

  • Workflows— UTF-8 字符串数组，不少于 1 个或不超过 25 个字符串。

    账户中工作流程的名称的列表。

  • NextToken – UTF-8 字符串。

    延续令牌（如果尚未返回所有工作流程名称）。

Errors

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchGetWorkflows 操作（Python：batch_get_workflows）

返回一系列给定工作流程名称的资源元数据列表。调用 ListWorkflows 操作后，您可以调用此操作来访问您有权访问的数据。此操作支持所有 IAM 权限，包括使用标签的权限条件。

Request

  • Names–必填项：必需 UTF-8 字符串数组，不少于 1 个或不超过 25 个字符串。

    触发器名称的列表，这些名称可能是通过 ListWorkflows 操作返回的名称。

  • IncludeGraph – Boolean.

    指定在返回工作流程资源元数据时是否包含图表。

Response

  • Workflows— 数组工作流程对象，不少于 1 个或不超过 25 个结构。

    工作流程资源元数据的列表。

  • MissingWorkflows— UTF-8 字符串数组，不少于 1 个或不超过 25 个字符串。

    未找到工作流程名称的列表。

Errors

  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

GetWorkflowRun 操作（Python：get_workflow_run）

检索给定工作流程运行的元数据。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要运行的工作流程的名称。

  • RunId–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    工作流程运行的 ID。

  • IncludeGraph – Boolean.

    指定是否在响应中包含工作流程图表。

Response

  • Run – 一个 WorkflowRun 对象。

    请求的工作流程运行元数据。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetWorkflowRuns 操作（Python：get_workflow_runs）

检索给定工作流程的所有运行的元数据。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要返回其运行元数据的工作流程的名称。

  • IncludeGraph – Boolean.

    指定是否在响应中包含工作流程图表。

  • NextToken – UTF-8 字符串。

    响应的最大大小。

  • MaxResults – 数字（整数），不小于 1 或大于 1000。

    要包含在响应中的工作流程运行的最大数目。

Response

  • Runs— 数组WorkflowRun对象，不少于 1 个或不超过 1000 个结构。

    工作流程运行元数据对象的列表。

  • NextToken – UTF-8 字符串。

    延续令牌（如果尚未返回所有请求的工作流程运行）。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetWorkflowRunProperties 操作（Python: get_workflow_run_properties）

检索运行期间已测试的工作流程运行属性。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    已运行的工作流程的名称。

  • RunId–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    应返回其运行属性的工作流程运行的 ID。

Response

  • RunProperties – 键值对的映射数组。

    每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    每个值是一个 UTF-8 字符串。

    指定运行期间已测试的工作流程运行属性。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

PutWorkflowRunProperties 操作（Python：put_workflow_run_properties）

为给定工作流程运行放置指定的工作流程运行属性。如果指定的运行中已存在属性，则重写该值，否则将该属性添加到现有属性。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    已运行的工作流程的名称。

  • RunId–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    应更新其运行属性的工作流程运行的 ID。

  • RunProperties–必填项：必需 键值对的映射数组。

    每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    每个值是一个 UTF-8 字符串。

    为指定的运行放置的属性。

Response

  • 无响应参数。

Errors

  • AlreadyExistsException

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

创建蓝图操作（Python：create_blueprint）

将蓝图注册到Amazon Glue。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图的名称。

  • Description— UTF-8 字符串，长度不少于 1 个字节或超过 512 个字节。

    蓝图的说明。

  • BlueprintLocation–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 8192 个字节，与匹配。Custom string pattern #19。

    指定 Amazon S3 中发布蓝图的路径。

  • Tags— 键值对的映射数组，不超过 50 对。

    每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

    每个值是一个 UTF-8 字符串，不超过 256 个字节。

    应用于此蓝图的标签。

Response

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    返回已注册的蓝图的名称。

Errors

  • AlreadyExistsException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • ResourceNumberLimitExceededException

UpdateLuns 操作（Python：update_blueprint）

更新已注册的蓝图。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图的名称。

  • Description— UTF-8 字符串，长度不少于 1 个字节或超过 512 个字节。

    蓝图的说明。

  • BlueprintLocation–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 8192 个字节，与匹配。Custom string pattern #19。

    指定 Amazon S3 中发布蓝图的路径。

Response

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    返回已更新的蓝图的名称。

Errors

  • EntityNotFoundException

  • ConcurrentModificationException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

DeleteRuns 操作 (Python: delete_blueprint)

删除现有蓝图。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要删除的蓝图的名称。

Response

  • Name – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    返回已删除的蓝图的名称。

Errors

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

List 蓝图操作（Python：list_blueprint）

列出帐户中的所有蓝图名称。

Request

  • NextToken – UTF-8 字符串。

    延续令牌 (如果这是延续请求)。

  • MaxResults – 数字（整数），不小于 1 或大于 1000。

    要返回的列表的最大大小。

  • Tags— 键值对的映射数组，不超过 50 对。

    每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

    每个值是一个 UTF-8 字符串，不超过 256 个字节。

    过滤列表Amazon资源标签。

Response

  • Blueprints – UTF-8 字符串数组。

    帐户中蓝图的名称的列表。

  • NextToken – UTF-8 字符串。

    延续令牌（如果尚未返回所有蓝图名称）。

Errors

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchGetLuns 操作（Python：batch_get_blueprint）

检索有关蓝图列表的信息。

Request

  • Names–必填项：必需 UTF-8 字符串数组，不少于 1 个或不超过 25 个字符串。

    蓝图名称的列表。

  • IncludeBlueprint – Boolean.

    指定是否在响应中包含蓝图。

  • IncludeParameterSpec – Boolean.

    指定是否在响应中包含蓝图的参数（作为 JSON 字符串）。

Response

  • Blueprints – 蓝图 对象的数组。

    返回蓝图列表，作为Blueprints对象。

  • MissingBlueprints – UTF-8 字符串数组。

    返回BlueprintNames未找到的。

Errors

  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

StartBrun 操作 (Python: start_blueprint)

启动指定蓝图的新运行。

Request

  • BlueprintName–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图的名称。

  • Parameters— UTF-8 字符串，长度不少于 1 个字节或超过 131072 个字节。

    将参数指定为BlueprintParameters对象。

  • RoleArn–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 1024 个字节，与匹配。Custom string pattern #17。

    指定用于创建工作流程的 IAM 角色。

Response

  • RunId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    此蓝图运行的运行 ID。

Errors

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • ResourceNumberLimitExceededException

  • EntityNotFoundException

GetBrun 操作 (Python: get_blueprint_run)

检索蓝图运行的详细信息。

Request

  • BlueprintName–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与匹配。Custom string pattern #18。

    蓝图的名称。

  • RunId–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要检索的蓝图运行的运行 ID。

Response

  • BlueprintRun – 一个 蓝图 对象。

    返回 BlueprintRun 对象。

Errors

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetBruns 操作（Python：get_blueprint_run）

检索指定蓝图的蓝图运行详细信息。

Request

  • BlueprintName–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    蓝图的名称。

  • NextToken – UTF-8 字符串。

    延续令牌 (如果这是延续请求)。

  • MaxResults – 数字（整数），不小于 1 或大于 1000。

    要返回的列表的最大大小。

Response

  • BlueprintRuns – 蓝图 对象的数组。

    返回 BlueprintRun 对象的列表。

  • NextToken – UTF-8 字符串。

    延续令牌（如果尚未返回所有蓝图运行）。

Errors

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

StartWorkflowRun 操作（Python：start_workflow_run）

启动指定的工作流程的新运行。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要启动的工作流程的名称。

Response

  • RunId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    新运行的 ID。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

StopWorkflowRun Action（Python: stop_workflow_run）

停止执行指定的工作流程运行。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要停止的工作流程的名称。

  • RunId–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要停止的工作流程运行的 ID。

Response

  • 无响应参数。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • IllegalWorkflowStateException

恢复工作流程运行操作（Python：恢复_workflow_run）

重新启动上一个部分完成的工作流运行的选定节点，并恢复工作流运行。将运行所选节点和所有从选定节点下游的节点。

Request

  • Name–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要恢复的工作流程的名称。

  • RunId–必填项：必需 UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与匹配。Single-line string pattern。

    要恢复的工作流程运行的 ID。

  • NodeIds–必填项：必需 UTF-8 字符串数组。

    要重新启动的节点的 ID 列表。要重新启动的节点必须在原始运行中尝试运行。

Response

  • RunId – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

    分配给恢复的工作流程运行的新 ID。工作流运行的每个恢复都将有一个新的运行 ID。

  • NodeIds – UTF-8 字符串数组。

    实际重新启动的节点的节点 ID 列表。

Errors

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentRunsExceededException

  • IllegalWorkflowStateException