次の方法で共有


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

OK です。

Other Status Codes

CloudError

Azure Data Factory サービスから受信したエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 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 Data Factoryエラー応答の構造を定義する オブジェクト。

CreateRunResponse

実行識別子を持つ応答本文。

CloudError

Azure Data Factoryエラー応答の構造を定義する オブジェクト。

名前 説明
error.code

string

エラー コード。

error.details

CloudError[]

追加のエラーの詳細を含む配列。

error.message

string

エラー メッセージ。

error.target

string

エラーに関連付けられている要求のプロパティ名/パス。

CreateRunResponse

実行識別子を持つ応答本文。

名前 説明
runId

string

実行の識別子。