共用方式為


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 參數

名稱 位於 必要 類型 Description
factoryName
path True

string

Factory 名稱。

Regex 模式: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

pipelineName
path True

string

管線名稱。

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

resourceGroupName
path True

string

資源群組名稱。

Regex 模式: ^[-\w\._\(\)]+$

subscriptionId
path True

string

訂用帳戶識別碼。

api-version
query True

string

API 版本。

isRecovery
query

boolean

恢復模式旗標。 如果恢復模式設定為 true,則會將指定的參考管線執行和新的執行分組在相同的 groupId 之下。

referencePipelineRunId
query

string

管線執行標識碼。 如果指定執行標識碼,則會使用指定回合的參數來建立新的執行。

startActivityName
query

string

在復原模式中,重新執行會從此活動開始。 如果未指定,則會執行所有活動。

startFromFailure
query

boolean

在復原模式中,如果設定為 true,則重新執行會從失敗的活動開始。 只有在未指定 startActivityName 時,才會使用 屬性。

要求本文

名稱 類型 Description
parameters

ParameterValueSpecification

管線執行的參數。 只有在未指定 runId 時,才會使用這些參數。

回應

名稱 類型 Description
200 OK

CreateRunResponse

正常。

Other Status Codes

CloudError

從 Azure Data Factory 服務收到的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
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"
}

定義

名稱 Description
CloudError

對象,定義 Azure Data Factory 錯誤響應的結構。

CreateRunResponse

具有執行標識碼的回應本文。

CloudError

對象,定義 Azure Data Factory 錯誤響應的結構。

名稱 類型 Description
error.code

string

錯誤碼。

error.details

CloudError[]

具有其他錯誤詳細數據的陣列。

error.message

string

錯誤訊息。

error.target

string

與錯誤相關聯之要求中的屬性名稱/路徑。

CreateRunResponse

具有執行標識碼的回應本文。

名稱 類型 Description
runId

string

執行的標識碼。