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 |
|---|---|---|---|---|
|
factory
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ |
Der Werksname. |
|
pipeline
|
path | True |
string minLength: 1maxLength: 260 pattern: ^[A-Za-z0-9_][^<>*#.%&:\\+?/]*$ |
Der Pipeline-Name. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Der Ressourcengruppenname. |
|
subscription
|
path | True |
string |
Der Abonnementbezeichner. |
|
api-version
|
query | True |
string |
Die API-Version. |
|
is
|
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. |
|
|
reference
|
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. |
|
|
start
|
query |
string |
Im Wiederherstellungsmodus wird die erneute Ausführung von dieser Aktivität gestartet. Wenn nicht angegeben, werden alle Aktivitäten ausgeführt. |
|
|
start
|
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 |
Parameter |
Parameter der Pipelineausführung. Diese Parameter werden nur verwendet, wenn die runId nicht angegeben ist. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY. |
|
| Other Status Codes |
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 |
|---|---|
|
Cloud |
Das Objekt, das die Struktur einer Azure Data Factory-Fehlerantwort definiert. |
|
Create |
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 |
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. |