Integration Runtimes - Start

Riferimento

Servizio:: Synapse

Versione API:: 2021-06-01

Avviare il runtime di integrazione
Avviare un runtime di integrazione

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
integrationRuntimeName	path	True	string	Nome del runtime di integrazione
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
workspaceName	path	True	string	Nome dell'area di lavoro.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	IntegrationRuntimeStatusResponse	OK.
202 Accepted		Accettato.
Other Status Codes	ErrorResponse	Risposta di errore ricevuta dal servizio Azure Synapse.

Esempio

Start integration runtime

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
    }
  }
}

Codice di stato:: 202

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
IntegrationRuntimeAutoUpdate	Stato dell'aggiornamento automatico del runtime di integrazione.
IntegrationRuntimeInternalChannelEncryptionMode	Viene usato per impostare la modalità di crittografia per il canale di comunicazione node-node (quando esistono più di 2 nodi di runtime di integrazione self-hosted).
IntegrationRuntimeState	Stato del runtime di integrazione.
IntegrationRuntimeStatusResponse	Risposta dello stato del runtime di integrazione.
IntegrationRuntimeType	Tipo di runtime di integrazione.
IntegrationRuntimeUpdateResult	Risultato dell'ultimo aggiornamento del nodo del runtime di integrazione.
LinkedIntegrationRuntime	Informazioni sul runtime di integrazione collegato.
ManagedIntegrationRuntimeError	Definizione di errore per il runtime di integrazione gestita.
ManagedIntegrationRuntimeNode	Proprietà del nodo del runtime di integrazione.
ManagedIntegrationRuntimeNodeStatus	Stato del nodo del runtime di integrazione gestita.
ManagedIntegrationRuntimeOperationResult	Proprietà del risultato dell'operazione del runtime di integrazione gestita.
ManagedIntegrationRuntimeStatus	Stato del runtime di integrazione gestita.
SelfHostedIntegrationRuntimeNode	Proprietà del nodo del runtime di integrazione self-hosted.
SelfHostedIntegrationRuntimeNodeStatus	Stato del nodo del runtime di integrazione.
SelfHostedIntegrationRuntimeStatus	Stato del runtime di integrazione self-hosted.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

IntegrationRuntimeAutoUpdate

Stato dell'aggiornamento automatico del runtime di integrazione.

Nome	Tipo	Descrizione
Off	string
On	string

IntegrationRuntimeInternalChannelEncryptionMode

Viene usato per impostare la modalità di crittografia per il canale di comunicazione node-node (quando esistono più di 2 nodi di runtime di integrazione self-hosted).

Nome	Tipo	Descrizione
NotEncrypted	string
NotSet	string
SslEncrypted	string

IntegrationRuntimeState

Stato del runtime di integrazione.

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

IntegrationRuntimeStatusResponse

Risposta dello stato del runtime di integrazione.

Nome	Tipo	Descrizione
name	string	Nome del runtime di integrazione.
properties	IntegrationRuntimeStatus: ManagedIntegrationRuntimeStatus SelfHostedIntegrationRuntimeStatus	Proprietà del runtime di integrazione.

IntegrationRuntimeType

Tipo di runtime di integrazione.

Nome	Tipo	Descrizione
Managed	string
SelfHosted	string

IntegrationRuntimeUpdateResult

Risultato dell'ultimo aggiornamento del nodo del runtime di integrazione.

Nome	Tipo	Descrizione
Fail	string
None	string
Succeed	string

LinkedIntegrationRuntime

Informazioni sul runtime di integrazione collegato.

Nome	Tipo	Descrizione
createTime	string	Ora di creazione del runtime di integrazione collegato.
dataFactoryLocation	string	Posizione dell'area di lavoro a cui appartiene il runtime di integrazione collegato.
dataFactoryName	string	Nome dell'area di lavoro a cui appartiene il runtime di integrazione collegato.
name	string	Nome del runtime di integrazione collegato.
subscriptionId	string	ID sottoscrizione a cui appartiene il runtime di integrazione collegato.

ManagedIntegrationRuntimeError

Definizione di errore per il runtime di integrazione gestita.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
parameters	string[]	Parametri di errore del runtime di integrazione gestita.
time	string	Ora in cui si è verificato l'errore.

ManagedIntegrationRuntimeNode

Proprietà del nodo del runtime di integrazione.

Nome	Tipo	Descrizione
errors	ManagedIntegrationRuntimeError[]	Errori che si sono verificati in questo nodo del runtime di integrazione.
nodeId	string	ID del nodo del runtime di integrazione gestito.
status	ManagedIntegrationRuntimeNodeStatus	Stato del nodo del runtime di integrazione gestita.

ManagedIntegrationRuntimeNodeStatus

Stato del nodo del runtime di integrazione gestita.

Nome	Tipo	Descrizione
Available	string
Recycling	string
Starting	string
Unavailable	string

ManagedIntegrationRuntimeOperationResult

Proprietà del risultato dell'operazione del runtime di integrazione gestita.

Nome	Tipo	Descrizione
activityId	string	ID attività per la richiesta di operazione.
errorCode	string	Codice di errore.
parameters	string[]	Parametri di errore del runtime di integrazione gestita.
result	string	Risultato dell'operazione.
startTime	string	Ora di inizio dell'operazione.
type	string	Tipo di operazione. Potrebbe essere avviato o arrestato.

ManagedIntegrationRuntimeStatus

Stato del runtime di integrazione gestita.

Nome	Tipo	Descrizione
dataFactoryName	string	Nome dell'area di lavoro a cui appartiene il runtime di integrazione.
state	IntegrationRuntimeState	Stato del runtime di integrazione.
type	string: Managed	Tipo di runtime di integrazione.
typeProperties.createTime	string	Ora in cui è stato creato il runtime di integrazione, in ISO8601 formato.
typeProperties.lastOperation	ManagedIntegrationRuntimeOperationResult	Ultimo risultato dell'operazione che si è verificato in questo runtime di integrazione.
typeProperties.nodes	ManagedIntegrationRuntimeNode[]	Elenco di nodi per il runtime di integrazione gestita.
typeProperties.otherErrors	ManagedIntegrationRuntimeError[]	Errori che si sono verificati in questo runtime di integrazione.

SelfHostedIntegrationRuntimeNode

Proprietà del nodo del runtime di integrazione self-hosted.

Nome	Tipo	Descrizione
capabilities	object	Dizionario delle funzionalità del runtime di integrazione
concurrentJobsLimit	integer	Numero massimo di processi simultanei nel nodo del runtime di integrazione.
expiryTime	string	Ora in cui il runtime di integrazione scadrà nel formato ISO8601.
hostServiceUri	string	URI per il computer host del runtime di integrazione.
isActiveDispatcher	boolean	Indica se questo nodo è il dispatcher attivo per le richieste del runtime di integrazione.
lastConnectTime	string	Ora più recente in cui il runtime di integrazione è stato connesso in formato ISO8601.
lastEndUpdateTime	string	Ora dell'ultima fine dell'aggiornamento del nodo del runtime di integrazione.
lastStartTime	string	Ora dell'ultima avvio del nodo.
lastStartUpdateTime	string	Ora dell'ultimo avvio dell'aggiornamento del nodo del runtime di integrazione.
lastStopTime	string	Ora dell'ultimo arresto del nodo del runtime di integrazione.
lastUpdateResult	IntegrationRuntimeUpdateResult	Risultato dell'ultimo aggiornamento del nodo del runtime di integrazione.
machineName	string	Nome del computer del nodo del runtime di integrazione.
maxConcurrentJobs	integer	Numero massimo di processi simultanei in questo runtime di integrazione.
nodeName	string	Nome del nodo del runtime di integrazione.
registerTime	string	Ora in cui il nodo del runtime di integrazione è stato registrato nel formato ISO8601.
status	SelfHostedIntegrationRuntimeNodeStatus	Stato del nodo del runtime di integrazione.
version	string	Versione del nodo del runtime di integrazione.
versionStatus	string	Stato della versione del nodo del runtime di integrazione.

SelfHostedIntegrationRuntimeNodeStatus

Stato del nodo del runtime di integrazione.

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

SelfHostedIntegrationRuntimeStatus

Stato del runtime di integrazione self-hosted.

Nome	Tipo	Descrizione
dataFactoryName	string	Nome dell'area di lavoro a cui appartiene il runtime di integrazione.
state	IntegrationRuntimeState	Stato del runtime di integrazione.
type	string: SelfHosted	Tipo di runtime di integrazione.
typeProperties.autoUpdate	IntegrationRuntimeAutoUpdate	Indica se l'aggiornamento automatico del runtime di integrazione self-hosted è stato attivato.
typeProperties.autoUpdateETA	string	Tempo stimato in cui verrà aggiornato il runtime di integrazione self-hosted.
typeProperties.capabilities	object	Oggetto con informazioni aggiuntive sulle funzionalità del runtime di integrazione.
typeProperties.createTime	string	Ora in cui è stato creato il runtime di integrazione, in ISO8601 formato.
typeProperties.internalChannelEncryption	IntegrationRuntimeInternalChannelEncryptionMode	Viene usato per impostare la modalità di crittografia per il canale di comunicazione node-node (quando esistono più di 2 nodi di runtime di integrazione self-hosted).
typeProperties.latestVersion	string	Versione più recente nell'Area download.
typeProperties.links	LinkedIntegrationRuntime[]	Elenco di runtime di integrazione collegati creati per la condivisione con questo runtime di integrazione.
typeProperties.localTimeZoneOffset	string	Differenza di fuso orario locale in ore.
typeProperties.nodeCommunicationChannelEncryptionMode	string	Modalità di crittografia del canale di comunicazione del nodo
typeProperties.nodes	SelfHostedIntegrationRuntimeNode[]	Elenco di nodi per questo runtime di integrazione.
typeProperties.pushedVersion	string	Versione in cui verrà aggiornato il runtime di integrazione.
typeProperties.scheduledUpdateDate	string	Data in cui il runtime di integrazione verrà pianificato per l'aggiornamento, nel formato ISO8601.
typeProperties.serviceUrls	string[]	URL per i servizi usati nel servizio back-end del runtime di integrazione.
typeProperties.taskQueueId	string	ID della coda di attività del runtime di integrazione.
typeProperties.updateDelayOffset	string	L'ora nella data pianificata dal servizio per aggiornare il runtime di integrazione, ad esempio PT03H è di 3 ore
typeProperties.version	string	Versione del runtime di integrazione.
typeProperties.versionStatus	string	Stato della versione del runtime di integrazione.

Condividi tramite