이 페이지에서는 curl
및 Windows PowerShell과 함께 Cloud Healthcare API를 사용하여 데이터 세트와 DICOM, FHIR 또는 HL7v2 저장소를 만드는 방법을 보여줍니다.
시작하기 전에
Google 계정으로
로그인 합니다.아직 계정이 없으면 새 계정을 등록 하세요.
Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.
참고 : 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.
프로젝트 선택기 페이지로 이동
Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요 .
인증 설정:
Cloud Console에서 서비스 계정 키 만들기 페이지로 이동합니다.
서비스 계정 키 만들기 페이지로 이동
서비스 계정 목록에서 새 서비스 계정 을 선택합니다.
서비스 계정 이름 필드에 이름을 입력합니다.
역할 목록에서 프로젝트 > 소유자 .
참고 : 역할 필드는 서비스 계정이 프로젝트에서 액세스할 수 있는 리소스에 영향을 줍니다. 이러한 역할을 취소하거나 나중에 추가 역할을 부여할 수 있습니다. 프로덕션 환경에서는 소유자, 편집자 또는 뷰어 역할을 부여하지 마세요. 자세한 내용은 리소스에 대한 액세스 권한 부여, 변경, 취소 를 참조하세요.
만들기 를 클릭합니다. 키가 포함된 JSON 파일이 컴퓨터에 다운로드됩니다.
GOOGLE_APPLICATION_CREDENTIALS
환경 변수를 서비스 계정 키가 포함된 JSON 파일의 경로로 설정합니다.
이 변수는 현재 셸 세션에만 적용되므로, 새 세션을 열 경우, 변수를 다시 설정합니다.
예: Linux 또는 macOS
[PATH] 를 서비스 계정 키가 포함된 JSON 파일의 경로로 바꿉니다.
export GOOGLE_APPLICATION_CREDENTIALS="[PATH] "
예를 들면 다음과 같습니다.
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
예: Windows
[PATH] 를 서비스 계정 키가 포함된 JSON 파일의 경로로 바꿉니다.
PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH] "
예를 들면 다음과 같습니다.
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key .json"
명령어 프롬프트:
set GOOGLE_APPLICATION_CREDENTIALS=[PATH]
Cloud Healthcare API를 사용 설정합니다.
API 사용 설정
Cloud SDK 설치 및 초기화
팁 : 명령어 프롬프트가 필요하세요? Google Cloud Shell 을 사용해 보세요. Google Cloud Shell 명령줄 환경에는 Google Cloud SDK가 이미 포함되어 있으므로 별도로 설치할 필요가 없습니다.
Google Cloud SDK는 Google Compute Engine 가상 머신에도 사전 설치되어 있습니다.
데이터 세트 생성
데이터 세트 는 Google Cloud에서 의료 데이터를 보관하는 기본 컨테이너입니다.
curl
데이터 세트를 만들려면 POST
요청을 수행하고 데이터 세트의 이름과 액세스 토큰을 제공합니다. 다음 샘플은 curl
을 사용하는 POST
요청을 보여줍니다.
LOCATION 변수를 설정할 때 us-central1
, us-west2
, europe-west2
, europe-west4
, europe-west6
, northamerica-northeast1
, southamerica-east1
, asia-east2
, asia-northeast1
, asia-southeast1
australia-southeast1
또는 us
를 사용합니다.
curl -X POST \
--data "" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets?datasetId=DATASET_ID "
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다. 응답에는 장기 실행 작업 의 식별자가 포함됩니다.
메서드 호출을 완료하는 데 상당한 시간이 걸릴 수 있는 장기 실행 작업은 반환됩니다.
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID ",
}
응답에 작업 이름이 포함됩니다. 작업 상태를 추적하려면 작업 get
메서드 를 사용합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID "
요청이 성공하면 서버는 JSON 형식의 작업 상태가 포함된 응답을 반환합니다. 응답에 "done": true
가 포함되어 있으면 작업이 완료된 것을 알 수 있습니다.
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID ",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset",
"createTime": "CREATE_TIME ",
"endTime": "END_TIME ",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL "
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset",
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
}
}
PowerShell
데이터 세트를 만들려면 POST
요청을 수행하고 데이터 세트의 이름과 액세스 토큰을 제공합니다. 다음 샘플은 Windows PowerShell을 사용한 POST
요청을 보여줍니다.
LOCATION 변수를 설정할 때 us-central1
, us-west2
, europe-west2
, europe-west4
, europe-west6
, northamerica-northeast1
, southamerica-east1
, asia-east2
, asia-northeast1
, asia-southeast1
australia-southeast1
또는 us
를 사용합니다.
$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Post `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets?datasetId=DATASET_ID " | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다. 응답에는 장기 실행 작업 의 식별자가 포함됩니다.
메서드 호출을 완료하는 데 상당한 시간이 걸릴 수 있는 장기 실행 작업은 반환됩니다.
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID ",
}
응답에 작업 이름이 포함됩니다. 작업 상태를 추적하려면 작업 get
메서드 를 사용합니다.
$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Get `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID " | Select-Object -Expand Content
요청이 성공하면 서버는 JSON 형식의 작업 상태가 포함된 응답을 반환합니다. 응답에 "done": true
가 포함되어 있으면 작업이 완료된 것을 알 수 있습니다.
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID ",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset",
"createTime": "CREATE_TIME ",
"endTime": "END_TIME ",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL "
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset",
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
}
}
데이터 세트 세부정보 가져오기
데이터 세트에 대한 세부정보를 보고 데이터 세트가 생성되었는지 확인할 수 있습니다.
curl
데이터 세트에 대한 세부정보를 가져오려면 GET
요청을 수행하고 데이터 세트 이름과 액세스 토큰을 제공합니다. 다음 샘플은 curl
을 사용하는 GET
요청을 보여줍니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
}
PowerShell
데이터 세트에 대한 세부정보를 가져오려면 GET
요청을 수행하고 데이터 세트 이름과 액세스 토큰을 제공합니다. 다음 샘플은 curl
을 사용하는 GET
요청을 보여줍니다.
$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Get `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID " | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
}
DICOM, FHIR, HL7v2 저장소 만들기 및 관리
이 빠른 시작을 완료하려면 관련 섹션을 확장합니다.
FHIR 저장소 만들기 및 관리
FHIR 저장소를 만듭니다.
FHIR 저장소는 데이터 세트 내에 존재하며 FHIR 데이터를 보유합니다. projects.locations.datasets.fhirStores.create
메서드를 사용하여 FHIR 저장소를 만들 수 있습니다.
curl
FHIR 저장소를 만들려면 POST
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
FHIR 저장소의 이름
FHIR 저장소의 FHIR 버전: DSTU2
, STU3
, R4
액세스 토큰
FHIR 저장소 이름은 FHIR 저장소의 상위 데이터 세트에서 고유해야 합니다. 이름은 숫자, 문자, 밑줄, 대시, 마침표로 이루어진 1~256자의 모든 유니코드 문자열일 수 있습니다.
Cloud Healthcare API가 FHIR 저장소 변경사항의 알림을 보내는 기존 Pub/Sub 주제를 선택적으로 구성할 수 있습니다.
Pub/Sub 주제를 지정할 때 다음 샘플과 같이 주제에 대해 한정된 URI를 입력합니다.
projects/PROJECT_ID /topics/PUBSUB_TOPIC
다음 샘플은 curl
을 사용하는 POST
요청을 보여줍니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data "{
'version': 'FHIR_STORE_VERSION '
}" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores?fhirStoreId=FHIR_STORE_ID "
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID ",
"version": "FHIR_STORE_VERSION "
}
PowerShell
FHIR 저장소를 만들려면 POST
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
FHIR 저장소의 이름
FHIR 저장소의 FHIR 버전: DSTU2
, STU3
, R4
액세스 토큰
FHIR 저장소 이름은 FHIR 저장소의 상위 데이터 세트에서 고유해야 합니다. 이름은 숫자, 문자, 밑줄, 대시, 마침표로 이루어진 1~256자의 모든 유니코드 문자열일 수 있습니다.
Cloud Healthcare API가 FHIR 저장소 변경사항의 알림을 보내는 기존 Pub/Sub 주제를 선택적으로 구성할 수 있습니다.
Pub/Sub 주제를 지정할 때 다음 샘플과 같이 주제에 대해 한정된 URI를 입력합니다.
projects/PROJECT_ID /topics/PUBSUB_TOPIC
다음 샘플은 Windows PowerShell을 사용한 POST
요청을 보여줍니다.
$cred = gcloud auth print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Post `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-Body "{
'version': 'FHIR_STORE_VERSION '
}" `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores?fhirStoreId=FHIR_STORE_ID " | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID ",
"version": "FHIR_STORE_VERSION "
}
FHIR 저장소 세부정보 가져오기
FHIR 저장소에 대한 세부정보를 보고 projects.locations.datasets.fhirStores.get
메서드를 사용하여 저장소가 생성되었는지 확인할 수 있습니다.
curl
FHIR 저장소에 대한 세부정보를 가져오려면 GET
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
FHIR 저장소의 이름
액세스 토큰
다음 샘플은 curl
을 사용하는 GET
요청을 보여줍니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID "
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID ",
"version": "FHIR_STORE_VERSION "
}
FhirStore
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
PowerShell
FHIR 저장소에 대한 세부정보를 가져오려면 GET
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
FHIR 저장소의 이름
액세스 토큰
다음 샘플은 Windows PowerShell을 사용한 GET
요청을 보여줍니다.
$cred = gcloud auth print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Get `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID " | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID ",
"version": "FHIR_STORE_VERSION "
}
FhirStore
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
FHIR 저장소 업데이트
projects.locations.datasets.fhirStores.patch
메서드를 사용하여 FHIR 저장소를 업데이트할 수 있습니다.
다음 샘플은 FHIR 저장소의 Pub/Sub 주제 및 라벨을 업데이트하는 방법을 보여줍니다.
curl
FHIR 저장소를 수정하려면 PATCH
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
FHIR 저장소의 이름
업데이트할 메타데이터 이 샘플에서는 Pub/Sub 주제의 정규화된 URI 및 쉼표로 구분된 키-값 쌍 목록으로 업데이트할 라벨입니다.
업데이트 마스크
액세스 토큰
다음 샘플은 curl
을 사용하는 PATCH
요청을 보여줍니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data "{
'notificationConfig': {
'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC '
},
'labels': {
'LABEL1 ':'VALUE1 ','LABEL2 ':'VALUE2 '
}
}" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID ?updateMask=notificationConfig,labels"
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID ",
"notificationConfig": {
"pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC "
},
"labels": {
"LABEL1 ":"VALUE1 ","LABEL2 ":"VALUE2 "
},
"version": "FHIR_STORE_VERSION "
}
PowerShell
FHIR 저장소를 수정하려면 PATCH
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
FHIR 저장소의 이름
업데이트할 메타데이터 이 예시에서는 Pub/Sub 주제의 정규화된 URI 및 쉼표로 구분된 키-값 쌍 목록으로 업데이트할 라벨입니다.
업데이트 마스크
액세스 토큰
다음 샘플은 Windows PowerShell을 사용한 PATCH
요청을 보여줍니다.
$cred = gcloud auth print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Patch `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-Body "{
'notificationConfig': {
'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC '
},
'labels': {
'LABEL1 ':'VALUE1 ','LABEL2 ':'VALUE2 '
}
}" `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/fhir_STORE_ID ?updateMask=notificationConfig,labels" | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /fhirStores/FHIR_STORE_ID ",
"notificationConfig": {
"pubsubTopic":
"projects/PROJECT_ID /topics/PUBSUB_TOPIC "
},
"labels": {
"LABEL1 ":"VALUE1 ","LABEL2 ":"VALUE2 "
},
"version": FHIR_STORE_VERSION
}
HL7v2 저장소 만들기 및 관리
HL7v2 저장소 만들기
HL7v2 저장소는 데이터 세트 내에 있으며 HL7v2 데이터를 보관합니다. projects.locations.datasets.hl7V2Stores.create
메서드를 사용하여 HL7v2 저장소를 만들 수 있습니다.
curl
HL7v2 저장소를 만들려면 POST
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
HL7v2 저장소의 이름입니다.
액세스 토큰
HL7v2 저장소 이름은 HL7v2 저장소의 상위 데이터 세트에서 고유해야 합니다. 이름은 숫자, 문자, 밑줄, 대시, 마침표로 이루어진 1~256자의 모든 유니코드 문자열일 수 있습니다.
Cloud Healthcare API가 HL7v2 저장소 변경사항의 알림을 보내는 하나 이상의 기존 Pub/Sub 주제 및 주제에 대한 필터를 선택적으로 구성할 수 있습니다.
Pub/Sub 주제를 지정할 때 다음 샘플과 같이 주제에 대해 한정된 URI를 입력합니다.
projects/PROJECT_ID /topics/PUBSUB_TOPIC
다음 샘플은 curl
을 사용하는 POST
요청을 보여줍니다.
curl -X POST \
--data "" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID "
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID "
}
PowerShell
HL7v2 저장소를 만들려면 POST
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
HL7v2 저장소의 이름입니다.
액세스 토큰
HL7v2 저장소 이름은 HL7v2 저장소의 상위 데이터 세트에서 고유해야 합니다. 이름은 숫자, 문자, 밑줄, 대시, 마침표로 이루어진 1~256자의 모든 유니코드 문자열일 수 있습니다.
Cloud Healthcare API가 HL7v2 저장소 변경사항의 알림을 보내는 하나 이상의 기존 Pub/Sub 주제 및 주제에 대한 필터를 선택적으로 구성할 수 있습니다.
Pub/Sub 주제를 지정할 때 다음 샘플과 같이 주제에 대해 한정된 URI를 입력합니다.
projects/PROJECT_ID /topics/PUBSUB_TOPIC
다음 샘플은 Windows PowerShell을 사용한 POST
요청을 보여줍니다.
$cred = gcloud auth print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Post `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID " | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID "
}
HL7v2 저장소 세부정보 가져오기
HL7v2 저장소에 대한 세부정보를 보고 projects.locations.datasets.hl7V2Stores.get
메서드를 사용하여 저장소가 생성되었는지 확인할 수 있습니다.
curl
HL7v2 저장소에 대한 세부정보를 가져오려면 GET
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
HL7v2 저장소의 이름
액세스 토큰
다음 샘플은 curl
을 사용하는 GET
요청을 보여줍니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID "
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID "
}
Hl7V2Store
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
PowerShell
HL7v2 저장소에 대한 세부정보를 가져오려면 GET
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
HL7v2 저장소의 이름
액세스 토큰
다음 샘플은 Windows PowerShell을 사용한 GET
요청을 보여줍니다.
$cred = gcloud auth print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Get `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID " | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID "
}
Hl7V2Store
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
HL7v2 저장소 업데이트
projects.locations.datasets.hl7V2Stores.patch
메서드를 사용하여 HL7v2 저장소를 업데이트할 수 있습니다.
다음 샘플은 HL7v2 저장소의 Pub/Sub 주제, 필터, 라벨을 업데이트하는 방법을 보여줍니다.
curl
HL7v2 저장소를 수정하려면 PATCH
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
HL7v2 저장소의 이름
업데이트할 메타데이터 이 샘플에서는 Pub/Sub 주제에 대한 정규화된 URI, 주제 필터, 쉼표로 구분된 키-값 쌍 목록으로 업데이트 할 라벨입니다.
업데이트 마스크
액세스 토큰
다음 샘플은 curl
을 사용하는 PATCH
요청을 보여줍니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data "{
'notificationConfigs': [
{
'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC ',
'filter': 'FILTER '
},
],
'labels': {
'LABEL1 ':'VALUE1 ','LABEL2 ':'VALUE2 '
}
}" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ?updateMask=notificationConfigs,labels"
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ",
"notificationConfigs": [
{
"pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC ",
"filter": "FILTER "
},
],
"labels": {
"LABEL1 ":"VALUE1 ","LABEL2 ":"VALUE2 "
}
}
PowerShell
HL7v2 저장소를 수정하려면 PATCH
요청을 실행합니다. 요청에 다음 정보를 제공합니다.
상위 데이터 세트의 이름
HL7v2 저장소의 이름
업데이트할 메타데이터 이 예시에서는 Pub/Sub 주제의 정규화된 URI, 주제 필터, 쉼표로 구분된 키-값 쌍의 목록으로 업데이트할 라벨입니다.
업데이트 마스크
액세스 토큰
다음 샘플은 Windows PowerShell을 사용한 PATCH
요청을 보여줍니다.
$cred = gcloud auth print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Patch `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-Body "{
'notificationConfigs': [
{
'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC ',
'filter': 'FILTER '
},
],
'labels': {
'LABEL1 ':'VALUE1 ','LABEL2 ':'VALUE2 '
}
}" `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/hl7v2_STORE_ID ?updateMask=notificationConfigs,labels" | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"name": "projects/PROJECT_ID /locations/REGION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ",
"notificationConfigs": [
{
"pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC ",
"filter": "FILTER "
},
],
"labels": {
"LABEL1 ":"VALUE1 ","LABEL2 ":"VALUE2 "
}
}
정리
이 가이드에 사용된 리소스의 비용이 Google Cloud 계정에 청구되지 않도록 Google Cloud에서 만든 리소스를 삭제할 수 있습니다.
이 가이드용으로 새 프로젝트를 만든 경우 프로젝트 삭제 단계를 수행합니다. 그렇지 않으면 데이터 세트 삭제 단계를 수행합니다.
프로젝트 삭제
Cloud Console에서 리소스 관리 페이지로 이동합니다.
리소스 관리로 이동
프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제 를 클릭합니다.
대화상자에서 프로젝트 ID를 입력한 후 종료 를 클릭하여 프로젝트를 삭제합니다.
데이터 세트 삭제
이 빠른 시작에서 만든 데이터 세트가 더 이상 필요하지 않으면 삭제할 수 있습니다. 데이터 세트를 삭제하면 데이터 세트 및 데이터 세트에 포함된 모든 FHIR, HL7v2 또는 DICOM 저장소가 영구적으로 삭제됩니다.
curl
데이터 세트를 삭제하려면 데이터 세트 이름과 액세스 토큰을 제공하여 DELETE
요청을 수행합니다. 다음 샘플은 curl
을 사용하는 DELETE
요청을 보여줍니다.
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{}
PowerShell
데이터 세트를 삭제하려면 데이터 세트 이름과 액세스 토큰을 제공하여 DELETE
요청을 수행합니다. 다음 샘플은 Windows PowerShell을 사용한 DELETE
요청을 보여줍니다.
$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Delete `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID " | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{}
다음 단계