Freigeben über


Pipelines - Create Run

Erstellt eine Ausführung einer 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}

URI-Parameter

Name In Erforderlich Typ Beschreibung
factoryName
path True

string

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

Der Werksname.

pipelineName
path True

string

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

Der Pipeline-Name.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Der Ressourcengruppenname.

subscriptionId
path True

string

Der Abonnementbezeichner.

api-version
query True

string

Die API-Version.

isRecovery
query

boolean

Flag für den Wiederherstellungsmodus. Wenn der Wiederherstellungsmodus auf "true" festgelegt ist, wird die angegebene referenzierte Pipelineausführung und der neue Run unter derselben groupId gruppiert.

referencePipelineRunId
query

string

Der Pipelineausführungsbezeichner. Wenn die Ausführungs-ID angegeben ist, werden die Parameter der angegebenen Ausführung verwendet, um eine neue Ausführung zu erstellen.

startActivityName
query

string

Im Wiederherstellungsmodus wird die erneute Ausführung von dieser Aktivität gestartet. Wenn nicht angegeben, werden alle Aktivitäten ausgeführt.

startFromFailure
query

boolean

Wenn der Wiederherstellungsmodus auf "true" festgelegt ist, wird die Erneutes Ausführen von fehlgeschlagenen Aktivitäten gestartet. Die Eigenschaft wird nur verwendet, wenn startActivityName nicht angegeben ist.

Anforderungstext

Name Typ Beschreibung
parameters

ParameterValueSpecification

Parameter der Pipelineausführung. Diese Parameter werden nur verwendet, wenn die runId nicht angegeben ist.

Antworten

Name Typ Beschreibung
200 OK

CreateRunResponse

OKAY.

Other Status Codes

CloudError

Eine Fehlerantwort, die vom Azure Data Factory-Dienst empfangen wurde.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Pipelines_CreateRun

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
CloudError

Das Objekt, das die Struktur einer Azure Data Factory-Fehlerantwort definiert.

CreateRunResponse

Antworttext mit einem Ausführungsbezeichner.

CloudError

Das Objekt, das die Struktur einer Azure Data Factory-Fehlerantwort definiert.

Name Typ Beschreibung
error.code

string

Fehlercode.

error.details

CloudError[]

Array mit zusätzlichen Fehlerdetails.

error.message

string

Fehlermeldung.

error.target

string

Eigenschaftsname/Pfad in Anforderung, die fehler zugeordnet ist.

CreateRunResponse

Antworttext mit einem Ausführungsbezeichner.

Name Typ Beschreibung
runId

string

Bezeichner einer Ausführung.