Pipelines - Create Run
Crée une exécution d’un 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}
Paramètres d’URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
factory
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ |
Nom de la fabrique. |
|
pipeline
|
path | True |
string minLength: 1maxLength: 260 pattern: ^[A-Za-z0-9_][^<>*#.%&:\\+?/]*$ |
Le nom du pipeline. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nom du groupe de ressources. |
|
subscription
|
path | True |
string |
Identificateur d’abonnement. |
|
api-version
|
query | True |
string |
Version de l’API. |
|
is
|
query |
boolean |
Indicateur du mode de récupération. Si le mode de récupération est défini sur true, l’exécution du pipeline référencé spécifié et la nouvelle exécution est regroupée sous le même groupId. |
|
|
reference
|
query |
string |
Identificateur d’exécution du pipeline. Si l’ID d’exécution est spécifié, les paramètres de l’exécution spécifiée sont utilisés pour créer une nouvelle exécution. |
|
|
start
|
query |
string |
En mode de récupération, la réexécution démarre à partir de cette activité. Si elle n’est pas spécifiée, toutes les activités s’exécutent. |
|
|
start
|
query |
boolean |
En mode de récupération, si la valeur est true, la réexécution démarre à partir d’activités ayant échoué. La propriété sera utilisée uniquement si startActivityName n’est pas spécifié. |
Corps de la requête
| Nom | Type | Description |
|---|---|---|
| parameters |
Parameter |
Paramètres de l’exécution du pipeline. Ces paramètres ne seront utilisés que si l’runId n’est pas spécifié. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
D’ACCORD. |
|
| Other Status Codes |
Réponse d’erreur reçue du service Azure Data Factory. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Couler:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Pipelines_CreateRun
Demande d’échantillon
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"
]
}
Exemple de réponse
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"
}
Définitions
| Nom | Description |
|---|---|
|
Cloud |
Objet qui définit la structure d’une réponse d’erreur Azure Data Factory. |
|
Create |
Corps de la réponse avec un identificateur d’exécution. |
CloudError
Objet qui définit la structure d’une réponse d’erreur Azure Data Factory.
| Nom | Type | Description |
|---|---|---|
| error.code |
string |
Code d’erreur. |
| error.details |
Tableau avec des détails d’erreur supplémentaires. |
|
| error.message |
string |
Message d'erreur. |
| error.target |
string |
Nom/chemin de propriété dans la requête associée à l’erreur. |
CreateRunResponse
Corps de la réponse avec un identificateur d’exécution.
| Nom | Type | Description |
|---|---|---|
| runId |
string |
Identificateur d’une exécution. |