Partilhar via


Integration Runtimes - Create Linked Integration Runtime

Crie uma entrada de tempo de execução de integração vinculada em um tempo de execução de integração compartilhada.

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

Parâmetros do URI

Name Em Necessário Tipo Description
factoryName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

O nome da fábrica.

integrationRuntimeName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

O nome do tempo de execução da integração.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

O nome do grupo de recursos.

subscriptionId
path True

string

O identificador de assinatura.

api-version
query True

string

A versão da API.

Corpo do Pedido

Name Tipo Description
dataFactoryLocation

string

O local da fábrica de dados à qual pertence o tempo de execução de integração vinculado.

dataFactoryName

string

O nome da fábrica de dados à qual pertence o tempo de execução de integração vinculado.

name

string

O nome do tempo de execução de integração vinculado.

subscriptionId

string

A ID da assinatura à qual pertence o tempo de execução de integração vinculado.

Respostas

Name 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 Ative Directory.

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

IntegrationRuntimes_CreateLinkedIntegrationRuntime

Pedido de amostra

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

{
  "name": "bfa92911-9fb6-4fbe-8f23-beae87bc1c83",
  "subscriptionId": "061774c7-4b5a-4159-a55b-365581830283",
  "dataFactoryName": "e9955d6d-56ea-4be3-841c-52a12c1a9981",
  "dataFactoryLocation": "West US"
}

Resposta da amostra

Date: Fri, 17 Aug 2018 06:31:03 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-request-id: f9a67067-62f3-43ce-b891-2ccb3de4a15f
x-ms-correlation-request-id: f9a67067-62f3-43ce-b891-2ccb3de4a15f
{
  "name": "exampleIntegrationRuntime",
  "properties": {
    "dataFactoryName": "exampleFactoryName",
    "state": "Online",
    "type": "SelfHosted",
    "typeProperties": {
      "autoUpdate": "On",
      "taskQueueId": "823da112-f2d9-426b-a0d8-5f361b94f72a",
      "version": "3.8.6743.6",
      "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.6743.6",
          "registerTime": "2018-08-17T03:44:55.8012825Z",
          "lastConnectTime": "2018-08-17T06:30:46.6262976Z",
          "lastStartTime": "2018-08-17T03:45:30.8499851Z",
          "lastUpdateResult": "None",
          "isActiveDispatcher": true,
          "maxConcurrentJobs": 20
        }
      ],
      "scheduledUpdateDate": "2018-08-20T00:00:00Z",
      "updateDelayOffset": "PT19H",
      "localTimeZoneOffset": "PT8H",
      "serviceUrls": [
        "wu.frontend.int.clouddatahub-int.net",
        "*.servicebus.windows.net"
      ],
      "links": [
        {
          "name": "bfa92911-9fb6-4fbe-8f23-beae87bc1c83",
          "subscriptionId": "061774c7-4b5a-4159-a55b-365581830283",
          "dataFactoryName": "e9955d6d-56ea-4be3-841c-52a12c1a9981",
          "dataFactoryLocation": "West US",
          "createTime": "2018-08-17T06:31:04.0617928Z"
        }
      ],
      "versionStatus": "UpdateAvailable",
      "capabilities": {
        "serviceBusConnected": "True",
        "httpsPortEnabled": "True",
        "credentialInSync": "True",
        "connectedToResourceManager": "True",
        "nodeEnabled": "True"
      },
      "pushedVersion": "3.9.6774.1",
      "latestVersion": "3.9.6774.1",
      "autoUpdateETA": "2018-08-20T19:00:00Z",
      "createTime": "2018-08-17T03:43:25.7055573Z"
    }
  }
}

Definições

Name Description
CloudError

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

CreateLinkedIntegrationRuntimeRequest

As informações de tempo de execução de integração vinculadas.

IntegrationRuntimeAutoUpdate

O estado de atualização automática do tempo de execução da integração.

IntegrationRuntimeInternalChannelEncryptionMode

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

IntegrationRuntimeState

O estado do tempo de execução da integração.

IntegrationRuntimeStatusResponse

Resposta de status do tempo de execução da integração.

IntegrationRuntimeType

O tipo de tempo de execução da integração.

IntegrationRuntimeUpdateResult

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

LinkedIntegrationRuntime

As informações de tempo de execução de integração vinculadas.

ManagedIntegrationRuntimeError

Definição de erro para tempo de execução de integração gerenciada.

ManagedIntegrationRuntimeNode

Propriedades do nó de tempo de execução de integração.

ManagedIntegrationRuntimeNodeStatus

O status do nó de tempo de execução de integração gerenciada.

ManagedIntegrationRuntimeOperationResult

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

ManagedIntegrationRuntimeStatus

Status do tempo de execução da integração gerenciada.

SelfHostedIntegrationRuntimeNode

Propriedades do nó de tempo de execução de integração auto-hospedado.

SelfHostedIntegrationRuntimeNodeStatus

Status do nó de tempo de execução de integração.

SelfHostedIntegrationRuntimeStatus

Status do tempo de execução da integração auto-hospedada.

CloudError

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

Name Tipo Description
error.code

string

Código de 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.

CreateLinkedIntegrationRuntimeRequest

As informações de tempo de execução de integração vinculadas.

Name Tipo Description
dataFactoryLocation

string

O local da fábrica de dados à qual pertence o tempo de execução de integração vinculado.

dataFactoryName

string

O nome da fábrica de dados à qual pertence o tempo de execução de integração vinculado.

name

string

O nome do tempo de execução de integração vinculado.

subscriptionId

string

A ID da assinatura à qual pertence o tempo de execução de integração vinculado.

IntegrationRuntimeAutoUpdate

O estado de atualização automática do tempo de execução da integração.

Valor Description
Off
On

IntegrationRuntimeInternalChannelEncryptionMode

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

Valor Description
NotEncrypted
NotSet
SslEncrypted

IntegrationRuntimeState

O estado do tempo de execução da integração.

Valor Description
AccessDenied
Initial
Limited
NeedRegistration
Offline
Online
Started
Starting
Stopped
Stopping

IntegrationRuntimeStatusResponse

Resposta de status do tempo de execução da integração.

Name Tipo Description
name

string

O nome do tempo de execução da integração.

properties IntegrationRuntimeStatus:

Propriedades de tempo de execução de integração.

IntegrationRuntimeType

O tipo de tempo de execução da integração.

Valor Description
Managed
SelfHosted

IntegrationRuntimeUpdateResult

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

Valor Description
Fail
None
Succeed

LinkedIntegrationRuntime

As informações de tempo de execução de integração vinculadas.

Name Tipo Description
createTime

string (date-time)

O tempo de criação do tempo de execução da integração vinculada.

dataFactoryLocation

string

O local do data factory ao qual pertence o tempo de execução de integração vinculado.

dataFactoryName

string

O nome da fábrica de dados à qual pertence o tempo de execução de integração vinculado.

name

string

O nome do tempo de execução de integração vinculado.

subscriptionId

string

O ID da assinatura ao qual o tempo de execução de integração vinculado pertence.

ManagedIntegrationRuntimeError

Definição de erro para tempo de execução de integração gerenciada.

Name Tipo Description
code

string

Código de erro.

message

string

Mensagem de erro.

parameters

string[]

Parâmetros de erro de tempo de execução de integração gerenciada.

time

string (date-time)

A hora em que o erro ocorreu.

ManagedIntegrationRuntimeNode

Propriedades do nó de tempo de execução de integração.

Name Tipo Description
errors

ManagedIntegrationRuntimeError[]

Os erros que ocorreram neste nó de tempo de execução de integração.

nodeId

string

A ID do nó de tempo de execução de integração gerenciada.

status

ManagedIntegrationRuntimeNodeStatus

O status do nó de tempo de execução de integração gerenciada.

ManagedIntegrationRuntimeNodeStatus

O status do nó de tempo de execução de integração gerenciada.

Valor Description
Available
Recycling
Starting
Unavailable

ManagedIntegrationRuntimeOperationResult

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

Name Tipo Description
activityId

string

O ID de atividade para a solicitação de operação.

errorCode

string

O código de erro.

parameters

string[]

Parâmetros de erro de tempo de execução de integração gerenciada.

result

string

O resultado da operação.

startTime

string (date-time)

A hora de início da operação.

type

string

O tipo de operação. Pode ser iniciar ou parar.

ManagedIntegrationRuntimeStatus

Status do tempo de execução da integração gerenciada.

Name Tipo Description
dataFactoryName

string

O nome da fábrica de dados ao qual o tempo de execução de integração pertence.

state

IntegrationRuntimeState

O estado do tempo de execução da integração.

type string:

Managed

Tipo de tempo de execução de integração.

typeProperties.createTime

string (date-time)

O momento em que o tempo de execução de integração foi criado, em ISO8601 formato.

typeProperties.lastOperation

ManagedIntegrationRuntimeOperationResult

O último resultado da operação que ocorreu neste tempo de execução de integração.

typeProperties.nodes

ManagedIntegrationRuntimeNode[]

A lista de nós para o tempo de execução da integração gerenciada.

typeProperties.otherErrors

ManagedIntegrationRuntimeError[]

Os erros que ocorreram neste tempo de execução de integração.

SelfHostedIntegrationRuntimeNode

Propriedades do nó de tempo de execução de integração auto-hospedado.

Name Tipo Description
capabilities

object

O dicionário de recursos de tempo de execução de integração

concurrentJobsLimit

integer

Máximo de trabalhos simultâneos no nó do tempo de execução da integração.

expiryTime

string (date-time)

O momento em que o tempo de execução de integração expirará em ISO8601 formato.

hostServiceUri

string

URI para a máquina host do tempo de execução de integração.

isActiveDispatcher

boolean

Indica se esse nó é o dispatcher ativo para solicitações de tempo de execução de integração.

lastConnectTime

string (date-time)

O momento mais recente em que o tempo de execução de integração foi conectado em ISO8601 formato.

lastEndUpdateTime

string (date-time)

A última vez para o fim da atualização do nó de tempo de execução de integração.

lastStartTime

string (date-time)

A hora em que o nó foi iniciado pela última vez.

lastStartUpdateTime

string (date-time)

A última vez para o início da atualização do nó de tempo de execução de integração.

lastStopTime

string (date-time)

O último tempo de parada do nó de tempo de execução de integração.

lastUpdateResult

IntegrationRuntimeUpdateResult

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

machineName

string

Nome da máquina do nó de tempo de execução de integração.

maxConcurrentJobs

integer

O máximo de trabalhos simultâneos neste tempo de execução de integração.

nodeName

string

Nome do nó do tempo de execução da integração.

registerTime

string (date-time)

O momento em que o nó de tempo de execução de integração foi registrado em ISO8601 formato.

status

SelfHostedIntegrationRuntimeNodeStatus

Status do nó de tempo de execução de integração.

version

string

Versão do nó de tempo de execução de integração.

versionStatus

string

Status da versão do nó de tempo de execução de integração.

SelfHostedIntegrationRuntimeNodeStatus

Status do nó de tempo de execução de integração.

Valor Description
InitializeFailed
Initializing
Limited
NeedRegistration
Offline
Online
Upgrading

SelfHostedIntegrationRuntimeStatus

Status do tempo de execução da integração auto-hospedada.

Name Tipo Description
dataFactoryName

string

O nome da fábrica de dados ao qual o tempo de execução de integração pertence.

state

IntegrationRuntimeState

O estado do tempo de execução da integração.

type string:

SelfHosted

Tipo de tempo de execução de integração.

typeProperties.autoUpdate

IntegrationRuntimeAutoUpdate

Se a atualização automática do tempo de execução da integração auto-hospedada foi ativada.

typeProperties.autoUpdateETA

string (date-time)

O tempo estimado em que o tempo de execução de integração auto-hospedado será atualizado.

typeProperties.capabilities

object

Objeto com informações adicionais sobre recursos de tempo de execução de integração.

typeProperties.createTime

string (date-time)

O momento em que o tempo de execução de integração foi criado, em ISO8601 formato.

typeProperties.internalChannelEncryption

IntegrationRuntimeInternalChannelEncryptionMode

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

typeProperties.latestVersion

string

A última versão no centro de download.

typeProperties.links

LinkedIntegrationRuntime[]

A lista de tempos de execução de integração vinculados que são criados para compartilhar com esse tempo de execução 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 tempo de execução de integração.

typeProperties.pushedVersion

string

A versão para a qual o tempo de execução de integração será atualizado.

typeProperties.scheduledUpdateDate

string (date-time)

A data em que o tempo de execução de integração será agendado para atualização, em formato ISO8601.

typeProperties.selfContainedInteractiveAuthoringEnabled

boolean

Uma opção alternativa para garantir a função de criação interativa quando o tempo de execução de integração auto-hospedado não consegue estabelecer uma conexão com o Azure Relay.

typeProperties.serviceUrls

string[]

As URLs para os serviços usados no serviço de back-end de tempo de execução de integração.

typeProperties.taskQueueId

string

A ID da fila de tarefas do tempo de execução da integração.

typeProperties.updateDelayOffset

string

O tempo na data agendada pelo serviço para atualizar o tempo de execução da integração, por exemplo, PT03H é de 3 horas

typeProperties.version

string

Versão do tempo de execução da integração.

typeProperties.versionStatus

string

Status da versão do tempo de execução da integração.