Data Factory versión 1 (V1)
Nota
Esta documentación de referencia se aplica a Azure Data Factory versión 1 (V1).
Crear o actualizar
La operación Crear o actualizar factoría de datos crea una factoría de datos o actualiza el contenido de una existente.
Solicitud
La solicitud Crear o actualizar factoría de datos se puede 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}?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 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 formato del cuerpo de la solicitud es el siguiente:
{
"name": <name>,
"location": <location>,
"tags": <tags>,
"properties": <properties>
}
En la tabla siguiente se describen los elementos del cuerpo de la solicitud.
Nombre del elemento | Obligatorio | Descripción |
---|---|---|
name | Sí | Especifica el nombre de la factoría de datos. |
ubicación | Sí | Especifica la ubicación compatible de Azure de la factoría de datos. |
etiquetas | No | Una lista de pares de clave y valor que describen el recurso. |
properties | No | Propiedades de la factoría de datos. |
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 pudo 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 | Un identificador único de la operación actual, generado por el servicio de Factoría de datos. |
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 registrarlo 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>",
"type": "Microsoft.DataFactory/datafactories",
"location": "<location>",
"tags": "<tag>",
"properties": {
"dataFactoryId": "<DataFactoryID>",
"provisioningState": "<provisioningstate>",
"error": "<Error>",
"errorMessage": "<ErrorMessage>"
}
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
Nombre del elemento | Descripción |
---|---|
name | Especifica el nombre de la factoría de datos. |
id | Especifica la dirección URL de identificación de la factoría de datos. |
ubicación | Especifica la ubicación compatible de Azure de la factoría de datos. |
etiquetas | Una lista de pares de clave y valor que describen el recurso. |
datafactoryID | Identificador generado automática para esta factoría de datos. |
provisioningstate | Especifica el estado de aprovisionamiento actual de la factoría de datos. Cuando se crea correctamente una factoría de datos, el valor del elemento es Correcto. |
error | Especifica si se produjo un error durante la implementación. |
errormessage | Mensaje relacionado con el error. |
Solicitud y respuesta de ejemplo
Para el siguiente URI de ejemplo:
PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test?api-version=2015-10-01
Encabezado de solicitud:
Headers:
x-ms-client-request-id : 029a8839-027e-43c5-8854-af4388dcd232
Cuerpo de la solicitud:
Body:
{
"name": "RestDataFactory",
"location": "West US",
"tags": {}
}
Se devuelve la siguiente respuesta:
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:20141203T212810Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:28:09 GMT
Location : https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test?api-version=2015-10-01
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
client-tracking-id : 10
The response includes the following XML body.
{
"name": "test",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test",
"type": "Microsoft.DataFactory/datafactories",
"location": "westus",
"tags": {},
"properties": {
"dataFactoryId": "39d4e663-cfcb-4ee9-ad19-92cf87de9197",
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
}
Eliminar
Elimina la factoría de datos específica.
Solicitud
La solicitud Eliminar factoría de datos 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}?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 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?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 : f8c04a54-259b-4085-b596-e6c97fa6433a
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id : ad02c0f4-ca01-49fe-b1d2-5149629d2412
x-ms-routing-request-id : EASTUS:20160205T230719Z:ad02c0f4-ca01-49fe-b1d2-5149629d2412
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Fri, 05 Feb 2016 23:07:19 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Body:
Get
Obtiene información sobre la factoría de datos especificada.
Solicitud
La solicitud Obtener factoría de datos 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}?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 que desea obtener. |
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
{
"name": "<Name>",
"id": "<ID>",
"type": "Microsoft.DataFactory/datafactories",
"location": "<location>",
"tags": "<tag>",
"properties": {
"dataFactoryId": "<DataFactoryID>",
"provisioningState": "<provisioningstate>",
"error": "<Error>",
"errorMessage": "<ErrorMessage>"
}
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
Nombre del elemento | Descripción |
---|---|
name | Especifica el nombre de la factoría de datos |
id | Especifica la dirección URL de identificación de la factoría de datos. |
ubicación | Especifica la ubicación compatible de Azure de la factoría de datos |
etiquetas | Una lista de pares de clave-valor que describen el recurso |
datafactoryID | Identificador generado automática para esta factoría de datos. |
provisioningstate | Especifica el estado de aprovisionamiento actual de la factoría de datos. Cuando se crea correctamente una factoría de datos, el valor del elemento es Correcto |
error | Especifica si se produjo algún error durante la implementación. |
errormessage | Mensaje relacionado con el error |
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/test?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: 799986
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T221428Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 22:14:27 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
The response includes the following XML body.
{
"name": "test",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test",
"type": "Microsoft.DataFactory/datafactories",
"location": "westus",
"tags": {},
"properties": {
"dataFactoryId": "00000000-1111-1111-1111-000000000000",
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
}
List
Listas información de todas las factorías de datos de un grupo de recursos.
Solicitud
La solicitud Enumerar Factorías de datos 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?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. |
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 otro se puedan correlacionar entre 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": <name1> ,
"id": <id>,
"type": "Microsoft.DataFactory/datafactories",
"location": <location>,
"tags": {},
"properties": {
"dataFactoryId": <datafactoryID>
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
},
{
"name": <name2> ,
"id": <id>,
"type": "Microsoft.DataFactory/datafactories",
"location": <location>,
"tags": {},
"properties": {
"dataFactoryId": <datafactoryID>
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
}
]
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
Nombre del elemento | Descripción |
---|---|
name | Especifica el nombre de la factoría de datos. |
id | Especifica la dirección URL de identificación de la factoría de datos. |
ubicación | Especifica la ubicación compatible de Azure de la factoría de datos. |
etiquetas | Una lista de pares de clave y valor que describen el recurso. |
datafactoryID | Identificador generado automática para esta factoría de datos. |
provisioningstate | Especifica el estado de aprovisionamiento actual de la factoría de datos. Cuando se crea correctamente una factoría de datos, el valor del elemento es Correcto. |
error | Especifica cualquier error que se produce durante la implementación. |
errormessage | Mensaje relacionado con el error. |
Si hay más de 100 registros, obtendrá 100 registros a la vez con un nextLink:
{
"value": [
{
"name": <name1> ,
"id": <id>,
"type": "Microsoft.DataFactory/datafactories",
"location": <location>,
"tags": {},
"properties": {
"dataFactoryId": <datafactoryID>,
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
},
{
"name": <name2> ,
"id": <id>,
"type": "Microsoft.DataFactory/datafactories",
"location": <location>,
"tags": {},
"properties": {
"dataFactoryId": <datafactoryID>,
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
}
],
"nextLink": "https://management.azure.com/subscriptions/{subscription ID>/resourcegroups/{Resource group name>/providers/Microsoft.DataFactory/datafactories?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?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: 799986
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T221428Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 22:14:27 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
The response includes the following XML body.
{
"value": [
{
"name": "test",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test",
"type": "Microsoft.DataFactory/datafactories",
"location": "westus",
"tags": {},
"properties": {
"dataFactoryId": "00000000-1111-1111-1111-000000000000",
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
},
{
"name": "test2",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test2",
"type": "Microsoft.DataFactory/datafactories",
"location": "westus",
"tags": {},
"properties": {
"dataFactoryId": "00000000-1111-1111-1111-000000000001",
"provisioningState": "Succeeded",
"error": null,
"errorMessage": null
}
}
]
}
Ventanas de actividad de lista
Listas la primera página de instancias de ventana de actividad asociadas a una factoría de datos 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}/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í | Nombre de la factoría de datos. |
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. 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/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": 5
}
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": "DA_WikipediaClickEvents",
"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": [
"DA_WikipediaClickEvents"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
},
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "DA_WikipediaClickEvents",
"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": [
"DA_WikipediaClickEvents"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
},
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "DA_WikipediaClickEvents",
"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-03:00:00Z",
"windowEnd": "2016-01-25T04:00:00Z",
"windowState": "Pending",
"windowSubstate": "Validating",
"inputDatasets": ["DA_WikipediaEvents"],
"outputDatasets": [
"DA_WikipediaClickEvents"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
},
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "DA_WikipediaClickEvents",
"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-04:00:00Z",
"windowEnd": "2016-01-25T05:00:00Z",
"windowState": "Pending",
"windowSubstate": "Validating",
"inputDatasets": ["DA_WikipediaEvents"],
"outputDatasets": [
"DA_WikipediaClickEvents"
],
"inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],
"outputDatasetIds": [
"1e4a0e42-5df3-4a7e-9860-7f75d306ff75"
]
},
{
"resourceGroupName": "rgName",
"dataFactoryName": "dfName",
"pipelineName": "DA_WikipediaClickEvents",
"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-25T05:00:00Z",
"windowEnd": "2016-01-25T06:00:00Z",
"windowState": "Pending",
"windowSubstate": "Validating",
"inputDatasets": ["DA_WikipediaEvents"],
"outputDatasets": [
"DA_WikipediaClickEvents"
],
"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/activitywindows/skip=FG154H?ApiVerion01012015"}
Use la dirección URL nextLink para obtener la siguiente página de resultados.
Uso del filtro en el cuerpo de la solicitud
{
"filter": "(ActivityName eq 'BlobToSqlCopyActivity') and (PipelineName eq 'DP_WikipediaSamplePipeline')"
}