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

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string (uuid)

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

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.

Antworten

Name Typ Beschreibung
200 OK

CreateRunResponse

Azure-Operation erfolgreich abgeschlossen.

Other Status Codes

CloudError

Unerwartete Fehlerantwort.

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

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.