다음을 통해 공유


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 매개 변수

Name In(다음 안에) 필수 형식 Description
factoryName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

팩터리 이름입니다.

pipelineName
path True

string

minLength: 1
maxLength: 260
pattern: ^[A-Za-z0-9_][^<>*#.%&:\\+?/]*$

파이프라인 이름입니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\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을 지정하지 않은 경우에만 속성이 사용됩니다.

요청 본문

Name 형식 Description
parameters

ParameterValueSpecification

파이프라인 실행의 매개 변수입니다. 이러한 매개 변수는 runId가 지정되지 않은 경우에만 사용됩니다.

응답

Name 형식 Description
200 OK

CreateRunResponse

그래.

Other Status Codes

CloudError

Azure Data Factory 서비스에서 받은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name 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"
}

정의

Name Description
CloudError

Azure Data Factory 오류 응답의 구조를 정의하는 개체입니다.

CreateRunResponse

실행 식별자가 있는 응답 본문입니다.

CloudError

Azure Data Factory 오류 응답의 구조를 정의하는 개체입니다.

Name 형식 Description
error.code

string

오류 코드입니다.

error.details

CloudError[]

추가 오류 세부 정보가 있는 배열입니다.

error.message

string

오류 메시지입니다.

error.target

string

오류와 연결된 요청의 속성 이름/경로입니다.

CreateRunResponse

실행 식별자가 있는 응답 본문입니다.

Name 형식 Description
runId

string

실행의 식별자입니다.