Compartilhar via


Integration Runtimes - Update

Atualizações um runtime de integração.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}?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.

Corpo da solicitação

Nome Tipo Description
autoUpdate

IntegrationRuntimeAutoUpdate

Habilita ou desabilita o recurso de atualização automática do runtime de integração auto-hospedada. Consulte https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

O deslocamento de tempo (em horas) no dia, por exemplo, PT03H é de 3 horas. A atualização automática do runtime de integração ocorrerá nesse horário.

Respostas

Nome Tipo Description
200 OK

IntegrationRuntimeResource

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_Update

Solicitação de exemplo

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

{
  "autoUpdate": "Off",
  "updateDelayOffset": "\"PT3H\""
}

Resposta de exemplo

Date: Wed, 13 Jun 2018 21:33:04 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1192
x-ms-request-id: eb1c35f8-4b37-4d08-b5dd-d6a0ad8b182d
x-ms-correlation-request-id: eb1c35f8-4b37-4d08-b5dd-d6a0ad8b182d
{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/integrationruntimes/exampleIntegrationRuntime",
  "name": "exampleIntegrationRuntime",
  "type": "Microsoft.DataFactory/factories/integrationruntimes",
  "properties": {
    "type": "SelfHosted",
    "description": "A selfhosted integration runtime"
  },
  "etag": "0400f1a1-0000-0000-0000-5b2188640000"
}

Definições

Nome Description
CloudError

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

CopyComputeScaleProperties

Propriedades CopyComputeScale para runtime de integração gerenciada.

CredentialReference

Tipo de referência de credencial.

CredentialReferenceType

Tipo de referência de credencial.

CustomProperties

As propriedades personalizadas são usadas para ajustar o desempenho do runtime do fluxo de dados.

DataFlowComputeType

Tipo de computação do cluster que executará o trabalho de fluxo de dados.

EntityReference

A referência de entidade.

IntegrationRuntimeAutoUpdate

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

IntegrationRuntimeComputeProperties

As propriedades do recurso de computação para o runtime de integração gerenciada.

IntegrationRuntimeCustomerVirtualNetwork

A definição e as propriedades da rede virtual à qual o Azure-SSIS Integration Runtime ingressará.

IntegrationRuntimeCustomSetupScriptProperties

Propriedades de script de instalação personalizada para um runtime de integração dedicado gerenciado.

IntegrationRuntimeDataFlowProperties

Propriedades de fluxo de dados para runtime de integração gerenciada.

IntegrationRuntimeDataProxyProperties

Propriedades de proxy de dados para um runtime de integração dedicado gerenciado.

IntegrationRuntimeEdition

A edição do SSIS Integration Runtime

IntegrationRuntimeEntityReferenceType

O tipo dessa entidade referenciada.

IntegrationRuntimeLicenseType

Tipo de licença para trazer seu próprio cenário de licença.

IntegrationRuntimeResource

Tipo de recurso de runtime de integração.

IntegrationRuntimeSsisCatalogInfo

Informações de catálogo para runtime de integração dedicada gerenciada.

IntegrationRuntimeSsisCatalogPricingTier

O tipo de preço do banco de dados de catálogo. Os valores válidos podem ser encontrados em https://azure.microsoft.com/en-us/pricing/details/sql-database/

IntegrationRuntimeSsisProperties

Propriedades do SSIS para runtime de integração gerenciada.

IntegrationRuntimeState

O estado do runtime de integração.

IntegrationRuntimeType

O tipo de runtime de integração.

IntegrationRuntimeVNetProperties

Propriedades de VNet para runtime de integração gerenciada.

LinkedIntegrationRuntimeKeyAuthorization

O runtime de integração do tipo de autorização de chave.

LinkedIntegrationRuntimeRbacAuthorization

O runtime de integração do tipo de autorização RBAC (controle de acesso baseado em função).

ManagedIntegrationRuntime

Runtime de integração gerenciada, incluindo runtimes de integração dedicados gerenciados e elásticos gerenciados.

ManagedVirtualNetworkReference

Tipo de referência de Rede Virtual gerenciado.

ManagedVirtualNetworkReferenceType

Tipo de referência de Rede Virtual gerenciado.

PackageStore

Repositório de pacotes para o runtime de integração do SSIS.

PipelineExternalComputeScaleProperties

Propriedades pipelineExternalComputeScale para runtime de integração gerenciada.

SecureString

Azure Data Factory definição de cadeia de caracteres segura. O valor da cadeia de caracteres será mascarado com asteriscos '*' durante as chamadas à API Get ou List.

SelfHostedIntegrationRuntime

Runtime de integração auto-hospedada.

UpdateIntegrationRuntimeRequest

Atualizar a solicitação de runtime de integração.

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.

CopyComputeScaleProperties

Propriedades CopyComputeScale para runtime de integração gerenciada.

Nome Tipo Description
dataIntegrationUnit

integer

Configuração de número de DIU reservada para execução da atividade de cópia. Os valores com suporte são múltiplos de 4 no intervalo de 4 a 256.

timeToLive

integer

Configuração de vida útil (em minutos) do runtime de integração que executará a atividade de cópia.

CredentialReference

Tipo de referência de credencial.

Nome Tipo Description
referenceName

string

Nome da credencial de referência.

type

CredentialReferenceType

Tipo de referência de credencial.

CredentialReferenceType

Tipo de referência de credencial.

Nome Tipo Description
CredentialReference

string

CustomProperties

As propriedades personalizadas são usadas para ajustar o desempenho do runtime do fluxo de dados.

Nome Tipo Description
name

string

Nome da propriedade personalizada.

value

string

Valor da propriedade personalizada.

DataFlowComputeType

Tipo de computação do cluster que executará o trabalho de fluxo de dados.

Nome Tipo Description
ComputeOptimized

string

General

string

MemoryOptimized

string

EntityReference

A referência de entidade.

Nome Tipo Description
referenceName

string

O nome dessa entidade referenciada.

type

IntegrationRuntimeEntityReferenceType

O tipo dessa entidade referenciada.

IntegrationRuntimeAutoUpdate

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

Nome Tipo Description
Off

string

On

string

IntegrationRuntimeComputeProperties

As propriedades do recurso de computação para o runtime de integração gerenciada.

Nome Tipo Description
copyComputeScaleProperties

CopyComputeScaleProperties

Propriedades CopyComputeScale para runtime de integração gerenciada.

dataFlowProperties

IntegrationRuntimeDataFlowProperties

Propriedades de fluxo de dados para runtime de integração gerenciada.

location

string

O local do runtime de integração gerenciada. As regiões com suporte podem ser encontradas em https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities

maxParallelExecutionsPerNode

integer

Contagem máxima de execuções paralelas por nó para runtime de integração gerenciada.

nodeSize

string

O requisito de tamanho do nó para o runtime de integração gerenciada.

numberOfNodes

integer

O número necessário de nós para o runtime de integração gerenciada.

pipelineExternalComputeScaleProperties

PipelineExternalComputeScaleProperties

Propriedades pipelineExternalComputeScale para runtime de integração gerenciada.

vNetProperties

IntegrationRuntimeVNetProperties

Propriedades de VNet para runtime de integração gerenciada.

IntegrationRuntimeCustomerVirtualNetwork

A definição e as propriedades da rede virtual à qual o Azure-SSIS Integration Runtime ingressará.

Nome Tipo Description
subnetId

string

A ID da sub-rede à qual o Azure-SSIS Integration Runtime ingressará.

IntegrationRuntimeCustomSetupScriptProperties

Propriedades de script de instalação personalizada para um runtime de integração dedicado gerenciado.

Nome Tipo Description
blobContainerUri

string

O URI do contêiner de blob do Azure que contém o script de instalação personalizado.

sasToken

SecureString

O token SAS do contêiner de blob do Azure.

IntegrationRuntimeDataFlowProperties

Propriedades de fluxo de dados para runtime de integração gerenciada.

Nome Tipo Description
cleanup

boolean

O cluster não será reciclado e será usado na próxima execução da atividade de fluxo de dados até que o TTL (vida útil) seja atingido se isso for definido como false. O padrão é true.

computeType

DataFlowComputeType

Tipo de computação do cluster que executará o trabalho de fluxo de dados.

coreCount

integer

Contagem principal do cluster que executará o trabalho de fluxo de dados. Os valores com suporte são: 8, 16, 32, 48, 80, 144 e 272.

customProperties

CustomProperties[]

As propriedades personalizadas são usadas para ajustar o desempenho do runtime do fluxo de dados.

timeToLive

integer

Configuração de vida útil (em minutos) do cluster que executará o trabalho de fluxo de dados.

IntegrationRuntimeDataProxyProperties

Propriedades de proxy de dados para um runtime de integração dedicado gerenciado.

Nome Tipo Description
connectVia

EntityReference

A referência de runtime de integração auto-hospedada.

path

string

O caminho para conter os dados preparados no Armazenamento de Blobs.

stagingLinkedService

EntityReference

A referência do serviço vinculado de preparo.

IntegrationRuntimeEdition

A edição do SSIS Integration Runtime

Nome Tipo Description
Enterprise

string

Standard

string

IntegrationRuntimeEntityReferenceType

O tipo dessa entidade referenciada.

Nome Tipo Description
IntegrationRuntimeReference

string

LinkedServiceReference

string

IntegrationRuntimeLicenseType

Tipo de licença para trazer seu próprio cenário de licença.

Nome Tipo Description
BasePrice

string

LicenseIncluded

string

IntegrationRuntimeResource

Tipo de recurso de runtime de integração.

Nome Tipo Description
etag

string

A Etag identifica a alteração no recurso.

id

string

O identificador do recurso.

name

string

O nome do recurso.

properties IntegrationRuntime:

Propriedades do runtime de integração.

type

string

O tipo de recurso.

IntegrationRuntimeSsisCatalogInfo

Informações de catálogo para runtime de integração dedicada gerenciada.

Nome Tipo Description
catalogAdminPassword

SecureString

A senha da conta de usuário administrador do banco de dados do catálogo.

catalogAdminUserName

string

O nome de usuário administrador do banco de dados do catálogo.

catalogPricingTier

IntegrationRuntimeSsisCatalogPricingTier

O tipo de preço do banco de dados do catálogo. Os valores válidos podem ser encontrados em https://azure.microsoft.com/en-us/pricing/details/sql-database/

catalogServerEndpoint

string

A URL do servidor de banco de dados do catálogo.

dualStandbyPairName

string

O nome do par em espera duplo do Azure-SSIS Integration Runtimes para dar suporte ao failover do SSISDB.

IntegrationRuntimeSsisCatalogPricingTier

O tipo de preço do banco de dados de catálogo. Os valores válidos podem ser encontrados em https://azure.microsoft.com/en-us/pricing/details/sql-database/

Nome Tipo Description
Basic

string

Premium

string

PremiumRS

string

Standard

string

IntegrationRuntimeSsisProperties

Propriedades do SSIS para runtime de integração gerenciada.

Nome Tipo Description
catalogInfo

IntegrationRuntimeSsisCatalogInfo

Informações de catálogo para runtime de integração dedicada gerenciada.

credential

CredentialReference

A referência de credencial que contém informações de autenticação.

customSetupScriptProperties

IntegrationRuntimeCustomSetupScriptProperties

Propriedades de script de instalação personalizada para um runtime de integração dedicado gerenciado.

dataProxyProperties

IntegrationRuntimeDataProxyProperties

Propriedades de proxy de dados para um runtime de integração dedicado gerenciado.

edition

IntegrationRuntimeEdition

A edição do SSIS Integration Runtime

expressCustomSetupProperties

CustomSetupBase[]

Configuração personalizada sem propriedades de script para um runtime de integração do SSIS.

licenseType

IntegrationRuntimeLicenseType

Tipo de licença para trazer seu próprio cenário de licença.

packageStores

PackageStore[]

Repositórios de pacotes para o Integration Runtime do SSIS.

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

IntegrationRuntimeType

O tipo de runtime de integração.

Nome Tipo Description
Managed

string

SelfHosted

string

IntegrationRuntimeVNetProperties

Propriedades de VNet para runtime de integração gerenciada.

Nome Tipo Description
publicIPs

string[]

IDs de recurso dos endereços IP públicos que esse runtime de integração usará.

subnet

string

O nome da sub-rede em que esse runtime de integração ingressará.

subnetId

string

A ID da sub-rede à qual esse runtime de integração do Azure-SSIS será ingressado.

vNetId

string

A ID da VNet à qual esse runtime de integração ingressará.

LinkedIntegrationRuntimeKeyAuthorization

O runtime de integração do tipo de autorização de chave.

Nome Tipo Description
authorizationType string:

Key

O tipo de autorização para compartilhamento de runtime de integração.

key

SecureString

A chave usada para autorização.

LinkedIntegrationRuntimeRbacAuthorization

O runtime de integração do tipo de autorização RBAC (controle de acesso baseado em função).

Nome Tipo Description
authorizationType string:

RBAC

O tipo de autorização para compartilhamento de runtime de integração.

credential

CredentialReference

A referência de credencial que contém informações de autenticação.

resourceId

string

O identificador de recurso do runtime de integração a ser compartilhado.

ManagedIntegrationRuntime

Runtime de integração gerenciada, incluindo runtimes de integração dedicados gerenciados e elásticos gerenciados.

Nome Tipo Description
description

string

Descrição do runtime de integração.

managedVirtualNetwork

ManagedVirtualNetworkReference

Referência de Rede Virtual gerenciada.

state

IntegrationRuntimeState

Estado do runtime de integração, válido apenas para o runtime de integração dedicado gerenciado.

type string:

Managed

Tipo de runtime de integração.

typeProperties.computeProperties

IntegrationRuntimeComputeProperties

O recurso de computação para runtime de integração gerenciada.

typeProperties.customerVirtualNetwork

IntegrationRuntimeCustomerVirtualNetwork

O nome da rede virtual à qual o Azure-SSIS Integration Runtime ingressará

typeProperties.ssisProperties

IntegrationRuntimeSsisProperties

Propriedades do SSIS para runtime de integração gerenciada.

ManagedVirtualNetworkReference

Tipo de referência de Rede Virtual gerenciado.

Nome Tipo Description
referenceName

string

Referência ManagedVirtualNetwork name.

type

ManagedVirtualNetworkReferenceType

Tipo de referência de Rede Virtual gerenciado.

ManagedVirtualNetworkReferenceType

Tipo de referência de Rede Virtual gerenciado.

Nome Tipo Description
ManagedVirtualNetworkReference

string

PackageStore

Repositório de pacotes para o runtime de integração do SSIS.

Nome Tipo Description
name

string

O nome do repositório de pacotes

packageStoreLinkedService

EntityReference

A referência de serviço vinculado do repositório de pacotes.

PipelineExternalComputeScaleProperties

Propriedades pipelineExternalComputeScale para runtime de integração gerenciada.

Nome Tipo Description
numberOfExternalNodes

integer

Número dos nós externos, que devem ser maiores que 0 e menores que 11.

numberOfPipelineNodes

integer

Número de nós de pipeline, que devem ser maiores que 0 e menores que 11.

timeToLive

integer

Configuração de vida útil (em minutos) do runtime de integração que executará o pipeline e a atividade externa.

SecureString

Azure Data Factory definição de cadeia de caracteres segura. O valor da cadeia de caracteres será mascarado com asteriscos '*' durante as chamadas à API Get ou List.

Nome Tipo Description
type string:

SecureString

Tipo do segredo.

value

string

Valor da cadeia de caracteres segura.

SelfHostedIntegrationRuntime

Runtime de integração auto-hospedada.

Nome Tipo Description
description

string

Descrição do runtime de integração.

type string:

SelfHosted

Tipo de runtime de integração.

typeProperties.linkedInfo LinkedIntegrationRuntimeType:

A definição base de um runtime de integração vinculada.

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 consegue estabelecer uma conexão com a Retransmissão do Azure.

UpdateIntegrationRuntimeRequest

Atualizar a solicitação de runtime de integração.

Nome Tipo Description
autoUpdate

IntegrationRuntimeAutoUpdate

Habilita ou desabilita o recurso de atualização automática do runtime de integração auto-hospedada. Consulte https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

O deslocamento de tempo (em horas) no dia, por exemplo, PT03H é de 3 horas. A atualização automática do runtime de integração ocorrerá nesse momento.