Compartilhar via


Fornecer parâmetros corretos ao Conector de Serviço

Se você estiver usando uma ferramenta da CLI para gerenciar conexões, é crucial entender como passar parâmetros corretos para o Conector de Serviço. Neste guia, você obtém insights sobre as propriedades fundamentais e os respectivos formatos de valor adequados.

Pré-requisitos

Serviço de origem

Os serviços de origem geralmente são serviços de computação do Azure. O Conector de Serviço é um recurso de extensão do Azure. Ao enviar solicitações usando ferramentas REST, para criar uma conexão, por exemplo, a URL da solicitação deve usar o formato {source_resource_id}/providers/Microsoft.ServiceLinker/linkers/{linkerName}, e {source_resource_id} deve corresponder a uma das IDs de recurso listadas na tabela abaixo.

Tipo de serviço de origem Formato da ID do recurso
Serviço de Aplicativo do Azure /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
Slot do Serviço de Aplicativo do Azure /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}/slots/{slot}
Aplicativos de Contêiner do Azure /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.App/containerApps/{app}
AKS (Serviço de Kubernetes do Azure) /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.ContainerService/managedClusters/{aks-cluster-name}
Azure Functions /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
Azure Spring Apps /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.AppPlatform/Spring/{spring}/apps/{app}/deployments/{deployment}

Serviço de Destino

Os serviços de destino são serviços de suporte ou serviços de dependência aos quais seus serviços de computação se conectam. Ao passar informações de recurso de destino para o Conector de Serviço, as IDs de recurso nem sempre são recursos de nível superior e também podem ser sub-recursos. Verifique a tabela a seguir para obter os formatos exatos de todos os serviços de destino compatíveis com o Conector de Serviço.

Tipo de serviço de destino Formato da ID do recurso
Configuração de Aplicativos do Azure /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.AppConfiguration/configurationStores/{config_store}
Cache Redis do Azure /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Cache/redis/{server}/databases/{database}
Cache do Azure para Redis (Enterprise) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Cache/redisEnterprise/{server}/databases/{database}
Azure Cosmos DB (NoSQL) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DocumentDB/databaseAccounts/{account}/sqlDatabases/{database}
Azure Cosmos DB (MongoDB) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DocumentDB/databaseAccounts/{account}/mongodbDatabases/{database}
Azure Cosmos DB (Gremlin) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DocumentDB/databaseAccounts/{account}/gremlinDatabases/{database}/graphs/{graph}
Azure Cosmos DB (Cassandra) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DocumentDB/databaseAccounts/{account}/cassandraKeyspaces/{key_space}
Azure Cosmos DB (Tabela) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DocumentDB/databaseAccounts/{account}/tables/{table}
Banco de Dados do Azure para MySQL /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DBforMySQL/flexibleServers/{server}/databases/{database}
Banco de Dados do Azure para PostgreSQL /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{server}/databases/{database}
Hubs de eventos do Azure /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.EventHub/namespaces/{namespace}
Azure Key Vault /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.KeyVault/vaults/{vault}
Barramento de Serviço do Azure /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.ServiceBus/namespaces/{namespace}
Banco de Dados SQL do Azure /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Sql/servers/{server}/databases/{database}
Serviço do Azure SignalR /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.SignalRService/SignalR/{signalr}
Armazenamento do Azure (Blob) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/blobServices/default
Armazenamento do Microsoft Azure (Fila) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/queueServices/default
Armazenamento do Microsoft Azure (Arquivo) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/fileServices/default
Armazenamento do Microsoft Azure (Tabela) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/tableServices/default
Azure Web PubSub /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.SignalRService/WebPubSub/{webpubsub}

Tipo de autenticação

O tipo de autenticação refere-se ao método de autenticação usado pela conexão. Há suporte para os tipos de autenticação a seguir:

  • identidade gerenciada pelo sistema
  • Identidade gerenciada pelo usuário
  • entidade de serviço
  • segredo/cadeia de conexão/chave de acesso

Um subconjunto diferente dos tipos de autenticação pode ser usado ao especificar um serviço de destino diferente e um tipo de cliente diferente; verifique como se integrar aos serviços de destino para conhecer as combinações deles.

Tipo de cliente

O tipo de cliente refere-se à estrutura de desenvolvimento ou pilha de runtime do serviço de computação. O tipo de cliente geralmente afeta o formato de cadeia de conexão de um banco de dados. Os tipos de cliente possíveis são:

  • dapr
  • django
  • dotnet
  • go
  • java
  • kafka-springBoot
  • nodejs
  • none
  • php
  • python
  • ruby
  • springBoot

Um subconjunto diferente dos tipos de cliente pode ser usado ao especificar um serviço de destino diferente e um tipo de autenticação diferente, verifique como se integrar aos serviços de destino para conhecer as combinações deles.