Weitergeben der korrekten Parameter an den Dienstconnector
Wenn Sie ein CLI-Tool für die Verwaltung von Verbindungen verwenden, müssen Sie wissen, wie Sie die korrekten Parameter an den Dienstconnector weitergeben. In diesem Leitfaden erhalten Sie Einblicke in die grundlegenden Eigenschaften und deren richtige Wertformate.
Voraussetzungen
- Dieser Leitfaden setzt voraus, dass Sie bereits mit den grundlegenden Konzepten des Dienstconnectors vertraut sind.
Quelldienst
Quelldienste sind in der Regel Azure-Computedienste. Der Dienstconnector ist eine erweiterte Azure-Ressource. Beim Senden von Anfragen mit REST-Tools, um beispielsweise eine Verbindung herzustellen, sollte die Anfrage-URL das Format {source_resource_id}/providers/Microsoft.ServiceLinker/linkers/{linkerName} verwenden und {source_resource_id} sollte mit einer der in der folgenden Tabelle aufgeführten Ressourcen-IDs übereinstimmen.
| Art des Quelldiensts | Format der Ressourcen-ID |
|---|---|
| Azure App Service | /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site} |
| Azure App Service-Slot | /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-Funktionen | /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} |
Zieldienst
Zieldienste sind unterstützende Dienste oder Abhängigkeitsdienste, mit denen Ihre Computedienste eine Verbindung herstellen. Wenn Zielressourceninformationen an den Dienstconnector weitergegeben werden, sind die Ressourcen-IDs nicht immer Ressourcen der obersten Ebene, sondern können auch Unterressourcen sein. Die genauen Formate aller vom Dienstconnector unterstützten Zieldienste sind in der folgenden Tabelle aufgeführt.
| Art des Zieldiensts | Format der Ressourcen-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 (Tabelle) | /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-Servicebus | /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.ServiceBus/namespaces/{namespace} |
| Azure SQL-Datenbank | /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 (Warteschlange) | /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/queueServices/default |
| Azure Storage (Datei) | /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/fileServices/default |
| Azure Storage (Tabelle) | /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
Der Authentifizierungstyp bezieht sich auf die von der Verbindung verwendete Authentifizierungsmethode. Folgende Authentifizierungstypen werden nicht unterstützt:
- systemseitig verwaltete Identität
- benutzerseitig verwaltete Identität
- Dienstprinzipal
- Geheimnis/Verbindungszeichenfolge/Zugriffsschlüssel
Eine andere Teilmenge der Authentifizierungstypen kann verwendet werden, wenn Sie einen anderen Zieldienst und einen anderen Clienttyp angeben, überprüfen Sie, wie sie Ihre Kombinationen in Zieldienste integrieren.
Clienttyp
Der Clienttyp bezieht sich auf den Laufzeitstapel oder das Entwicklungsframework Ihres Computediensts. Der Clienttyp wirkt sich häufig auf das Verbindungszeichenfolgenformat einer Datenbank aus. Die folgenden Clienttypen sind möglich:
daprdjangodotnetgojavakafka-springBootnodejsnonephppythonrubyspringBoot
Eine andere Teilmenge der Clienttypen kann verwendet werden, wenn Sie einen anderen Zieldienst und einen anderen Authentifizierungstyp angeben, überprüfen Sie, wie sie Ihre Kombinationen in Zieldienste integrieren.