이 페이지에서는 Cloud Healthcare API의 DICOMweb 구현을 사용하여 DICOM 이미지 데이터를 저장 및 관리합니다.
Cloud Healthcare API가 여러 DICOMweb REST 서비스를 구현하는 방법에 대한 자세한 내용은 DICOM 적합성 명세를 참조하세요.
Cloud Healthcare API의 DICOM 웹 구현은 RPC가 아닌 REST만 지원합니다.
Cloud Healthcare API DICOMweb CLI 설치
이 페이지의 일부 샘플에는 DICOMweb 서버와의 상호작용 방법을 단순화하는 오픈소스 도구인 Cloud Healthcare API DICOMweb CLI가 사용됩니다. 이 도구는 DICOM 파일 저장, 검색, 삭제, 검색을 위한 기능을 제공합니다. 이 도구의 GitHub 페이지에는 세부 설치 요구사항 및 도구 맞춤설정 방법과 같은 추가 정보가 포함되어 있습니다.
이 도구는 Python을 사용하여 실행됩니다. Google Cloud에서 Python을 설정하는 방법에 대한 자세한 내용은 Python 개발 환경 설정을 참조하세요.
Python을 설정한 후에는 PIP를 사용해서 도구를 설치할 수 있습니다.
pip install https://github.com/GoogleCloudPlatform/healthcare-api-dicomweb-cli/archive/v1.0.zip
이 도구를 사용하려면 Google Cloud 서버로 인증해야 합니다. 이를 위해서는 다음 방법 중 하나를 사용하면 됩니다.
GOOGLE_APPLICATION_CREDENTIALS
환경 변수 설정gcloud auth application-default login
를 사용하여 Google Cloud CLI를 통해 인증
이러한 옵션을 구성하면 도구가 사용자 인증 정보를 자동으로 검색합니다.
DICOM 데이터 저장
DICOM 데이터를 저장하려면 먼저 DICOM 저장소를 만들어야 합니다.
Cloud Healthcare API는 DICOM 데이터를 저장할 때 저장소 트랜잭션 RESTful 웹 서비스를 구현합니다. 자세한 내용은 Cloud Healthcare API DICOM 적합성 명세에서 저장소 트랜잭션을 참조하세요.
다음 방법을 사용하여 DICOM 데이터를 저장할 수 있습니다. 두 경우 모두 해당 요청에 application/dicom
Accept 헤더를 전달해야 합니다.
- DICOM 인스턴스(일반적으로
.dcm
파일)를 저장합니다. JPEG 파일로 DICOM JSON 메타데이터를 저장합니다.
JPEG 파일로 DICOM JSON 메타데이터를 저장하기 위한 모든 요청은
Content-Type
의multipart/related
부분으로 지정되는 멀티파트 메시지입니다.Content-Type
의multipart/related
부분은 요청이 요청 완료 후 조합되는 여러 데이터 부분으로 구성되었음을 나타냅니다.Content-Type
의boundary
부분으로 지정된 대로 경계를 사용하여 이러한 각 데이터 세트를 구분해야 합니다.
SOP_CLASS_UID
, SOP_INSTANCE_UID
, STUDY_INSTANCE_UID
, SERIES_INSTANCE_UID
값은 제공된 메타데이터로부터 채워집니다. UID는 다음 요구사항을 충족해야 합니다.
- 마침표로 구분된 숫자 값만 포함합니다.
- 보호 건강 정보(PHI)를 포함하지 않습니다.
다음 샘플은 DICOM 저장소에 인스턴스를 저장하는 방법을 보여줍니다. 자세한 내용은 projects.locations.datasets.dicomStores.storeInstances
를 참조하세요.
DICOM 인스턴스 저장
다음 샘플은 DICOM 인스턴스를 저장하는 방법을 보여줍니다. 자세한 내용은 projects.locations.datasets.dicomStores.storeInstances
를 참조하세요.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 IDDICOM_INSTANCE_FILE
: 로컬 머신에 있는 DICOM 인스턴스 파일의 경로로,.dcm
접미사로 끝납니다.
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/dicom" \
--data-binary @DICOM_INSTANCE_FILE \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-InFile DICOM_INSTANCE_FILE `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies" | Select-Object -Expand Content
Go
Java
Node.js
Python
DICOM 인스턴스를 저장할 스토리지 클래스 지정(미리보기)
기본적으로 projects.locations.datasets.dicomStores.storeInstances
메서드는 Standard Storage 클래스를 사용하여 DICOM 인스턴스를 DICOM 저장소에 저장합니다. 로컬 머신에서 DICOM 객체를 저장할 때 스토리지 클래스를 설정할 수 있습니다.
자세한 내용은 DICOM 스토리지 클래스 변경을 참조하세요.
다음 샘플은 로컬 머신에서 DICOM 객체를 저장할 때 스토리지 클래스를 지정하는 방법을 보여줍니다.
curl
projects.locations.datasets.dicomStores.storeInstances
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 IDDICOM_INSTANCE_FILE
: 로컬 머신에 있는 DICOM 인스턴스 파일의 경로로,.dcm
접미사로 끝납니다.STORAGE_CLASS
:STANDARD
,NEARLINE
,COLDLINE
,ARCHIVE
의 DICOM 저장소에 있는 DICOM 인스턴스의 스토리지 클래스입니다.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/dicom" \ -H "Storage-Class: STORAGE_CLASS" --data-binary @DICOM_INSTANCE_FILE \ "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies"
요청이 성공하면 서버는 다음 응답을 반환합니다.
<NativeDicomModel> <DicomAttribute tag="00081190" vr="UR" keyword="RetrieveURL"> <Value number="1">https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID</Value> </DicomAttribute> <DicomAttribute tag="00081199" vr="SQ" keyword="ReferencedSOPSequence"> <Item number="1"> <DicomAttribute tag="00081150" vr="UI" keyword="ReferencedSOPClassUID"> <Value number="1">SOP_CLASS_UID</Value> </DicomAttribute> <DicomAttribute tag="00081155" vr="UI" keyword="ReferencedSOPInstanceUID"> <Value number="1">SOP_INSTANCE_UID</Value> </DicomAttribute> <DicomAttribute tag="00081190" vr="UR" keyword="RetrieveURL"> <Value number="1">https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID</Value> </DicomAttribute> </Item> </DicomAttribute> </NativeDicomModel>
PowerShell
projects.locations.datasets.dicomStores.storeInstances
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 IDDICOM_INSTANCE_FILE
: 로컬 머신에 있는 DICOM 인스턴스 파일의 경로로,.dcm
접미사로 끝납니다.STORAGE_CLASS
:STANDARD
,NEARLINE
,COLDLINE
,ARCHIVE
의 DICOM 저장소에 있는 DICOM 인스턴스의 스토리지 클래스입니다.
$cred = gcloud auth application-default print-access-token $headers = @{ "Authorization" = "Bearer $cred"; "Storage-Class" = "STORAGE_CLASS" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/dicom" ` -InFile DCM_FILE.dcm ` -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies" | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
<NativeDicomModel> <DicomAttribute tag="00081190" vr="UR" keyword="RetrieveURL"> <Value number="1">https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID</Value> </DicomAttribute> <DicomAttribute tag="00081199" vr="SQ" keyword="ReferencedSOPSequence"> <Item number="1"> <DicomAttribute tag="00081150" vr="UI" keyword="ReferencedSOPClassUID"> <Value number="1">SOP_CLASS_UID</Value> </DicomAttribute> <DicomAttribute tag="00081155" vr="UI" keyword="ReferencedSOPInstanceUID"> <Value number="1">SOP_INSTANCE_UID</Value> </DicomAttribute> <DicomAttribute tag="00081190" vr="UR" keyword="RetrieveURL"> <Value number="1">https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID</Value> </DicomAttribute> </Item> </DicomAttribute> </NativeDicomModel>
JSON 메타데이터 및 JPEG 이미지에서 DICOM 인스턴스 만들기
Cloud Healthcare API는 JSON 메타데이터 파일 및 JPEG 파일을 사용하여 DICOM 인스턴스를 만들 수 있습니다. Cloud Healthcare API로 수행할 수 있으므로, DICOM 파싱 및 직렬화를 직접 수행하지 않으려면 JSON 메타데이터 및 JPEG 파일에서 DICOM 인스턴스를 만듭니다.
이 데이터를 저장하는 HTTP 요청에는 요청의 Content-Type
에 다음이 포함되어야 합니다.
multipart/related
미디어 유형- MIME 유형
application/dicom+json
boundary
구분 기호
다음 샘플은 JPEG 파일로 JSON 메타데이터 파일을 저장하는 방법을 보여줍니다.
curl
다음 샘플은 기존 JPEG 이미지가 있다고 가정합니다.
JPEG 이미지로 JSON 메타데이터 파일을 저장하는 작업은 다음 세 가지 단계로 구성됩니다.
- JPEG 이미지가 포함된 DICOM 인스턴스의 JSON 표현이 포함된 파일을 만듭니다. 템플릿 파일은 아래에 제공됩니다.
3개의 경계 파일을 만듭니다.
opening.file
: JSON 메타데이터 파일의 시작 경계를 포함합니다.middle.file
: JPEG 이미지의 중간 경계를 포함합니다.closing.file
: 메시지의 모든 부분에 대한 종료 경계를 포함합니다.
경계 파일 내에서 JSON 메타데이터 파일 및 JPEG 이미지를 묶어서
multipart-request.file
이라는 파일을 만듭니다.
JSON 메타데이터 템플릿 파일에 기본적으로 제공되는 다음 값을 확인합니다.
- 전송 구문 UID(
1.2.840.10008.1.2.4.50
)는 전송 구문을 JPEG 기준으로 지정합니다. 대부분의 JPEG 이미지는 JPEG 기준 형식입니다. 사진 해석 값(YBR_FULL_422
)은 이미지가 그레이 스케일이 아닌 컬러라는 것을 나타냅니다. BulkDataUri
는 이미지의 임의 설명자이고, 템플릿에서jpeg-image
로 설정됩니다. 이 값은 이미지 경계를 만들 때 사용됩니다.
SOP_CLASS_UID, SOP_INSTANCE_UID, STUDY_INSTANCE_UID, SERIES_INSTANCE_UID 값은 마침표로 구분된 숫자 값일 수 있습니다. DICOM은 인스턴스, 환자, 연구, 시리즈에 대해 식별자 계층을 사용하므로, 이러한 변수에 대해 논리적인 식별자 세트를 선택합니다.
SOP Class UID를 저장되는 이미지 유형을 지정하는 표준 SOP 클래스 테이블의 값으로 바꿉니다.
Rows를 JPEG 이미지의 세로 높이(픽셀)로 바꿉니다. Columns를 JPEG 이미지의 가로 너비(픽셀)로 바꿉니다.
다음 단계를 완료합니다.
다음 텍스트를
instance.json
이라는 파일에 저장하고, 지정된 경우 변수를 바꿉니다.[{ "00020010":{"vr":"UI","Value":["1.2.840.10008.1.2.4.50"]}, "00080005":{"vr":"CS","Value":["ISO_IR 192"]}, "00080016":{"vr":"UI","Value":["SOP_CLASS_UID"]}, "00080018":{"vr":"UI","Value":["SOP_INSTANCE_UID"]}, "0020000D":{"vr":"UI","Value":["STUDY_INSTANCE_UID"]}, "0020000E":{"vr":"UI","Value":["SERIES_INSTANCE_UID"]}, "00280002":{"vr":"US","Value":[3]}, "00280004":{"vr":"CS","Value":["YBR_FULL_422"]}, "00280006":{"vr":"US","Value":[0]}, "00280008":{"vr":"IS","Value":[1]}, "00280010":{"vr":"US","Value":[Rows]}, "00280011":{"vr":"US","Value":[Columns]}, "00280100":{"vr":"US","Value":[8]}, "00280101":{"vr":"US","Value":[8]}, "00280102":{"vr":"US","Value":[7]}, "00280103":{"vr":"US","Value":[0]}, "7FE00010":{"vr":"OB","BulkDataURI":"jpeg-image"} }]
시작(JSON 메타데이터), 중간(JPEG 이미지), 종료 경계를 만들기 위해 다음 명령어를 실행합니다.
echo -ne "--DICOMwebBoundary\r\nContent-Type: application/dicom+json\r\n\r\n" > opening.file echo -ne "\r\n--DICOMwebBoundary\r\nContent-Location: jpeg-image\r\nContent-Type: image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50\r\n\r\n" > middle.file echo -ne "\r\n--DICOMwebBoundary--" > closing.file
중간 및 종료 경계 내에서 JPEG 이미지를 래핑합니다. Cloud Healthcare API로 전송하는 출력 파일은
multipart-request.file
이라고 부릅니다.cat opening.file instance.json middle.file image.jpg closing.file > multipart-request.file
POST
요청을 수행하고 다음 정보를 지정합니다.- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
multipart-request.file
파일- 액세스 토큰
다음 샘플은 curl
을 사용하는 POST
요청을 보여줍니다.
curl -X POST \ -H "Content-Type: multipart/related; type=\"application/dicom+json\"; boundary=DICOMwebBoundary" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies \ --data-binary @multipart-request.file
요청이 성공하면 서버가 XML 형식으로 응답을 반환합니다.
<NativeDicomModel> <DicomAttribute tag="00081190" vr="UR" keyword="RetrieveURL"> <Value number="1">https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID</Value> </DicomAttribute> <DicomAttribute tag="00081199" vr="SQ" keyword="ReferencedSOPSequence"> <Item number="1"> <DicomAttribute tag="00081150" vr="UI" keyword="ReferencedSOPClassUID"> <Value number="1">SOP_CLASS_UID</Value> </DicomAttribute> <DicomAttribute tag="00081155" vr="UI" keyword="ReferencedSOPInstanceUID"> <Value number="1">SOP_INSTANCE_UID</Value> </DicomAttribute> <DicomAttribute tag="00081190" vr="UR" keyword="RetrieveURL"> <Value number="1">https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID</Value> </DicomAttribute> </Item> </DicomAttribute> </NativeDicomModel>
DICOMweb CLI 사용
다음 샘플은 Cloud Healthcare API DICOMweb CLI를 사용하여 하나 이상의 DICOM 인스턴스를 저장하는 방법을 보여줍니다. DICOMweb CLI GitHub 저장소에는 사용 가능한 샘플이 더 있습니다.
단일 DICOM 인스턴스 저장:
dcmweb \ https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb \ store DCM_FILE
요청이 성공하면 서버가 다음 샘플과 비슷한 응답을 반환합니다.
TIMESTAMP -- DCM_FILE.dcm uploaded as https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID TIMESTAMP -- INSTANCE_UID TIMESTAMP -- Transferred SIZE in COUNT files
와일드 카드를 사용하여 여러 파일을 병렬로 저장:
다음 샘플은 현재 작동 중인 디렉터리에서 여러 DICOM 파일을 병렬로 반복해서 저장하는 방법을 보여줍니다. 파일을 병렬로 저장하려면 -m
플래그를 추가합니다.
dcmweb -m \ https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb \ store "./**.dcm"
요청이 성공하면 서버가 다음 샘플과 비슷한 응답을 반환합니다.
TIMESTAMP -- DCM_FILE_1.dcm uploaded as https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID TIMESTAMP -- INSTANCE_UID TIMESTAMP -- DCM_FILE_2.dcm uploaded as https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID TIMESTAMP -- INSTANCE_UID TIMESTAMP -- DCM_FILE_3.dcm uploaded as https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID TIMESTAMP -- INSTANCE_UID ... TIMESTAMP -- Transferred SIZE in COUNT files
DICOM 데이터 검색
연구, 시리즈, 인스턴스, 프레임을 검색할 수 있습니다. 다음 샘플은 DICOM 저장소에서 인스턴스를 검색하기 위한 검색 트랜잭션의 구현을 보여줍니다. 자세한 내용은 Cloud Healthcare API DICOM 적합성 명세에서 검색 트랜잭션을 참조하세요.
다음 샘플은 DICOM 저장소에서 인스턴스 검색 방법을 보여줍니다. 자세한 내용은 projects.locations.datasets.dicomStores.searchForInstances
를 참조하세요.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
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/dicomWeb/instances"
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/dicomWeb/instances" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
Go
Java
Node.js
Python
DICOM 태그를 사용하여 검색
쿼리 매개변수 형식으로 요청에 DICOM 태그를 추가하여 검색을 미세 조정할 수 있습니다. 예를 들어 환자 이름이 포함된 연구를 검색해야 할 수 있습니다.
앞의 샘플에서와 같이 다음 샘플은 DICOM 저장소에서 연구를 검색하기 위한 검색 트랜잭션 구현을 보여줍니다. 하지만 이 샘플은 환자 이름이 'Sally Zhang'인 연구를 검색하는 방법을 보여줍니다.
다음 샘플은 환자 이름이 나열된 DICOM 인스턴스의 메타데이터 부분을 보여줍니다.
...
{
"vr": "PN",
"Value": [
{
"Alphabetic": "Sally Zhang"
}
]
}
...
DICOM 저장소에서 환자와 관련된 연구를 검색하려면 PatientName
DICOM 태그로 검색하는 요청에 쿼리 매개변수를 추가합니다.
Cloud Healthcare API에서 지원되는 검색 매개변수 목록을 보려면 검색 트랜잭션 문서를 참조하세요.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
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/dicomWeb/studies?PatientName=Sally%20Zhang"
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/dicomWeb/studies?PatientName=Sally%20Zhang" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
Go
Java
Node.js
Python
DICOMweb CLI 사용
다음 샘플은 Cloud Healthcare API DICOMweb CLI를 사용하여 DICOM 저장소에서 인스턴스를 검색하는 방법을 보여줍니다. 검색 필터링 방법을 포함하여 DICOMweb CLI GitHub 저장소에서 사용 가능한 샘플이 더 있습니다.
dcmweb \ https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb \ search instances
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
[ { "00080005":{ "vr":"CS", "Value":[ "CODE_STRING" ] }, "00080016":{ "vr":"UI", "Value":[ "UNIQUE_IDENTIFIER" ] }, "00080018":{ "vr":"UI", "Value":[ "UNIQUE_IDENTIFIER" ] }, "00080020":{ "vr":"DA", "Value":[ "DATE_TIME" ] }, "00080030":{ "vr":"TM", "Value":[ "TIME" ] }, "00080060":{ "vr":"CS", "Value":[ "CODE_STRING" ] }, "0008103E":{ "vr":"LO", "Value":[ "LONG_STRING" ] }, "00100010":{ "vr":"PN", "Value":[ { "Alphabetic":"Anonymized" } ] }, }, ... ]
DICOM 데이터 검색
Cloud Healthcare API는 DICOM 저장소에서 연구, 시리즈, 인스턴스, 프레임을 검색하기 위해 검색 트랜잭션을 구현합니다.
자세한 내용은 Cloud Healthcare API DICOM 적합성 명세에서 검색 트랜잭션을 참조하세요.
연구 검색
다음 샘플은 연구를 검색하는 방법을 보여줍니다. 자세한 내용은 Cloud Healthcare API DICOM 적합성 명세에서 DICOM 연구/시리즈/인스턴스를 참조하세요.
출력 파일을 지정할 때 .multipart
와 같은 확장자를 사용합니다. 그런 후 멀티파트 파일을 파싱하여 연구에서 개별 시리즈 및 인스턴스를 가져옵니다.
자세한 내용은 projects.locations.datasets.dicomStores.studies.retrieveStudy
를 참조하세요.
curl
연구를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 출력 파일
- 액세스 토큰
다음 샘플은 curl
을 사용하는 GET
요청을 보여줍니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Accept: multipart/related; type=application/dicom; transfer-syntax=*" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID" \ --output FILENAME.multipart
요청이 성공하면 DICOM 파일이 머신에 기록됩니다.
PowerShell
연구를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 출력 파일
- 액세스 토큰
다음 샘플은 Windows PowerShell을 사용한 GET
요청을 보여줍니다.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred"; Accept = "multipart/related; type=application/dicom; transfer-syntax=*" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID" | Select-Object -Expand Content -OutFile FILENAME.multipart `
요청이 성공하면 DICOM 파일이 머신에 기록됩니다.
Go
Java
Node.js
Python
인스턴스 검색
다음 샘플은 인스턴스 검색 방법을 보여줍니다. 자세한 내용은 Cloud Healthcare API DICOM 적합성 명세에서 DICOM 인스턴스를 참조하세요.
인스턴스를 검색할 때 Accept: application/dicom
HTTP 헤더를 사용하면 멀티파트 경계를 파싱할 필요가 없습니다. transfer-syntax=*
를 추가하면 원래 저장된 형식으로 파일을 반환하여 트랜스코딩이 필요하지 않습니다.
자세한 내용은 projects.locations.datasets.dicomStores.studies.series.instances.retrieveInstance
를 참조하세요.
curl
인스턴스를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 시리즈 UID, 인스턴스 UID
- 출력 파일 이름
- 액세스 토큰
다음 샘플은 curl
을 사용하는 GET
요청을 보여줍니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Accept: application/dicom; transfer-syntax=*" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID" \ --output FILENAME.dcm
요청이 성공하면 DICOM 파일이 머신에 기록됩니다.
PowerShell
인스턴스를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 시리즈 UID
- 인스턴스 UID
- 출력 파일 이름
- 액세스 토큰
다음 샘플은 Windows PowerShell을 사용한 GET
요청을 보여줍니다.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred"; Accept = "application/dicom; transfer-syntax=*" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID" -OutFile FILENAME.dcm `
요청이 성공하면 DICOM 파일이 머신에 기록됩니다.
Go
Java
Node.js
Python
소비자 이미지 형식 검색
다음 샘플은 렌더링된 리소스에 대한 Cloud Healthcare API 구현을 사용하여 JPEG 또는 PNG와 같은 소비자 이미징 형식을 검색하는 방법을 보여줍니다. 자세한 내용은 Cloud Healthcare API DICOM 적합성 명세에서 렌더링된 리소스를 참조하세요.
자세한 내용은 projects.locations.datasets.dicomStores.studies.series.instances.retrieveRendered
를 참조하세요.
curl
이미지를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 시리즈 UID
- 인스턴스 UID
- 출력 파일 이름
- 액세스 토큰
다음 샘플에서는 curl
을 사용하여 GET
요청으로 PNG 이미지를 검색하는 방법을 보여줍니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Accept: image/png" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/rendered" \ --output FILENAME.png
요청이 성공하면 PNG 파일이 머신에 기록됩니다.
PowerShell
이미지를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 시리즈 UID
- 인스턴스 UID
- 출력 파일 이름
- 액세스 토큰
다음 샘플은 Windows PowerShell을 사용하여 GET
요청으로 PNG 이미지를 검색하는 방법을 보여줍니다.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred"; Accept = "image/png" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/rendered" -OutFile FILENAME.png `
요청이 성공하면 PNG 파일이 머신에 기록됩니다.
Go
Java
Node.js
Python
메타데이터 검색
연구 또는 시리즈에서 모든 인스턴스에 대해 메타데이터를 검색할 수 있습니다. 다음 샘플은 인스턴스에 대해 메타데이터를 검색하는 방법을 보여줍니다. 자세한 내용은 Cloud Healthcare API DICOM 적합성 명세에서 메타데이터 리소스를 참조하세요.
자세한 내용은 projects.locations.datasets.dicomStores.studies.series.instances.retrieveMetadata
를 참조하세요.
retrieveMetadata
를 호출하면 includefield=all
쿼리 매개변수로 인스턴스를 검색할 때 반환되는 것과 동일한 필드 집합이 메서드로 반환됩니다. 애플리케이션이 지연 시간에 민감하고 모든 필드 대신 특정 필드 집합에 대해 메타데이터를 검색하려는 경우에는 retrieveMetadata
를 호출하지 마세요. 대신 searchForInstances
메서드 중 하나를 호출하고 필드를 지정합니다. 더 작은 필드 집합이 응답되고 작은 필드 집합은 지연 시간에 민감한 애플리케이션에 도움이 됩니다.
retrieveMetadata
는 기본적으로 JSON 응답을 반환합니다. XML 응답을 반환하려면 요청에 Accept: multipart/related; type="application/dicom+xml"
HTTP 헤더를 전달합니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 IDSTUDY_INSTANCE_UID
: 연구 인스턴스 고유 식별자SERIES_INSTANCE_UID
: 시리즈 인스턴스 고유 식별자INSTANCE_UID
: 인스턴스 고유 식별자
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
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/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/metadata"
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/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/metadata" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
일괄 데이터 검색
저장된 인스턴스에서 특정 일괄 데이터 태그에 대해 원시 바이트를 검색할 수 있습니다. 미리보기 메서드를 사용해서 인스턴스에서 메타데이터를 검색할 때 지원되는 일괄 데이터 태그에 대해 BulkDataURI가 생성됩니다(일괄 데이터 정의 참조).
자세한 내용은 projects.locations.datasets.dicomStores.studies.series.instances.bulkdata.retrieveBulkdata
를 참조하세요.
다음 예시에서는 일괄 데이터 태그의 알려진 경로를 기반으로 요청 URL을 직접 만듭니다(BulkDataURI를 가져오기 위한 retrieveMetadata
사용 제외).
curl
일괄 데이터를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 시리즈 UID
- 인스턴스 UID
- 타겟 일괄 데이터 태그의 경로
- 색인 i에서 시퀀스(YYYY,YYYY) 내의 태그(XXXX,XXXX)의 경우 경로가 "YYYYYYYY/i/XXXXXXXX"입니다.
- 출력 파일 이름
- 액세스 토큰
다음 샘플은 curl
을 사용해서 GET
요청으로 DAT 파일을 검색하는 방법을 보여줍니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Accept: application/octet-stream; transfer-syntax=*" \ "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/bulkdata/BULKDATA_PATH" \ --output FILENAME.dat
요청이 성공하면 인스턴스의 원시 바이트가 포함된 DAT 파일이 머신에 기록됩니다.
PowerShell
일괄 데이터를 검색하려면 GET
요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- DICOM 저장소의 이름
- 연구 고유 식별자(UID)
- 시리즈 UID
- 인스턴스 UID
- 타겟 일괄 데이터 태그의 경로
- 색인 i에서 시퀀스(YYYY,YYYY) 내의 태그(XXXX,XXXX)의 경우 경로가 "YYYYYYYY/i/XXXXXXXX"입니다.
- 출력 파일 이름
- 액세스 토큰
다음 샘플은 Windows PowerShell을 사용해서 GET
요청으로 DAT 파일을 검색하는 방법을 보여줍니다.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred"; Accept = "application/octet-stream; transfer-syntax=*" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/bulkdata/BULKDATA_PATH" -OutFile FILENAME.DAT `
요청이 성공하면 인스턴스의 원시 바이트가 포함된 DAT 파일이 머신에 기록됩니다.
DICOMweb CLI 사용
다음 샘플에서는 Cloud Healthcare API DICOMweb CLI를 사용하여 DICOM 저장소에서 모든 인스턴스를 검색하고 머신에서 현재 작업 디렉터리에 저장하는 방법을 보여줍니다. DICOMweb CLI GitHub 저장소에는 사용 가능한 샘플이 더 있습니다.
dcmweb \ https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb \ retrieve
요청이 성공하면 서버가 다음과 비슷한 응답을 반환하고 DICOM 파일이 머신에 기록됩니다.
TIMESTAMP -- Saving files into ./ TIMESTAMP -- Transferred SIZE in COUNT files
연구, 시리즈, 인스턴스 삭제
Cloud Healthcare API는 DICOM 연구, 시리즈, 인스턴스를 삭제하기 위한 독점 웹 서비스를 구현합니다. 이 서비스는 DICOMweb 표준 서비스의 일부가 아닙니다. 자세한 내용은 Cloud Healthcare API DICOM 적합성 문의 삭제 섹션을 참조하세요.
연구 및 시리즈의 삭제 요청은 장기 실행 작업을 반환합니다. 작업이 완료되면 연구 또는 시리즈의 모든 인스턴스가 삭제됩니다.
인스턴스의 삭제 요청은 장기 실행 작업을 반환하지 않으며 대신 다음과 같이 빈 응답 본문을 반환합니다.
{}
다음 샘플은 DICOM 연구를 삭제하는 방법을 보여줍니다. 자세한 내용은 projects.locations.datasets.dicomStores.studies.delete
를 참조하세요.
REST
연구를 삭제합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트DICOM_STORE_ID
: DICOM 저장소 IDSTUDY_INSTANCE_UID
: 연구 인스턴스 고유 식별자
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
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/dicomWeb/studies/STUDY_INSTANCE_UID"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/dicomWeb/studies/STUDY_INSTANCE_UID" | Select-Object -Expand ContentAPI 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
장기 실행 작업 상태를 가져옵니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: DICOM 저장소의 상위 데이터 세트OPERATION_ID
: 장기 실행 작업에서 반환된 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/operations/OPERATION_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/operations/OPERATION_ID" | Select-Object -Expand ContentAPI 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
Go
Java
Node.js
Python
DICOMweb CLI 사용
다음 샘플은 Cloud Healthcare API DICOMweb CLI를 사용하여 연구를 삭제하는 방법을 보여줍니다.
dcmweb \ https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb \ delete studies/STUDY_INSTANCE_UID
요청이 성공하면 서버는 삭제 도구가 완료될 때까지 CLI 도구가 폴링하는 작업을 반환합니다.