本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `ListDICOMImportJobs` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `ListDICOMImportJobs`。
------
#### [ CLI ]
**AWS CLI**
**列出 dicom 匯入任務**
下列 `list-dicom-import-jobs` 程式碼範例列出 dicom 匯入任務。
```
aws medical-imaging list-dicom-import-jobs \
--datastore-id "12345678901234567890123456789012"
```
輸出：
```
{
"jobSummaries": [
{
"jobId": "09876543210987654321098765432109",
"jobName": "my-job",
"jobStatus": "COMPLETED",
"datastoreId": "12345678901234567890123456789012",
"dataAccessRoleArn": "arn:aws:iam::123456789012:role/ImportJobDataAccessRole",
"endedAt": "2022-08-12T11:21:56.504000+00:00",
"submittedAt": "2022-08-12T11:20:21.734000+00:00"
}
]
}
```
如需詳細資訊，請參閱《AWS HealthImaging 開發人員指南》**中的[列出匯入任務](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-dicom-import-jobs.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListDICOMImportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-dicom-import-jobs.html)。
------
#### [ Java ]
**適用於 Java 2.x 的 SDK**
```
public static List listDicomImportJobs(MedicalImagingClient medicalImagingClient,
String datastoreId) {
try {
ListDicomImportJobsRequest listDicomImportJobsRequest = ListDicomImportJobsRequest.builder()
.datastoreId(datastoreId)
.build();
ListDicomImportJobsResponse response = medicalImagingClient.listDICOMImportJobs(listDicomImportJobsRequest);
return response.jobSummaries();
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return new ArrayList<>();
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [ListDICOMImportJobs](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/ListDICOMImportJobs)。
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples)中設定和執行。
------
#### [ JavaScript ]
**適用於 JavaScript (v3) 的 SDK**
```
import { paginateListDICOMImportJobs } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreId - The ID of the data store.
*/
export const listDICOMImportJobs = async (
datastoreId = "xxxxxxxxxxxxxxxxxx",
) => {
const paginatorConfig = {
client: medicalImagingClient,
pageSize: 50,
};
const commandParams = { datastoreId: datastoreId };
const paginator = paginateListDICOMImportJobs(paginatorConfig, commandParams);
const jobSummaries = [];
for await (const page of paginator) {
// Each page contains a list of `jobSummaries`. The list is truncated if is larger than `pageSize`.
jobSummaries.push(...page.jobSummaries);
console.log(page);
}
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '3c20c66e-0797-446a-a1d8-91b742fd15a0',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// jobSummaries: [
// {
// dataAccessRoleArn: 'arn:aws:iam::xxxxxxxxxxxx:role/dicom_import',
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxx',
// endedAt: 2023-09-22T14:49:51.351Z,
// jobId: 'xxxxxxxxxxxxxxxxxxxxxxxxx',
// jobName: 'test-1',
// jobStatus: 'COMPLETED',
// submittedAt: 2023-09-22T14:48:45.767Z
// }
// ]}
return jobSummaries;
};
```
+ 如需 API 詳細資訊，請參閱《適用於 JavaScript 的 AWS SDK API 參考》**中的 [ListDICOMImportJobs](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/ListDICOMImportJobsCommand)。
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples)中設定和執行。
------
#### [ Python ]
**適用於 Python 的 SDK (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def list_dicom_import_jobs(self, datastore_id):
"""
List the DICOM import jobs.
:param datastore_id: The ID of the data store.
:return: The list of jobs.
"""
try:
paginator = self.health_imaging_client.get_paginator(
"list_dicom_import_jobs"
)
page_iterator = paginator.paginate(datastoreId=datastore_id)
job_summaries = []
for page in page_iterator:
job_summaries.extend(page["jobSummaries"])
except ClientError as err:
logger.error(
"Couldn't list DICOM import jobs. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return job_summaries
```
下列程式碼會執行個體化 MedicalImagingWrapper 物件。
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Python (Boto3) API 參考》**中的 [ListDICOMImportJobs](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/ListDICOMImportJobs)。
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples)中設定和執行。
------
#### [ SAP ABAP ]
**適用於 SAP ABAP 的開發套件**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
oo_result = lo_mig->listdicomimportjobs( iv_datastoreid = iv_datastore_id ).
DATA(lt_jobs) = oo_result->get_jobsummaries( ).
DATA(lv_count) = lines( lt_jobs ).
MESSAGE |Found { lv_count } DICOM import jobs.| 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 'Resource not found.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ 如需 API 詳細資訊，請參閱《適用於 *AWS SAP ABAP 的 SDK API 參考*》中的 [ListDICOMImportJobs](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)。
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples)中設定和執行。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用此服務](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。