次の方法で共有

サービス コネクタに正しいパラメーターを指定する

  • [アーティクル]

CLI ツールを使用して接続を管理している場合は、サービス コネクタに正しいパラメーターを渡す方法を理解することが重要です。 このガイドでは、基本的なプロパティとその適切な値の形式について詳しく説明します。

前提条件

ソース サービス

ソース サービスは、通常、Azure コンピューティング サービスです。 サービス コネクタは Azure 拡張機能のリソースです。 たとえば、REST ツールを使用して要求を送信して接続を作成する場合、要求 URL は {source_resource_id}/providers/Microsoft.ServiceLinker/linkers/{linkerName} の形式を使用し、{source_resource_id} は下の表に一覧表示されているリソース ID のいずれかと一致する必要があります。

ソース サービスの種類 リソース ID の形式
Azure App Service /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
Azure App Service スロット /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 Service (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 App Configuration /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.AppConfiguration/configurationStores/{config_store}
Azure Cache for Redis /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 Event Hubs /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 Service Bus /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 Service /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.SignalRService/SignalR/{signalr}
Azure Storage (BLOB) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/blobServices/default
Azure Storage (キュー) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/queueServices/default
Azure Storage (ファイル) /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/fileServices/default
Azure Storage (テーブル) /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}

認証の種類

認証の種類は、接続で使用される認証方法を指します。 以下の認証の種類はサポートされていません:

  • システム マネージド ID
  • ユーザー マネージド ID
  • サービス プリンシパル (service principal)
  • シークレット/接続文字列/アクセス キー

異なるターゲット サービスと異なるクライアントの種類を指定する場合は、異なるサブセットの認証の種類を使用できます。組み合わせについては、ターゲット サービスとの統合方法に関する記事を確認してください。

クライアントの種類

クライアントの種類は、コンピューティング サービスのランタイム スタックまたは開発フレームワークを指します。 クライアントの種類は、多くの場合、データベースの接続文字列の形式に影響します。 使用できるクライアントの種類は次のとおりです。

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

異なるターゲット サービスと異なる認証の種類を指定する場合は、異なるサブセットのクライアントの種類を使用できます。組み合わせについては、ターゲット サービスとの統合方法に関する記事を確認してください。