기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# HealthImaging에서 DICOM 시리즈 메타데이터 가져오기
<a name="dicomweb-retrieve-series-metadata"></a>

`GetDICOMSeriesMetadata` 작업을 사용하여 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)에서 DICOM 시리즈(`.json` 파일)의 메타데이터를 검색합니다. 리소스와 연결된 연구 및 시리즈 UIDs를 지정하여 HealthImaging 데이터 스토어의 모든 기본 [ 이미지 세트](getting-started-concepts.md#concept-image-set)에 대한 시리즈 메타데이터를 검색할 수 있습니다. 이미지 세트 ID를 쿼리 파라미터로 제공하여 기본이 아닌 이미지 세트에 대한 시리즈 메타데이터를 검색할 수 있습니다. 시리즈 메타데이터는 `DICOM JSON` 형식으로 반환됩니다.

**DICOM 시리즈 메타데이터를 가져오려면(`.json`)**  


1. HealthImaging `datastoreId` 및 `imageSetId` 파라미터 값을 수집합니다.

1. `datastoreId`, `studyInstanceUID`, `seriesInstanceUID`및 선택적으로 값을 사용하여 요청에 대한 URL을 구성합니다`imageSetId`. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. URL의 형식은 다음과 같습니다.

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/metadata
   ```

1. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `GetDICOMSeriesMetadata` 사용합니다. 다음 코드 예제에서는 `curl` 명령줄 도구를 사용하여 HealthImaging에서 메타데이터(`.json` 파일)를 가져옵니다.

------
#### [ Shell ]

   ```
   curl --request GET \
    'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/metadata \
     --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
     --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
     --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
     --header 'Accept: application/dicom+json' \
     --output 'series-metadata.json'
   ```

------

   선택적 `imageSetId` 파라미터를 사용합니다.

------
#### [ Shell ]

   ```
   curl --request GET \
     'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/metadata?imageSetId=459e50687f121185f747b67bb60d1bc8' \
     --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
     --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
     --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
     --header 'Accept: application/dicom+json' \
     --output 'series-metadata.json'
   ```

------
**참고**  
`imageSetId` 파라미터는 기본이 아닌 이미지 세트에 대한 시리즈 메타데이터를 검색하는 데 필요합니다. `GetDICOMInstanceMetadata` 작업은 `datastoreId`, `studyInstanceUID`가 지정된 경우에만 기본 이미지 세트에 대한 시리즈 메타데이터를 반환`seriesInstanceUID`합니다( 제외`imagesetID`).