你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Pipelines - Create Run

创建管道的运行。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/pipelines/{pipelineName}/createRun?api-version=2018-06-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/pipelines/{pipelineName}/createRun?api-version=2018-06-01&referencePipelineRunId={referencePipelineRunId}&isRecovery={isRecovery}&startActivityName={startActivityName}&startFromFailure={startFromFailure}

URI 参数

名称 必需 类型 说明
factoryName
path True

string

工厂名称。

正则表达式模式: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

pipelineName
path True

string

管道名称。

正则表达式模式: ^[A-Za-z0-9_][^<>*#.%&:\\+?/]*$

resourceGroupName
path True

string

资源组名称。

正则表达式模式: ^[-\w\._\(\)]+$

subscriptionId
path True

string

订阅标识符。

api-version
query True

string

API 版本。

isRecovery
query

boolean

恢复模式标志。 如果恢复模式设置为 true,则指定的引用管道运行和新运行将分组到同一 groupId 下。

referencePipelineRunId
query

string

管道运行标识符。 如果指定了运行 ID,则指定运行的参数将用于创建新运行。

startActivityName
query

string

在恢复模式下,重新运行将从此活动开始。 如果未指定,将运行所有活动。

startFromFailure
query

boolean

在恢复模式下,如果设置为 true,则重新运行将从失败的活动开始。 仅当未指定 startActivityName 时,才会使用 属性。

请求正文

名称 类型 说明
parameters

ParameterValueSpecification

管道运行的参数。 仅当未指定 runId 时,才会使用这些参数。

响应

名称 类型 说明
200 OK

CreateRunResponse

没问题。

Other Status Codes

CloudError

从Azure 数据工厂服务收到的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Pipelines_CreateRun

示例请求

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/pipelines/examplePipeline/createRun?api-version=2018-06-01&referencePipelineRunId=

{
  "OutputBlobNameList": [
    "exampleoutput.csv"
  ]
}

示例响应

Date: Sat, 16 Jun 2018 00:37:48 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1190
x-ms-request-id: 5c2b442b-d360-43ec-9268-f923f88f31fd
x-ms-correlation-request-id: 5c2b442b-d360-43ec-9268-f923f88f31fd
{
  "runId": "2f7fdb90-5df1-4b8e-ac2f-064cfa58202b"
}

定义

名称 说明
CloudError

定义Azure 数据工厂错误响应结构的对象。

CreateRunResponse

具有运行标识符的响应正文。

CloudError

定义Azure 数据工厂错误响应结构的对象。

名称 类型 说明
error.code

string

错误代码。

error.details

CloudError[]

包含其他错误详细信息的数组。

error.message

string

错误消息。

error.target

string

与错误关联的请求中的属性名称/路径。

CreateRunResponse

具有运行标识符的响应正文。

名称 类型 说明
runId

string

运行的标识符。