이 페이지에서는 Digital Imaging and Communications in Medicine(DICOM) 저장소를 생성, 수정, 확인, 나열, 삭제하는 방법을 설명합니다.
DICOM 저장소에는 DICOM 인스턴스가 포함됩니다. Cloud Healthcare API의 DICOMweb 구현을 사용하여 DICOM 저장소에서 DICOM 인스턴스를 추가하고 관리하거나 Google Cloud 서비스를 사용하여 DICOM 인스턴스를 가져오고 내보낼 수 있습니다.
Cloud Healthcare API가 DICOM 표준을 준수하는 방법에 대한 자세한 내용은 DICOM 규정 준수 설명을 참조하세요.
DICOM 저장소 만들기
DICOM 저장소를 만들기 전에 데이터 세트를 생성해야 합니다.
다음 샘플은 DICOM 저장소를 만드는 방법을 보여줍니다.
Console
DICOM 저장소를 만드는 방법은 다음과 같습니다.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- DICOM 저장소를 만들 데이터 세트를 선택합니다.
- 데이터 스토어 만들기를 클릭합니다.
- DICOM을 데이터 스토어 유형으로 선택합니다.
- 데이터 세트에서 사용자가 선택한 고유한 이름을 입력합니다. 이름이 고유하지 않으면 데이터 스토어 만들기가 실패합니다.
- 다음을 클릭합니다.
-
데이터 스토어에 대해 Pub/Sub 주제를 구성하려면 Cloud Pub/Sub 알림 수신을 클릭하고 주제 이름을 선택합니다.
Pub/Sub 주제를 지정할 때 다음 샘플과 같이 주제에 대해 정규화된 URI를 입력합니다.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- 다음을 클릭합니다.
- 저장소에 라벨을 한 개 이상 추가하려면 라벨을 추가하여 데이터 스토어 정리를 클릭하고 키/값 라벨을 입력합니다. 리소스 라벨에 대한 자세한 내용은 리소스 라벨 사용을 참조하세요.
- 만들기를 클릭합니다.
새 데이터 스토어가 목록에 표시됩니다.
gcloud
DICOM 저장소를 만들려면 gcloud healthcare dicom-stores create
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
LOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소의 식별자. DICOM 저장소 ID는 다음을 포함해야 합니다.- 데이터 세트의 고유 ID
- 다음으로 구성된 1~256자의 유니코드 문자열:
- 숫자
- 편지
- 밑줄
- 대시
- 마침표
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare dicom-stores create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores create DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores create DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
다음과 비슷한 응답이 표시됩니다.
응답
Created dicomStore [DICOM_STORE_ID].
REST
DICOM 저장소를 만들려면 projects.locations.datasets.dicomStores.create
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소의 식별자. DICOM 저장소 ID는 다음을 포함해야 합니다.- 데이터 세트의 고유 ID
- 다음으로 구성된 1~256자의 유니코드 문자열:
- 숫자
- 편지
- 밑줄
- 대시
- 마침표
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
Go
Java
Node.js
Python
DICOM 저장소 수정
다음 샘플은 DICOM 저장소에 다음 변경 사항을 적용하는 방법을 보여줍니다.
- Cloud Healthcare API가 DICOM 저장소 변경사항의 알림을 보내는 Pub/Sub 주제를 수정합니다.
- 라벨을 수정합니다. 라벨은 Google Cloud 리소스를 구성하는 데 도움이 되는 키-값 쌍입니다.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
DICOM 저장소를 수정하려면 다음 단계를 완료하세요.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 수정할 DICOM 저장소가 포함된 데이터 세트를 선택합니다.
- 데이터 스토어 목록에서 수정할 데이터 스토어를 클릭합니다.
- 데이터 스토어에 대한 Pub/Sub 주제를 구성하려면 Cloud Pub/Sub 주제 선택에서 주제 이름을 선택합니다.
- 저장소에 라벨을 하나 이상 추가하려면 리소스 라벨 사용을 참조하세요. 라벨, 라벨 추가를 차례로 클릭하고 키/값 라벨을 입력합니다. 리소스 라벨에 대한 자세한 내용은
- 저장을 클릭합니다.
gcloud
DICOM 저장소를 수정하려면 gcloud healthcare dicom-stores update
명령어를 실행합니다.
gcloud CLI에서는 라벨 수정을 지원하지 않습니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
LOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 IDPUBSUB_TOPIC
: 데이터 스토어에서 이벤트가 발생할 때 메시지가 게시되는 Pub/Sub 주제
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows(PowerShell)
gcloud healthcare dicom-stores update DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows(cmd.exe)
gcloud healthcare dicom-stores update DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
다음과 비슷한 응답이 표시됩니다.
응답
Updated dicomStore [DICOM_STORE_ID]. ... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC
REST
DICOM 저장소를 수정하려면 projects.locations.datasets.dicomStores.patch
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 IDPUBSUB_TOPIC
: 데이터 스토어에서 이벤트가 발생할 때 메시지가 게시되는 Pub/Sub 주제KEY_1
: 첫 번째 라벨 키VALUE_1
: 첫 번째 라벨 값KEY_2
: 두 번째 라벨 키VALUE_2
: 두 번째 라벨 값
JSON 요청 본문:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장합니다.
터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels"
PowerShell
요청 본문을 request.json
파일에 저장합니다.
터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
API 탐색기
요청 본문을 복사하고 메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 요청 본문을 이 도구에 붙여넣고 다른 필수 필드를 입력한 후 실행을 클릭합니다.
다음과 비슷한 응답이 표시됩니다.
DicomStore
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
Go
Java
Node.js
Python
DICOM 스토어 세부정보 가져오기
다음 샘플은 DICOM 저장소에 대한 세부정보를 가져오는 방법을 보여줍니다.
Console
DICOM 스토어의 세부정보를 보려면 다음을 실행합니다.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 보려는 DICOM 저장소가 포함된 데이터 세트를 선택합니다.
- DICOM 저장소의 이름을 클릭합니다.
개요 탭에는 선택한 DICOM 저장소의 세부정보가 표시됩니다. 측정항목 탭에는 DICOM 저장소, DICOM 연구, DICOM 시리즈 측정항목이 표시됩니다. 자세한 내용은 DICOM 저장소, DICOM 연구, DICOM 시리즈 측정항목 보기를 참조하세요.
gcloud
DICOM 저장소에 대한 세부정보를 가져오려면 gcloud healthcare dicom-stores describe
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 ID
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
다음과 비슷한 응답이 표시됩니다.
DicomStore
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
응답
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
DICOM 저장소에 대한 세부정보를 가져오려면 projects.locations.datasets.dicomStores.get
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 ID
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
다음 명령어를 실행합니다.
$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/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 응답이 표시됩니다.
DicomStore
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
Go
Java
Node.js
Python
데이터 세트의 DICOM 저장소 나열
다음 샘플은 데이터 세트의 DICOM 저장소를 나열하는 방법을 보여줍니다.
Console
데이터 세트의 데이터 스토어를 보려면 다음 안내를 따르세요.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 보려는 데이터 스토어가 포함된 데이터 세트를 선택합니다.
gcloud
데이터 세트의 DICOM 저장소를 나열하려면 gcloud healthcare dicom-stores list
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare dicom-stores list \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores list ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores list ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
다음과 비슷한 응답이 표시됩니다.
DicomStore
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
데이터 세트의 DICOM 저장소를 나열하려면 projects.locations.datasets.dicomStores.list
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores"
PowerShell
다음 명령어를 실행합니다.
$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/LOCATION/datasets/DATASET_ID/dicomStores" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 응답이 표시됩니다.
DicomStore
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
Go
Java
Node.js
Python
DICOM 저장소 삭제
다음 샘플은 DICOM 저장소 삭제 방법을 보여줍니다.
Console
데이터 스토어를 삭제하려면 다음 안내를 따르세요.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 삭제할 데이터 스토어가 포함된 데이터 세트를 선택합니다.
- 삭제할 데이터 스토어의 작업 드롭다운 목록에서 삭제를 선택합니다.
- 확인하려면 데이터 스토어 이름을 입력한 다음 삭제를 클릭합니다.
gcloud
DICOM 저장소를 삭제하려면 gcloud healthcare dicom-stores delete
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
LOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 ID
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID].
REST
DICOM 저장소를 삭제하려면 projects.locations.datasets.dicomStores.delete
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 ID
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth 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/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.