기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 이미지 세트 속성 가져오기
`GetImageSet` 작업을 사용하여 HealthImaging에서 지정된 [이미지 세트](getting-started-concepts.md#concept-image-set)의 속성을 반환합니다. 다음 메뉴에서는 AWS Management Console 및 AWS SDKs의 AWS CLI 및 코드 예제에 대한 절차를 제공합니다. 자세한 내용은 *AWS HealthImaging API Reference*에서 [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSet.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSet.html) 섹션을 참조하세요.
**참고**
기본적으로 AWS HealthImaging은 최신 버전의 이미지 세트에 대한 속성을 반환합니다. 이전 버전의 이미지 세트에 대한 속성을 보려면 요청과 함께 `versionId`를 제공하십시오.
DICOMweb 서비스에 대한 `GetDICOMInstance` HealthImaging의 표현인를 사용하여 DICOM 인스턴스 바이너리(`.dcm` 파일)를 반환합니다. 자세한 내용은 [HealthImaging에서 DICOM 인스턴스 가져오기](dicomweb-retrieve-instance.md) 단원을 참조하십시오.
**이미지 세트 속성 가져오기**
AWS HealthImaging에 대한 액세스 기본 설정에 따라 메뉴를 선택합니다.
## AWS 콘솔
1. HealthImaging 콘솔 [데이터 스토어 페이지](https://console.aws.amazon.com/medical-imaging/home#/dataStores)를 엽니다.
1. 데이터 스토어를 선택합니다.
**데이터 스토어 세부 정보** 페이지가 열리고 기본적으로 **이미지 세트** 탭이 선택됩니다.
1. 이미지 세트를 선택합니다.
**이미지 세트 세부 정보** 페이지가 열리고 이미지 세트 속성이 표시됩니다.
## AWS CLI 및 SDKs
------
#### [ CLI ]
**AWS CLI**
**이미지 세트 속성 가져오기**
다음 `get-image-set` 코드 예시에서는 이미지 세트의 속성을 가져옵니다.
```
aws medical-imaging get-image-set \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 18f88ac7870584f58d56256646b4d92b \
--version-id 1
```
출력:
```
{
"versionId": "1",
"imageSetWorkflowStatus": "COPIED",
"updatedAt": 1680027253.471,
"imageSetId": "18f88ac7870584f58d56256646b4d92b",
"imageSetState": "ACTIVE",
"createdAt": 1679592510.753,
"datastoreId": "12345678901234567890123456789012"
}
```
자세한 내용은 *AWS HealthImaging 개발자 안내서*의 [이미지 세트 속성 가져오기](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-properties.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set.html)를 참조하세요.
------
#### [ Java ]
**SDK for Java 2.x**
```
public static GetImageSetResponse getMedicalImageSet(MedicalImagingClient medicalImagingClient,
String datastoreId,
String imagesetId,
String versionId) {
try {
GetImageSetRequest.Builder getImageSetRequestBuilder = GetImageSetRequest.builder()
.datastoreId(datastoreId)
.imageSetId(imagesetId);
if (versionId != null) {
getImageSetRequestBuilder = getImageSetRequestBuilder.versionId(versionId);
}
return medicalImagingClient.getImageSet(getImageSetRequestBuilder.build());
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
+ API에 대한 세부 정보는 *AWS SDK for Java 2.x API 참조*의 [GetImageSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageSet)를 참조하세요.
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
------
#### [ JavaScript ]
**SDK for JavaScript(v3)**
```
import { GetImageSetCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreId - The ID of the data store.
* @param {string} imageSetId - The ID of the image set.
* @param {string} imageSetVersion - The optional version of the image set.
*
*/
export const getImageSet = async (
datastoreId = "xxxxxxxxxxxxxxx",
imageSetId = "xxxxxxxxxxxxxxx",
imageSetVersion = "",
) => {
const params = { datastoreId: datastoreId, imageSetId: imageSetId };
if (imageSetVersion !== "") {
params.imageSetVersion = imageSetVersion;
}
const response = await medicalImagingClient.send(
new GetImageSetCommand(params),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '0615c161-410d-4d06-9d8c-6e1241bb0a5a',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// createdAt: 2023-09-22T14:49:26.427Z,
// datastoreId: 'xxxxxxxxxxxxxxx',
// imageSetArn: 'arn:aws:medical-imaging:us-east-1:xxxxxxxxxx:datastore/xxxxxxxxxxxxxxxxxxxx/imageset/xxxxxxxxxxxxxxxxxxxx',
// imageSetId: 'xxxxxxxxxxxxxxx',
// imageSetState: 'ACTIVE',
// imageSetWorkflowStatus: 'CREATED',
// updatedAt: 2023-09-22T14:49:26.427Z,
// versionId: '1'
// }
return response;
};
```
+ API에 대한 세부 정보는 *AWS SDK for JavaScript API 참조*의 [GetImageSet](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageSetCommand)를 참조하세요.
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
------
#### [ Python ]
**SDK for Python(Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def get_image_set(self, datastore_id, image_set_id, version_id=None):
"""
Get the properties of an image set.
:param datastore_id: The ID of the data store.
:param image_set_id: The ID of the image set.
:param version_id: The optional version of the image set.
:return: The image set properties.
"""
try:
if version_id:
image_set = self.health_imaging_client.get_image_set(
imageSetId=image_set_id,
datastoreId=datastore_id,
versionId=version_id,
)
else:
image_set = self.health_imaging_client.get_image_set(
imageSetId=image_set_id, datastoreId=datastore_id
)
except ClientError as err:
logger.error(
"Couldn't get image set. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return image_set
```
다음 코드는 MedicalImagingWrapper 객체를 인스턴스화합니다.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [GetImageSet](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageSet)를 참조하세요.
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_image_set_id = '1234567890123456789012345678901234567890'
" iv_version_id = '1' (optional)
IF iv_version_id IS NOT INITIAL.
oo_result = lo_mig->getimageset(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id
iv_versionid = iv_version_id ).
ELSE.
oo_result = lo_mig->getimageset(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id ).
ENDIF.
DATA(lv_state) = oo_result->get_imagesetstate( ).
MESSAGE |Image set retrieved with state: { lv_state }.| TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' TYPE 'I'.
CATCH /aws1/cx_migconflictexception.
MESSAGE 'Conflict error.' TYPE 'I'.
CATCH /aws1/cx_miginternalserverex.
MESSAGE 'Internal server error.' TYPE 'I'.
CATCH /aws1/cx_migresourcenotfoundex.
MESSAGE 'Image set not found.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ API 세부 정보는 SDK for SAP ABAP API 참조의 [GetImageSet](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)를 참조하세요. *AWS *
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
------
**예제 가용성**
필요한 예제를 찾을 수 없습니까? 이 페이지의 오른쪽 사이드바에 있는 **피드백 제공** 링크를 사용하여 코드 예제를 요청합니다.