Compartilhar via


Pipelines - Create Run

Cria uma execução de um pipeline.

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}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
factoryName
path True

string

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

O nome da fábrica.

pipelineName
path True

string

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

O nome do pipeline.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

isRecovery
query

boolean

Sinalizador do modo de recuperação. Se o modo de recuperação for definido como true, a execução de pipeline referenciada especificada e a nova execução serão agrupadas sob a mesma groupId.

referencePipelineRunId
query

string

O identificador de execução do pipeline. Se a ID da execução for especificada, os parâmetros da execução especificada serão usados para criar uma nova execução.

startActivityName
query

string

No modo de recuperação, a nova execução será iniciada a partir dessa atividade. Se não for especificado, todas as atividades serão executadas.

startFromFailure
query

boolean

No modo de recuperação, se definido como true, a nova execução será iniciada a partir de atividades com falha. A propriedade será usada somente se startActivityName não for especificado.

Respostas

Nome Tipo Description
200 OK

CreateRunResponse

Operação do Azure concluída com sucesso.

Other Status Codes

CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Pipelines_CreateRun

Solicitação de exemplo

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

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

Resposta de exemplo

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

Definições

Nome Description
CloudError

O objeto que define a estrutura de uma resposta de erro do Azure Data Factory.

CreateRunResponse

Corpo da resposta com um identificador de execução.

CloudError

O objeto que define a estrutura de uma resposta de erro do Azure Data Factory.

Nome Tipo Description
error.code

string

Código de erro.

error.details

CloudError[]

Matriz com detalhes de erro adicionais.

error.message

string

Mensagem de erro.

error.target

string

Nome/caminho da propriedade na solicitação associada ao erro.

CreateRunResponse

Corpo da resposta com um identificador de execução.

Nome Tipo Description
runId

string

Identificador de uma execução.