Integration Runtimes - Start

Serviço:: Synapse

Versão da API:: 2021-06-01

Iniciar o runtime de integração
Iniciar um runtime de integração

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/start?api-version=2021-06-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
integrationRuntimeName	path	True	string	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 minLength: 1	A ID da assinatura de destino.
workspaceName	path	True	string	O nome do workspace.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	IntegrationRuntimeStatusResponse	OKEY.
202 Accepted		Aceitado.
Other Status Codes	ErrorResponse	Uma resposta de erro recebida do serviço do Azure Synapse.

Exemplos

Start integration runtime

Solicitação de exemplo

HTTP

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspace/integrationRuntimes/exampleManagedIntegrationRuntime/start?api-version=2021-06-01

Resposta de exemplo

Código de status:: 200

Date: Wed, 13 Jun 2018 21:33:00 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 14912
x-ms-request-id: 2af47f9f-5625-4b01-a3a5-bccb576a4677
x-ms-correlation-request-id: 2af47f9f-5625-4b01-a3a5-bccb576a4677

{
  "name": "exampleManagedIntegrationRuntime",
  "properties": {
    "dataFactoryName": "exampleWorkspaceName",
    "type": "Managed",
    "state": "Started",
    "typeProperties": {
      "nodes": [],
      "otherErrors": [],
      "createTime": "2018-06-13T21:11:01.8695494Z"
    }
  }
}

Código de status:: 202

Definições

Nome	Description
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
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.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

IntegrationRuntimeAutoUpdate

Enumeração

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

Valor	Description
On
Off

IntegrationRuntimeInternalChannelEncryptionMode

Enumeração

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
SslEncrypted
NotEncrypted

IntegrationRuntimeState

Enumeração

O estado do runtime de integração.

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

IntegrationRuntimeStatusResponse

Objeto

Resposta de status do 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

Enumeração

O tipo de runtime de integração.

Valor	Description
Managed
SelfHosted

IntegrationRuntimeUpdateResult

Enumeração

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

Valor	Description
None
Succeed
Fail

LinkedIntegrationRuntime

Objeto

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 workspace ao qual o runtime de integração vinculada pertence.
dataFactoryName	string	O nome do workspace 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

Objeto

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

Objeto

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

Enumeração

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

Valor	Description
Starting
Available
Recycling
Unavailable

ManagedIntegrationRuntimeOperationResult

Objeto

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

Objeto

Status do runtime de integração gerenciada.

Nome	Tipo	Description
dataFactoryName	string	O nome do workspace 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

Objeto

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

Enumeração

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

Valor	Description
NeedRegistration
Online
Limited
Offline
Upgrading
Initializing
InitializeFailed

SelfHostedIntegrationRuntimeStatus

Objeto

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

Nome	Tipo	Description
dataFactoryName	string	O nome do workspace 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.nodeCommunicationChannelEncryptionMode	string	O modo de criptografia do canal de comunicação do nó
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.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.

Compartilhar via

Integration Runtimes - Start

Parâmetros de URI

Respostas

Exemplos

Start integration runtime

Solicitação de exemplo

Resposta de exemplo

Definições

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IntegrationRuntimeAutoUpdate

IntegrationRuntimeInternalChannelEncryptionMode

IntegrationRuntimeState

IntegrationRuntimeStatusResponse

IntegrationRuntimeType

IntegrationRuntimeUpdateResult

LinkedIntegrationRuntime

ManagedIntegrationRuntimeError

ManagedIntegrationRuntimeNode

ManagedIntegrationRuntimeNodeStatus

ManagedIntegrationRuntimeOperationResult

ManagedIntegrationRuntimeStatus

SelfHostedIntegrationRuntimeNode

SelfHostedIntegrationRuntimeNodeStatus

SelfHostedIntegrationRuntimeStatus