CLI(v2) Azure AI 서비스 연결 YAML 스키마
적용 대상: 
Azure CLI ml 확장 v2(현재)
참고 항목
이 문서에 자세히 설명된 YAML 구문은 최신 버전의 ML CLI v2 확장에 대한 JSON 스키마를 기반으로 합니다. 이 구문은 최신 버전의 ML CLI v2 확장에서만 작동하도록 보장됩니다. https://azuremlschemasprod.azureedge.net/에서 이전 확장 버전에 대한 스키마를 찾을 수 있습니다.
YAML 구문
| 키 | 형식 | 설명 | 허용된 값 | 기본값 |
|---|---|---|---|---|
$schema |
string | YAML 스키마입니다. Azure Machine Learning Visual Studio Code 확장을 사용하여 YAML 파일을 작성하는 경우 파일 맨 위에 $schema을(를) 포함하여 스키마 및 리소스 완성을 호출합니다. |
||
name |
string | 필수입니다. 연결 이름입니다. | ||
description |
string | 연결에 관한 설명입니다. | ||
tags |
개체 | 연결 태그 사전입니다. | ||
type |
string | 필수입니다. 연결 유형입니다. | azure_ai_services |
azure_ai_services |
is_shared |
부울 값 | 허브의 다른 프로젝트에서 연결이 공유되면 true이고 그렇지 않으면 false입니다. |
true |
|
endpoint |
string | 필수입니다. 엔드포인트의 URL입니다. | ||
api_key |
string | 연결을 인증하는 데 사용하는 API 키입니다. 제공되지 않으면 Microsoft Entra ID(자격 증명 없는 인증)를 통해 연결이 인증됩니다. | ||
ai_services_resource_id |
string | 필수입니다. Azure AI 서비스 리소스의 정규화된 Azure 리소스 ID입니다. |
설명
Azure AI 서비스에 대한 연결을 만드는 방법은 두 가지가 있습니다.
- Azure AI 검색을 제외한 모든 Azure AI 서비스에 대한 하나의 연결.
- 각 Azure AI 서비스에 대한 하나의 연결.
이 문서에서 설명하는 스키마는 Azure AI 검색을 제외한 모든 Azure AI 서비스에 대한 하나의 연결을 위한 것입니다.
az ml connection 명령을 사용하여 Azure Machine Learning과 Azure AI Studio 연결을 모두 관리할 수 있지만 Azure AI 서비스 연결은 Azure AI Studio에만 해당됩니다.
예제
이러한 예제는 YAML 파일 형식이며 CLI에서 사용됩니다. 예들 들어 az ml connection create -f <file-name>.yaml입니다.
YAML: API 키
#AzureAIServiceConnection.yml
name: myazai_ei
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/
api_key: XXXXXXXXXXXXXXX
YAML: Microsoft Entra ID
#AzureAIServiceConnection.yml
name: myazai_apk
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/