Partilhar 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 do URI

Name Em Necessá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 um UUID.

api-version
query True

string

minLength: 1

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

isRecovery
query

boolean

Sinalizador do modo de recuperação. Se o modo de recuperação estiver definido como true, o pipeline referenciado especificado será executado e a nova execução serão agrupados sob o mesmo groupId.

referencePipelineRunId
query

string

O identificador de execução do pipeline. Se o ID de execução for especificado, 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 repetição será iniciada a partir desta 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

Name 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 Ative Directory.

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Pipelines_CreateRun

Pedido de amostra

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 da amostra

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

Name 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.

Name 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.

Name Tipo Description
runId

string

Identificador de uma execução.