다음을 통해 공유

서비스 커넥터에 올바른 매개 변수 제공

  • 아티클

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}
AKS(Azure Kubernetes Service) /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.ContainerService/managedClusters/{aks-cluster-name}
Azure 기능 /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 Database /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

다른 대상 서비스 및 다른 인증 유형을 지정할 때 클라이언트 유형의 다른 하위 집합을 사용할 수 있습니다. 해당 조합에 대해 대상 서비스와 통합하는 방법을 확인합니다.