다음을 통해 공유

az healthcareapis service

  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.66.0 이상)에 대한 healthcareapis 확장의 일부입니다. az healthcareapis service 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Healthcareapis 서비스.

명령

Name Description 형식 상태
az healthcareapis service create

서비스 인스턴스의 메타데이터를 만듭니다.

 내선 번호 GA
az healthcareapis service delete

서비스 인스턴스를 삭제합니다.

 내선 번호 GA
az healthcareapis service list

리소스 그룹의 모든 서비스 인스턴스를 가져옵니다. 그리고 구독의 모든 서비스 인스턴스를 가져옵니다.

 내선 번호 GA
az healthcareapis service show

서비스 인스턴스의 메타데이터를 가져옵니다.

 내선 번호 GA
az healthcareapis service update

서비스 인스턴스의 메타데이터를 업데이트합니다.

 내선 번호 GA
az healthcareapis service wait

healthcareapis 서비스의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

 내선 번호 GA

az healthcareapis service create

서비스 인스턴스의 메타데이터를 만듭니다.

az healthcareapis service create --kind {fhir, fhir-R4, fhir-Stu3}
                                 --location
                                 --resource-group
                                 --resource-name
                                 [--access-policies]
                                 [--authentication-configuration]
                                 [--cors-configuration]
                                 [--cosmos-db-configuration]
                                 [--etag]
                                 [--export-configuration-storage-account-name]
                                 [--identity-type {None, SystemAssigned}]
                                 [--login-servers]
                                 [--no-wait]
                                 [--oci-artifacts]
                                 [--private-endpoint-connections]
                                 [--public-network-access {Disabled, Enabled}]
                                 [--tags]

예제

모든 매개 변수를 사용하여 서비스 만들기 또는 업데이트

az healthcareapis service create --resource-group "rg1" --resource-name "service1" --identity-type "SystemAssigned" --kind "fhir-R4" --location "westus2" --access-policies object-id="c487e7d1-3210-41a3-8ccc-e9372b78da47" --access-policies object-id="5b307da8-43d4-492b-8b66-b0294ade872f" --authentication-configuration audience="https://azurehealthcareapis.com" authority="https://login.microsoftonline.com/abfde7b2-df0f-47e6-aabf-2462b07508dc" smart-proxy-enabled=true --cors-configuration allow-credentials=false headers="*" max-age=1440 methods="DELETE" methods="GET" methods="OPTIONS" methods="PATCH" methods="POST" methods="PUT" origins="*" --cosmos-db-configuration key-vault-key-uri="https://my-vault.vault.azure.net/keys/my-key" offer-throughput=1000 --export-configuration-storage-account-name "existingStorageAccount" --public-network-access "Disabled"

최소 매개 변수를 사용하여 서비스 만들기 또는 업데이트

az healthcareapis service create --resource-group "rg1" --resource-name "service2" --kind "fhir-R4" --location "westus2" --access-policies object-id="c487e7d1-3210-41a3-8ccc-e9372b78da47"

필수 매개 변수

--kind

서비스의 종류입니다.

허용되는 값: fhir, fhir-R4, fhir-Stu3
--location -l

위치. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--resource-group -g

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

--resource-name

서비스 인스턴스의 이름입니다.

선택적 매개 변수

--access-policies

서비스 인스턴스의 액세스 정책입니다.

사용: --access-policies object-id=XX

object-id: 필수입니다. FHIR 서비스에 액세스할 수 있는 Azure AD 개체 ID(사용자 또는 앱)입니다.

둘 이상의 --access-policies 인수를 사용하여 여러 작업을 지정할 수 있습니다.

--authentication-configuration -c

서비스 인스턴스에 대한 인증 구성입니다.

사용: --authentication-configuration authority=XX audience=XX smart-proxy-enabled=XX

authority: 서비스 대상 그룹에 대한 권한 URL: 스마트 프록시 사용 서비스의 대상 그룹 URL: SMART on FHIR 프록시를 사용하는 경우

--cors-configuration

서비스 인스턴스의 CORS 구성에 대한 설정입니다.

사용법: --cors-configuration origins=XX headers=XX methods=XX max-age=XX allow-credentials=XX

origins: CORS를 통해 허용되는 원본입니다. 헤더: CORS를 통해 허용되는 헤더입니다. 메서드: CORS를 통해 허용되는 메서드입니다. max-age: CORS를 통해 허용되는 최대 기간입니다. 허용 자격 증명: CORS를 통해 자격 증명이 허용되는 경우

--cosmos-db-configuration

서비스를 지원하는 Cosmos DB 데이터베이스에 대한 설정입니다.

사용: --cosmos-db-configuration offer-throughput=XX key-vault-key-uri=XX

제품 처리량: 백업 데이터베이스에 대해 프로비전된 처리량입니다. key-vault-key-uri: 지원 데이터베이스에 대한 고객 관리형 키의 URI입니다.

--etag

리소스와 연결된 etag로, 리소스를 편집할 때 낙관적 동시성에 사용됩니다.

--export-configuration-storage-account-name -s

기본 내보내기 스토리지 계정의 이름입니다.

--identity-type

지정되는 ID의 형식이며, 현재 SystemAssigned 및 None은 허용됩니다.

허용되는 값: None, SystemAssigned
--login-servers

서비스 인스턴스에 추가해야 하는 로그인 서버 목록입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--oci-artifacts

OCI(Open Container Initiative) 아티팩트 목록입니다.

사용법: --oci-artifacts login-server=XX image-name=XX digest=XX

login-server: Azure Container Registry 로그인 서버입니다. image-name: 아티팩트 이름입니다. 다이제스트: 아티팩트 다이제스트입니다.

둘 이상의 --oci-artifacts 인수를 사용하여 여러 작업을 지정할 수 있습니다.

--private-endpoint-connections

이 리소스에 대해 설정된 프라이빗 엔드포인트 연결 목록입니다.

사용: --private-endpoint-connections status=XX description=XX actions-required=XX

status: 서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다. 설명: 연결의 승인/거부 이유입니다. 작업 필요: 서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.

둘 이상의 --private-endpoint-connections 인수를 사용하여 여러 작업을 지정할 수 있습니다.

--public-network-access

프라이빗 엔드포인트를 사용하는 동안 공용 네트워크에서 들어오는 데이터 평면 트래픽에 대한 제어 권한입니다.

허용되는 값: Disabled, Enabled
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az healthcareapis service delete

서비스 인스턴스를 삭제합니다.

az healthcareapis service delete [--ids]
                                 [--no-wait]
                                 [--resource-group]
                                 [--resource-name]
                                 [--subscription]
                                 [--yes]

예제

서비스 삭제

az healthcareapis service delete --resource-group "rg1" --resource-name "service1"

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--resource-group -g

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

--resource-name

서비스 인스턴스의 이름입니다.

--subscription

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

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az healthcareapis service list

리소스 그룹의 모든 서비스 인스턴스를 가져옵니다. 그리고 구독의 모든 서비스 인스턴스를 가져옵니다.

az healthcareapis service list [--resource-group]

예제

리소스 그룹의 모든 서비스 나열

az healthcareapis service list --resource-group "rgname"

구독의 모든 서비스 나열

az healthcareapis service list

선택적 매개 변수

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az healthcareapis service show

서비스 인스턴스의 메타데이터를 가져옵니다.

az healthcareapis service show [--ids]
                               [--resource-group]
                               [--resource-name]
                               [--subscription]

예제

메타데이터 가져오기

az healthcareapis service show --resource-group "rg1" --resource-name "service1"

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--resource-group -g

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

--resource-name

서비스 인스턴스의 이름입니다.

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az healthcareapis service update

서비스 인스턴스의 메타데이터를 업데이트합니다.

az healthcareapis service update [--ids]
                                 [--no-wait]
                                 [--public-network-access {Disabled, Enabled}]
                                 [--resource-group]
                                 [--resource-name]
                                 [--subscription]
                                 [--tags]

예제

패치 서비스

az healthcareapis service update --resource-group "rg1" --resource-name "service1" --tags tag1="value1" tag2="value2"

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--public-network-access

프라이빗 엔드포인트를 사용하는 동안 공용 네트워크에서 들어오는 데이터 평면 트래픽에 대한 제어 권한입니다.

허용되는 값: Disabled, Enabled
--resource-group -g

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

--resource-name

서비스 인스턴스의 이름입니다.

--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az healthcareapis service wait

healthcareapis 서비스의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az healthcareapis service wait [--created]
                               [--custom]
                               [--deleted]
                               [--exists]
                               [--ids]
                               [--interval]
                               [--resource-group]
                               [--resource-name]
                               [--subscription]
                               [--timeout]
                               [--updated]

예제

healthcareapis 서비스가 성공적으로 생성될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az healthcareapis service wait --resource-group "rg1" --resource-name "service1" --created

healthcareapis 서비스가 성공적으로 업데이트될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az healthcareapis service wait --resource-group "rg1" --resource-name "service1" --updated

healthcareapis 서비스가 성공적으로 삭제될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az healthcareapis service wait --resource-group "rg1" --resource-name "service1" --deleted

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--interval

폴링 간격(초)입니다.

Default value: 30
--resource-group -g

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

--resource-name

서비스 인스턴스의 이름입니다.

--subscription

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

--timeout

최대 대기 시간(초)입니다.

Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.