Versión 1 de la canalización (V1)
Nota
Esta documentación de referencia se aplica a Azure Data Factory versión 1 (V1).
Create or Update (Crear o actualizar)
Crea una canalización nueva o actualiza el contenido de una canalización existente.
Solicitud
La solicitud Crear o actualizar canalización se pueden construir de la siguiente manera. Se recomienda HTTPS:
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| PUT | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datapipelines/{PipelineName}?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Un nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos en la que desea crear la canalización. |
| PipelineName | Sí | Nombre de la canalización que desea crear. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud:
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
El cuerpo de la solicitud depende de la propiedad de canalización. Para más información sobre las canalizaciones, consulte el artículo Canalizaciones y actividades en Azure Data Factory para obtener más información.
El formato del cuerpo de la solicitud es el siguiente:
{
"name": <name>,
"properties": {
"description": <description>,
"activities": <activity>
}
}
En la tabla siguiente se describen los elementos del cuerpo de la solicitud.
| Nombre del elemento | Obligatorio | Descripción |
|---|---|---|
| name | Sí | Nombre de la canalización. |
| description | Sí | Texto que describe para qué se usa la actividad. |
| activity | Sí | Actividad en la canalización. Una canalización puede tener una o más actividades. |
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
202 (Aceptado), si se aceptó la solicitud.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
412 (Error de condición previa), si la condición especificada por el encabezado If-Match produjo un error.
501 (No implementado), si la validación no está implementada.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud; el proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otro se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
| Location | URI del objeto que desea crear u obtener. |
Cuerpo de la respuesta
{
"name": <name>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
| Nombre del elemento | Descripción |
|---|---|
| name | Especifica el nombre de la canalización. |
| ID | Especifica la dirección URL de identificación de la canalización. |
| Descripción | Texto que describe para qué se usa la actividad. |
| Actividad | Actividad en la canalización. Una canalización puede tener una o más actividades. |
| Estado | Especifica si esta canalización está pausada o no. |
| Provisioningstate | Especifica el estado de aprovisionamiento actual de la canalización. Cuando se crea correctamente una canalización, el valor del elemento es Correcto. |
| Hubname | El centro que contiene su canalización. |
Solicitud y respuesta de ejemplo
URI de ejemplo:
PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datapipelines/ADFTutorialPipeline?api-version=2015-10-01
La solicitud se envía con los encabezados siguientes:
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
y el siguiente cuerpo:
{
"name": "ADFTutorialPipeline",
"properties": {
"description": "Copy data from a blob to Azure SQL table",
"activities": [
{
"name": "CopyFromBlobToSQL",
"description": "Push Regional Effectiveness Campaign data to Azure SQL database",
"type": "Copy",
"inputs": [
{
"name": "EmpTableFromBlob"
}
],
"outputs": [
{
"name": "EmpSQLTable"
}
],
"typeProperties": {
"source": {
"type": "BlobSource"
},
"sink": {
"type": "SqlSink"
}
},
"Policy": {
"concurrency": 1,
"executionPriorityOrder": "NewestFirst",
"style": "StartOfInterval",
"retry": 0,
"timeout": "01:00:00"
},
"scheduler": {
"frequency": "Hour",
"interval": 1
}
}
],
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z",
"isPaused": false
}
}
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Encabezado:
Status Code:
Created
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213927Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:39:27 GMT
Location : https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/datapipelines/pipelinetest?api-version=2015-10-01
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
client-tracking-id : 51
La respuesta incluye el cuerpo XML siguiente.
Body:
{
"name": "ADFTutorialPipeline",
"id":
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/
SPRestDataFactory/datapipelines/ADFTutorialPipeline",
"properties": {
"description": "Copy data from a blob to Azure SQL table",
"activities": [
{
"type": "Copy",
"typeProperties": {
"source": {
"type": "BlobSource"
},
"sink": {
"type": "SqlSink",
"writeBatchSize": 0,
"writeBatchTimeout": "00:00:00"
}
},
"inputs": [
{
"name": "EmpTableFromBlob"
}
],
"outputs": [
{
"name": "EmpSQLTable"
}
],
"policy": {
"timeout": "01:00:00",
"concurrency": 1,
"executionPriorityOrder": "NewestFirst",
"style": "StartOfInterval"
},
"scheduler": {
"frequency": "Hour",
"interval": 1
},
"name": "CopyFromBlobToSQL",
"description": "Push Regional Effectiveness Campaign data to Azure SQL database"
}
],
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z",
"isPaused": false,
"runtimeInfo": {
"deploymentTime": "2016-02-22T22:40:24.9768561Z",
"activePeriodSetTime": "2016-02-22T22:40:25.7707093Z",
"activityPeriods": {
"copyFromBlobToSQL": {
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z"
}
}
},
"id": "00000000-0000-0000-0000-000000000000",
"provisioningState": "Succeeded",
"hubName": "sprestdatafactory_hub",
"pipelineMode": "Scheduled"
}
}
Consulte también
Canalizaciones y actividades en Azure Data Factory
Eliminar
Elimina la canalización especificada.
Solicitud
La solicitud Eliminar canalización se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| Delete | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datapipelines/{PipelineName}?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | El nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos donde desea eliminar la canalización. |
| PipelineName | Sí | Nombre de la canalización que desea eliminar. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
412 (Error de condición previa), si la condición especificada por el encabezado If-Match produjo un error.
501 (No implementado), si la validación no está implementada.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud; el proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otro se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
Ninguno.
Solicitud y respuesta de ejemplo
URI de ejemplo:
DELETE: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/datapipelines/pipelinetest?api-version=2015-10-01
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213927Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:39:27 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
client-tracking-id : 79
Consulte también
Canalizaciones y actividades en Azure Data Factory
Get
Obtiene información sobre la canalización especificada.
Solicitud
La solicitud Obtener canalización se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| GET | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datapipelines/{PipelineName}?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Un nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos donde desea ubicar la canalización. |
| PipelineName | Sí | Nombre de la canalización que desea ubicar. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Requerido | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
412 (Error de condición previa), si la condición especificada por el encabezado If-Match produjo un error.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud; el proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otro se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
El cuerpo de la respuesta depende de la propiedad de canalización para obtener más información sobre las canalizaciones, consulte Canalizaciones y actividades.
{
"name": <name>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
| Nombre del elemento | Descripción |
|---|---|
| name | Especifica el nombre de la canalización. |
| ID | Especifica la dirección URL de identificación de la canalización. |
| Descripción | Texto que describe para qué se usa la actividad. |
| Actividad | Actividad en la canalización. Una canalización puede tener una o más actividades. |
| Estado | Especifica si esta canalización está pausada o no |
| Provisioningstate | Especifica el estado de aprovisionamiento actual de la canalización. Cuando se crea correctamente una canalización, el valor del elemento es Correcto. |
| Hubname | El centro que contiene su canalización. |
Solicitud y respuesta de ejemplo
URI de ejemplo:
GET: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datapipelines/ADFTutorialPipeline?api-version=2015-10-01
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Encabezado:
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213927Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:39:27 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
La respuesta incluye el siguiente cuerpo XML.
{
"name": "ADFTutorialPipeline",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datapipelines/ADFTutorialPipeline",
"properties": {
"description": "Copy data from a blob to Azure SQL table",
"activities": [
{
"type": "Copy",
"typeProperties": {
"source": {
"type": "BlobSource"
},
"sink": {
"type": "SqlSink",
"writeBatchSize": 0,
"writeBatchTimeout": "00:00:00"
}
},
"inputs": [
{
"name": "EmpTableFromBlob"
}
],
"outputs": [
{
"name": "EmpSQLTable"
}
],
"policy": {
"timeout": "01:00:00",
"concurrency": 1,
"executionPriorityOrder": "NewestFirst",
"style": "StartOfInterval"
},
"scheduler": {
"frequency": "Hour",
"interval": 1
},
"name": "CopyFromBlobToSQL",
"description": "Push Regional Effectiveness Campaign data to Azure SQL database"
}
],
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z",
"isPaused": false,
"runtimeInfo": {
"deploymentTime": "2016-02-22T22:40:24.9768561Z",
"activePeriodSetTime": "2016-02-22T22:40:25.7707093Z",
"activityPeriods": {
"copyFromBlobToSQL": {
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z"
}
}
},
"id": "00000000-0000-0000-0000-000000000000",
"provisioningState": "Succeeded",
"hubName": "sprestdatafactory_hub",
"pipelineMode": "Scheduled"
}
}
Consulte también
Canalizaciones y actividades en Azure Data Factory
List
Listas información sobre todos los servicios vinculados de una factoría de datos.
Solicitud
La solicitud Enumerar canalización se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| GET | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datapipelines?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos donde desea ubicar la canalización. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
412 (Error de condición previa), si la condición especificada por el encabezado If-Match produjo un error.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud. El proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otros se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
{
"value": [
{
"name": <name>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
},
{
"name": <name2>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
}
]
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
| Nombre del elemento | Descripción |
|---|---|
| name | Especifica el nombre de la canalización. |
| ID | Especifica la dirección URL de identificación de la canalización. |
| Descripción | Texto que describe para qué se usa la actividad. |
| Actividad | Actividad en la canalización; una canalización puede tener una o más actividades. |
| Estado | Especifica si esta canalización está pausada o no. |
| Provisioningstate | Especifica el estado de aprovisionamiento actual de la canalización. Cuando se crea correctamente una canalización, el valor del elemento es Correcto. |
| Hubname | El centro que contiene su canalización. |
Consulte Canalizaciones y actividades en Azure Data Factory para obtener más información.
Si hay más de 100 registros, obtendrá 100 registros a la vez con un nextLink:
{
"value": [
{
"name": <name>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
},
{
"name": <name2>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
}
] ,
"nextLink": "https://management.azure.com/subscriptions/{subscription ID>/resourcegroups/{Resource group name>/providers/Microsoft.DataFactory/datafactories/{data factory name>/datapipelines?api-version=2015-10-01&%24skipToken=MSExNiFSR0YwWVVGeWRHbG1ZV04wCjEhNTIhUkVGZlpUSXlaR1UyTXpndFpURTJNeTAwWXpZNUxUaGhNR0l0Wm1VMU1ETmpOakF4T0RObA%3d%3d"
}
Envíe la siguiente solicitud mediante la dirección URL nextLink para obtener el siguiente conjunto de registros. Es posible que tenga que encapsular & con comillas dobles ("") en la dirección URL de nextLink. Solo se devuelven 100 registros a la vez.
Solicitud y respuesta de ejemplo
URI de ejemplo:
GET: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datapipelines?api-version=2015-10-01
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 799985
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213927Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:39:27 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
La respuesta incluye el siguiente cuerpo XML.
{
"value": [
{
"name": "FirstPipeline",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datapipelines/FirstPipeline",
"properties": {
"activities": [
{
"type": "Copy",
"typeProperties": {
"source": null,
"sink": null,
"translator": null
},
"inputs": [
{
"name": "InputTable1"
}
],
"outputs": [
{
"name": "OutputTable1"
}
],
"scheduler": {
"frequency": "Hour",
"interval": 1
},
"name": "First pipeline"
}
],
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z",
"isPaused": false,
"runtimeInfo": {
"deploymentTime": "2016-02-22T22:40:24.9768561Z",
"activityPeriods": {
"copyFromBlobToSQL": {
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z"
}
}
},
"id": "c5326985-fd60-4f46-bbae-130d318759c6",
"provisioningState": "Succeeded",
"pipelineMode": "Scheduled"
}
},
{
"value": [
{
"name": "SecondPipeline",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datapipelines/SecondPipeline",
"properties": {
"activities": [
{
"type": "Copy",
"typeProperties": {
"source": null,
"sink": null,
"translator": null
},
"inputs": [
{
"name": "InputTable2"
}
],
"outputs": [
{
"name": "OutputTable2"
}
],
"scheduler": {
"frequency": "Hour",
"interval": 1
},
"name": "Second pipeline"
}
],
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z",
"isPaused": false,
"runtimeInfo": {
"deploymentTime": "2016-02-22T22:40:24.9768561Z",
"activityPeriods": {
"copyFromBlobToSQL": {
"start": "2015-12-09T00:00:00Z",
"end": "2015-12-10T00:00:00Z"
}
}
},
"id": "c5326985-fd60-4f46-bbae-130d318759c6",
"provisioningState": "Succeeded",
"pipelineMode": "Scheduled"
}
}
]
}
Consulte también
Canalizaciones y actividades en Azure Data Factory
Ventanas de actividad de lista
Listas la primera página de instancias de ventana de actividad asociadas a una canalización junto con un vínculo a la página siguiente.
Solicitud
La solicitud de ventana Obtener actividad se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName/datapipelines/{PipelineName}/activitywindows?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro del URI | Requerido | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Nombre del grupo de recursos que hospeda la factoría de datos de Azure. |
| DataFactoryName | Sí | El nombre de la factoría de datos. |
| PipelineName | Sí | Nombre de la canalización. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Requerido | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
| Nombre del elemento | Descripción | Requerido |
|---|---|---|
| Filtrar | Filtro de ventana de actividad especificado mediante la gramática de filtro de Azure Search. Para obtener información detallada, vea https://msdn.microsoft.com/library/azure/dn798921.aspx. | No |
| OrderBy | Ordene la respuesta por las propiedades de la ventana de actividad especificadas. Se trata de una lista de propiedades separadas por comas. Por ejemplo: WindowStart, PercentComplete. Por befault, el orden es ascendente (ASC). Especifique DESC si desea que la lista se ordene en orden descendente. | No |
| Superior | Número de ventanas de actividad que se van a enumerar. | No |
| RunStart | La hora de inicio de la ejecución de la ventana de actividad. | No |
| RunEnd | Hora de finalización de la ejecución de la ventana de actividad. | No |
| WindowStart | La hora de inicio de la ventana de actividad. | No |
| WindowEnd | Hora de finalización de la ventana de actividad. | No |
| WindowState | Estado de la ventana de actividad. Debe ser uno de los valores especificados en este artículo. | No |
| WindowSubstate | Subestado de la ventana de actividad. Debe ser uno de los valores especificados en este artículo. | No |
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud. El proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otros se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
{
"value": {
"activityWindows": [
{
"resourceGroupName": "<resource group name>",
"dataFactoryName": "<data factory name>",
"pipelineName": "<pipeline name>",
"activityName": "<Pipeline activity name.>",
"linkedServiceName": "<linked service name>",
"activityType": "<The activity type>",
"runAttempts": "<Number of activity run attempts.>",
"runStart": "<start time of the last run>",
"runEnd": "<end time of the last run>",
"duration": "<duration of the activity window>",
"percentComplete": "<percent completion of activity window>",
"windowStart": "<window start time>",
"windowEnd": "<window end time>",
"windowState": "<window state>",
"windowSubstate": "<window substate>",
"inputDatasets": "[<input dataset names>]",
"outputDatasets": [
"<output dataset names>"
],
"inputDatasetIds":["<input dataset ids>"],
"outputDatasetIds": [
"<output dataset ids>"
]
}
],
"lastUpdate":"<The approximate time for the last activity windows>",
"aggregates": {}
},
"nextLink": "<Link to next page>"
}
Solicitud y respuesta de ejemplo
URI de ejemplo:
POST:https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/dfName/datapipelines/pipelineName/activitywindows?api-version=2015-10-01
La solicitud se envía con los siguientes encabezados y el cuerpo.
Encabezado:
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Cuerpo:
{
"top": 2
}
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 799985
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:33:07 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
La respuesta incluye el siguiente cuerpo XML.
"value": {
"activityWindows": [
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "pipelineName",
"activityName": "DA_WikipediaClickEvents",
"linkedServiceName": "LS_Wikipedia",
"activityType": "Copy",
"runAttempts": 1,
"runStart": "2016-01-26T21:41:48.636Z",
"runEnd": "2016-01-26T21:41:48.886Z",
"duration": "00:00:00.0000250",
"percentComplete": 100,
"windowStart": "2016-01-25T01:00:00Z",
"windowEnd": "2016-01-25T02:00:00Z",
"windowState": "Pending",
"windowSubstate": "Validating",
"inputDatasets": ["DA_WikipediaEvents"],
"outputDatasets": [
"dsName"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
},
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "pipelineName",
"activityName": "DA_WikipediaClickEvents",
"linkedServiceName": "LS_Wikipedia",
"activityType": "Copy",
"runAttempts": 1,
"runStart": "2016-01-26T21:41:48.636Z",
"runEnd": "2016-01-26T21:41:48.886Z",
"duration": "00:00:00.0000250",
"percentComplete": 100,
"windowStart": "2016-01-25T02:00:00Z",
"windowEnd": "2016-01-25T03:00:00Z",
"windowState": "Pending",
"windowSubstate": "Validating",
"inputDatasets": ["DA_WikipediaEvents"],
"outputDatasets": [
"dsName"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
}
],
"lastUpdate": "2016-01-26T21:43:45.6837301+00:00",
"aggregates": {}
},
"nextLink": "https://localhost:86/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName/datafactories/dfName/datapipelines/pipelineName/activitywindows/skip=FG154H?ApiVerion01012015"}
Use la dirección URL nextLink para obtener la siguiente página de resultados.
Enumerar ventanas de actividad por actividad
Listas la primera página de instancias de ventana de actividad asociadas a una actividad junto con un vínculo a la página siguiente.
Solicitud
La solicitud de ventana Obtener actividad se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName/datapipelines/{PipelineName}/activities/{ActivityName}/activitywindows?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro del URI | Requerido | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Nombre del grupo de recursos que hospeda la factoría de datos de Azure. |
| DataFactoryName | Sí | El nombre de la factoría de datos. |
| PipelineName | Sí | Nombre de la canalización. |
| ActivityName | Sí | Nombre de la actividad. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Requerido | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
| Nombre del elemento | Descripción | Requerido |
|---|---|---|
| Filtrar | Filtro de ventana de actividad especificado mediante la gramática de filtro de Azure Search. Para obtener información detallada, vea https://msdn.microsoft.com/library/azure/dn798921.aspx. | No |
| OrderBy | Ordene la respuesta por las propiedades de la ventana de actividad especificadas. Se trata de una lista de propiedades separadas por comas. Por ejemplo: WindowStart, PercentComplete. Por befault, el orden es ascendente (ASC). Especifique DESC si desea que la lista se ordene en orden descendente. | No |
| Superior | Número de ventanas de actividad que se mostrarán. | No |
| RunStart | Hora de inicio de la ejecución de la ventana de actividad. | No |
| RunEnd | Hora de finalización de la ejecución de la ventana de actividad. | No |
| WindowStart | Hora de inicio de la ventana de actividad. | No |
| WindowEnd | Hora de finalización de la ventana de actividad. | No |
| WindowState | Estado de la ventana de actividad. | No |
| WindowSubstate | Estado de la ventana de actividad. | No |
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud. El proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otros se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
{
"value": {
"activityWindows": [
{
"resourceGroupName": "<resource group name>",
"dataFactoryName": "<data factory name>",
"pipelineName": "<pipeline name>",
"activityName": "<Pipeline activity name.>",
"linkedServiceName": "<linked service name>",
"activityType": "<The activity type>",
"runAttempts": "<Number of activity run attempts.>",
"runStart": "<start time of the last run>",
"runEnd": "<end time of the last run>",
"duration": "<duration of the activity window>",
"percentComplete": "<percent completion of activity window>",
"windowStart": "<window start time>",
"windowEnd": "<window end time>",
"windowState": "<window state>",
"windowSubstate": "<window substate>",
"inputDatasets": "[<input dataset names>]",
"outputDatasets": [
"<output dataset names>"
],
"inputDatasetIds":["<input dataset ids>"],
"outputDatasetIds": [
"<output dataset ids>"
]
}
],
"lastUpdate":"<The approximate time for the last activity windows>",
"aggregates": {}
},
"nextLink": "<Link to next page>"
}
Solicitud y respuesta de ejemplo
URI de ejemplo:
POST:https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/dfName/datapipelines/pipelineName/activities/activityName/activitywindows?api-version=2015-10-01
La solicitud se envía con el siguiente encabezado y el cuerpo:
Encabezado:
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Cuerpo:
{
"top": 2
}
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 799985
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:33:07 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
La respuesta incluye el siguiente cuerpo XML.
"value": {
"activityWindows": [
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "pipelineName",
"activityName": "activityName",
"linkedServiceName": "LS_Wikipedia",
"activityType": "Copy",
"runAttempts": 1,
"runStart": "2016-01-26T21:41:48.636Z",
"runEnd": "2016-01-26T21:41:48.886Z",
"duration": "00:00:00.0000250",
"percentComplete": 100,
"windowStart": "2016-01-25T01:00:00Z",
"windowEnd": "2016-01-25T02:00:00Z",
"windowState": "Pending",
"windowSubstate": "Validating",
"inputDatasets": ["DA_WikipediaEvents"],
"outputDatasets": [
"dsName"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
},
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "pipelineName",
"activityName": "activityName",
"linkedServiceName": "LS_Wikipedia",
"activityType": "Copy",
"runAttempts": 1,
"runStart": "2016-01-26T21:41:48.636Z",
"runEnd": "2016-01-26T21:41:48.886Z",
"duration": "00:00:00.0000250",
"percentComplete": 100,
"windowStart": "2016-01-25T02:00:00Z",
"windowEnd": "2016-01-25T03:00:00Z",
"windowState": "Pending",
"windowSubstate": "Validating",
"inputDatasets": ["DA_WikipediaEvents"],
"outputDatasets": [
"dsName"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
}
],
"lastUpdate": "2016-01-26T21:43:45.6837301+00:00",
"aggregates": {}
},
"nextLink": "https://localhost:86/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName/datafactories/dfName/datapipelines/pipelineName/activities/activityName/activitywindows/skip=FG154H?ApiVerion01012015"}
Use la dirección URL nextLink para obtener la siguiente página de resultados.
Reanudar
Reanuda una canalización suspendida en la factoría de datos.
Solicitud
La solicitud Reanudar canalización se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datapipelines/{PipelineName}/resume?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | El identificador de suscripción a Azure |
| ResourceGroupName | Sí | Un nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos donde desea ubicar la canalización. |
| PipelineName | Sí | Nombre de la canalización que desea reanudar. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud; el proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otro se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
Ninguno.
Solicitud y respuesta de ejemplo
URI de ejemplo:
POST: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/datapipelines/pipelinetest/resume?api-version=2015-10-01
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 11995
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213927Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:39:27 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Consulte también
Canalizaciones y actividades en Azure Data Factory
Establecer período activo
Configura el período activo para una canalización de datos.
Solicitud
La solicitud Establecer estado de segmento se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datapipelines/{PipelineName}/update?start={StartDateTime}& end={EndDateTime}&autoResolve=false&forceRecalc=false&api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
Inserte aquí el cuerpo de la subsección.
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Un nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos que desea establecer como canalización. |
| PipelineName | Sí | Nombre de la tabla que desea crear. |
| StartDateTime | Sí | Datetime cuando se inician los segmentos. |
| EndDateTime | Sí | Datetime cuando finalizan los segmentos. La fecha y hora predeterminadas es 48 horas después de la fecha y hora de inicio. |
| autoResolve | No | Indica si esta solicitud usa o no resolución automática. |
| forceRecalc | No | Indica si esta solicitud usa o no el recálculo forzoso. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud. El proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otros se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
| Location | URI del objeto que desea crear u obtener. |
Cuerpo de la respuesta
Ninguno.
Solicitud y respuesta de ejemplo
URI de ejemplo:
POST: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/datapipelines/pipelinetest/update?start=2014-12-02T00:00:00.0000000&end=2014-12-02T01:00:00.0000000& autoResolve=false&forceRecalc=false&api-version=2015-10-01
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 799985
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:33:07 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Consulte también
Canalizaciones y actividades en Azure Data Factory
Suspender
Pausa una canalización en ejecución existente.
Solicitud
La solicitud Suspender canalización se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datapipelines/{PipelineName}/pause?api-version={api-version} | HTTP/1.1 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Un nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos donde desea ubicar la canalización. |
| PipelineName | Sí | Nombre de la canalización que desea suspender. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud. El proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otros se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
Ninguno.
Solicitud y respuesta de ejemplo
Ejemplo:
POST: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/datapipelines/pipelinetest/pause?api-version=2015-10-01
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Status Code:
OK
Headers:
Pragma : no-cache
x-ms-request-id : 00000000-1111-1111-1111-000000000000
x-ms-ratelimit-remaining-subscription-writes: 11995
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213927Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:39:27 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET