你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

向服务连接器提供正确的参数

如果使用 CLI 工具管理连接,请务必了解如何将正确的参数传递给服务连接器。 本指南深入介绍基本属性及其正确的值格式。

先决条件

源服务

源服务通常是 Azure 计算服务。 服务连接器是一个 Azure 扩展资源。 使用 REST 工具发送请求时,若要创建连接,请求 URL 应使用 {source_resource_id}/providers/Microsoft.ServiceLinker/linkers/{linkerName} 格式,{source_resource_id} 应与下表中列出的资源 ID 之一匹配。

源服务类型 资源 ID 格式
Azure 应用程序服务 /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
Azure 应用服务槽 /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}/slots/{slot}
Azure Container Apps /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.App/containerApps/{app}
Azure Kubernetes 服务 (AKS) /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}

目标服务

目标服务是计算服务连接到的后备服务或依赖项服务。 将目标资源信息传递给服务连接器时,资源 ID 不一定是顶级资源,它们也有可能是子资源。 请查看下表了解所有服务连接器支持的目标服务的确切格式。

目标服务类型 资源 ID 格式
Azure 应用配置 /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.AppConfiguration/configurationStores/{config_store}
用于 Redis 的 Azure 缓存 /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Cache/redis/{server}/databases/{database}
Azure Cache for 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(表) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DocumentDB/databaseAccounts/{account}/tables/{table}
Azure Database for MySQL /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DBforMySQL/flexibleServers/{server}/databases/{database}
Azure Database for PostgreSQL /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{server}/databases/{database}
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}
Azure 服务总线 /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.ServiceBus/namespaces/{namespace}
Azure SQL 数据库 /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Sql/servers/{server}/databases/{database}
Azure SignalR 服务 /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.SignalRService/SignalR/{signalr}
Azure 存储 (Blob) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/blobServices/default
Azure 存储(队列) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/queueServices/default
Azure 存储(文件) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/fileServices/default
Azure 存储(表) /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}

身份验证类型

身份验证类型是指连接使用的身份验证方法。 支持以下身份验证类型:

  • 系统托管标识
  • 用户托管标识
  • 服务主体 (service principal)
  • 机密/连接字符串/访问密钥

指定不同的目标服务和不同的客户端类型时,可以使用身份验证类型的不同子集,请查看如何与目标服务集成了解其组合。

客户端类型

客户端类型是指计算服务的运行时堆栈或开发框架。 客户端类型通常影响数据库的连接字符串格式。 可能的客户端类型包括:

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

指定不同的目标服务和不同的身份验证类型时,可以使用客户端类型的不同子集,请查看如何与目标服务集成了解其组合。