Segmento versión 1 (V1)
Nota
Esta documentación de referencia se aplica a Azure Data Factory versión 1 (V1).
Get
Obtiene los segmentos de datos de una tabla de la factoría de datos.
Solicitud
La solicitud Obtener segmento 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}/tables/{TableName}/slices?start={StartDateTime}& end={EndDateTime}&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 tabla. |
TableName | Sí | Nombre de la tabla que desea segmentar. |
StartDateTime | Sí | La fecha y hora cuando se inician los segmentos. |
EndDateTime | No | La fecha y hora cuando finalizan los segmentos. El valor predeterminado es de 48 horas después de la fecha y hora de inicio. |
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 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": [
{
"status": <SliceStatus>,
"state": <SliceState>,
"retryCount": <RetryCount>,
"longRetryCount": <LongRetryCount>,
"statusUpdateTimestamp": <Timestamp>,
"start": <StartDateTime1>.
"end": <EndDateTime1>
},
{
"status": <SliceStatus>,
"state": <SliceState>,
"retryCount": <RetryCount>,
"longRetryCount": <LongRetryCount>,
"statusUpdateTimestamp": <Timestamp>,
"start": <StartDateTime2>.
"end": <EndDateTime2>
},
{
"status": <SliceStatus>,
"state": <SliceState>,
"retryCount": <RetryCount>,
"longRetryCount": <LongRetryCount>,
"statusUpdateTimestamp": <Timestamp>,
"start": <StartDateTime3>.
"end": <EndDateTime3>
}
]
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
Nombre del elemento | Descripción |
---|---|
SliceStatus | Estado de este segmento. |
SliceState | Estado del segmento. |
RetryCount | El número de veces que se reintentarán los segmentos. |
LongRetryCount | El número de veces que los segmentos realizarán un reintento largo. |
StartDateTime | La fecha y hora en que se inicia este segmento |
EndDateTime | La fecha y hora en que finaliza este segmento. |
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/datasets/EmpSQLTable/slices?start=2015-12-09T12:00:00.0000000&end=2015-12-09T14:00:00.0000000&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: 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": [
{
"status": "Ready",
"state": "Ready",
"retryCount": 0,
"longRetryCount": 0,
"statusUpdateTimestamp": "2016-02-22T23:06:59.1238656Z",
"start": "2015-12-09T12:00:00Z",
"end": "2015-12-09T13:00:00Z"
},
{
"status": "Ready",
"state": "Ready",
"retryCount": 0,
"longRetryCount": 0,
"statusUpdateTimestamp": "2016-02-22T23:06:59.1238656Z",
"start": "2015-12-09T13:00:00Z",
"end": "2015-12-09T14:00:00Z"
}
]
}
Establecimiento del estado
Establece el estado de los segmentos de una tabla de una factoría 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 |
---|---|---|
PUT | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/tables/{TableName}/slices/ setstatus?start={StartDateTime}&end={EndDateTime}&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 tabla. |
TableName | Sí | Nombre de la tabla que desea crear. |
StartDateTime | Sí | Datetime cuando se inician los segmentos. |
EndDateTime | Sí | Datetime cuando finalizan los segmentos. |
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
{
"SliceStatus": <NewSliceStatus>,
"UpdateType": <UpdateType>
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
Nombre del elemento | Descripción |
---|---|
NewSliceStatus | El estado que desea establecer. |
UpdateType | Especifica el tipo de actualización del segmento. |
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
Ninguno.
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/test/tables/tabletest/slices/setstatus?start=2015-12-02T00:00:00.0000000&end=2015-12-02T01:00:00.0000000&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