다음을 통해 공유

az cognitiveservices account connection

Azure Cognitive Services 연결 및 보다 구체적인 파생 상품을 관리합니다.

Azure Cognitive Services 연결은 외부 리소스에 연결하고 상호 작용하는 데 필요한 인증 및 구성 정보를 저장하는 안전한 방법을 제공합니다.

명령

Name Description 형식 상태
az cognitiveservices account connection create

연결 만들기.

 Core GA
az cognitiveservices account connection delete

연결을 삭제합니다.

 Core GA
az cognitiveservices account connection list

모든 연결을 나열합니다.

 Core GA
az cognitiveservices account connection show

연결의 세부 정보를 표시합니다.

 Core GA
az cognitiveservices account connection update

연결을 업데이트합니다.

 Core GA

az cognitiveservices account connection create

편집

연결 만들기.

az cognitiveservices account connection create --connection-name
                                               --file
                                               --name
                                               --resource-group

예제

YAML 사양 파일에서 연결을 만듭니다.

az cognitiveservices account connection create --file connection.yml --connection-name my-connection-name --resource-group my-resource-group --name my-cogsvc-account

필수 매개 변수

--connection-name

Cognitive Services 계정 연결 이름입니다.

--file

JSON 또는 YAML 형식의 연결 파일 경로입니다.

--name -n

Cognitive Service 계정 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az cognitiveservices account connection delete

편집

연결을 삭제합니다.

az cognitiveservices account connection delete --connection-name
                                               --name
                                               --resource-group

예제

연결을 삭제합니다.

az cognitiveservices account connection delete --resource-group my-resource-group --connection-name my-connection-name --name my-cogsvc-account

필수 매개 변수

--connection-name

Cognitive Services 계정 연결 이름입니다.

--name -n

Cognitive Service 계정 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az cognitiveservices account connection list

편집

모든 연결을 나열합니다.

Azure AI Foundry 계정의 연결 목록입니다.

az cognitiveservices account connection list --name
                                             --resource-group
                                             [--category]
                                             [--include-all]
                                             [--target]

예제

Azure AI Foundry 계정의 모든 연결 나열

az cognitiveservices account connection list --resource-group my-resource-group --name my-cogsvc-account

--query 인수를 사용하여 명령 결과에 대한 JMESPath 쿼리를 실행하는 Azure AI Foundry 계정의 모든 연결을 나열합니다.

az cognitiveservices account connection list --query "[].{Name:name}"  --output table --resource-group my-resource-group --name my-cogsvc-account

필수 매개 변수

--name -n

Cognitive Service 계정 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--category

연결의 범주입니다. 기본값은 None입니다.

--include-all

연결 가져오기 호출이 연결 및 데이터 저장소를 모두 반환해야 하는지를 나타내는 쿼리 매개 변수입니다. 기본값은 False입니다.

속성 값
Default value: False
--target

연결의 대상입니다. 기본값은 None입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az cognitiveservices account connection show

편집

연결의 세부 정보를 표시합니다.

az cognitiveservices account connection show --connection-name
                                             --name
                                             --resource-group

예제

연결의 세부 정보를 표시합니다.

az cognitiveservices account connection show --resource-group my-resource-group --connection-name my-connection-name --name my-cogsvc-account

필수 매개 변수

--connection-name

Cognitive Services 계정 연결 이름입니다.

--name -n

Cognitive Service 계정 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az cognitiveservices account connection update

편집

연결을 업데이트합니다.

az cognitiveservices account connection update --connection-name
                                               --name
                                               --resource-group
                                               [--add]
                                               [--force-string]
                                               [--remove]
                                               [--set]

예제

연결 API 키를 업데이트합니다.

az cognitiveservices account connection update --resource-group my-resource-group --connection-name my-connection-name --name my-cogsvc-account --set properties.credentials.key=<new-key>

필수 매개 변수

--connection-name

Cognitive Services 계정 연결 이름입니다.

--name -n

Cognitive Service 계정 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: False
--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False