Service Connector に正しいパラメーターを指定する

  • [アーティクル]

CLI ツールを使用して接続を管理する場合は、Service Connector に正しいパラメーターを渡す方法を理解することが重要です。 このガイドでは、基本的なプロパティとその適切な値の形式に関する分析情報を取得します。

前提条件

ソース サービス

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

ソース サービスの種類 リソース ID の形式
Azure App Service /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 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}
Azure Container Apps /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.App/containerApps/{app}

対象サービス

ターゲット サービスは、コンピューティング サービスの接続先となるバッキング サービスまたは依存関係サービスです。 ターゲット リソース情報を Service Connector に渡す場合、リソース ID は常に最上位のリソースであるとは限りません。サブリソースになる場合もあります。 次の表で、Service Connector でサポートされているすべてのターゲット サービスの正確な形式を確認してください。

ターゲット サービスの種類 リソース 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}

Authentication type

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

  • システム マネージド ID
  • ユーザーマネージド ID
  • サービス プリンシパル (service principal)
  • secret/接続文字列/access キー

異なるターゲット サービスと異なるクライアントの種類を指定する場合は、認証の種類の異なるサブセットを使用できます。チェック、それらの組み合わせのためにターゲット サービスと統合する方法を説明します。

クライアントの種類

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

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

クライアントの種類の異なるサブセットは、別のターゲット サービスと異なる認証の種類を指定するときに使用できます。チェック、それらの組み合わせのためにターゲット サービスと統合する方法を説明します。

次のステップ

ターゲット サービスを統合する方法