Pipelines - Create Run

Hiermee maakt u een uitvoering van een pijplijn.

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-parameters

Name In Vereist Type Description
factoryName
path True

string

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

De naam van de fabriek.

pipelineName
path True

string

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

De naam van de pijplijn.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

isRecovery
query

boolean

Vlag voor herstelmodus. Als de herstelmodus is ingesteld op true, wordt de opgegeven pijplijnuitvoering waarnaar wordt verwezen, gegroepeerd onder dezelfde groupId.

referencePipelineRunId
query

string

De id van de pijplijnuitvoering. Als de uitvoerings-id is opgegeven, worden de parameters van de opgegeven uitvoering gebruikt om een nieuwe uitvoering te maken.

startActivityName
query

string

In de herstelmodus wordt het opnieuw uitvoeren gestart vanaf deze activiteit. Als dit niet is opgegeven, worden alle activiteiten uitgevoerd.

startFromFailure
query

boolean

In de herstelmodus, als deze is ingesteld op waar, wordt de herstart gestart vanuit mislukte activiteiten. De eigenschap wordt alleen gebruikt als startActivityName niet is opgegeven.

Antwoorden

Name Type Description
200 OK

CreateRunResponse

Azure-operatie succesvol voltooid.

Other Status Codes

CloudError

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Pipelines_CreateRun

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
CloudError

Het object dat de structuur van een Azure Data Factory-foutreactie definieert.

CreateRunResponse

Antwoordtekst met een uitvoerings-id.

CloudError

Het object dat de structuur van een Azure Data Factory-foutreactie definieert.

Name Type Description
error.code

string

Foutcode.

error.details

CloudError[]

Matrix met aanvullende foutdetails.

error.message

string

Foutmelding.

error.target

string

Eigenschapsnaam/pad in aanvraag die is gekoppeld aan een fout.

CreateRunResponse

Antwoordtekst met een uitvoerings-id.

Name Type Description
runId

string

Id van een uitvoering.