Pipeline versão 1 (V1)
Observação
Esta documentação de referência se aplica a Azure Data Factory versão 1 (V1).
Criar ou Atualizar
Cria um novo pipeline ou atualiza o conteúdo de um pipeline existente.
Solicitação
A solicitação Criar ou Atualizar Pipeline pode ser construída da seguinte maneira. Recomendado HTTPS:
Verbo HTTP | URI da solicitação | Versão 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 URI
Parâmetro URI | Necessário | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | Um nome exclusivo para o grupo de recursos que hospeda sua fábrica de dados do Azure. |
DataFactoryName | Yes | O nome da fábrica de dados onde deseja criar o pipeline. |
PipelineName | Yes | Nome do pipeline que deseja criar. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação:
Cabeçalho da solicitação | Necessário | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
O corpo da solicitação depende de sua propriedade de pipeline. Para obter mais informações sobre pipelines, consulte Pipelines e Atividades em Azure Data Factory artigo para obter detalhes.
Formato do corpo da solicitação:
{
"name": <name>,
"properties": {
"description": <description>,
"activities": <activity>
}
}
A tabela a seguir descreve os elementos do corpo da solicitação.
Nome do elemento | Obrigatório | Descrição |
---|---|---|
name | Sim | Nome do pipeline. |
descrição | Sim | Texto que descreve qual a utilidade da atividade. |
activity | Yes | Atividade no pipeline. Um pipeline pode ter uma ou mais atividades. |
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) - se a solicitação foi concluída com êxito.
202 (Aceito) – quando a solicitação é aceita.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
412 (Falha na Pré-condição) – quando a condição especificada pelo cabeçalho If-Match falha.
501 (Não Implementado) – quando a validação não está implementada
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação; o provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Localização | URI do objeto que você deseja criar ou obter. |
Corpo da resposta
{
"name": <name>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
}
A tabela a seguir descreve os elementos do corpo da resposta.
Nome do elemento | Descrição |
---|---|
name | Especifica o nome do pipeline. |
ID | Especifica a URL de identificação do Pipeline. |
Descrição | Texto que descreve qual a utilidade da atividade. |
Atividade | Atividade no pipeline. Um pipeline pode ter uma ou mais atividades. |
Status | Especifica se este pipeline é pausado ou não. |
Provisioningstate | Especifica o estado atual de provisionamento do pipeline. Quando um pipeline é criado com êxito, o valor do elemento é Bem-sucedido. |
Hubname | O hub que contém o pipeline. |
Exemplo de solicitação e resposta
URI de exemplo:
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
A solicitação é enviada com os seguintes cabeçalhos:
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
e o seguinte corpo:
{
"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
}
}
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
Cabeçalho:
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
A resposta inclui o seguinte corpo XML:
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 Também
Pipelines e atividades em Azure Data Factory
Excluir
Exclui o pipeline especificado.
Solicitação
A solicitação Excluir Pipeline pode ser construída da seguinte maneira (recomendado HTTPS):
Verbo HTTP | URI da solicitação | Versão 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 URI
Parâmetro URI | Necessário | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | O nome exclusivo para o grupo de recursos que hospeda sua Fábrica de Dados do Azure. |
DataFactoryName | Yes | Nome da fábrica de dados de onde deseja excluir o pipeline. |
PipelineName | Yes | Nome do pipeline que você deseja excluir. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Necessário | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) – quando a solicitação é concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
412 (Falha na Pré-condição) – quando a condição especificada pelo cabeçalho If-Match falha.
501 (Não Implementado) – quando a validação não está implementada
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação; o provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Corpo da resposta
Nenhum.
Exemplo de solicitação e resposta
URI de exemplo:
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
A solicitação é enviada com os seguintes cabeçalhos.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
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 Também
Pipelines e atividades em Azure Data Factory
Get
Obtém informações sobre o pipeline especificado.
Solicitação
A solicitação Obter Pipeline pode ser construída da seguinte maneira (recomendado HTTPS):
Verbo HTTP | URI da solicitação | Versão 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 URI
Parâmetro URI | Necessário | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | Um nome exclusivo para o grupo de recursos que hospeda sua fábrica de dados do Azure. |
DataFactoryName | Yes | Nome da fábrica de dados em que você deseja localizar seu pipeline. |
PipelineName | Yes | Nome do pipeline que deseja localizar. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Obrigatório | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) – quando a solicitação é concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
412 (Falha na Pré-condição) – quando a condição especificada pelo cabeçalho If-Match falha.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação; o provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Corpo da resposta
O corpo da resposta depende de sua propriedade de pipeline, para obter mais informações sobre pipelines, consulte Pipelines e Atividades.
{
"name": <name>,
"id": <ID>,
"properties": {
"description": <description>,
"activities": <activity>,
"isPaused": <Status>,
"provisioningState": <ProvisioningState>,
"hubName": <HubName>
}
}
A tabela a seguir descreve os elementos do corpo da resposta.
Nome do elemento | Descrição |
---|---|
name | Especifica o nome do pipeline. |
ID | Especifica a URL de identificação do Pipeline. |
Descrição | Texto que descreve qual a utilidade da atividade. |
Atividade | Atividade no pipeline. Um pipeline pode ter uma ou mais atividades. |
Status | Especifica se este pipeline é pausado ou não |
Provisioningstate | Especifica o estado atual de provisionamento do pipeline. Quando um pipeline é criado com êxito, o valor do elemento é Bem-sucedido. |
Hubname | O hub que contém o pipeline. |
Exemplo de solicitação e resposta
URI de exemplo:
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
A solicitação é enviada com os seguintes cabeçalhos.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
Cabeçalho:
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
A resposta inclui o corpo XML a seguir.
{
"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 Também
Pipelines e atividades no Azure Data Factory
Lista
Listas informações sobre todos os serviços vinculados em um data factory.
Solicitação
A solicitação Listar Pipeline pode ser construída da seguinte maneira (recomendado HTTPS):
Verbo HTTP | URI da solicitação | Versão 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 URI
Parâmetro URI | Necessário | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | Um nome exclusivo para o grupo de recursos que hospeda seu serviço de fábrica de dados do Azure. |
DataFactoryName | Yes | Nome da fábrica de dados em que você deseja localizar seu pipeline. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Necessário | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) - se a solicitação foi concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
412 (Falha na Pré-condição) – quando a condição especificada pelo cabeçalho If-Match falha.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação. O provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Corpo da resposta
{
"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>
}
}
]
}
A tabela a seguir descreve os elementos do corpo da resposta.
Nome do elemento | Descrição |
---|---|
name | Especifica o nome do pipeline. |
ID | Especifica a URL de identificação do Pipeline. |
Descrição | Texto que descreve qual a utilidade da atividade. |
Atividade | Atividade no pipeline: um pipeline pode ter uma ou mais atividades. |
Status | Especifica se este pipeline é pausado ou não. |
Provisioningstate | Especifica o estado atual de provisionamento do pipeline. Quando um pipeline é criado com êxito, o valor do elemento é Bem-sucedido. |
Hubname | O hub que contém o pipeline. |
Consulte Pipelines e Atividades em Azure Data Factory para obter mais detalhes.
Se houver mais de 100 registros, você obterá 100 registros por vez com um 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"
}
Você envia a próxima solicitação usando a URL nextLink para obter o próximo conjunto de registros. Talvez seja necessário encapsular & com aspas duplas ("") na URL nextLink. Apenas 100 registros são retornados por vez.
Exemplo de solicitação e resposta
URI de exemplo:
GET: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datapipelines?api-version=2015-10-01
A solicitação é enviada com os seguintes cabeçalhos.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
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
A resposta inclui o corpo XML a seguir.
{
"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 Também
Pipelines e atividades no Azure Data Factory
Listar Windows de Atividades
Listas a primeira página das instâncias da janela de atividade associadas a um pipeline, juntamente com um link para a próxima página.
Solicitação
A solicitação da janela Obter Atividade pode ser construída da seguinte maneira (HTTPS é recomendado):
Verbo HTTP | URI da solicitação | Versão de 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 URI
Parâmetro do URI | Obrigatório | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | Nome do grupo de recursos que hospeda o Azure Data Factory. |
DataFactoryName | Yes | Nome do Data Factory. |
PipelineName | Yes | Nome do pipeline. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Obrigatório | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nome do elemento | Descrição | Obrigatório |
---|---|---|
Filtrar | O filtro de janela de atividade especificado usando a gramática de filtro do Azure Search. Para obter detalhes, consulte https://msdn.microsoft.com/library/azure/dn798921.aspx. | No |
OrderBy | Ordenar a resposta pelas propriedades da janela de atividade especificadas. Esta é uma lista de propriedades separadas por vírgulas. Por exemplo: WindowStart, PercentComplete. Por befault, a ordem é ordem crescente (ASC). Especifique DESC se quiser que a lista seja ordenada em ordem decrescente. | No |
Parte superior | O número de janelas de atividade a serem listadas. | No |
RunStart | A hora de início da execução da janela de atividade. | No |
RunEnd | A hora de término da execução da janela de atividade. | No |
WindowStart | A janela hora de início da atividade. | No |
WindowEnd | A janela de hora de término da atividade. | No |
WindowState | O estado da janela de atividade. Deve ser um dos valores especificados neste artigo. | No |
WindowSubstate | O subestado da janela de atividade. Deve ser um dos valores especificados neste artigo. | No |
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) - se a solicitação foi concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de Resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação. O provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Corpo da resposta
{
"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>"
}
Exemplo de solicitação e resposta
URI de exemplo:
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
A solicitação é enviada com os cabeçalhos e o corpo a seguir.
Cabeçalho:
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Corpo:
{
"top": 2
}
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
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
A resposta inclui o corpo XML a seguir.
"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 a URL nextLink para obter a próxima página de resultados.
Listar atividades windows por atividade
Listas a primeira página de instâncias da janela de atividade associadas a uma atividade, juntamente com um link para a próxima página.
Solicitação
A solicitação da janela Obter Atividade pode ser construída da seguinte maneira (HTTPS é recomendado):
Verbo HTTP | URI da solicitação | Versão de 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 URI
Parâmetro do URI | Obrigatório | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | Nome do grupo de recursos que hospeda o Azure Data Factory. |
DataFactoryName | Yes | Nome do Data Factory. |
PipelineName | Yes | Nome do pipeline. |
ActivityName | Yes | Nome da atividade. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Obrigatório | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nome do elemento | Descrição | Obrigatório |
---|---|---|
Filtrar | O filtro de janela de atividade especificado usando a gramática de filtro do Azure Search. Para obter detalhes, consulte https://msdn.microsoft.com/library/azure/dn798921.aspx. | No |
OrderBy | Ordenar a resposta pelas propriedades da janela de atividade especificadas. Esta é uma lista de propriedades separadas por vírgulas. Por exemplo: WindowStart, PercentComplete. Por befault, a ordem é ordem crescente (ASC). Especifique DESC se quiser que a lista seja ordenada em ordem decrescente. | No |
Parte superior | O número de janelas de atividade a serem listadas. | No |
RunStart | A hora de início da execução da janela de atividade. | No |
RunEnd | A hora de término da execução da janela de atividade. | No |
WindowStart | A janela hora de início da atividade. | No |
WindowEnd | A janela de hora de término da atividade. | No |
WindowState | O estado da janela de atividade. | No |
WindowSubstate | O estado da janela de atividade. | No |
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) - se a solicitação foi concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de Resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação. O provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Corpo da resposta
{
"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>"
}
Exemplo de solicitação e resposta
URI de exemplo:
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
A solicitação é enviada com o seguinte cabeçalho e o corpo:
Cabeçalho:
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Corpo:
{
"top": 2
}
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
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
A resposta inclui o corpo XML a seguir.
"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 a URL nextLink para obter a próxima página de resultados.
Retomar
Retoma um pipeline suspenso no data factory.
Solicitação
A solicitação Retomar Pipeline pode ser construída da seguinte maneira (recomendado HTTPS):
Verbo HTTP | URI da solicitação | Versão 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 URI
Parâmetro URI | Necessário | Descrição |
---|---|---|
SubscriptionID | Yes | ID da assinatura do Azure |
ResourceGroupName | Yes | Um nome exclusivo para o grupo de recursos que hospeda sua fábrica de dados do Azure. |
DataFactoryName | Yes | Nome da fábrica de dados em que você deseja localizar seu pipeline. |
PipelineName | Yes | Nome do pipeline que deseja retomar. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Necessário | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) – quando a solicitação é concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação; o provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Corpo da resposta
Nenhum.
Exemplo de solicitação e resposta
URI de exemplo:
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
A solicitação é enviada com os seguintes cabeçalhos.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
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 Também
Pipelines e atividades em Azure Data Factory
Definir Período Ativo
Configura o período ativo para um pipeline de dados.
Solicitação
A solicitação Definir Status da Fatia pode ser construída da seguinte maneira (recomendado HTTPS):
Verbo HTTP | URI da solicitação | Versão 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 URI
Inserir o corpo da subseção aqui.
Parâmetro URI | Necessário | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | Um nome exclusivo para o grupo de recursos que hospeda sua fábrica de dados do Azure. |
DataFactoryName | Yes | Nome da fábrica de dados para o qual você deseja definir o pipeline. |
PipelineName | Yes | Nome da tabela que você deseja criar. |
StartDateTime | Yes | A data e hora de início das fatias. |
EndDateTime | Yes | A data e hora de encerrar as fatias. A data e hora padrão é 48 horas após a data e hora de início. |
autoResolve | No | Indica se essa solicitação usa resolução automática ou não. |
forceRecalc | No | Indica se essa solicitação usa forçar recalcular ou não. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Necessário | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
200 (OK) - se a solicitação foi concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação. O provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Localização | URI do objeto que você deseja criar ou obter. |
Corpo da resposta
Nenhum.
Exemplo de solicitação e resposta
URI de exemplo:
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
A solicitação é enviada com os seguintes cabeçalhos.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
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 Também
Pipelines e atividades no Azure Data Factory
Suspend
Pausa um pipeline em execução existente.
Solicitação
A solicitação Suspender Pipeline pode ser construída da seguinte maneira (recomendado HTTPS):
Verbo HTTP | URI da solicitação | Versão 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 URI
Parâmetro URI | Necessário | Descrição |
---|---|---|
SubscriptionID | Yes | Sua ID da assinatura do Azure. |
ResourceGroupName | Yes | Um nome exclusivo para o grupo de recursos que hospeda sua fábrica de dados do Azure. |
DataFactoryName | Yes | Nome da fábrica de dados em que você deseja localizar seu pipeline. |
PipelineName | Yes | Nome do pipeline que deseja suspender. |
Versão da API | Yes | Especifica a versão do protocolo usado para fazer essa solicitação. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos da solicitação.
Cabeçalho da solicitação | Necessário | Descrição |
---|---|---|
x-ms-client-request-id | Yes | A ID da operação para essa solicitação. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
200 (OK) - se a solicitação foi concluída com êxito.
400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.
404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id | Um identificador exclusivo para a operação atual, serviço gerado. |
x-ms-ratelimit-remaining-subscription-writes | O limite restante da assinatura atual. |
x-ms-correlation-request-id | Especifica a ID de correlação de rastreamento para a solicitação. O provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure. |
x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
Data | Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Corpo da resposta
Nenhum.
Exemplo de solicitação e resposta
Exemplo:
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
A solicitação é enviada com os seguintes cabeçalhos.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.
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