Compartilhar via


Integration Runtimes - Create Linked Integration Runtime

Crie uma entrada de runtime de integração vinculada em um runtime 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 de URI

Nome Em Obrigató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 runtime de integração.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
dataFactoryLocation

string

O local do data factory ao qual o runtime de integração vinculada pertence.

dataFactoryName

string

O nome do data factory ao qual o runtime de integração vinculada pertence.

name

string

O nome do runtime de integração vinculado.

subscriptionId

string

A ID da assinatura à qual o runtime de integração vinculada pertence.

Respostas

Nome Tipo Description
200 OK

IntegrationRuntimeStatusResponse

Operação do Azure concluída com sucesso.

Other Status Codes

CloudError

Uma resposta de erro inesperada.

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_CreateLinkedIntegrationRuntime

Solicitação de exemplo

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

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

Resposta de exemplo

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

Definições

Nome Description
CloudError

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

CreateLinkedIntegrationRuntimeRequest

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

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 nó-nó (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 do 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 status do nó do runtime de integração gerenciada.

ManagedIntegrationRuntimeOperationResult

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

ManagedIntegrationRuntimeStatus

Status do 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 do runtime de integração auto-hospedada.

CloudError

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

Nome 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 do runtime de integração vinculada.

Nome Tipo Description
dataFactoryLocation

string

O local do data factory ao qual o runtime de integração vinculada pertence.

dataFactoryName

string

O nome do data factory ao qual o runtime de integração vinculada pertence.

name

string

O nome do runtime de integração vinculado.

subscriptionId

string

A ID da assinatura à qual o runtime de integração vinculada pertence.

IntegrationRuntimeAutoUpdate

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

Valor Description
On

Ligado

Off

Desativado

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 runtime de integração auto-hospedada).

Valor Description
NotSet

Não definido

SslEncrypted

SSLEncrypted

NotEncrypted

NotEncrypted

IntegrationRuntimeState

O estado do runtime de integração.

Valor Description
Initial

Inicial

Stopped

Parado

Started

Iniciado

Starting

Iniciando

Stopping

Parar

NeedRegistration

NeedRegistration

Online

Online

Limited

Limitado

Offline

Offline

AccessDenied

AccessDenied

IntegrationRuntimeStatusResponse

Resposta de status do runtime de integração.

Nome Tipo Description
name

string

O nome do runtime de integração.

properties IntegrationRuntimeStatus:

Propriedades do runtime de integração.

IntegrationRuntimeType

O tipo de runtime de integração.

Valor Description
Managed

Gerenciado

SelfHosted

AutoHospedado

IntegrationRuntimeUpdateResult

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

Valor Description
None

Nenhum

Succeed

Êxito

Fail

Falha

LinkedIntegrationRuntime

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

Nome Tipo Description
createTime

string (date-time)

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 vinculada pertence.

dataFactoryName

string

O nome do data factory ao qual o runtime de integração vinculada pertence.

name

string

O nome do runtime de integração vinculado.

subscriptionId

string

A ID da assinatura à qual o runtime de integração vinculada pertence.

ManagedIntegrationRuntimeError

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

Nome Tipo Description
code

string

Código de erro.

message

string

Mensagem de erro.

parameters

string[]

Parâmetros de erro de runtime de integração gerenciada.

time

string (date-time)

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 status do nó do runtime de integração gerenciada.

ManagedIntegrationRuntimeNodeStatus

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

Valor Description
Starting

Iniciando

Available

Disponível

Recycling

Reciclagem

Unavailable

Indisponível

ManagedIntegrationRuntimeOperationResult

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

Nome Tipo Description
activityId

string

A ID da atividade para a solicitação de operação.

errorCode

string

O código de erro.

parameters

string[]

Parâmetros de erro de runtime 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 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 (date-time)

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 (int32)

Máximo de trabalhos simultâneos no nó de runtime de integração.

expiryTime

string (date-time)

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 (date-time)

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

lastEndUpdateTime

string (date-time)

A última vez para o final da atualização do nó do runtime 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ó do runtime de integração.

lastStopTime

string (date-time)

A hora da última parada do nó do 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 (int32)

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

nodeName

string

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

registerTime

string (date-time)

O momento 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.

Valor Description
NeedRegistration

NeedRegistration

Online

Online

Limited

Limitado

Offline

Offline

Upgrading

Atualizando

Initializing

Inicializar

InitializeFailed

InicializeFailed

SelfHostedIntegrationRuntimeStatus

Status do 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 (date-time)

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 (date-time)

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 nó-nó (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 (date-time)

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 integration runtime.