Integration Runtimes - Get Status

Serviço:

Data Factory

Versão da API:

2018-06-01

Obtém informações detalhadas de status para um runtime de integração.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/getStatus?api-version=2018-06-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
factoryName	path	True	string	O nome da fábrica. Padrão Regex: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$
integrationRuntimeName	path	True	string	O nome do runtime de integração. Padrão Regex: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$
resourceGroupName	path	True	string	O nome do grupo de recursos. Padrão Regex: ^[-\w\._\(\)]+$
subscriptionId	path	True	string	O identificador da assinatura.
api-version	query	True	string	A versão da API.

Respostas

Nome	Tipo	Description
200 OK	IntegrationRuntimeStatusResponse	OK.
Other Status Codes	CloudError	Uma resposta de erro recebida do serviço Azure Data Factory.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

IntegrationRuntimes_GetStatus

Solicitação de exemplo

HTTP

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/integrationRuntimes/exampleIntegrationRuntime/getStatus?api-version=2018-06-01

Java

/**
 * Samples for IntegrationRuntimes GetStatus.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/examples/
     * IntegrationRuntimes_GetStatus.json
     */
    /**
     * Sample code: IntegrationRuntimes_GetStatus.
     * 
     * @param manager Entry point to DataFactoryManager.
     */
    public static void integrationRuntimesGetStatus(com.azure.resourcemanager.datafactory.DataFactoryManager manager) {
        manager.integrationRuntimes().getStatusWithResponse("exampleResourceGroup", "exampleFactoryName",
            "exampleIntegrationRuntime", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.datafactory import DataFactoryManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-datafactory
# USAGE
    python integration_runtimes_get_status.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DataFactoryManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="12345678-1234-1234-1234-12345678abc",
    )

    response = client.integration_runtimes.get_status(
        resource_group_name="exampleResourceGroup",
        factory_name="exampleFactoryName",
        integration_runtime_name="exampleIntegrationRuntime",
    )
    print(response)


# x-ms-original-file: specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/examples/IntegrationRuntimes_GetStatus.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armdatafactory_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/datafactory/armdatafactory/v9"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ab04533261eff228f28e08900445d0edef3eb70c/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/examples/IntegrationRuntimes_GetStatus.json
func ExampleIntegrationRuntimesClient_GetStatus() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdatafactory.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewIntegrationRuntimesClient().GetStatus(ctx, "exampleResourceGroup", "exampleFactoryName", "exampleIntegrationRuntime", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.IntegrationRuntimeStatusResponse = armdatafactory.IntegrationRuntimeStatusResponse{
	// 	Name: to.Ptr("exampleIntegrationRuntime"),
	// 	Properties: &armdatafactory.SelfHostedIntegrationRuntimeStatus{
	// 		Type: to.Ptr(armdatafactory.IntegrationRuntimeTypeSelfHosted),
	// 		State: to.Ptr(armdatafactory.IntegrationRuntimeStateOnline),
	// 		TypeProperties: &armdatafactory.SelfHostedIntegrationRuntimeStatusTypeProperties{
	// 			AutoUpdate: to.Ptr(armdatafactory.IntegrationRuntimeAutoUpdateOff),
	// 			Capabilities: map[string]*string{
	// 				"connectedToResourceManager": to.Ptr("True"),
	// 				"credentialInSync": to.Ptr("True"),
	// 				"httpsPortEnabled": to.Ptr("True"),
	// 				"nodeEnabled": to.Ptr("True"),
	// 				"serviceBusConnected": to.Ptr("True"),
	// 			},
	// 			CreateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-06-14T09:17:45.183Z"); return t}()),
	// 			LatestVersion: to.Ptr("3.7.6711.1"),
	// 			LocalTimeZoneOffset: to.Ptr("PT8H"),
	// 			Nodes: []*armdatafactory.SelfHostedIntegrationRuntimeNode{
	// 				{
	// 					Capabilities: map[string]*string{
	// 						"connectedToResourceManager": to.Ptr("True"),
	// 						"credentialInSync": to.Ptr("True"),
	// 						"httpsPortEnabled": to.Ptr("True"),
	// 						"nodeEnabled": to.Ptr("True"),
	// 						"serviceBusConnected": to.Ptr("True"),
	// 					},
	// 					HostServiceURI: to.Ptr("https://yanzhang-dt.fareast.corp.microsoft.com:8050/HostServiceRemote.svc/"),
	// 					IsActiveDispatcher: to.Ptr(true),
	// 					LastConnectTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-06-14T14:52:59.893Z"); return t}()),
	// 					LastStartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-06-14T14:52:59.893Z"); return t}()),
	// 					LastUpdateResult: to.Ptr(armdatafactory.IntegrationRuntimeUpdateResultNone),
	// 					MachineName: to.Ptr("YANZHANG-DT"),
	// 					MaxConcurrentJobs: to.Ptr[int32](56),
	// 					NodeName: to.Ptr("Node_1"),
	// 					RegisterTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-06-14T14:51:44.923Z"); return t}()),
	// 					Status: to.Ptr(armdatafactory.SelfHostedIntegrationRuntimeNodeStatusOnline),
	// 					Version: to.Ptr("3.8.6730.2"),
	// 					VersionStatus: to.Ptr("UpToDate"),
	// 			}},
	// 			ServiceUrls: []*string{
	// 				to.Ptr("wu.frontend.int.clouddatahub-int.net"),
	// 				to.Ptr("*.servicebus.windows.net")},
	// 				TaskQueueID: to.Ptr("1a6296ab-423c-4346-9bcc-85a78c2c0582"),
	// 				UpdateDelayOffset: to.Ptr("PT3H"),
	// 				Version: to.Ptr("3.8.6730.2"),
	// 				VersionStatus: to.Ptr("UpToDate"),
	// 			},
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { DataFactoryManagementClient } = require("@azure/arm-datafactory");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets detailed status information for an integration runtime.
 *
 * @summary Gets detailed status information for an integration runtime.
 * x-ms-original-file: specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/examples/IntegrationRuntimes_GetStatus.json
 */
async function integrationRuntimesGetStatus() {
  const subscriptionId =
    process.env["DATAFACTORY_SUBSCRIPTION_ID"] || "12345678-1234-1234-1234-12345678abc";
  const resourceGroupName = process.env["DATAFACTORY_RESOURCE_GROUP"] || "exampleResourceGroup";
  const factoryName = "exampleFactoryName";
  const integrationRuntimeName = "exampleIntegrationRuntime";
  const credential = new DefaultAzureCredential();
  const client = new DataFactoryManagementClient(credential, subscriptionId);
  const result = await client.integrationRuntimes.getStatus(
    resourceGroupName,
    factoryName,
    integrationRuntimeName,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DataFactory.Models;
using Azure.ResourceManager.DataFactory;

// Generated from example definition: specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/examples/IntegrationRuntimes_GetStatus.json
// this example is just showing the usage of "IntegrationRuntimes_GetStatus" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataFactoryIntegrationRuntimeResource created on azure
// for more information of creating DataFactoryIntegrationRuntimeResource, please refer to the document of DataFactoryIntegrationRuntimeResource
string subscriptionId = "12345678-1234-1234-1234-12345678abc";
string resourceGroupName = "exampleResourceGroup";
string factoryName = "exampleFactoryName";
string integrationRuntimeName = "exampleIntegrationRuntime";
ResourceIdentifier dataFactoryIntegrationRuntimeResourceId = DataFactoryIntegrationRuntimeResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, factoryName, integrationRuntimeName);
DataFactoryIntegrationRuntimeResource dataFactoryIntegrationRuntime = client.GetDataFactoryIntegrationRuntimeResource(dataFactoryIntegrationRuntimeResourceId);

// invoke the operation
DataFactoryIntegrationRuntimeStatusResult result = await dataFactoryIntegrationRuntime.GetStatusAsync();

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta de exemplo

Código de status:

200

Date: Thu, 14 Jun 2018 14:53:22 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 14997
x-ms-request-id: 19efe790-074f-4241-ae94-0422935d0f46
x-ms-correlation-request-id: 19efe790-074f-4241-ae94-0422935d0f46

{
  "name": "exampleIntegrationRuntime",
  "properties": {
    "state": "Online",
    "type": "SelfHosted",
    "typeProperties": {
      "autoUpdate": "Off",
      "taskQueueId": "1a6296ab-423c-4346-9bcc-85a78c2c0582",
      "version": "3.8.6730.2",
      "nodes": [
        {
          "nodeName": "Node_1",
          "machineName": "YANZHANG-DT",
          "hostServiceUri": "https://yanzhang-dt.fareast.corp.microsoft.com:8050/HostServiceRemote.svc/",
          "status": "Online",
          "capabilities": {
            "serviceBusConnected": "True",
            "httpsPortEnabled": "True",
            "credentialInSync": "True",
            "connectedToResourceManager": "True",
            "nodeEnabled": "True"
          },
          "versionStatus": "UpToDate",
          "version": "3.8.6730.2",
          "registerTime": "2018-06-14T14:51:44.9237069Z",
          "lastConnectTime": "2018-06-14T14:52:59.8933313Z",
          "lastStartTime": "2018-06-14T14:52:59.8933313Z",
          "lastUpdateResult": "None",
          "isActiveDispatcher": true,
          "maxConcurrentJobs": 56
        }
      ],
      "updateDelayOffset": "PT3H",
      "localTimeZoneOffset": "PT8H",
      "serviceUrls": [
        "wu.frontend.int.clouddatahub-int.net",
        "*.servicebus.windows.net"
      ],
      "versionStatus": "UpToDate",
      "capabilities": {
        "serviceBusConnected": "True",
        "httpsPortEnabled": "True",
        "credentialInSync": "True",
        "connectedToResourceManager": "True",
        "nodeEnabled": "True"
      },
      "latestVersion": "3.7.6711.1",
      "createTime": "2018-06-14T09:17:45.1839685Z"
    }
  }
}

Definições

Nome	Description
CloudError	O objeto que define a estrutura de uma resposta de erro Azure Data Factory.
IntegrationRuntimeAutoUpdate	O estado da atualização automática do integration runtime.
IntegrationRuntimeInternalChannelEncryptionMode	Ele é usado para definir o modo de criptografia para o canal de comunicação node-node (quando existem mais de 2 nós de runtime de integração auto-hospedada).
IntegrationRuntimeState	O estado do runtime de integração.
IntegrationRuntimeStatusResponse	Resposta de status de runtime de integração.
IntegrationRuntimeType	O tipo de runtime de integração.
IntegrationRuntimeUpdateResult	O resultado da última atualização do nó de runtime de integração.
LinkedIntegrationRuntime	As informações do runtime de integração vinculada.
ManagedIntegrationRuntimeError	Definição de erro para runtime de integração gerenciada.
ManagedIntegrationRuntimeNode	Propriedades do nó de runtime de integração.
ManagedIntegrationRuntimeNodeStatus	O nó de runtime de integração gerenciada status.
ManagedIntegrationRuntimeOperationResult	Propriedades do resultado da operação de runtime de integração gerenciada.
ManagedIntegrationRuntimeStatus	Status de runtime de integração gerenciada.
SelfHostedIntegrationRuntimeNode	Propriedades do nó de runtime de integração auto-hospedada.
SelfHostedIntegrationRuntimeNodeStatus	Status do nó de runtime de integração.
SelfHostedIntegrationRuntimeStatus	Status de runtime de integração auto-hospedada.

CloudError

O objeto que define a estrutura de uma resposta de erro Azure Data Factory.

Nome	Tipo	Description
error.code	string	Código do erro.
error.details	CloudError[]	Matriz com detalhes de erro adicionais.
error.message	string	Mensagem de erro.
error.target	string	Nome/caminho da propriedade na solicitação associada ao erro.

IntegrationRuntimeAutoUpdate

O estado da atualização automática do integration runtime.

Nome	Tipo	Description
Off	string
On	string

IntegrationRuntimeInternalChannelEncryptionMode

Ele é usado para definir o modo de criptografia para o canal de comunicação node-node (quando existem mais de 2 nós de runtime de integração auto-hospedada).

Nome	Tipo	Description
NotEncrypted	string
NotSet	string
SslEncrypted	string

IntegrationRuntimeState

O estado do runtime de integração.

Nome	Tipo	Description
AccessDenied	string
Initial	string
Limited	string
NeedRegistration	string
Offline	string
Online	string
Started	string
Starting	string
Stopped	string
Stopping	string

IntegrationRuntimeStatusResponse

Resposta de status de runtime de integração.

Nome	Tipo	Description
name	string	O nome do runtime de integração.
properties	IntegrationRuntimeStatus: ManagedIntegrationRuntimeStatus SelfHostedIntegrationRuntimeStatus	Propriedades do runtime de integração.

IntegrationRuntimeType

O tipo de runtime de integração.

Nome	Tipo	Description
Managed	string
SelfHosted	string

IntegrationRuntimeUpdateResult

O resultado da última atualização do nó de runtime de integração.

Nome	Tipo	Description
Fail	string
None	string
Succeed	string

LinkedIntegrationRuntime

As informações do runtime de integração vinculada.

Nome	Tipo	Description
createTime	string	O tempo de criação do runtime de integração vinculado.
dataFactoryLocation	string	O local do data factory ao qual o runtime de integração vinculado pertence.
dataFactoryName	string	O nome do data factory ao qual o runtime de integração vinculado pertence.
name	string	O nome do runtime de integração vinculado.
subscriptionId	string	A ID da assinatura à qual o runtime de integração vinculado pertence.

ManagedIntegrationRuntimeError

Definição de erro para runtime de integração gerenciada.

Nome	Tipo	Description
code	string	Código do erro.
message	string	Mensagem de erro.
parameters	string[]	Parâmetros de erro do runtime de integração gerenciada.
time	string	A hora em que o erro ocorreu.

ManagedIntegrationRuntimeNode

Propriedades do nó de runtime de integração.

Nome	Tipo	Description
errors	ManagedIntegrationRuntimeError[]	Os erros que ocorreram nesse nó de runtime de integração.
nodeId	string	A ID do nó do runtime de integração gerenciada.
status	ManagedIntegrationRuntimeNodeStatus	O nó de runtime de integração gerenciada status.

ManagedIntegrationRuntimeNodeStatus

O nó de runtime de integração gerenciada status.

Nome	Tipo	Description
Available	string
Recycling	string
Starting	string
Unavailable	string

ManagedIntegrationRuntimeOperationResult

Propriedades do resultado da operação de runtime de integração gerenciada.

Nome	Tipo	Description
activityId	string	A ID de atividade da solicitação de operação.
errorCode	string	O código de erro.
parameters	string[]	Parâmetros de erro do runtime de integração gerenciada.
result	string	O resultado da operação.
startTime	string	A hora de início da operação.
type	string	O tipo de operação. Pode ser iniciar ou parar.

ManagedIntegrationRuntimeStatus

Status de runtime de integração gerenciada.

Nome	Tipo	Description
dataFactoryName	string	O nome do data factory ao qual o runtime de integração pertence.
state	IntegrationRuntimeState	O estado do runtime de integração.
type	string: Managed	Tipo de runtime de integração.
typeProperties.createTime	string	O momento em que o runtime de integração foi criado, no formato ISO8601.
typeProperties.lastOperation	ManagedIntegrationRuntimeOperationResult	O último resultado da operação que ocorreu neste runtime de integração.
typeProperties.nodes	ManagedIntegrationRuntimeNode[]	A lista de nós para o runtime de integração gerenciada.
typeProperties.otherErrors	ManagedIntegrationRuntimeError[]	Os erros que ocorreram nesse runtime de integração.

SelfHostedIntegrationRuntimeNode

Propriedades do nó de runtime de integração auto-hospedada.

Nome	Tipo	Description
capabilities	object	O dicionário de funcionalidades de runtime de integração
concurrentJobsLimit	integer	Máximo de trabalhos simultâneos no nó de runtime de integração.
expiryTime	string	O tempo em que o runtime de integração expirará no formato ISO8601.
hostServiceUri	string	URI para o computador host do runtime de integração.
isActiveDispatcher	boolean	Indica se esse nó é o dispatcher ativo para solicitações de runtime de integração.
lastConnectTime	string	O momento mais recente em que o runtime de integração foi conectado no formato ISO8601.
lastEndUpdateTime	string	A última vez para o fim da atualização do nó de runtime de integração.
lastStartTime	string	A hora em que o nó foi iniciado pela última vez.
lastStartUpdateTime	string	A última vez para o início da atualização do nó de runtime de integração.
lastStopTime	string	A hora da última parada do nó de runtime de integração.
lastUpdateResult	IntegrationRuntimeUpdateResult	O resultado da última atualização do nó de runtime de integração.
machineName	string	Nome do computador do nó de runtime de integração.
maxConcurrentJobs	integer	Os trabalhos simultâneos máximos neste runtime de integração.
nodeName	string	Nome do nó de runtime de integração.
registerTime	string	A hora em que o nó de runtime de integração foi registrado no formato ISO8601.
status	SelfHostedIntegrationRuntimeNodeStatus	Status do nó de runtime de integração.
version	string	Versão do nó de runtime de integração.
versionStatus	string	Status da versão do nó de runtime de integração.

SelfHostedIntegrationRuntimeNodeStatus

Status do nó de runtime de integração.

Nome	Tipo	Description
InitializeFailed	string
Initializing	string
Limited	string
NeedRegistration	string
Offline	string
Online	string
Upgrading	string

SelfHostedIntegrationRuntimeStatus

Status de runtime de integração auto-hospedada.

Nome	Tipo	Description
dataFactoryName	string	O nome do data factory ao qual o runtime de integração pertence.
state	IntegrationRuntimeState	O estado do runtime de integração.
type	string: SelfHosted	Tipo de runtime de integração.
typeProperties.autoUpdate	IntegrationRuntimeAutoUpdate	Se a atualização automática do runtime de integração auto-hospedada foi ativada.
typeProperties.autoUpdateETA	string	O tempo estimado em que o runtime de integração auto-hospedada será atualizado.
typeProperties.capabilities	object	Objeto com informações adicionais sobre recursos de runtime de integração.
typeProperties.createTime	string	O momento em que o runtime de integração foi criado, no formato ISO8601.
typeProperties.internalChannelEncryption	IntegrationRuntimeInternalChannelEncryptionMode	Ele é usado para definir o modo de criptografia para o canal de comunicação node-node (quando existem mais de 2 nós de runtime de integração auto-hospedada).
typeProperties.latestVersion	string	A versão mais recente no centro de download.
typeProperties.links	LinkedIntegrationRuntime[]	A lista de runtimes de integração vinculados que são criados para compartilhar com esse runtime de integração.
typeProperties.localTimeZoneOffset	string	O deslocamento de fuso horário local em horas.
typeProperties.nodes	SelfHostedIntegrationRuntimeNode[]	A lista de nós para esse runtime de integração.
typeProperties.pushedVersion	string	A versão para a qual o runtime de integração será atualizado.
typeProperties.scheduledUpdateDate	string	A data em que o runtime de integração será agendado para ser atualizado, no formato ISO8601.
typeProperties.selfContainedInteractiveAuthoringEnabled	boolean	Uma opção alternativa para garantir a função de criação interativa quando o runtime de integração auto-hospedada não conseguir estabelecer uma conexão com a Retransmissão do Azure.
typeProperties.serviceUrls	string[]	As URLs dos serviços usados no serviço de back-end do runtime de integração.
typeProperties.taskQueueId	string	A ID da fila de tarefas do runtime de integração.
typeProperties.updateDelayOffset	string	A hora na data agendada pelo serviço para atualizar o runtime de integração, por exemplo, PT03H é de 3 horas
typeProperties.version	string	Versão do runtime de integração.
typeProperties.versionStatus	string	Status da versão do runtime de integração.