Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Azioni per l'utilizzo HealthImaging AWS SDKs
I seguenti esempi di codice mostrano come eseguire singole HealthImaging azioni con AWS SDKs. Ogni esempio include un collegamento a GitHub, dove sono disponibili le istruzioni per la configurazione e l'esecuzione del codice.
Questi estratti richiamano l' HealthImaging API e sono estratti di codice di programmi più grandi che devono essere eseguiti nel contesto. È possibile visualizzare le azioni nel contesto in [Scenari di utilizzo HealthImaging AWS SDKs](service_code_examples_scenarios.md).
Gli esempi seguenti includono solo le azioni più comunemente utilizzate. Per un elenco completo, consulta la [documentazione di riferimento dell’API AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/APIReference/Welcome.html).
**Topics**
+ [`CopyImageSet`](example_medical-imaging_CopyImageSet_section.md)
+ [`CreateDatastore`](example_medical-imaging_CreateDatastore_section.md)
+ [`DeleteDatastore`](example_medical-imaging_DeleteDatastore_section.md)
+ [`DeleteImageSet`](example_medical-imaging_DeleteImageSet_section.md)
+ [`GetDICOMImportJob`](example_medical-imaging_GetDICOMImportJob_section.md)
+ [`GetDatastore`](example_medical-imaging_GetDatastore_section.md)
+ [`GetImageFrame`](example_medical-imaging_GetImageFrame_section.md)
+ [`GetImageSet`](example_medical-imaging_GetImageSet_section.md)
+ [`GetImageSetMetadata`](example_medical-imaging_GetImageSetMetadata_section.md)
+ [`ListDICOMImportJobs`](example_medical-imaging_ListDICOMImportJobs_section.md)
+ [`ListDatastores`](example_medical-imaging_ListDatastores_section.md)
+ [`ListImageSetVersions`](example_medical-imaging_ListImageSetVersions_section.md)
+ [`ListTagsForResource`](example_medical-imaging_ListTagsForResource_section.md)
+ [`SearchImageSets`](example_medical-imaging_SearchImageSets_section.md)
+ [`StartDICOMImportJob`](example_medical-imaging_StartDICOMImportJob_section.md)
+ [`TagResource`](example_medical-imaging_TagResource_section.md)
+ [`UntagResource`](example_medical-imaging_UntagResource_section.md)
+ [`UpdateImageSetMetadata`](example_medical-imaging_UpdateImageSetMetadata_section.md)
# Utilizzo `CopyImageSet` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `CopyImageSet`.
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: come copiare un set di immagini senza una destinazione.**
L’esempio `copy-image-set` seguente crea una copia duplicata di un set di immagini senza una destinazione.
```
aws medical-imaging copy-image-set \
--datastore-id 12345678901234567890123456789012 \
--source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" } }'
```
Output:
```
{
"destinationImageSetProperties": {
"latestVersionId": "2",
"imageSetWorkflowStatus": "COPYING",
"updatedAt": 1680042357.432,
"imageSetId": "b9a06fef182a5f992842f77f8e0868e5",
"imageSetState": "LOCKED",
"createdAt": 1680042357.432
},
"sourceImageSetProperties": {
"latestVersionId": "1",
"imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS",
"updatedAt": 1680042357.432,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436
},
"datastoreId": "12345678901234567890123456789012"
}
```
**Esempio 2: come copiare un set di immagini con una destinazione.**
L’esempio `copy-image-set` seguente crea una copia duplicata di un set di immagini con una destinazione.
```
aws medical-imaging copy-image-set \
--datastore-id 12345678901234567890123456789012 \
--source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" }, "destinationImageSet": { "imageSetId": "b9a06fef182a5f992842f77f8e0868e5", "latestVersionId": "1"} }'
```
Output:
```
{
"destinationImageSetProperties": {
"latestVersionId": "2",
"imageSetWorkflowStatus": "COPYING",
"updatedAt": 1680042505.135,
"imageSetId": "b9a06fef182a5f992842f77f8e0868e5",
"imageSetState": "LOCKED",
"createdAt": 1680042357.432
},
"sourceImageSetProperties": {
"latestVersionId": "1",
"imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS",
"updatedAt": 1680042505.135,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436
},
"datastoreId": "12345678901234567890123456789012"
}
```
**Esempio 3: come copiare un sottoinsieme di istanze da un set di immagini di origine a un set di immagini di destinazione.**
L’esempio `copy-image-set` seguente copia un’istanza DICOM dal set di immagini di origine nel set di immagini di destinazione. Il parametro force viene fornito per eseguire l’override delle incongruenze a livello degli attributi Patient, Study e Series.
```
aws medical-imaging copy-image-set \
--datastore-id 12345678901234567890123456789012 \
--source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1","DICOMCopies": {"copiableAttributes": "{\"SchemaVersion\":\"1.1\",\"Study\":{\"Series\":{\"1.3.6.1.4.1.5962.99.1.3673257865.2104868982.1369432891697.3666.0\":{\"Instances\":{\"1.3.6.1.4.1.5962.99.1.3673257865.2104868982.1369432891697.3669.0\":{}}}}}}"}},"destinationImageSet": {"imageSetId": "b9eb50d8ee682eb9fcf4acbf92f62bb7","latestVersionId": "1"}}' \
--force
```
Output:
```
{
"destinationImageSetProperties": {
"latestVersionId": "2",
"imageSetWorkflowStatus": "COPYING",
"updatedAt": 1680042505.135,
"imageSetId": "b9eb50d8ee682eb9fcf4acbf92f62bb7",
"imageSetState": "LOCKED",
"createdAt": 1680042357.432
},
"sourceImageSetProperties": {
"latestVersionId": "1",
"imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS",
"updatedAt": 1680042505.135,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436
},
"datastoreId": "12345678901234567890123456789012"
}
```
Per ulteriori informazioni, consulta [Copiare un set di immagini nella Guida](https://docs.aws.amazon.com/healthimaging/latest/devguide/copy-image-set.html) per gli *AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [CopyImageSet AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/copy-image-set.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
/**
* Copy an AWS HealthImaging image set.
*
* @param medicalImagingClient - The AWS HealthImaging client object.
* @param datastoreId - The datastore ID.
* @param imageSetId - The image set ID.
* @param latestVersionId - The version ID.
* @param destinationImageSetId - The optional destination image set ID, ignored if null.
* @param destinationVersionId - The optional destination version ID, ignored if null.
* @param force - The force flag.
* @param subsets - The optional subsets to copy, ignored if null.
* @return - The image set ID of the copy.
* @throws MedicalImagingException - Base exception for all service exceptions thrown by AWS HealthImaging.
*/
public static String copyMedicalImageSet(MedicalImagingClient medicalImagingClient,
String datastoreId,
String imageSetId,
String latestVersionId,
String destinationImageSetId,
String destinationVersionId,
boolean force,
Vector subsets) {
try {
CopySourceImageSetInformation.Builder copySourceImageSetInformation = CopySourceImageSetInformation.builder()
.latestVersionId(latestVersionId);
// Optionally copy a subset of image instances.
if (subsets != null) {
String subsetInstanceToCopy = getCopiableAttributesJSON(imageSetId, subsets);
copySourceImageSetInformation.dicomCopies(MetadataCopies.builder()
.copiableAttributes(subsetInstanceToCopy)
.build());
}
CopyImageSetInformation.Builder copyImageSetBuilder = CopyImageSetInformation.builder()
.sourceImageSet(copySourceImageSetInformation.build());
// Optionally designate a destination image set.
if (destinationImageSetId != null) {
copyImageSetBuilder = copyImageSetBuilder.destinationImageSet(CopyDestinationImageSet.builder()
.imageSetId(destinationImageSetId)
.latestVersionId(destinationVersionId)
.build());
}
CopyImageSetRequest copyImageSetRequest = CopyImageSetRequest.builder()
.datastoreId(datastoreId)
.sourceImageSetId(imageSetId)
.copyImageSetInformation(copyImageSetBuilder.build())
.force(force)
.build();
CopyImageSetResponse response = medicalImagingClient.copyImageSet(copyImageSetRequest);
return response.destinationImageSetProperties().imageSetId();
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
throw e;
}
}
```
Funzione di utilità per creare attributi copiabili.
```
/**
* Create a JSON string of copiable image instances.
*
* @param imageSetId - The image set ID.
* @param subsets - The subsets to copy.
* @return A JSON string of copiable image instances.
*/
private static String getCopiableAttributesJSON(String imageSetId, Vector subsets) {
StringBuilder subsetInstanceToCopy = new StringBuilder(
"""
{
"SchemaVersion": 1.1,
"Study": {
"Series": {
"
"""
);
subsetInstanceToCopy.append(imageSetId);
subsetInstanceToCopy.append(
"""
": {
"Instances": {
"""
);
for (String subset : subsets) {
subsetInstanceToCopy.append('"' + subset + "\": {},");
}
subsetInstanceToCopy.deleteCharAt(subsetInstanceToCopy.length() - 1);
subsetInstanceToCopy.append("""
}
}
}
}
}
""");
return subsetInstanceToCopy.toString();
}
```
+ Per i dettagli sull'API, [CopyImageSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/CopyImageSet)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
Funzione di utilità per copiare un set di immagini.
```
import { CopyImageSetCommand } 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 source image set ID.
* @param {string} sourceVersionId - The source version ID.
* @param {string} destinationImageSetId - The optional ID of the destination image set.
* @param {string} destinationVersionId - The optional version ID of the destination image set.
* @param {boolean} force - Force the copy action.
* @param {[string]} copySubsets - A subset of instance IDs to copy.
*/
export const copyImageSet = async (
datastoreId = "xxxxxxxxxxx",
imageSetId = "xxxxxxxxxxxx",
sourceVersionId = "1",
destinationImageSetId = "",
destinationVersionId = "",
force = false,
copySubsets = [],
) => {
try {
const params = {
datastoreId: datastoreId,
sourceImageSetId: imageSetId,
copyImageSetInformation: {
sourceImageSet: { latestVersionId: sourceVersionId },
},
force: force,
};
if (destinationImageSetId !== "" && destinationVersionId !== "") {
params.copyImageSetInformation.destinationImageSet = {
imageSetId: destinationImageSetId,
latestVersionId: destinationVersionId,
};
}
if (copySubsets.length > 0) {
let copySubsetsJson;
copySubsetsJson = {
SchemaVersion: 1.1,
Study: {
Series: {
imageSetId: {
Instances: {},
},
},
},
};
for (let i = 0; i < copySubsets.length; i++) {
copySubsetsJson.Study.Series.imageSetId.Instances[copySubsets[i]] = {};
}
params.copyImageSetInformation.dicomCopies = copySubsetsJson;
}
const response = await medicalImagingClient.send(
new CopyImageSetCommand(params),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'd9b219ce-cc48-4a44-a5b2-c5c3068f1ee8',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreId: 'xxxxxxxxxxxxxx',
// destinationImageSetProperties: {
// createdAt: 2023-09-27T19:46:21.824Z,
// imageSetArn: 'arn:aws:medical-imaging:us-east-1:xxxxxxxxxxx:datastore/xxxxxxxxxxxxx/imageset/xxxxxxxxxxxxxxxxxxx',
// imageSetId: 'xxxxxxxxxxxxxxx',
// imageSetState: 'LOCKED',
// imageSetWorkflowStatus: 'COPYING',
// latestVersionId: '1',
// updatedAt: 2023-09-27T19:46:21.824Z
// },
// sourceImageSetProperties: {
// createdAt: 2023-09-22T14:49:26.427Z,
// imageSetArn: 'arn:aws:medical-imaging:us-east-1:xxxxxxxxxxx:datastore/xxxxxxxxxxxxx/imageset/xxxxxxxxxxxxxxxx',
// imageSetId: 'xxxxxxxxxxxxxxxx',
// imageSetState: 'LOCKED',
// imageSetWorkflowStatus: 'COPYING_WITH_READ_ONLY_ACCESS',
// latestVersionId: '4',
// updatedAt: 2023-09-27T19:46:21.824Z
// }
// }
return response;
} catch (err) {
console.error(err);
}
};
```
Copia un set di immagini senza una destinazione.
```
await copyImageSet(
"12345678901234567890123456789012",
"12345678901234567890123456789012",
"1",
);
```
Copia un set di immagini con una destinazione.
```
await copyImageSet(
"12345678901234567890123456789012",
"12345678901234567890123456789012",
"1",
"12345678901234567890123456789012",
"1",
false,
);
```
Copia un sottoinsieme di un set di immagini con una destinazione e forza la copia.
```
await copyImageSet(
"12345678901234567890123456789012",
"12345678901234567890123456789012",
"1",
"12345678901234567890123456789012",
"1",
true,
["12345678901234567890123456789012", "11223344556677889900112233445566"],
);
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [CopyImageSet](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/CopyImageSetCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
Funzione di utilità per copiare un set di immagini.
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def copy_image_set(
self,
datastore_id,
image_set_id,
version_id,
destination_image_set_id=None,
destination_version_id=None,
force=False,
subsets=[],
):
"""
Copy 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 ID of the image set version.
:param destination_image_set_id: The ID of the optional destination image set.
:param destination_version_id: The ID of the optional destination image set version.
:param force: Force the copy.
:param subsets: The optional subsets to copy. For example: ["12345678901234567890123456789012"].
:return: The copied image set ID.
"""
try:
copy_image_set_information = {
"sourceImageSet": {"latestVersionId": version_id}
}
if destination_image_set_id and destination_version_id:
copy_image_set_information["destinationImageSet"] = {
"imageSetId": destination_image_set_id,
"latestVersionId": destination_version_id,
}
if len(subsets) > 0:
copySubsetsJson = {
"SchemaVersion": "1.1",
"Study": {"Series": {"imageSetId": {"Instances": {}}}},
}
for subset in subsets:
copySubsetsJson["Study"]["Series"]["imageSetId"]["Instances"][
subset
] = {}
copy_image_set_information["sourceImageSet"]["DICOMCopies"] = {
"copiableAttributes": json.dumps(copySubsetsJson)
}
copy_results = self.health_imaging_client.copy_image_set(
datastoreId=datastore_id,
sourceImageSetId=image_set_id,
copyImageSetInformation=copy_image_set_information,
force=force,
)
except ClientError as err:
logger.error(
"Couldn't copy image set. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return copy_results["destinationImageSetProperties"]["imageSetId"]
```
Copia un set di immagini senza una destinazione.
```
copy_image_set_information = {
"sourceImageSet": {"latestVersionId": version_id}
}
copy_results = self.health_imaging_client.copy_image_set(
datastoreId=datastore_id,
sourceImageSetId=image_set_id,
copyImageSetInformation=copy_image_set_information,
force=force,
)
```
Copia un set di immagini con una destinazione.
```
copy_image_set_information = {
"sourceImageSet": {"latestVersionId": version_id}
}
if destination_image_set_id and destination_version_id:
copy_image_set_information["destinationImageSet"] = {
"imageSetId": destination_image_set_id,
"latestVersionId": destination_version_id,
}
copy_results = self.health_imaging_client.copy_image_set(
datastoreId=datastore_id,
sourceImageSetId=image_set_id,
copyImageSetInformation=copy_image_set_information,
force=force,
)
```
Copia un sottoinsieme di un set di immagini.
```
copy_image_set_information = {
"sourceImageSet": {"latestVersionId": version_id}
}
if len(subsets) > 0:
copySubsetsJson = {
"SchemaVersion": "1.1",
"Study": {"Series": {"imageSetId": {"Instances": {}}}},
}
for subset in subsets:
copySubsetsJson["Study"]["Series"]["imageSetId"]["Instances"][
subset
] = {}
copy_image_set_information["sourceImageSet"]["DICOMCopies"] = {
"copiableAttributes": json.dumps(copySubsetsJson)
}
copy_results = self.health_imaging_client.copy_image_set(
datastoreId=datastore_id,
sourceImageSetId=image_set_id,
copyImageSetInformation=copy_image_set_information,
force=force,
)
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [CopyImageSet AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/CopyImageSet)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_source_image_set_id = '1234567890123456789012345678901234567890'
" iv_source_version_id = '1'
" iv_destination_image_set_id = '1234567890123456789012345678901234567890' (optional)
" iv_destination_version_id = '1' (optional)
" iv_force = abap_false
DATA(lo_source_info) = NEW /aws1/cl_migcpsrcimagesetinf00(
iv_latestversionid = iv_source_version_id ).
DATA(lo_copy_info) = NEW /aws1/cl_migcpimagesetinfmtion(
io_sourceimageset = lo_source_info ).
IF iv_destination_image_set_id IS NOT INITIAL AND
iv_destination_version_id IS NOT INITIAL.
DATA(lo_dest_info) = NEW /aws1/cl_migcopydstimageset(
iv_imagesetid = iv_destination_image_set_id
iv_latestversionid = iv_destination_version_id ).
lo_copy_info = NEW /aws1/cl_migcpimagesetinfmtion(
io_sourceimageset = lo_source_info
io_destinationimageset = lo_dest_info ).
ENDIF.
oo_result = lo_mig->copyimageset(
iv_datastoreid = iv_datastore_id
iv_sourceimagesetid = iv_source_image_set_id
io_copyimagesetinformation = lo_copy_info
iv_force = iv_force ).
DATA(lo_dest_props) = oo_result->get_dstimagesetproperties( ).
DATA(lv_new_id) = lo_dest_props->get_imagesetid( ).
MESSAGE |Image set copied with new ID: { lv_new_id }.| 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_migservicequotaexcdex.
MESSAGE 'Service quota exceeded.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [CopyImageSet AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `CreateDatastore` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `CreateDatastore`.
------
#### [ Bash ]
**AWS CLI con lo script Bash**
```
###############################################################################
# function errecho
#
# This function outputs everything sent to it to STDERR (standard error output).
###############################################################################
function errecho() {
printf "%s\n" "$*" 1>&2
}
###############################################################################
# function imaging_create_datastore
#
# This function creates an AWS HealthImaging data store for importing DICOM P10 files.
#
# Parameters:
# -n data_store_name - The name of the data store.
#
# Returns:
# The datastore ID.
# And:
# 0 - If successful.
# 1 - If it fails.
###############################################################################
function imaging_create_datastore() {
local datastore_name response
local option OPTARG # Required to use getopts command in a function.
# bashsupport disable=BP5008
function usage() {
echo "function imaging_create_datastore"
echo "Creates an AWS HealthImaging data store for importing DICOM P10 files."
echo " -n data_store_name - The name of the data store."
echo ""
}
# Retrieve the calling parameters.
while getopts "n:h" option; do
case "${option}" in
n) datastore_name="${OPTARG}" ;;
h)
usage
return 0
;;
\?)
echo "Invalid parameter"
usage
return 1
;;
esac
done
export OPTIND=1
if [[ -z "$datastore_name" ]]; then
errecho "ERROR: You must provide a data store name with the -n parameter."
usage
return 1
fi
response=$(aws medical-imaging create-datastore \
--datastore-name "$datastore_name" \
--output text \
--query 'datastoreId')
local error_code=${?}
if [[ $error_code -ne 0 ]]; then
aws_cli_error_log $error_code
errecho "ERROR: AWS reports medical-imaging create-datastore operation failed.$response"
return 1
fi
echo "$response"
return 0
}
```
+ Per i dettagli sull'API, vedere [CreateDatastore](https://docs.aws.amazon.com/goto/aws-cli/medical-imaging-2023-07-19/CreateDatastore)in *AWS CLI Command Reference.*
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli/bash-linux/medical-imaging#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: creare un archivio dati**
L’esempio di codice `create-datastore` seguente crea un datastore denominato `my-datastore`. Quando si crea un datastore senza specificare a`--lossless-storage-format`, il AWS HealthImaging valore predefinito è HTJ2 K (High Throughput JPEG 2000).
```
aws medical-imaging create-datastore \
--datastore-name "my-datastore"
```
Output:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "CREATING"
}
```
**Esempio 2: creare un archivio dati con il formato di archiviazione JPEG 2000 Lossless**
Un data store configurato con il formato di archiviazione JPEG 2000 Lossless transcodificherà e renderà persistenti i frame di immagine senza perdita di dati in formato JPEG 2000. I fotogrammi delle immagini possono quindi essere recuperati in JPEG 2000 Lossless senza transcodifica. Il seguente esempio di `create-datastore` codice crea un archivio dati configurato per il formato di archiviazione JPEG 2000 Lossless con il nome. `my-datastore`
```
aws medical-imaging create-datastore \
--datastore-name "my-datastore" \
--lossless-storage-format JPEG_2000_LOSSLESS
```
Output:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "CREATING"
}
```
Per ulteriori informazioni, consulta [Creazione di un data store](https://docs.aws.amazon.com/healthimaging/latest/devguide/create-data-store.html) nella *AWS HealthImaging Developer Guide*.
+ Per i dettagli sull'API, consulta [CreateDatastore AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/create-datastore.html)*Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
public static String createMedicalImageDatastore(MedicalImagingClient medicalImagingClient,
String datastoreName) {
try {
CreateDatastoreRequest datastoreRequest = CreateDatastoreRequest.builder()
.datastoreName(datastoreName)
.build();
CreateDatastoreResponse response = medicalImagingClient.createDatastore(datastoreRequest);
return response.datastoreId();
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return "";
}
```
+ Per i dettagli sull'API, [CreateDatastore](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/CreateDatastore)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { CreateDatastoreCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreName - The name of the data store to create.
*/
export const createDatastore = async (datastoreName = "DATASTORE_NAME") => {
const response = await medicalImagingClient.send(
new CreateDatastoreCommand({ datastoreName: datastoreName }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'a71cd65f-2382-49bf-b682-f9209d8d399b',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreStatus: 'CREATING'
// }
return response;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [CreateDatastore](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/CreateDatastoreCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def create_datastore(self, name):
"""
Create a data store.
:param name: The name of the data store to create.
:return: The data store ID.
"""
try:
data_store = self.health_imaging_client.create_datastore(datastoreName=name)
except ClientError as err:
logger.error(
"Couldn't create data store %s. Here's why: %s: %s",
name,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return data_store["datastoreId"]
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [CreateDatastore AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/CreateDatastore)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_name = 'my-datastore-name'
oo_result = lo_mig->createdatastore( iv_datastorename = iv_datastore_name ).
DATA(lv_datastore_id) = oo_result->get_datastoreid( ).
MESSAGE 'Data store created.' TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' TYPE 'I'.
CATCH /aws1/cx_migconflictexception.
MESSAGE 'Conflict. Data store may already exist.' TYPE 'I'.
CATCH /aws1/cx_miginternalserverex.
MESSAGE 'Internal server error.' TYPE 'I'.
CATCH /aws1/cx_migservicequotaexcdex.
MESSAGE 'Service quota exceeded.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [CreateDatastore AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `DeleteDatastore` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `DeleteDatastore`.
------
#### [ Bash ]
**AWS CLI con lo script Bash**
```
###############################################################################
# function errecho
#
# This function outputs everything sent to it to STDERR (standard error output).
###############################################################################
function errecho() {
printf "%s\n" "$*" 1>&2
}
###############################################################################
# function imaging_delete_datastore
#
# This function deletes an AWS HealthImaging data store.
#
# Parameters:
# -i datastore_id - The ID of the data store.
#
# Returns:
# 0 - If successful.
# 1 - If it fails.
###############################################################################
function imaging_delete_datastore() {
local datastore_id response
local option OPTARG # Required to use getopts command in a function.
# bashsupport disable=BP5008
function usage() {
echo "function imaging_delete_datastore"
echo "Deletes an AWS HealthImaging data store."
echo " -i datastore_id - The ID of the data store."
echo ""
}
# Retrieve the calling parameters.
while getopts "i:h" option; do
case "${option}" in
i) datastore_id="${OPTARG}" ;;
h)
usage
return 0
;;
\?)
echo "Invalid parameter"
usage
return 1
;;
esac
done
export OPTIND=1
if [[ -z "$datastore_id" ]]; then
errecho "ERROR: You must provide a data store ID with the -i parameter."
usage
return 1
fi
response=$(aws medical-imaging delete-datastore \
--datastore-id "$datastore_id")
local error_code=${?}
if [[ $error_code -ne 0 ]]; then
aws_cli_error_log $error_code
errecho "ERROR: AWS reports medical-imaging delete-datastore operation failed.$response"
return 1
fi
return 0
}
```
+ Per i dettagli sull'API, vedere [DeleteDatastore](https://docs.aws.amazon.com/goto/aws-cli/medical-imaging-2023-07-19/DeleteDatastore)in *AWS CLI Command Reference.*
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli/bash-linux/medical-imaging#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Come eliminare un datastore**
L’esempio di codice `delete-datastore` seguente elimina un datastore.
```
aws medical-imaging delete-datastore \
--datastore-id "12345678901234567890123456789012"
```
Output:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "DELETING"
}
```
Per ulteriori informazioni, consulta [Eliminazione di un data store](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-data-store.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [DeleteDatastore AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-datastore.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
public static void deleteMedicalImagingDatastore(MedicalImagingClient medicalImagingClient,
String datastoreID) {
try {
DeleteDatastoreRequest datastoreRequest = DeleteDatastoreRequest.builder()
.datastoreId(datastoreID)
.build();
medicalImagingClient.deleteDatastore(datastoreRequest);
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ Per i dettagli sull'API, [DeleteDatastore](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/DeleteDatastore)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { DeleteDatastoreCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreId - The ID of the data store to delete.
*/
export const deleteDatastore = async (datastoreId = "DATASTORE_ID") => {
const response = await medicalImagingClient.send(
new DeleteDatastoreCommand({ datastoreId }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'f5beb409-678d-48c9-9173-9a001ee1ebb1',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreStatus: 'DELETING'
// }
return response;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [DeleteDatastore](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/DeleteDatastoreCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def delete_datastore(self, datastore_id):
"""
Delete a data store.
:param datastore_id: The ID of the data store.
"""
try:
self.health_imaging_client.delete_datastore(datastoreId=datastore_id)
except ClientError as err:
logger.error(
"Couldn't delete data store %s. Here's why: %s: %s",
datastore_id,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [DeleteDatastore AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/DeleteDatastore)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
oo_result = lo_mig->deletedatastore( iv_datastoreid = iv_datastore_id ).
MESSAGE 'Data store deleted.' TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' TYPE 'I'.
CATCH /aws1/cx_migconflictexception.
MESSAGE 'Conflict. Data store may contain resources.' TYPE 'I'.
CATCH /aws1/cx_miginternalserverex.
MESSAGE 'Internal server error.' TYPE 'I'.
CATCH /aws1/cx_migresourcenotfoundex.
MESSAGE 'Data store not found.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [DeleteDatastore AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `DeleteImageSet` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `DeleteImageSet`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. Puoi vedere questa azione nel contesto nel seguente esempio di codice:
+ [Nozioni di base su set di immagini e frame di immagini](example_medical-imaging_Scenario_ImageSetsAndFrames_section.md)
------
#### [ C\$1\$1 ]
**SDK per C\$1\$1**
```
//! Routine which deletes an AWS HealthImaging image set.
/*!
\param dataStoreID: The HealthImaging data store ID.
\param imageSetID: The image set ID.
\param clientConfig: Aws client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::deleteImageSet(
const Aws::String &dataStoreID, const Aws::String &imageSetID,
const Aws::Client::ClientConfiguration &clientConfig) {
Aws::MedicalImaging::MedicalImagingClient client(clientConfig);
Aws::MedicalImaging::Model::DeleteImageSetRequest request;
request.SetDatastoreId(dataStoreID);
request.SetImageSetId(imageSetID);
Aws::MedicalImaging::Model::DeleteImageSetOutcome outcome = client.DeleteImageSet(
request);
if (outcome.IsSuccess()) {
std::cout << "Successfully deleted image set " << imageSetID
<< " from data store " << dataStoreID << std::endl;
}
else {
std::cerr << "Error deleting image set " << imageSetID << " from data store "
<< dataStoreID << ": " <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Per i dettagli sull'API, consulta [DeleteImageSet AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/DeleteImageSet)*API Reference.*
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Come eliminare un set di immagini**
L’esempio di codice `delete-image-set` seguente elimina un set di immagini.
```
aws medical-imaging delete-image-set \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e
```
Output:
```
{
"imageSetWorkflowStatus": "DELETING",
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"datastoreId": "12345678901234567890123456789012"
}
```
Per ulteriori informazioni, consulta [Eliminazione di un set di immagini](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-image-set.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [DeleteImageSet AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-image-set.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
public static void deleteMedicalImageSet(MedicalImagingClient medicalImagingClient,
String datastoreId,
String imagesetId) {
try {
DeleteImageSetRequest deleteImageSetRequest = DeleteImageSetRequest.builder()
.datastoreId(datastoreId)
.imageSetId(imagesetId)
.build();
medicalImagingClient.deleteImageSet(deleteImageSetRequest);
System.out.println("The image set was deleted.");
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ Per i dettagli sull'API, [DeleteImageSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/DeleteImageSet)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { DeleteImageSetCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreId - The data store ID.
* @param {string} imageSetId - The image set ID.
*/
export const deleteImageSet = async (
datastoreId = "xxxxxxxxxxxxxxxx",
imageSetId = "xxxxxxxxxxxxxxxx",
) => {
const response = await medicalImagingClient.send(
new DeleteImageSetCommand({
datastoreId: datastoreId,
imageSetId: imageSetId,
}),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '6267bbd2-eaa5-4a50-8ee8-8fddf535cf73',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreId: 'xxxxxxxxxxxxxxxx',
// imageSetId: 'xxxxxxxxxxxxxxx',
// imageSetState: 'LOCKED',
// imageSetWorkflowStatus: 'DELETING'
// }
return response;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [DeleteImageSet](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/DeleteImageSetCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def delete_image_set(self, datastore_id, image_set_id):
"""
Delete an image set.
:param datastore_id: The ID of the data store.
:param image_set_id: The ID of the image set.
:return: The delete results.
"""
try:
delete_results = self.health_imaging_client.delete_image_set(
imageSetId=image_set_id, datastoreId=datastore_id
)
except ClientError as err:
logger.error(
"Couldn't delete image set. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return delete_results
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [DeleteImageSet AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/DeleteImageSet)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_image_set_id = '1234567890123456789012345678901234567890'
oo_result = lo_mig->deleteimageset(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id ).
MESSAGE 'Image set deleted.' 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.
```
+ Per i dettagli sull'API, consulta [DeleteImageSet AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `GetDICOMImportJob` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `GetDICOMImportJob`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. Puoi vedere questa azione nel contesto nel seguente esempio di codice:
+ [Nozioni di base su set di immagini e frame di immagini](example_medical-imaging_Scenario_ImageSetsAndFrames_section.md)
------
#### [ C\$1\$1 ]
**SDK per C\$1\$1**
```
//! Routine which gets a HealthImaging DICOM import job's properties.
/*!
\param dataStoreID: The HealthImaging data store ID.
\param importJobID: The DICOM import job ID
\param clientConfig: Aws client configuration.
\return GetDICOMImportJobOutcome: The import job outcome.
*/
Aws::MedicalImaging::Model::GetDICOMImportJobOutcome
AwsDoc::Medical_Imaging::getDICOMImportJob(const Aws::String &dataStoreID,
const Aws::String &importJobID,
const Aws::Client::ClientConfiguration &clientConfig) {
Aws::MedicalImaging::MedicalImagingClient client(clientConfig);
Aws::MedicalImaging::Model::GetDICOMImportJobRequest request;
request.SetDatastoreId(dataStoreID);
request.SetJobId(importJobID);
Aws::MedicalImaging::Model::GetDICOMImportJobOutcome outcome = client.GetDICOMImportJob(
request);
if (!outcome.IsSuccess()) {
std::cerr << "GetDICOMImportJob error: "
<< outcome.GetError().GetMessage() << std::endl;
}
return outcome;
}
```
+ Per i dettagli sull'API, consulta [Get DICOMImport Job](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/GetDICOMImportJob) in *AWS SDK per C\$1\$1 API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Come ottenere le proprietà di un processo di importazione DICOM**
L’esempio di codice `get-dicom-import-job` seguente concede l’autorizzazione ad avviare un processo di importazione DICOM.
```
aws medical-imaging get-dicom-import-job \
--datastore-id "12345678901234567890123456789012" \
--job-id "09876543210987654321098765432109"
```
Output:
```
{
"jobProperties": {
"jobId": "09876543210987654321098765432109",
"jobName": "my-job",
"jobStatus": "COMPLETED",
"datastoreId": "12345678901234567890123456789012",
"dataAccessRoleArn": "arn:aws:iam::123456789012:role/ImportJobDataAccessRole",
"endedAt": "2022-08-12T11:29:42.285000+00:00",
"submittedAt": "2022-08-12T11:28:11.152000+00:00",
"inputS3Uri": "s3://medical-imaging-dicom-input/dicom_input/",
"outputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/"
}
}
```
Per ulteriori informazioni, consulta [Ottenere le proprietà dei lavori di importazione](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-dicom-import-job.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [Get DICOMImport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-dicom-import-job.html) in *AWS CLI Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
public static DICOMImportJobProperties getDicomImportJob(MedicalImagingClient medicalImagingClient,
String datastoreId,
String jobId) {
try {
GetDicomImportJobRequest getDicomImportJobRequest = GetDicomImportJobRequest.builder()
.datastoreId(datastoreId)
.jobId(jobId)
.build();
GetDicomImportJobResponse response = medicalImagingClient.getDICOMImportJob(getDicomImportJobRequest);
return response.jobProperties();
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
+ Per i dettagli sull'API, consulta [Get DICOMImport Job](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetDICOMImportJob) in *AWS SDK for Java 2.x API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { GetDICOMImportJobCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreId - The ID of the data store.
* @param {string} jobId - The ID of the import job.
*/
export const getDICOMImportJob = async (
datastoreId = "xxxxxxxxxxxxxxxxxxxx",
jobId = "xxxxxxxxxxxxxxxxxxxx",
) => {
const response = await medicalImagingClient.send(
new GetDICOMImportJobCommand({ datastoreId: datastoreId, jobId: jobId }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'a2637936-78ea-44e7-98b8-7a87d95dfaee',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// jobProperties: {
// dataAccessRoleArn: 'arn:aws:iam::xxxxxxxxxxxx:role/dicom_import',
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxx',
// endedAt: 2023-09-19T17:29:21.753Z,
// inputS3Uri: 's3://healthimaging-source/CTStudy/',
// jobId: ''xxxxxxxxxxxxxxxxxxxxxxxxx'',
// jobName: 'job_1',
// jobStatus: 'COMPLETED',
// outputS3Uri: 's3://health-imaging-dest/ouput_ct/'xxxxxxxxxxxxxxxxxxxxxxxxx'-DicomImport-'xxxxxxxxxxxxxxxxxxxxxxxxx'/',
// submittedAt: 2023-09-19T17:27:25.143Z
// }
// }
return response;
};
```
+ Per i dettagli sull'API, consulta [Get DICOMImport Job](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetDICOMImportJobCommand) in *AWS SDK per JavaScript API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def get_dicom_import_job(self, datastore_id, job_id):
"""
Get the properties of a DICOM import job.
:param datastore_id: The ID of the data store.
:param job_id: The ID of the job.
:return: The job properties.
"""
try:
job = self.health_imaging_client.get_dicom_import_job(
jobId=job_id, datastoreId=datastore_id
)
except ClientError as err:
logger.error(
"Couldn't get DICOM import job. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return job["jobProperties"]
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [Get DICOMImport Job](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetDICOMImportJob) in *AWS SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_job_id = '12345678901234567890123456789012'
oo_result = lo_mig->getdicomimportjob(
iv_datastoreid = iv_datastore_id
iv_jobid = iv_job_id ).
DATA(lo_job_props) = oo_result->get_jobproperties( ).
DATA(lv_job_status) = lo_job_props->get_jobstatus( ).
MESSAGE |Job status: { lv_job_status }.| 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 'Job not found.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta il riferimento all'API [Get DICOMImport Job](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK per SAP ABAP*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `GetDatastore` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `GetDatastore`.
------
#### [ Bash ]
**AWS CLI con lo script Bash**
```
###############################################################################
# function errecho
#
# This function outputs everything sent to it to STDERR (standard error output).
###############################################################################
function errecho() {
printf "%s\n" "$*" 1>&2
}
###############################################################################
# function imaging_get_datastore
#
# Get a data store's properties.
#
# Parameters:
# -i data_store_id - The ID of the data store.
#
# Returns:
# [datastore_name, datastore_id, datastore_status, datastore_arn, created_at, updated_at]
# And:
# 0 - If successful.
# 1 - If it fails.
###############################################################################
function imaging_get_datastore() {
local datastore_id option OPTARG # Required to use getopts command in a function.
local error_code
# bashsupport disable=BP5008
function usage() {
echo "function imaging_get_datastore"
echo "Gets a data store's properties."
echo " -i datastore_id - The ID of the data store."
echo ""
}
# Retrieve the calling parameters.
while getopts "i:h" option; do
case "${option}" in
i) datastore_id="${OPTARG}" ;;
h)
usage
return 0
;;
\?)
echo "Invalid parameter"
usage
return 1
;;
esac
done
export OPTIND=1
if [[ -z "$datastore_id" ]]; then
errecho "ERROR: You must provide a data store ID with the -i parameter."
usage
return 1
fi
local response
response=$(
aws medical-imaging get-datastore \
--datastore-id "$datastore_id" \
--output text \
--query "[ datastoreProperties.datastoreName, datastoreProperties.datastoreId, datastoreProperties.datastoreStatus, datastoreProperties.datastoreArn, datastoreProperties.createdAt, datastoreProperties.updatedAt]"
)
error_code=${?}
if [[ $error_code -ne 0 ]]; then
aws_cli_error_log $error_code
errecho "ERROR: AWS reports list-datastores operation failed.$response"
return 1
fi
echo "$response"
return 0
}
```
+ Per i dettagli sull'API, vedere [GetDatastore](https://docs.aws.amazon.com/goto/aws-cli/medical-imaging-2023-07-19/GetDatastore)in *AWS CLI Command Reference.*
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli/bash-linux/medical-imaging#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: per ottenere le proprietà di un data store**
L’esempio di codice `get-datastore` seguente ottiene le proprietà di un datastore.
```
aws medical-imaging get-datastore \
--datastore-id 12345678901234567890123456789012
```
Output:
```
{
"datastoreProperties": {
"datastoreId": "12345678901234567890123456789012",
"datastoreName": "TestDatastore123",
"datastoreStatus": "ACTIVE",
"losslessStorageFormat": "HTJ2K"
"datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
"createdAt": "2022-11-15T23:33:09.643000+00:00",
"updatedAt": "2022-11-15T23:33:09.643000+00:00"
}
}
```
**Esempio 2: Per configurare le proprietà del data store per JPEG2000**
Il seguente esempio di `get-datastore` codice ottiene le proprietà di un data store per un data store configurato per il formato di archiviazione JPEG 2000 Lossless.
```
aws medical-imaging get-datastore \
--datastore-id 12345678901234567890123456789012
```
Output:
```
{
"datastoreProperties": {
"datastoreId": "12345678901234567890123456789012",
"datastoreName": "TestDatastore123",
"datastoreStatus": "ACTIVE",
"losslessStorageFormat": "JPEG_2000_LOSSLESS",
"datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
"createdAt": "2022-11-15T23:33:09.643000+00:00",
"updatedAt": "2022-11-15T23:33:09.643000+00:00"
}
}
```
Per ulteriori informazioni, consulta [Ottenere le proprietà del data store](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-data-store.html) nella *AWS HealthImaging Developer Guide*.
+ Per i dettagli sull'API, consulta [GetDatastore AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-datastore.html)*Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
public static DatastoreProperties getMedicalImageDatastore(MedicalImagingClient medicalImagingClient,
String datastoreID) {
try {
GetDatastoreRequest datastoreRequest = GetDatastoreRequest.builder()
.datastoreId(datastoreID)
.build();
GetDatastoreResponse response = medicalImagingClient.getDatastore(datastoreRequest);
return response.datastoreProperties();
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
+ Per i dettagli sull'API, [GetDatastore](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetDatastore)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { GetDatastoreCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreID - The ID of the data store.
*/
export const getDatastore = async (datastoreID = "DATASTORE_ID") => {
const response = await medicalImagingClient.send(
new GetDatastoreCommand({ datastoreId: datastoreID }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '55ea7d2e-222c-4a6a-871e-4f591f40cadb',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreProperties: {
// createdAt: 2023-08-04T18:50:36.239Z,
// datastoreArn: 'arn:aws:medical-imaging:us-east-1:xxxxxxxxx:datastore/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreName: 'my_datastore',
// datastoreStatus: 'ACTIVE',
// updatedAt: 2023-08-04T18:50:36.239Z
// }
// }
return response.datastoreProperties;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [GetDatastore](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetDatastoreCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def get_datastore_properties(self, datastore_id):
"""
Get the properties of a data store.
:param datastore_id: The ID of the data store.
:return: The data store properties.
"""
try:
data_store = self.health_imaging_client.get_datastore(
datastoreId=datastore_id
)
except ClientError as err:
logger.error(
"Couldn't get data store %s. Here's why: %s: %s",
id,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return data_store["datastoreProperties"]
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [GetDatastore AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetDatastore)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
oo_result = lo_mig->getdatastore( iv_datastoreid = iv_datastore_id ).
DATA(lo_properties) = oo_result->get_datastoreproperties( ).
DATA(lv_name) = lo_properties->get_datastorename( ).
DATA(lv_status) = lo_properties->get_datastorestatus( ).
MESSAGE 'Data store properties retrieved.' TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' TYPE 'I'.
CATCH /aws1/cx_miginternalserverex.
MESSAGE 'Internal server error.' TYPE 'I'.
CATCH /aws1/cx_migresourcenotfoundex.
MESSAGE 'Data store not found.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [GetDatastore AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `GetImageFrame` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `GetImageFrame`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. Puoi vedere questa azione nel contesto nel seguente esempio di codice:
+ [Nozioni di base su set di immagini e frame di immagini](example_medical-imaging_Scenario_ImageSetsAndFrames_section.md)
------
#### [ C\$1\$1 ]
**SDK per C\$1\$1**
```
//! Routine which downloads an AWS HealthImaging image frame.
/*!
\param dataStoreID: The HealthImaging data store ID.
\param imageSetID: The image set ID.
\param frameID: The image frame ID.
\param jphFile: File to store the downloaded frame.
\param clientConfig: Aws client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::getImageFrame(const Aws::String &dataStoreID,
const Aws::String &imageSetID,
const Aws::String &frameID,
const Aws::String &jphFile,
const Aws::Client::ClientConfiguration &clientConfig) {
Aws::MedicalImaging::MedicalImagingClient client(clientConfig);
Aws::MedicalImaging::Model::GetImageFrameRequest request;
request.SetDatastoreId(dataStoreID);
request.SetImageSetId(imageSetID);
Aws::MedicalImaging::Model::ImageFrameInformation imageFrameInformation;
imageFrameInformation.SetImageFrameId(frameID);
request.SetImageFrameInformation(imageFrameInformation);
Aws::MedicalImaging::Model::GetImageFrameOutcome outcome = client.GetImageFrame(
request);
if (outcome.IsSuccess()) {
std::cout << "Successfully retrieved image frame." << std::endl;
auto &buffer = outcome.GetResult().GetImageFrameBlob();
std::ofstream outfile(jphFile, std::ios::binary);
outfile << buffer.rdbuf();
}
else {
std::cout << "Error retrieving image frame." << outcome.GetError().GetMessage()
<< std::endl;
}
return outcome.IsSuccess();
}
```
+ Per i dettagli sull'API, consulta [GetImageFrame AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/GetImageFrame)*API Reference.*
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Come ottenere i dati dei pixel del set di immagini**
L’esempio di codice `get-image-frame` seguente ottiene un image frame di immagine.
```
aws medical-imaging get-image-frame \
--datastore-id "12345678901234567890123456789012" \
--image-set-id "98765412345612345678907890789012" \
--image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \
imageframe.jph
```
Nota: questo esempio di codice non include l'output perché l' GetImageFrame azione restituisce un flusso di dati di pixel al file imageframe.jph. Per informazioni sulla decodifica e la visualizzazione dei frame di immagini, vedete K decoding libraries. HTJ2
Per ulteriori informazioni, consultate [Ottenere i dati dei pixel del set di immagini](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-frame.html) nella Guida per gli *AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [GetImageFrame AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-frame.html)*Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
public static void getMedicalImageSetFrame(MedicalImagingClient medicalImagingClient,
String destinationPath,
String datastoreId,
String imagesetId,
String imageFrameId) {
try {
GetImageFrameRequest getImageSetMetadataRequest = GetImageFrameRequest.builder()
.datastoreId(datastoreId)
.imageSetId(imagesetId)
.imageFrameInformation(ImageFrameInformation.builder()
.imageFrameId(imageFrameId)
.build())
.build();
medicalImagingClient.getImageFrame(getImageSetMetadataRequest,
FileSystems.getDefault().getPath(destinationPath));
System.out.println("Image frame downloaded to " + destinationPath);
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ Per i dettagli sull'API, [GetImageFrame](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageFrame)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { GetImageFrameCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} imageFrameFileName - The name of the file for the HTJ2K-encoded image frame.
* @param {string} datastoreID - The data store's ID.
* @param {string} imageSetID - The image set's ID.
* @param {string} imageFrameID - The image frame's ID.
*/
export const getImageFrame = async (
imageFrameFileName = "image.jph",
datastoreID = "DATASTORE_ID",
imageSetID = "IMAGE_SET_ID",
imageFrameID = "IMAGE_FRAME_ID",
) => {
const response = await medicalImagingClient.send(
new GetImageFrameCommand({
datastoreId: datastoreID,
imageSetId: imageSetID,
imageFrameInformation: { imageFrameId: imageFrameID },
}),
);
const buffer = await response.imageFrameBlob.transformToByteArray();
writeFileSync(imageFrameFileName, buffer);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'e4ab42a5-25a3-4377-873f-374ecf4380e1',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// contentType: 'application/octet-stream',
// imageFrameBlob: [ IncomingMessage {}
// }
return response;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [GetImageFrame](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageFrameCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def get_pixel_data(
self, file_path_to_write, datastore_id, image_set_id, image_frame_id
):
"""
Get an image frame's pixel data.
:param file_path_to_write: The path to write the image frame's HTJ2K encoded pixel data.
:param datastore_id: The ID of the data store.
:param image_set_id: The ID of the image set.
:param image_frame_id: The ID of the image frame.
"""
try:
image_frame = self.health_imaging_client.get_image_frame(
datastoreId=datastore_id,
imageSetId=image_set_id,
imageFrameInformation={"imageFrameId": image_frame_id},
)
with open(file_path_to_write, "wb") as f:
for chunk in image_frame["imageFrameBlob"].iter_chunks():
if chunk:
f.write(chunk)
except ClientError as err:
logger.error(
"Couldn't get image frame. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [GetImageFrame AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageFrame)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_image_set_id = '1234567890123456789012345678901234567890'
" iv_image_frame_id = '1234567890123456789012345678901234567890'
oo_result = lo_mig->getimageframe(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id
io_imageframeinformation = NEW /aws1/cl_migimageframeinfmtion(
iv_imageframeid = iv_image_frame_id ) ).
DATA(lv_frame_blob) = oo_result->get_imageframeblob( ).
MESSAGE 'Image frame retrieved.' 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 frame not found.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [GetImageFrame AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `GetImageSet` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `GetImageSet`.
------
#### [ CLI ]
**AWS CLI**
**Come ottenere le proprietà del set di immagini**
L’esempio di codice `get-image-set` seguente ottiene le proprietà di un set di immagini.
```
aws medical-imaging get-image-set \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 18f88ac7870584f58d56256646b4d92b \
--version-id 1
```
Output:
```
{
"versionId": "1",
"imageSetWorkflowStatus": "COPIED",
"updatedAt": 1680027253.471,
"imageSetId": "18f88ac7870584f58d56256646b4d92b",
"imageSetState": "ACTIVE",
"createdAt": 1679592510.753,
"datastoreId": "12345678901234567890123456789012"
}
```
Per ulteriori informazioni, consulta [Ottenere le proprietà del set di immagini](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-properties.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [GetImageSet AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set.html)*Command Reference*.
------
#### [ Java ]
**SDK per 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;
}
```
+ Per i dettagli sull'API, [GetImageSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageSet)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per 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;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [GetImageSet](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageSetCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per 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
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [GetImageSet AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageSet)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
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.
```
+ Per i dettagli sull'API, consulta [GetImageSet AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `GetImageSetMetadata` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `GetImageSetMetadata`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. Puoi vedere questa azione nel contesto nel seguente esempio di codice:
+ [Nozioni di base su set di immagini e frame di immagini](example_medical-imaging_Scenario_ImageSetsAndFrames_section.md)
------
#### [ C\$1\$1 ]
**SDK per C\$1\$1**
Funzione di utilità per ottenere i metadati del set di immagini.
```
//! Routine which gets a HealthImaging image set's metadata.
/*!
\param dataStoreID: The HealthImaging data store ID.
\param imageSetID: The HealthImaging image set ID.
\param versionID: The HealthImaging image set version ID, ignored if empty.
\param outputFilePath: The path where the metadata will be stored as gzipped json.
\param clientConfig: Aws client configuration.
\\return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::getImageSetMetadata(const Aws::String &dataStoreID,
const Aws::String &imageSetID,
const Aws::String &versionID,
const Aws::String &outputFilePath,
const Aws::Client::ClientConfiguration &clientConfig) {
Aws::MedicalImaging::Model::GetImageSetMetadataRequest request;
request.SetDatastoreId(dataStoreID);
request.SetImageSetId(imageSetID);
if (!versionID.empty()) {
request.SetVersionId(versionID);
}
Aws::MedicalImaging::MedicalImagingClient client(clientConfig);
Aws::MedicalImaging::Model::GetImageSetMetadataOutcome outcome = client.GetImageSetMetadata(
request);
if (outcome.IsSuccess()) {
std::ofstream file(outputFilePath, std::ios::binary);
auto &metadata = outcome.GetResult().GetImageSetMetadataBlob();
file << metadata.rdbuf();
}
else {
std::cerr << "Failed to get image set metadata: "
<< outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
Ottiene i metadati del set di immagini senza la versione.
```
if (AwsDoc::Medical_Imaging::getImageSetMetadata(dataStoreID, imageSetID, "", outputFilePath, clientConfig))
{
std::cout << "Successfully retrieved image set metadata." << std::endl;
std::cout << "Metadata stored in: " << outputFilePath << std::endl;
}
```
Ottiene i metadati del set di immagini con la versione.
```
if (AwsDoc::Medical_Imaging::getImageSetMetadata(dataStoreID, imageSetID, versionID, outputFilePath, clientConfig))
{
std::cout << "Successfully retrieved image set metadata." << std::endl;
std::cout << "Metadata stored in: " << outputFilePath << std::endl;
}
```
+ Per i dettagli sull'API, consulta [GetImageSetMetadata AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/GetImageSetMetadata)*API Reference.*
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: come ottenere i metadati del set di immagini senza versione.**
L’esempio di codice `get-image-set-metadata` seguente ottiene i metadati per un set di immagini senza specificare una versione.
Nota: `outfile` è un parametro obbligatorio.
```
aws medical-imaging get-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
studymetadata.json.gz
```
I metadati restituiti vengono compressi con gzip e archiviati nel file studymetadata.json.gz. Per visualizzare il contenuto dell’oggetto JSON restituito, devi prima decomprimerlo.
Output:
```
{
"contentType": "application/json",
"contentEncoding": "gzip"
}
```
**Esempio 2: come ottenere i metadati del set di immagini con versione**
L’esempio di codice `get-image-set-metadata` seguente ottiene i metadati per un set di immagini con una versione specificata.
Nota: `outfile` è un parametro obbligatorio.
```
aws medical-imaging get-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--version-id 1 \
studymetadata.json.gz
```
I metadati restituiti vengono compressi con gzip e archiviati nel file studymetadata.json.gz. Per visualizzare il contenuto dell’oggetto JSON restituito, devi prima decomprimerlo.
Output:
```
{
"contentType": "application/json",
"contentEncoding": "gzip"
}
```
Per ulteriori informazioni, consulta [Ottenere i metadati dei set di immagini](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-metadata.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [GetImageSetMetadata AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set-metadata.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
public static void getMedicalImageSetMetadata(MedicalImagingClient medicalImagingClient,
String destinationPath,
String datastoreId,
String imagesetId,
String versionId) {
try {
GetImageSetMetadataRequest.Builder getImageSetMetadataRequestBuilder = GetImageSetMetadataRequest.builder()
.datastoreId(datastoreId)
.imageSetId(imagesetId);
if (versionId != null) {
getImageSetMetadataRequestBuilder = getImageSetMetadataRequestBuilder.versionId(versionId);
}
medicalImagingClient.getImageSetMetadata(getImageSetMetadataRequestBuilder.build(),
FileSystems.getDefault().getPath(destinationPath));
System.out.println("Metadata downloaded to " + destinationPath);
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ Per i dettagli sull'API, [GetImageSetMetadata](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageSetMetadata)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
Funzione di utilità per ottenere i metadati del set di immagini.
```
import { GetImageSetMetadataCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
import { writeFileSync } from "node:fs";
/**
* @param {string} metadataFileName - The name of the file for the gzipped metadata.
* @param {string} datastoreId - The ID of the data store.
* @param {string} imagesetId - The ID of the image set.
* @param {string} versionID - The optional version ID of the image set.
*/
export const getImageSetMetadata = async (
metadataFileName = "metadata.json.gzip",
datastoreId = "xxxxxxxxxxxxxx",
imagesetId = "xxxxxxxxxxxxxx",
versionID = "",
) => {
const params = { datastoreId: datastoreId, imageSetId: imagesetId };
if (versionID) {
params.versionID = versionID;
}
const response = await medicalImagingClient.send(
new GetImageSetMetadataCommand(params),
);
const buffer = await response.imageSetMetadataBlob.transformToByteArray();
writeFileSync(metadataFileName, buffer);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '5219b274-30ff-4986-8cab-48753de3a599',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// contentType: 'application/json',
// contentEncoding: 'gzip',
// imageSetMetadataBlob: ][ IncomingMessage {}
// }
return response;
};
```
Ottiene i metadati del set di immagini senza la versione.
```
try {
await getImageSetMetadata(
"metadata.json.gzip",
"12345678901234567890123456789012",
"12345678901234567890123456789012",
);
} catch (err) {
console.log("Error", err);
}
```
Ottiene i metadati del set di immagini con la versione.
```
try {
await getImageSetMetadata(
"metadata2.json.gzip",
"12345678901234567890123456789012",
"12345678901234567890123456789012",
"1",
);
} catch (err) {
console.log("Error", err);
}
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [GetImageSetMetadata](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageSetMetadataCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
Funzione di utilità per ottenere i metadati del set di immagini.
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def get_image_set_metadata(
self, metadata_file, datastore_id, image_set_id, version_id=None
):
"""
Get the metadata of an image set.
:param metadata_file: The file to store the JSON gzipped metadata.
:param datastore_id: The ID of the data store.
:param image_set_id: The ID of the image set.
:param version_id: The version of the image set.
"""
try:
if version_id:
image_set_metadata = self.health_imaging_client.get_image_set_metadata(
imageSetId=image_set_id,
datastoreId=datastore_id,
versionId=version_id,
)
else:
image_set_metadata = self.health_imaging_client.get_image_set_metadata(
imageSetId=image_set_id, datastoreId=datastore_id
)
print(image_set_metadata)
with open(metadata_file, "wb") as f:
for chunk in image_set_metadata["imageSetMetadataBlob"].iter_chunks():
if chunk:
f.write(chunk)
except ClientError as err:
logger.error(
"Couldn't get image metadata. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
Ottiene i metadati del set di immagini senza la versione.
```
image_set_metadata = self.health_imaging_client.get_image_set_metadata(
imageSetId=image_set_id, datastoreId=datastore_id
)
```
Ottiene i metadati del set di immagini con la versione.
```
image_set_metadata = self.health_imaging_client.get_image_set_metadata(
imageSetId=image_set_id,
datastoreId=datastore_id,
versionId=version_id,
)
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [GetImageSetMetadata AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageSetMetadata)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
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->getimagesetmetadata(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id
iv_versionid = iv_version_id ).
ELSE.
oo_result = lo_mig->getimagesetmetadata(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id ).
ENDIF.
DATA(lv_metadata_blob) = oo_result->get_imagesetmetadatablob( ).
MESSAGE 'Image set metadata retrieved.' 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.
```
+ Per i dettagli sull'API, consulta [GetImageSetMetadata AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `ListDICOMImportJobs` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `ListDICOMImportJobs`.
------
#### [ CLI ]
**AWS CLI**
**Come elencare i processi di importazione DICOM**
L’esempio di codice `list-dicom-import-jobs` seguente elenca i processi di importazione DICOM.
```
aws medical-imaging list-dicom-import-jobs \
--datastore-id "12345678901234567890123456789012"
```
Output:
```
{
"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"
}
]
}
```
Per ulteriori informazioni, consulta [Elencare i lavori di importazione](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-dicom-import-jobs.html) nella *AWS HealthImaging Developer Guide*.
+ Per i dettagli sull'API, consulta [List DICOMImport Jobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-dicom-import-jobs.html) in *AWS CLI Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
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<>();
}
```
+ Per i dettagli sull'API, consulta [List DICOMImport Jobs](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/ListDICOMImportJobs) in *AWS SDK for Java 2.x API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
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;
};
```
+ Per i dettagli sull'API, consulta [List DICOMImport Jobs](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/ListDICOMImportJobsCommand) in *AWS SDK per JavaScript API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (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
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [List DICOMImport Jobs](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/ListDICOMImportJobs) in *AWS SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per 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.
```
+ Per i dettagli sull'API, consulta il riferimento all'API [List DICOMImport Jobs](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `ListDatastores` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `ListDatastores`.
------
#### [ Bash ]
**AWS CLI con lo script Bash**
```
###############################################################################
# function errecho
#
# This function outputs everything sent to it to STDERR (standard error output).
###############################################################################
function errecho() {
printf "%s\n" "$*" 1>&2
}
###############################################################################
# function imaging_list_datastores
#
# List the HealthImaging data stores in the account.
#
# Returns:
# [[datastore_name, datastore_id, datastore_status]]
# And:
# 0 - If successful.
# 1 - If it fails.
###############################################################################
function imaging_list_datastores() {
local option OPTARG # Required to use getopts command in a function.
local error_code
# bashsupport disable=BP5008
function usage() {
echo "function imaging_list_datastores"
echo "Lists the AWS HealthImaging data stores in the account."
echo ""
}
# Retrieve the calling parameters.
while getopts "h" option; do
case "${option}" in
h)
usage
return 0
;;
\?)
echo "Invalid parameter"
usage
return 1
;;
esac
done
export OPTIND=1
local response
response=$(aws medical-imaging list-datastores \
--output text \
--query "datastoreSummaries[*][datastoreName, datastoreId, datastoreStatus]")
error_code=${?}
if [[ $error_code -ne 0 ]]; then
aws_cli_error_log $error_code
errecho "ERROR: AWS reports list-datastores operation failed.$response"
return 1
fi
echo "$response"
return 0
}
```
+ Per i dettagli sull'API, vedere [ListDatastores](https://docs.aws.amazon.com/goto/aws-cli/medical-imaging-2023-07-19/ListDatastores)in *AWS CLI Command Reference.*
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli/bash-linux/medical-imaging#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Come elencare i datastore**
L’esempio di codice `list-datastores` seguente elenca i datastore disponibili.
```
aws medical-imaging list-datastores
```
Output:
```
{
"datastoreSummaries": [
{
"datastoreId": "12345678901234567890123456789012",
"datastoreName": "TestDatastore123",
"datastoreStatus": "ACTIVE",
"datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
"createdAt": "2022-11-15T23:33:09.643000+00:00",
"updatedAt": "2022-11-15T23:33:09.643000+00:00"
}
]
}
```
Per ulteriori informazioni, consulta [Elencare gli archivi di dati](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-data-stores.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [ListDatastores AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-datastores.html)*Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
public static List listMedicalImagingDatastores(MedicalImagingClient medicalImagingClient) {
try {
ListDatastoresRequest datastoreRequest = ListDatastoresRequest.builder()
.build();
ListDatastoresIterable responses = medicalImagingClient.listDatastoresPaginator(datastoreRequest);
List datastoreSummaries = new ArrayList<>();
responses.stream().forEach(response -> datastoreSummaries.addAll(response.datastoreSummaries()));
return datastoreSummaries;
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
+ Per i dettagli sull'API, [ListDatastores](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/ListDatastores)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { paginateListDatastores } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
export const listDatastores = async () => {
const paginatorConfig = {
client: medicalImagingClient,
pageSize: 50,
};
const commandParams = {};
const paginator = paginateListDatastores(paginatorConfig, commandParams);
/**
* @type {import("@aws-sdk/client-medical-imaging").DatastoreSummary[]}
*/
const datastoreSummaries = [];
for await (const page of paginator) {
// Each page contains a list of `jobSummaries`. The list is truncated if is larger than `pageSize`.
datastoreSummaries.push(...page.datastoreSummaries);
console.log(page);
}
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '6aa99231-d9c2-4716-a46e-edb830116fa3',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreSummaries: [
// {
// createdAt: 2023-08-04T18:49:54.429Z,
// datastoreArn: 'arn:aws:medical-imaging:us-east-1:xxxxxxxxx:datastore/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreName: 'my_datastore',
// datastoreStatus: 'ACTIVE',
// updatedAt: 2023-08-04T18:49:54.429Z
// }
// ...
// ]
// }
return datastoreSummaries;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [ListDatastores](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/ListDatastoresCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def list_datastores(self):
"""
List the data stores.
:return: The list of data stores.
"""
try:
paginator = self.health_imaging_client.get_paginator("list_datastores")
page_iterator = paginator.paginate()
datastore_summaries = []
for page in page_iterator:
datastore_summaries.extend(page["datastoreSummaries"])
except ClientError as err:
logger.error(
"Couldn't list data stores. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return datastore_summaries
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [ListDatastores AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/ListDatastores)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
oo_result = lo_mig->listdatastores( ).
DATA(lt_datastores) = oo_result->get_datastoresummaries( ).
DATA(lv_count) = lines( lt_datastores ).
MESSAGE |Found { lv_count } data stores.| TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' TYPE 'I'.
CATCH /aws1/cx_miginternalserverex.
MESSAGE 'Internal server error.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [ListDatastores AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `ListImageSetVersions` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `ListImageSetVersions`.
------
#### [ CLI ]
**AWS CLI**
**Come elencare le versioni dei set di immagini**
L’esempio di codice `list-image-set-versions` seguente elenca la cronologia delle versioni di un set di immagini.
```
aws medical-imaging list-image-set-versions \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e
```
Output:
```
{
"imageSetPropertiesList": [
{
"ImageSetWorkflowStatus": "UPDATED",
"versionId": "4",
"updatedAt": 1680029436.304,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"createdAt": 1680027126.436
},
{
"ImageSetWorkflowStatus": "UPDATED",
"versionId": "3",
"updatedAt": 1680029163.325,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"createdAt": 1680027126.436
},
{
"ImageSetWorkflowStatus": "COPY_FAILED",
"versionId": "2",
"updatedAt": 1680027455.944,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"message": "INVALID_REQUEST: Series of SourceImageSet and DestinationImageSet don't match.",
"createdAt": 1680027126.436
},
{
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"versionId": "1",
"ImageSetWorkflowStatus": "COPIED",
"createdAt": 1680027126.436
}
]
}
```
Per ulteriori informazioni, consulta [Elenco delle versioni dei set di immagini](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-image-set-versions.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [ListImageSetVersions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-image-set-versions.html)*Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
public static List listMedicalImageSetVersions(MedicalImagingClient medicalImagingClient,
String datastoreId,
String imagesetId) {
try {
ListImageSetVersionsRequest getImageSetRequest = ListImageSetVersionsRequest.builder()
.datastoreId(datastoreId)
.imageSetId(imagesetId)
.build();
ListImageSetVersionsIterable responses = medicalImagingClient
.listImageSetVersionsPaginator(getImageSetRequest);
List imageSetProperties = new ArrayList<>();
responses.stream().forEach(response -> imageSetProperties.addAll(response.imageSetPropertiesList()));
return imageSetProperties;
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
+ Per i dettagli sull'API, [ListImageSetVersions](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/ListImageSetVersions)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { paginateListImageSetVersions } 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.
*/
export const listImageSetVersions = async (
datastoreId = "xxxxxxxxxxxx",
imageSetId = "xxxxxxxxxxxx",
) => {
const paginatorConfig = {
client: medicalImagingClient,
pageSize: 50,
};
const commandParams = { datastoreId, imageSetId };
const paginator = paginateListImageSetVersions(
paginatorConfig,
commandParams,
);
const imageSetPropertiesList = [];
for await (const page of paginator) {
// Each page contains a list of `jobSummaries`. The list is truncated if is larger than `pageSize`.
imageSetPropertiesList.push(...page.imageSetPropertiesList);
console.log(page);
}
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '74590b37-a002-4827-83f2-3c590279c742',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// imageSetPropertiesList: [
// {
// ImageSetWorkflowStatus: 'CREATED',
// createdAt: 2023-09-22T14:49:26.427Z,
// imageSetId: 'xxxxxxxxxxxxxxxxxxxxxxx',
// imageSetState: 'ACTIVE',
// versionId: '1'
// }]
// }
return imageSetPropertiesList;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [ListImageSetVersions](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/ListImageSetVersionsCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def list_image_set_versions(self, datastore_id, image_set_id):
"""
List the image set versions.
:param datastore_id: The ID of the data store.
:param image_set_id: The ID of the image set.
:return: The list of image set versions.
"""
try:
paginator = self.health_imaging_client.get_paginator(
"list_image_set_versions"
)
page_iterator = paginator.paginate(
imageSetId=image_set_id, datastoreId=datastore_id
)
image_set_properties_list = []
for page in page_iterator:
image_set_properties_list.extend(page["imageSetPropertiesList"])
except ClientError as err:
logger.error(
"Couldn't list image set versions. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return image_set_properties_list
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [ListImageSetVersions AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/ListImageSetVersions)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_image_set_id = '1234567890123456789012345678901234567890'
oo_result = lo_mig->listimagesetversions(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id ).
DATA(lt_versions) = oo_result->get_imagesetpropertieslist( ).
DATA(lv_count) = lines( lt_versions ).
MESSAGE |Found { lv_count } image set versions.| 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.
```
+ Per i dettagli sull'API, consulta [ListImageSetVersions AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `ListTagsForResource` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `ListTagsForResource`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. È possibile visualizzare questa operazione nel contesto nei seguenti esempi di codice:
+ [Tagging di un datastore](example_medical-imaging_Scenario_TaggingDataStores_section.md)
+ [Tagging un set di immagini](example_medical-imaging_Scenario_TaggingImageSets_section.md)
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: come elencare i tag delle risorse per un datastore.**
L’esempio di codice `list-tags-for-resource` seguente elenca i tag di un datastore.
```
aws medical-imaging list-tags-for-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012"
```
Output:
```
{
"tags":{
"Deployment":"Development"
}
}
```
**Esempio 2: come elencare i tag delle risorse per un set di immagini**
L’esempio di codice `list-tags-for-resource` seguente elenca i tag di un set di immagini.
```
aws medical-imaging list-tags-for-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b"
```
Output:
```
{
"tags":{
"Deployment":"Development"
}
}
```
Per ulteriori informazioni, consulta [Tagging resources with AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) nella *AWS HealthImaging Developer* Guide.
+ Per i dettagli sull'API, consulta [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-tags-for-resource.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
public static ListTagsForResourceResponse listMedicalImagingResourceTags(MedicalImagingClient medicalImagingClient,
String resourceArn) {
try {
ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
.resourceArn(resourceArn)
.build();
return medicalImagingClient.listTagsForResource(listTagsForResourceRequest);
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
+ Per i dettagli sull'API, [ListTagsForResource](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/ListTagsForResource)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { ListTagsForResourceCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} resourceArn - The Amazon Resource Name (ARN) for the data store or image set.
*/
export const listTagsForResource = async (
resourceArn = "arn:aws:medical-imaging:us-east-1:abc:datastore/def/imageset/ghi",
) => {
const response = await medicalImagingClient.send(
new ListTagsForResourceCommand({ resourceArn: resourceArn }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '008fc6d3-abec-4870-a155-20fa3631e645',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// tags: { Deployment: 'Development' }
// }
return response;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [ListTagsForResource](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/ListTagsForResourceCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def list_tags_for_resource(self, resource_arn):
"""
List the tags for a resource.
:param resource_arn: The ARN of the resource.
:return: The list of tags.
"""
try:
tags = self.health_imaging_client.list_tags_for_resource(
resourceArn=resource_arn
)
except ClientError as err:
logger.error(
"Couldn't list tags for resource. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return tags["tags"]
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [ListTagsForResource AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/ListTagsForResource)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_resource_arn = 'arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012'
oo_result = lo_mig->listtagsforresource( iv_resourcearn = iv_resource_arn ).
DATA(lt_tags) = oo_result->get_tags( ).
DATA(lv_count) = lines( lt_tags ).
MESSAGE |Found { lv_count } tags for resource.| TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' 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.
```
+ Per i dettagli sull'API, consulta [ListTagsForResource AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `SearchImageSets` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `SearchImageSets`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. Puoi vedere questa azione nel contesto nel seguente esempio di codice:
+ [Nozioni di base su set di immagini e frame di immagini](example_medical-imaging_Scenario_ImageSetsAndFrames_section.md)
------
#### [ C\$1\$1 ]
**SDK per C\$1\$1**
La funzione di utilità per la ricerca di set di immagini.
```
//! Routine which searches for image sets based on defined input attributes.
/*!
\param dataStoreID: The HealthImaging data store ID.
\param searchCriteria: A search criteria instance.
\param imageSetResults: Vector to receive the image set IDs.
\param clientConfig: Aws client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::searchImageSets(const Aws::String &dataStoreID,
const Aws::MedicalImaging::Model::SearchCriteria &searchCriteria,
Aws::Vector &imageSetResults,
const Aws::Client::ClientConfiguration &clientConfig) {
Aws::MedicalImaging::MedicalImagingClient client(clientConfig);
Aws::MedicalImaging::Model::SearchImageSetsRequest request;
request.SetDatastoreId(dataStoreID);
request.SetSearchCriteria(searchCriteria);
Aws::String nextToken; // Used for paginated results.
bool result = true;
do {
if (!nextToken.empty()) {
request.SetNextToken(nextToken);
}
Aws::MedicalImaging::Model::SearchImageSetsOutcome outcome = client.SearchImageSets(
request);
if (outcome.IsSuccess()) {
for (auto &imageSetMetadataSummary: outcome.GetResult().GetImageSetsMetadataSummaries()) {
imageSetResults.push_back(imageSetMetadataSummary.GetImageSetId());
}
nextToken = outcome.GetResult().GetNextToken();
}
else {
std::cout << "Error: " << outcome.GetError().GetMessage() << std::endl;
result = false;
}
} while (!nextToken.empty());
return result;
}
```
Caso d’uso 1: operatore EQUAL.
```
Aws::Vector imageIDsForPatientID;
Aws::MedicalImaging::Model::SearchCriteria searchCriteriaEqualsPatientID;
Aws::Vector patientIDSearchFilters = {
Aws::MedicalImaging::Model::SearchFilter().WithOperator(Aws::MedicalImaging::Model::Operator::EQUAL)
.WithValues({Aws::MedicalImaging::Model::SearchByAttributeValue().WithDICOMPatientId(patientID)})
};
searchCriteriaEqualsPatientID.SetFilters(patientIDSearchFilters);
bool result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
searchCriteriaEqualsPatientID,
imageIDsForPatientID,
clientConfig);
if (result) {
std::cout << imageIDsForPatientID.size() << " image sets found for the patient with ID '"
<< patientID << "'." << std::endl;
for (auto &imageSetResult : imageIDsForPatientID) {
std::cout << " Image set with ID '" << imageSetResult << std::endl;
}
}
```
Caso d'uso \$12: operatore BETWEEN che utilizza DICOMStudy data e DICOMStudy ora.
```
Aws::MedicalImaging::Model::SearchByAttributeValue useCase2StartDate;
useCase2StartDate.SetDICOMStudyDateAndTime(Aws::MedicalImaging::Model::DICOMStudyDateAndTime()
.WithDICOMStudyDate("19990101")
.WithDICOMStudyTime("000000.000"));
Aws::MedicalImaging::Model::SearchByAttributeValue useCase2EndDate;
useCase2EndDate.SetDICOMStudyDateAndTime(Aws::MedicalImaging::Model::DICOMStudyDateAndTime()
.WithDICOMStudyDate(Aws::Utils::DateTime(std::chrono::system_clock::now()).ToLocalTimeString("%Y%m%d"))
.WithDICOMStudyTime("000000.000"));
Aws::MedicalImaging::Model::SearchFilter useCase2SearchFilter;
useCase2SearchFilter.SetValues({useCase2StartDate, useCase2EndDate});
useCase2SearchFilter.SetOperator(Aws::MedicalImaging::Model::Operator::BETWEEN);
Aws::MedicalImaging::Model::SearchCriteria useCase2SearchCriteria;
useCase2SearchCriteria.SetFilters({useCase2SearchFilter});
Aws::Vector usesCase2Results;
result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
useCase2SearchCriteria,
usesCase2Results,
clientConfig);
if (result) {
std::cout << usesCase2Results.size() << " image sets found for between 1999/01/01 and present."
<< std::endl;
for (auto &imageSetResult : usesCase2Results) {
std::cout << " Image set with ID '" << imageSetResult << std::endl;
}
}
```
Caso d’uso 3: operatore BETWEEN con createdAt. Gli studi relativi agli orari sono stati precedentemente resi persistenti.
```
Aws::MedicalImaging::Model::SearchByAttributeValue useCase3StartDate;
useCase3StartDate.SetCreatedAt(Aws::Utils::DateTime("20231130T000000000Z",Aws::Utils::DateFormat::ISO_8601_BASIC));
Aws::MedicalImaging::Model::SearchByAttributeValue useCase3EndDate;
useCase3EndDate.SetCreatedAt(Aws::Utils::DateTime(std::chrono::system_clock::now()));
Aws::MedicalImaging::Model::SearchFilter useCase3SearchFilter;
useCase3SearchFilter.SetValues({useCase3StartDate, useCase3EndDate});
useCase3SearchFilter.SetOperator(Aws::MedicalImaging::Model::Operator::BETWEEN);
Aws::MedicalImaging::Model::SearchCriteria useCase3SearchCriteria;
useCase3SearchCriteria.SetFilters({useCase3SearchFilter});
Aws::Vector usesCase3Results;
result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
useCase3SearchCriteria,
usesCase3Results,
clientConfig);
if (result) {
std::cout << usesCase3Results.size() << " image sets found for created between 2023/11/30 and present."
<< std::endl;
for (auto &imageSetResult : usesCase3Results) {
std::cout << " Image set with ID '" << imageSetResult << std::endl;
}
}
```
Caso d'uso \$14: operatore EQUAL su DICOMSeries instanceUID e BETWEEN su updatedAt e ordina la risposta in ordine ASC nel campo updatedAt.
```
Aws::MedicalImaging::Model::SearchByAttributeValue useCase4StartDate;
useCase4StartDate.SetUpdatedAt(Aws::Utils::DateTime("20231130T000000000Z",Aws::Utils::DateFormat::ISO_8601_BASIC));
Aws::MedicalImaging::Model::SearchByAttributeValue useCase4EndDate;
useCase4EndDate.SetUpdatedAt(Aws::Utils::DateTime(std::chrono::system_clock::now()));
Aws::MedicalImaging::Model::SearchFilter useCase4SearchFilterBetween;
useCase4SearchFilterBetween.SetValues({useCase4StartDate, useCase4EndDate});
useCase4SearchFilterBetween.SetOperator(Aws::MedicalImaging::Model::Operator::BETWEEN);
Aws::MedicalImaging::Model::SearchByAttributeValue seriesInstanceUID;
seriesInstanceUID.SetDICOMSeriesInstanceUID(dicomSeriesInstanceUID);
Aws::MedicalImaging::Model::SearchFilter useCase4SearchFilterEqual;
useCase4SearchFilterEqual.SetValues({seriesInstanceUID});
useCase4SearchFilterEqual.SetOperator(Aws::MedicalImaging::Model::Operator::EQUAL);
Aws::MedicalImaging::Model::SearchCriteria useCase4SearchCriteria;
useCase4SearchCriteria.SetFilters({useCase4SearchFilterBetween, useCase4SearchFilterEqual});
Aws::MedicalImaging::Model::Sort useCase4Sort;
useCase4Sort.SetSortField(Aws::MedicalImaging::Model::SortField::updatedAt);
useCase4Sort.SetSortOrder(Aws::MedicalImaging::Model::SortOrder::ASC);
useCase4SearchCriteria.SetSort(useCase4Sort);
Aws::Vector usesCase4Results;
result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
useCase4SearchCriteria,
usesCase4Results,
clientConfig);
if (result) {
std::cout << usesCase4Results.size() << " image sets found for EQUAL operator "
<< "on DICOMSeriesInstanceUID and BETWEEN on updatedAt and sort response\n"
<< "in ASC order on updatedAt field." << std::endl;
for (auto &imageSetResult : usesCase4Results) {
std::cout << " Image set with ID '" << imageSetResult << std::endl;
}
}
```
+ *Per i dettagli sull'API, consulta la sezione API Reference. [SearchImageSets](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/SearchImageSets)AWS SDK per C\$1\$1 *
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: come cercare set di immagini con un operatore EQUAL.**
L’esempio di codice `search-image-sets` seguente utilizza l’operatore EQUAL per cercare set di immagini in base a un valore specifico.
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenuto di `search-criteria.json`
```
{
"filters": [{
"values": [{"DICOMPatientId" : "SUBJECT08701"}],
"operator": "EQUAL"
}]
}
```
Output:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"updatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
**Esempio 2: Per cercare set di immagini con un operatore BETWEEN utilizzando DICOMStudy Data e DICOMStudy ora**
L’esempio `search-image-sets` seguente cerca set di immagini con studi DICOM generati tra il 1° gennaio 1990 (00:00) e il 1° gennaio 2023 (00:00).
Nota: l'DICOMStudyora è facoltativa. Se non presente, 00:00 (inizio della giornata) è il valore temporale per le date fornite per l’applicazione di filtri.
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenuto di `search-criteria.json`
```
{
"filters": [{
"values": [{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "19900101",
"DICOMStudyTime": "000000"
}
},
{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "20230101",
"DICOMStudyTime": "000000"
}
}],
"operator": "BETWEEN"
}]
}
```
Output:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"updatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
**Esempio 3: come cercare set di immagini con un operatore BETWEEN utilizzando createdAt (in precedenza gli studi temporali erano persistenti)**
Il seguente esempio di `search-image-sets` codice cerca set di immagini con DICOM Studies persistenti HealthImaging tra gli intervalli di tempo del fuso orario UTC.
Nota: fornisci createdAt nel formato dell’esempio (“1985-04-12T23:20:50.52Z”).
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenuto di `search-criteria.json`
```
{
"filters": [{
"values": [{
"createdAt": "1985-04-12T23:20:50.52Z"
},
{
"createdAt": "2022-04-12T23:20:50.52Z"
}],
"operator": "BETWEEN"
}]
}
```
Output:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
**Esempio 4: cercare set di immagini con un operatore EQUAL su DICOMSeries instanceUID e BETWEEN su updatedAt e ordinare la risposta in ordine ASC nel campo updatedAt**
Il seguente esempio di `search-image-sets` codice cerca i set di immagini con un operatore EQUAL su DICOMSeries instanceUID e BETWEEN su updatedAt e ordina la risposta in ordine ASC sul campo updatedAt.
Nota: fornisci updatedAt nel formato dell’esempio (“1985-04-12T23:20:50.52Z”).
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenuto di `search-criteria.json`
```
{
"filters": [{
"values": [{
"updatedAt": "2024-03-11T15:00:05.074000-07:00"
}, {
"updatedAt": "2024-03-11T16:00:05.074000-07:00"
}],
"operator": "BETWEEN"
}, {
"values": [{
"DICOMSeriesInstanceUID": "1.2.840.99999999.84710745.943275268089"
}],
"operator": "EQUAL"
}],
"sort": {
"sortField": "updatedAt",
"sortOrder": "ASC"
}
}
```
Output:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
[https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html](https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html)
+ Per i dettagli sull'API, consulta [SearchImageSets AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/search-image-sets.html)*Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
La funzione di utilità per la ricerca di set di immagini.
```
public static List searchMedicalImagingImageSets(
MedicalImagingClient medicalImagingClient,
String datastoreId, SearchCriteria searchCriteria) {
try {
SearchImageSetsRequest datastoreRequest = SearchImageSetsRequest.builder()
.datastoreId(datastoreId)
.searchCriteria(searchCriteria)
.build();
SearchImageSetsIterable responses = medicalImagingClient
.searchImageSetsPaginator(datastoreRequest);
List imageSetsMetadataSummaries = new ArrayList<>();
responses.stream().forEach(response -> imageSetsMetadataSummaries
.addAll(response.imageSetsMetadataSummaries()));
return imageSetsMetadataSummaries;
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
Caso d’uso 1: operatore EQUAL.
```
List searchFilters = Collections.singletonList(SearchFilter.builder()
.operator(Operator.EQUAL)
.values(SearchByAttributeValue.builder()
.dicomPatientId(patientId)
.build())
.build());
SearchCriteria searchCriteria = SearchCriteria.builder()
.filters(searchFilters)
.build();
List imageSetsMetadataSummaries = searchMedicalImagingImageSets(
medicalImagingClient,
datastoreId, searchCriteria);
if (imageSetsMetadataSummaries != null) {
System.out.println("The image sets for patient " + patientId + " are:\n"
+ imageSetsMetadataSummaries);
System.out.println();
}
```
Caso d'uso \$12: operatore BETWEEN che utilizza DICOMStudy data e DICOMStudy ora.
```
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyyMMdd");
searchFilters = Collections.singletonList(SearchFilter.builder()
.operator(Operator.BETWEEN)
.values(SearchByAttributeValue.builder()
.dicomStudyDateAndTime(DICOMStudyDateAndTime.builder()
.dicomStudyDate("19990101")
.dicomStudyTime("000000.000")
.build())
.build(),
SearchByAttributeValue.builder()
.dicomStudyDateAndTime(DICOMStudyDateAndTime.builder()
.dicomStudyDate((LocalDate.now()
.format(formatter)))
.dicomStudyTime("000000.000")
.build())
.build())
.build());
searchCriteria = SearchCriteria.builder()
.filters(searchFilters)
.build();
imageSetsMetadataSummaries = searchMedicalImagingImageSets(medicalImagingClient,
datastoreId, searchCriteria);
if (imageSetsMetadataSummaries != null) {
System.out.println(
"The image sets searched with BETWEEN operator using DICOMStudyDate and DICOMStudyTime are:\n"
+
imageSetsMetadataSummaries);
System.out.println();
}
```
Caso d’uso 3: operatore BETWEEN con createdAt. Gli studi relativi agli orari sono stati precedentemente resi persistenti.
```
searchFilters = Collections.singletonList(SearchFilter.builder()
.operator(Operator.BETWEEN)
.values(SearchByAttributeValue.builder()
.createdAt(Instant.parse("1985-04-12T23:20:50.52Z"))
.build(),
SearchByAttributeValue.builder()
.createdAt(Instant.now())
.build())
.build());
searchCriteria = SearchCriteria.builder()
.filters(searchFilters)
.build();
imageSetsMetadataSummaries = searchMedicalImagingImageSets(medicalImagingClient,
datastoreId, searchCriteria);
if (imageSetsMetadataSummaries != null) {
System.out.println("The image sets searched with BETWEEN operator using createdAt are:\n "
+ imageSetsMetadataSummaries);
System.out.println();
}
```
Caso d'uso \$14: operatore EQUAL su DICOMSeries instanceUID e BETWEEN su updatedAt e ordina la risposta in ordine ASC nel campo updatedAt.
```
Instant startDate = Instant.parse("1985-04-12T23:20:50.52Z");
Instant endDate = Instant.now();
searchFilters = Arrays.asList(
SearchFilter.builder()
.operator(Operator.EQUAL)
.values(SearchByAttributeValue.builder()
.dicomSeriesInstanceUID(seriesInstanceUID)
.build())
.build(),
SearchFilter.builder()
.operator(Operator.BETWEEN)
.values(
SearchByAttributeValue.builder().updatedAt(startDate).build(),
SearchByAttributeValue.builder().updatedAt(endDate).build()
).build());
Sort sort = Sort.builder().sortOrder(SortOrder.ASC).sortField(SortField.UPDATED_AT).build();
searchCriteria = SearchCriteria.builder()
.filters(searchFilters)
.sort(sort)
.build();
imageSetsMetadataSummaries = searchMedicalImagingImageSets(medicalImagingClient,
datastoreId, searchCriteria);
if (imageSetsMetadataSummaries != null) {
System.out.println("The image sets searched with EQUAL operator on DICOMSeriesInstanceUID and BETWEEN on updatedAt and sort response\n" +
"in ASC order on updatedAt field are:\n "
+ imageSetsMetadataSummaries);
System.out.println();
}
```
+ *Per i dettagli sull'API, consulta la sezione API Reference. [SearchImageSets](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/SearchImageSets)AWS SDK for Java 2.x *
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
La funzione di utilità per la ricerca di set di immagini.
```
import { paginateSearchImageSets } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreId - The data store's ID.
* @param { import('@aws-sdk/client-medical-imaging').SearchFilter[] } filters - The search criteria filters.
* @param { import('@aws-sdk/client-medical-imaging').Sort } sort - The search criteria sort.
*/
export const searchImageSets = async (
datastoreId = "xxxxxxxx",
searchCriteria = {},
) => {
const paginatorConfig = {
client: medicalImagingClient,
pageSize: 50,
};
const commandParams = {
datastoreId: datastoreId,
searchCriteria: searchCriteria,
};
const paginator = paginateSearchImageSets(paginatorConfig, commandParams);
const imageSetsMetadataSummaries = [];
for await (const page of paginator) {
// Each page contains a list of `jobSummaries`. The list is truncated if is larger than `pageSize`.
imageSetsMetadataSummaries.push(...page.imageSetsMetadataSummaries);
console.log(page);
}
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'f009ea9c-84ca-4749-b5b6-7164f00a5ada',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// imageSetsMetadataSummaries: [
// {
// DICOMTags: [Object],
// createdAt: "2023-09-19T16:59:40.551Z",
// imageSetId: '7f75e1b5c0f40eac2b24cf712f485f50',
// updatedAt: "2023-09-19T16:59:40.551Z",
// version: 1
// }]
// }
return imageSetsMetadataSummaries;
};
```
Caso d’uso 1: operatore EQUAL.
```
const datastoreId = "12345678901234567890123456789012";
try {
const searchCriteria = {
filters: [
{
values: [{ DICOMPatientId: "1234567" }],
operator: "EQUAL",
},
],
};
await searchImageSets(datastoreId, searchCriteria);
} catch (err) {
console.error(err);
}
```
Caso d'uso \$12: operatore BETWEEN che utilizza DICOMStudy data e DICOMStudy ora.
```
const datastoreId = "12345678901234567890123456789012";
try {
const searchCriteria = {
filters: [
{
values: [
{
DICOMStudyDateAndTime: {
DICOMStudyDate: "19900101",
DICOMStudyTime: "000000",
},
},
{
DICOMStudyDateAndTime: {
DICOMStudyDate: "20230901",
DICOMStudyTime: "000000",
},
},
],
operator: "BETWEEN",
},
],
};
await searchImageSets(datastoreId, searchCriteria);
} catch (err) {
console.error(err);
}
```
Caso d’uso 3: operatore BETWEEN con createdAt. Gli studi relativi agli orari sono stati precedentemente resi persistenti.
```
const datastoreId = "12345678901234567890123456789012";
try {
const searchCriteria = {
filters: [
{
values: [
{ createdAt: new Date("1985-04-12T23:20:50.52Z") },
{ createdAt: new Date() },
],
operator: "BETWEEN",
},
],
};
await searchImageSets(datastoreId, searchCriteria);
} catch (err) {
console.error(err);
}
```
Caso d'uso \$14: operatore EQUAL su DICOMSeries instanceUID e BETWEEN su updatedAt e ordina la risposta in ordine ASC nel campo updatedAt.
```
const datastoreId = "12345678901234567890123456789012";
try {
const searchCriteria = {
filters: [
{
values: [
{ updatedAt: new Date("1985-04-12T23:20:50.52Z") },
{ updatedAt: new Date() },
],
operator: "BETWEEN",
},
{
values: [
{
DICOMSeriesInstanceUID:
"1.1.123.123456.1.12.1.1234567890.1234.12345678.123",
},
],
operator: "EQUAL",
},
],
sort: {
sortOrder: "ASC",
sortField: "updatedAt",
},
};
await searchImageSets(datastoreId, searchCriteria);
} catch (err) {
console.error(err);
}
```
+ *Per i dettagli sull'API, consulta la sezione API Reference. [SearchImageSets](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/SearchImageSetsCommand)AWS SDK per JavaScript *
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
La funzione di utilità per la ricerca di set di immagini.
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def search_image_sets(self, datastore_id, search_filter):
"""
Search for image sets.
:param datastore_id: The ID of the data store.
:param search_filter: The search filter.
For example: {"filters" : [{ "operator": "EQUAL", "values": [{"DICOMPatientId": "3524578"}]}]}.
:return: The list of image sets.
"""
try:
paginator = self.health_imaging_client.get_paginator("search_image_sets")
page_iterator = paginator.paginate(
datastoreId=datastore_id, searchCriteria=search_filter
)
metadata_summaries = []
for page in page_iterator:
metadata_summaries.extend(page["imageSetsMetadataSummaries"])
except ClientError as err:
logger.error(
"Couldn't search image sets. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return metadata_summaries
```
Caso d’uso 1: operatore EQUAL.
```
search_filter = {
"filters": [
{"operator": "EQUAL", "values": [{"DICOMPatientId": patient_id}]}
]
}
image_sets = self.search_image_sets(data_store_id, search_filter)
print(f"Image sets found with EQUAL operator\n{image_sets}")
```
Caso d'uso \$12: operatore BETWEEN che utilizza DICOMStudy data e DICOMStudy ora.
```
search_filter = {
"filters": [
{
"operator": "BETWEEN",
"values": [
{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "19900101",
"DICOMStudyTime": "000000",
}
},
{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "20230101",
"DICOMStudyTime": "000000",
}
},
],
}
]
}
image_sets = self.search_image_sets(data_store_id, search_filter)
print(
f"Image sets found with BETWEEN operator using DICOMStudyDate and DICOMStudyTime\n{image_sets}"
)
```
Caso d’uso 3: operatore BETWEEN con createdAt. Gli studi relativi agli orari sono stati precedentemente resi persistenti.
```
search_filter = {
"filters": [
{
"values": [
{
"createdAt": datetime.datetime(
2021, 8, 4, 14, 49, 54, 429000
)
},
{
"createdAt": datetime.datetime.now()
+ datetime.timedelta(days=1)
},
],
"operator": "BETWEEN",
}
]
}
recent_image_sets = self.search_image_sets(data_store_id, search_filter)
print(
f"Image sets found with with BETWEEN operator using createdAt\n{recent_image_sets}"
)
```
Caso d'uso \$14: operatore EQUAL su DICOMSeries instanceUID e BETWEEN su updatedAt e ordina la risposta in ordine ASC nel campo updatedAt.
```
search_filter = {
"filters": [
{
"values": [
{
"updatedAt": datetime.datetime(
2021, 8, 4, 14, 49, 54, 429000
)
},
{
"updatedAt": datetime.datetime.now()
+ datetime.timedelta(days=1)
},
],
"operator": "BETWEEN",
},
{
"values": [{"DICOMSeriesInstanceUID": series_instance_uid}],
"operator": "EQUAL",
},
],
"sort": {
"sortOrder": "ASC",
"sortField": "updatedAt",
},
}
image_sets = self.search_image_sets(data_store_id, search_filter)
print(
"Image sets found with EQUAL operator on DICOMSeriesInstanceUID and BETWEEN on updatedAt and"
)
print(f"sort response in ASC order on updatedAt field\n{image_sets}")
```
Il codice seguente crea un'istanza dell'oggetto. MedicalImagingWrapper
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [SearchImageSets AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/SearchImageSets)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
oo_result = lo_mig->searchimagesets(
iv_datastoreid = iv_datastore_id
io_searchcriteria = io_search_criteria ).
DATA(lt_imagesets) = oo_result->get_imagesetsmetadatasums( ).
DATA(lv_count) = lines( lt_imagesets ).
MESSAGE |Found { lv_count } image sets.| 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.
```
+ Per i dettagli sull'API, consulta [SearchImageSets AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `StartDICOMImportJob` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `StartDICOMImportJob`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. Puoi vedere questa azione nel contesto nel seguente esempio di codice:
+ [Nozioni di base su set di immagini e frame di immagini](example_medical-imaging_Scenario_ImageSetsAndFrames_section.md)
------
#### [ C\$1\$1 ]
**SDK per C\$1\$1**
```
//! Routine which starts a HealthImaging import job.
/*!
\param dataStoreID: The HealthImaging data store ID.
\param inputBucketName: The name of the Amazon S3 bucket containing the DICOM files.
\param inputDirectory: The directory in the S3 bucket containing the DICOM files.
\param outputBucketName: The name of the S3 bucket for the output.
\param outputDirectory: The directory in the S3 bucket to store the output.
\param roleArn: The ARN of the IAM role with permissions for the import.
\param importJobId: A string to receive the import job ID.
\param clientConfig: Aws client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::startDICOMImportJob(
const Aws::String &dataStoreID, const Aws::String &inputBucketName,
const Aws::String &inputDirectory, const Aws::String &outputBucketName,
const Aws::String &outputDirectory, const Aws::String &roleArn,
Aws::String &importJobId,
const Aws::Client::ClientConfiguration &clientConfig) {
Aws::MedicalImaging::MedicalImagingClient medicalImagingClient(clientConfig);
Aws::String inputURI = "s3://" + inputBucketName + "/" + inputDirectory + "/";
Aws::String outputURI = "s3://" + outputBucketName + "/" + outputDirectory + "/";
Aws::MedicalImaging::Model::StartDICOMImportJobRequest startDICOMImportJobRequest;
startDICOMImportJobRequest.SetDatastoreId(dataStoreID);
startDICOMImportJobRequest.SetDataAccessRoleArn(roleArn);
startDICOMImportJobRequest.SetInputS3Uri(inputURI);
startDICOMImportJobRequest.SetOutputS3Uri(outputURI);
Aws::MedicalImaging::Model::StartDICOMImportJobOutcome startDICOMImportJobOutcome = medicalImagingClient.StartDICOMImportJob(
startDICOMImportJobRequest);
if (startDICOMImportJobOutcome.IsSuccess()) {
importJobId = startDICOMImportJobOutcome.GetResult().GetJobId();
}
else {
std::cerr << "Failed to start DICOM import job because "
<< startDICOMImportJobOutcome.GetError().GetMessage() << std::endl;
}
return startDICOMImportJobOutcome.IsSuccess();
}
```
+ Per i dettagli sull'API, consulta [Start DICOMImport Job](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/StartDICOMImportJob) in *AWS SDK per C\$1\$1 API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples).
------
#### [ CLI ]
**AWS CLI**
**Come avviare un processo di importazione DICOM**
L’esempio di codice `start-dicom-import-job` seguente avvia un processo di importazione DICOM.
```
aws medical-imaging start-dicom-import-job \
--job-name "my-job" \
--datastore-id "12345678901234567890123456789012" \
--input-s3-uri "s3://medical-imaging-dicom-input/dicom_input/" \
--output-s3-uri "s3://medical-imaging-output/job_output/" \
--data-access-role-arn "arn:aws:iam::123456789012:role/ImportJobDataAccessRole"
```
Output:
```
{
"datastoreId": "12345678901234567890123456789012",
"jobId": "09876543210987654321098765432109",
"jobStatus": "SUBMITTED",
"submittedAt": "2022-08-12T11:28:11.152000+00:00"
}
```
Per ulteriori informazioni, consulta [Avvio di un processo di importazione](https://docs.aws.amazon.com/healthimaging/latest/devguide/start-dicom-import-job.html) nella *Guida per gli AWS HealthImaging sviluppatori*.
+ Per i dettagli sull'API, consulta [Start DICOMImport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/start-dicom-import-job.html) in *AWS CLI Command Reference*.
------
#### [ Java ]
**SDK per Java 2.x**
```
public static String startDicomImportJob(MedicalImagingClient medicalImagingClient,
String jobName,
String datastoreId,
String dataAccessRoleArn,
String inputS3Uri,
String outputS3Uri) {
try {
StartDicomImportJobRequest startDicomImportJobRequest = StartDicomImportJobRequest.builder()
.jobName(jobName)
.datastoreId(datastoreId)
.dataAccessRoleArn(dataAccessRoleArn)
.inputS3Uri(inputS3Uri)
.outputS3Uri(outputS3Uri)
.build();
StartDicomImportJobResponse response = medicalImagingClient.startDICOMImportJob(startDicomImportJobRequest);
return response.jobId();
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return "";
}
```
+ Per i dettagli sull'API, consulta [Start DICOMImport Job](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/StartDICOMImportJob) in *AWS SDK for Java 2.x API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { StartDICOMImportJobCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} jobName - The name of the import job.
* @param {string} datastoreId - The ID of the data store.
* @param {string} dataAccessRoleArn - The Amazon Resource Name (ARN) of the role that grants permission.
* @param {string} inputS3Uri - The URI of the S3 bucket containing the input files.
* @param {string} outputS3Uri - The URI of the S3 bucket where the output files are stored.
*/
export const startDicomImportJob = async (
jobName = "test-1",
datastoreId = "12345678901234567890123456789012",
dataAccessRoleArn = "arn:aws:iam::xxxxxxxxxxxx:role/ImportJobDataAccessRole",
inputS3Uri = "s3://medical-imaging-dicom-input/dicom_input/",
outputS3Uri = "s3://medical-imaging-output/job_output/",
) => {
const response = await medicalImagingClient.send(
new StartDICOMImportJobCommand({
jobName: jobName,
datastoreId: datastoreId,
dataAccessRoleArn: dataAccessRoleArn,
inputS3Uri: inputS3Uri,
outputS3Uri: outputS3Uri,
}),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '6e81d191-d46b-4e48-a08a-cdcc7e11eb79',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// jobId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// jobStatus: 'SUBMITTED',
// submittedAt: 2023-09-22T14:48:45.767Z
// }
return response;
};
```
+ Per i dettagli sull'API, consulta [Start DICOMImport Job](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/StartDICOMImportJobCommand) in *AWS SDK per JavaScript API Reference*.
C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def start_dicom_import_job(
self, job_name, datastore_id, role_arn, input_s3_uri, output_s3_uri
):
"""
Start a DICOM import job.
:param job_name: The name of the job.
:param datastore_id: The ID of the data store.
:param role_arn: The Amazon Resource Name (ARN) of the role to use for the job.
:param input_s3_uri: The S3 bucket input prefix path containing the DICOM files.
:param output_s3_uri: The S3 bucket output prefix path for the result.
:return: The job ID.
"""
try:
job = self.health_imaging_client.start_dicom_import_job(
jobName=job_name,
datastoreId=datastore_id,
dataAccessRoleArn=role_arn,
inputS3Uri=input_s3_uri,
outputS3Uri=output_s3_uri,
)
except ClientError as err:
logger.error(
"Couldn't start DICOM import job. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return job["jobId"]
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [Start DICOMImport Job](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/StartDICOMImportJob) in *AWS SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_job_name = 'import-job-1'
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_role_arn = 'arn:aws:iam::123456789012:role/ImportJobRole'
" iv_input_s3_uri = 's3://my-bucket/input/'
" iv_output_s3_uri = 's3://my-bucket/output/'
oo_result = lo_mig->startdicomimportjob(
iv_jobname = iv_job_name
iv_datastoreid = iv_datastore_id
iv_dataaccessrolearn = iv_role_arn
iv_inputs3uri = iv_input_s3_uri
iv_outputs3uri = iv_output_s3_uri ).
DATA(lv_job_id) = oo_result->get_jobid( ).
MESSAGE |DICOM import job started with ID: { lv_job_id }.| 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_migservicequotaexcdex.
MESSAGE 'Service quota exceeded.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [Start DICOMImport Job](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK per il riferimento all'API SAP ABAP*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `TagResource` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `TagResource`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. È possibile visualizzare questa operazione nel contesto nei seguenti esempi di codice:
+ [Tagging di un datastore](example_medical-imaging_Scenario_TaggingDataStores_section.md)
+ [Tagging un set di immagini](example_medical-imaging_Scenario_TaggingImageSets_section.md)
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: come applicare tag a un datastore.**
L’esempio `tag-resource` seguente aggiunge tag a un datastore.
```
aws medical-imaging tag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
--tags '{"Deployment":"Development"}'
```
Questo comando non produce alcun output.
**Esempio 2: come applicare tag a un set di immagini**
L’esempio `tag-resource` seguente tagga un set di immagini.
```
aws medical-imaging tag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
--tags '{"Deployment":"Development"}'
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Tagging resources with AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) nella *AWS HealthImaging Developer* Guide.
+ Per i dettagli sull'API, consulta [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/tag-resource.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
public static void tagMedicalImagingResource(MedicalImagingClient medicalImagingClient,
String resourceArn,
Map tags) {
try {
TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
.resourceArn(resourceArn)
.tags(tags)
.build();
medicalImagingClient.tagResource(tagResourceRequest);
System.out.println("Tags have been added to the resource.");
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ Per i dettagli sull'API, [TagResource](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/TagResource)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { TagResourceCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} resourceArn - The Amazon Resource Name (ARN) for the data store or image set.
* @param {Record} tags - The tags to add to the resource as JSON.
* - For example: {"Deployment" : "Development"}
*/
export const tagResource = async (
resourceArn = "arn:aws:medical-imaging:us-east-1:xxxxxx:datastore/xxxxx/imageset/xxx",
tags = {},
) => {
const response = await medicalImagingClient.send(
new TagResourceCommand({ resourceArn: resourceArn, tags: tags }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 204,
// requestId: '8a6de9a3-ec8e-47ef-8643-473518b19d45',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// }
// }
return response;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [TagResource](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/TagResourceCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def tag_resource(self, resource_arn, tags):
"""
Tag a resource.
:param resource_arn: The ARN of the resource.
:param tags: The tags to apply.
"""
try:
self.health_imaging_client.tag_resource(resourceArn=resource_arn, tags=tags)
except ClientError as err:
logger.error(
"Couldn't tag resource. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [TagResource AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/TagResource)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_resource_arn = 'arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012'
lo_mig->tagresource(
iv_resourcearn = iv_resource_arn
it_tags = it_tags ).
MESSAGE 'Resource tagged successfully.' TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' 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.
```
+ Per i dettagli sull'API, consulta [TagResource AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `UntagResource` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `UntagResource`.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. È possibile visualizzare questa operazione nel contesto nei seguenti esempi di codice:
+ [Tagging di un datastore](example_medical-imaging_Scenario_TaggingDataStores_section.md)
+ [Tagging un set di immagini](example_medical-imaging_Scenario_TaggingImageSets_section.md)
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: come rimuovere i tag da un datastore.**
L’esempio di codice `untag-resource` seguente rimuove i tag da un datastore.
```
aws medical-imaging untag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
--tag-keys '["Deployment"]'
```
Questo comando non produce alcun output.
**Esempio 2: come rimuovere i tag da un set di immagini**
L’esempio `untag-resource` seguente rimuove i tag da un set di immagini.
```
aws medical-imaging untag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
--tag-keys '["Deployment"]'
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Tagging resources with AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) nella *AWS HealthImaging Developer* Guide.
+ Per i dettagli sull'API, consulta [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/untag-resource.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
public static void untagMedicalImagingResource(MedicalImagingClient medicalImagingClient,
String resourceArn,
Collection tagKeys) {
try {
UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
.resourceArn(resourceArn)
.tagKeys(tagKeys)
.build();
medicalImagingClient.untagResource(untagResourceRequest);
System.out.println("Tags have been removed from the resource.");
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ Per i dettagli sull'API, [UntagResource](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/UntagResource)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { UntagResourceCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} resourceArn - The Amazon Resource Name (ARN) for the data store or image set.
* @param {string[]} tagKeys - The keys of the tags to remove.
*/
export const untagResource = async (
resourceArn = "arn:aws:medical-imaging:us-east-1:xxxxxx:datastore/xxxxx/imageset/xxx",
tagKeys = [],
) => {
const response = await medicalImagingClient.send(
new UntagResourceCommand({ resourceArn: resourceArn, tagKeys: tagKeys }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 204,
// requestId: '8a6de9a3-ec8e-47ef-8643-473518b19d45',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// }
// }
return response;
};
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [UntagResource](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/UntagResourceCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def untag_resource(self, resource_arn, tag_keys):
"""
Untag a resource.
:param resource_arn: The ARN of the resource.
:param tag_keys: The tag keys to remove.
"""
try:
self.health_imaging_client.untag_resource(
resourceArn=resource_arn, tagKeys=tag_keys
)
except ClientError as err:
logger.error(
"Couldn't untag resource. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ Per i dettagli sull'API, consulta [UntagResource AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/UntagResource)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_resource_arn = 'arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012'
lo_mig->untagresource(
iv_resourcearn = iv_resource_arn
it_tagkeys = it_tag_keys ).
MESSAGE 'Resource untagged successfully.' TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' 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.
```
+ Per i dettagli sull'API, consulta [UntagResource AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.
# Utilizzo `UpdateImageSetMetadata` con un AWS SDK o una CLI
Gli esempi di codice seguenti mostrano come utilizzare `UpdateImageSetMetadata`.
------
#### [ CLI ]
**AWS CLI**
**Esempio 1: come inserire o aggiornare un attributo nei metadati del set di immagini**
L’esempio `update-image-set-metadata` seguente inserisce o aggiorna un attributo nei metadati del set di immagini.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates file://metadata-updates.json
```
Contenuto di `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"MX^MX\"}}}"
}
}
```
Output:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Esempio 2: come rimuovere un attributo dai metadati del set di immagini**
L’esempio `update-image-set-metadata` seguente rimuove un attributo dai metadati del set di immagini.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates file://metadata-updates.json
```
Contenuto di `metadata-updates.json`
```
{
"DICOMUpdates": {
"removableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"DICOM\":{\"StudyDescription\":\"CHEST\"}}}"
}
}
```
Output:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Esempio 3: come rimuovere un’istanza dai metadati del set di immagini**
L’esempio `update-image-set-metadata` seguente rimuove un’istanza dai metadati del set di immagini.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates file://metadata-updates.json \
--force
```
Contenuto di `metadata-updates.json`
```
{
"DICOMUpdates": {
"removableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {}}}}}}"
}
}
```
Output:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Esempio 4: come ripristinare la versione precedente di un set di immagini**
L'`update-image-set-metadata`esempio seguente mostra come ripristinare una versione precedente di un'immagine impostata. CopyImageSet e UpdateImageSetMetadata le azioni creano nuove versioni dei set di immagini.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 3 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates '{"revertToVersionId": "1"}'
```
Output:
```
{
"datastoreId": "12345678901234567890123456789012",
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"latestVersionId": "4",
"imageSetState": "LOCKED",
"imageSetWorkflowStatus": "UPDATING",
"createdAt": 1680027126.436,
"updatedAt": 1680042257.908
}
```
**Esempio 5: come aggiungere un elemento di dati DICOM privato a un’istanza**
L’esempio `update-image-set-metadata` seguente aggiunge un elemento privato a un’istanza specificata all’interno di un set di immagini. Lo standard DICOM consente di utilizzare elementi di dati privati nella comunicazione di informazioni che non possono essere contenute in elementi di dati standard. È possibile creare, aggiornare ed eliminare elementi di dati privati con l'UpdateImageSetMetadata azione.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--force \
--update-image-set-metadata-updates file://metadata-updates.json
```
Contenuto di `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"001910F9\": \"97\"},\"DICOMVRs\": {\"001910F9\": \"DS\"}}}}}}}"
}
}
```
Output:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Esempio 6: come aggiornare un elemento di dati DICOM privato a un’istanza**
L’esempio `update-image-set-metadata` seguente aggiorna il valore di un elemento dati privato appartenente a un’istanza all’interno di un set di immagini.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--force \
--update-image-set-metadata-updates file://metadata-updates.json
```
Contenuto di `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"00091001\": \"GE_GENESIS_DD\"}}}}}}}"
}
}
```
Output:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Esempio 7: aggiornare un SOPInstance UID con il parametro force**
L'`update-image-set-metadata`esempio seguente mostra come aggiornare un SOPInstance UID, utilizzando il parametro force per sovrascrivere i vincoli dei metadati DICOM.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--force \
--update-image-set-metadata-updates file://metadata-updates.json
```
Contenuto di `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"Series\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3656.0\":{\"Instances\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.0\":{\"DICOM\":{\"SOPInstanceUID\":\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.9\"}}}}}}}"
}
}
```
Output:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
*Per ulteriori informazioni, consultate [Updating image set](https://docs.aws.amazon.com/healthimaging/latest/devguide/update-image-set-metadata.html) metadata nella Developer Guide.AWS HealthImaging *
+ Per i dettagli sull'API, consulta [UpdateImageSetMetadata AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/update-image-set-metadata.html)*Command Reference.*
------
#### [ Java ]
**SDK per Java 2.x**
```
/**
* Update the metadata of an AWS HealthImaging image set.
*
* @param medicalImagingClient - The AWS HealthImaging client object.
* @param datastoreId - The datastore ID.
* @param imageSetId - The image set ID.
* @param versionId - The version ID.
* @param metadataUpdates - A MetadataUpdates object containing the updates.
* @param force - The force flag.
* @throws MedicalImagingException - Base exception for all service exceptions thrown by AWS HealthImaging.
*/
public static void updateMedicalImageSetMetadata(MedicalImagingClient medicalImagingClient,
String datastoreId,
String imageSetId,
String versionId,
MetadataUpdates metadataUpdates,
boolean force) {
try {
UpdateImageSetMetadataRequest updateImageSetMetadataRequest = UpdateImageSetMetadataRequest
.builder()
.datastoreId(datastoreId)
.imageSetId(imageSetId)
.latestVersionId(versionId)
.updateImageSetMetadataUpdates(metadataUpdates)
.force(force)
.build();
UpdateImageSetMetadataResponse response = medicalImagingClient.updateImageSetMetadata(updateImageSetMetadataRequest);
System.out.println("The image set metadata was updated" + response);
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
throw e;
}
}
```
Caso d’uso 1: inserisce o aggiorna un attributo.
```
final String insertAttributes = """
{
"SchemaVersion": 1.1,
"Study": {
"DICOM": {
"StudyDescription": "CT CHEST"
}
}
}
""";
MetadataUpdates metadataInsertUpdates = MetadataUpdates.builder()
.dicomUpdates(DICOMUpdates.builder()
.updatableAttributes(SdkBytes.fromByteBuffer(
ByteBuffer.wrap(insertAttributes
.getBytes(StandardCharsets.UTF_8))))
.build())
.build();
updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId,
versionid, metadataInsertUpdates, force);
```
Caso d’uso 2: rimuove un attributo.
```
final String removeAttributes = """
{
"SchemaVersion": 1.1,
"Study": {
"DICOM": {
"StudyDescription": "CT CHEST"
}
}
}
""";
MetadataUpdates metadataRemoveUpdates = MetadataUpdates.builder()
.dicomUpdates(DICOMUpdates.builder()
.removableAttributes(SdkBytes.fromByteBuffer(
ByteBuffer.wrap(removeAttributes
.getBytes(StandardCharsets.UTF_8))))
.build())
.build();
updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId,
versionid, metadataRemoveUpdates, force);
```
Caso d’uso 3: rimuove un’istanza.
```
final String removeInstance = """
{
"SchemaVersion": 1.1,
"Study": {
"Series": {
"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {
"Instances": {
"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {}
}
}
}
}
}
""";
MetadataUpdates metadataRemoveUpdates = MetadataUpdates.builder()
.dicomUpdates(DICOMUpdates.builder()
.removableAttributes(SdkBytes.fromByteBuffer(
ByteBuffer.wrap(removeInstance
.getBytes(StandardCharsets.UTF_8))))
.build())
.build();
updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId,
versionid, metadataRemoveUpdates, force);
```
Caso d’uso 4: ripristina una versione precedente.
```
// In this case, revert to previous version.
String revertVersionId = Integer.toString(Integer.parseInt(versionid) - 1);
MetadataUpdates metadataRemoveUpdates = MetadataUpdates.builder()
.revertToVersionId(revertVersionId)
.build();
updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId,
versionid, metadataRemoveUpdates, force);
```
+ Per i dettagli sull'API, [UpdateImageSetMetadata](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/UpdateImageSetMetadata)consulta *AWS SDK for Java 2.x API Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK per JavaScript (v3)**
```
import { UpdateImageSetMetadataCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} datastoreId - The ID of the HealthImaging data store.
* @param {string} imageSetId - The ID of the HealthImaging image set.
* @param {string} latestVersionId - The ID of the HealthImaging image set version.
* @param {{}} updateMetadata - The metadata to update.
* @param {boolean} force - Force the update.
*/
export const updateImageSetMetadata = async (
datastoreId = "xxxxxxxxxx",
imageSetId = "xxxxxxxxxx",
latestVersionId = "1",
updateMetadata = "{}",
force = false,
) => {
try {
const response = await medicalImagingClient.send(
new UpdateImageSetMetadataCommand({
datastoreId: datastoreId,
imageSetId: imageSetId,
latestVersionId: latestVersionId,
updateImageSetMetadataUpdates: updateMetadata,
force: force,
}),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '7966e869-e311-4bff-92ec-56a61d3003ea',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// createdAt: 2023-09-22T14:49:26.427Z,
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// imageSetId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// imageSetState: 'LOCKED',
// imageSetWorkflowStatus: 'UPDATING',
// latestVersionId: '4',
// updatedAt: 2023-09-27T19:41:43.494Z
// }
return response;
} catch (err) {
console.error(err);
}
};
```
Caso d’uso 1: inserisce o aggiorna un attributo e forza l’aggiornamento.
```
const insertAttributes = JSON.stringify({
SchemaVersion: 1.1,
Study: {
DICOM: {
StudyDescription: "CT CHEST",
},
},
});
const updateMetadata = {
DICOMUpdates: {
updatableAttributes: new TextEncoder().encode(insertAttributes),
},
};
await updateImageSetMetadata(
datastoreID,
imageSetID,
versionID,
updateMetadata,
true,
);
```
Caso d’uso 2: rimuove un attributo.
```
// Attribute key and value must match the existing attribute.
const remove_attribute = JSON.stringify({
SchemaVersion: 1.1,
Study: {
DICOM: {
StudyDescription: "CT CHEST",
},
},
});
const updateMetadata = {
DICOMUpdates: {
removableAttributes: new TextEncoder().encode(remove_attribute),
},
};
await updateImageSetMetadata(
datastoreID,
imageSetID,
versionID,
updateMetadata,
);
```
Caso d’uso 3: rimuove un’istanza.
```
const remove_instance = JSON.stringify({
SchemaVersion: 1.1,
Study: {
Series: {
"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {
Instances: {
"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {},
},
},
},
},
});
const updateMetadata = {
DICOMUpdates: {
removableAttributes: new TextEncoder().encode(remove_instance),
},
};
await updateImageSetMetadata(
datastoreID,
imageSetID,
versionID,
updateMetadata,
);
```
Caso d’uso 4: ripristina una versione precedente.
```
const updateMetadata = {
revertToVersionId: "1",
};
await updateImageSetMetadata(
datastoreID,
imageSetID,
versionID,
updateMetadata,
);
```
+ Per i dettagli sull'API, consulta la sezione *AWS SDK per JavaScript API [UpdateImageSetMetadata](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/UpdateImageSetMetadataCommand)Reference*.
C'è di più su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK per Python (Boto3)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def update_image_set_metadata(
self, datastore_id, image_set_id, version_id, metadata, force=False
):
"""
Update the metadata 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 ID of the image set version.
:param metadata: The image set metadata as a dictionary.
For example {"DICOMUpdates": {"updatableAttributes":
"{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"Garcia^Gloria\"}}}"}}
:param: force: Force the update.
:return: The updated image set metadata.
"""
try:
updated_metadata = self.health_imaging_client.update_image_set_metadata(
imageSetId=image_set_id,
datastoreId=datastore_id,
latestVersionId=version_id,
updateImageSetMetadataUpdates=metadata,
force=force,
)
except ClientError as err:
logger.error(
"Couldn't update image set metadata. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return updated_metadata
```
Il codice seguente crea un'istanza dell' MedicalImagingWrapper oggetto.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
Caso d’uso 1: inserisce o aggiorna un attributo.
```
attributes = """{
"SchemaVersion": 1.1,
"Study": {
"DICOM": {
"StudyDescription": "CT CHEST"
}
}
}"""
metadata = {"DICOMUpdates": {"updatableAttributes": attributes}}
self.update_image_set_metadata(
data_store_id, image_set_id, version_id, metadata, force
)
```
Caso d’uso 2: rimuove un attributo.
```
# Attribute key and value must match the existing attribute.
attributes = """{
"SchemaVersion": 1.1,
"Study": {
"DICOM": {
"StudyDescription": "CT CHEST"
}
}
}"""
metadata = {"DICOMUpdates": {"removableAttributes": attributes}}
self.update_image_set_metadata(
data_store_id, image_set_id, version_id, metadata, force
)
```
Caso d’uso 3: rimuove un’istanza.
```
attributes = """{
"SchemaVersion": 1.1,
"Study": {
"Series": {
"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {
"Instances": {
"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {}
}
}
}
}
}"""
metadata = {"DICOMUpdates": {"removableAttributes": attributes}}
self.update_image_set_metadata(
data_store_id, image_set_id, version_id, metadata, force
)
```
Caso d’uso 4: ripristina una versione precedente.
```
metadata = {"revertToVersionId": "1"}
self.update_image_set_metadata(
data_store_id, image_set_id, version_id, metadata, force
)
```
+ Per i dettagli sull'API, consulta [UpdateImageSetMetadata AWS](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/UpdateImageSetMetadata)*SDK for Python (Boto3) API Reference*.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK per SAP ABAP**
```
TRY.
" iv_datastore_id = '1234567890123456789012345678901234567890'
" iv_image_set_id = '1234567890123456789012345678901234567890'
" iv_latest_version_id = '1'
" iv_force = abap_false
oo_result = lo_mig->updateimagesetmetadata(
iv_datastoreid = iv_datastore_id
iv_imagesetid = iv_image_set_id
iv_latestversionid = iv_latest_version_id
io_updateimagesetmetupdates = io_metadata_updates
iv_force = iv_force ).
DATA(lv_new_version) = oo_result->get_latestversionid( ).
MESSAGE |Image set metadata updated to version: { lv_new_version }.| 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_migservicequotaexcdex.
MESSAGE 'Service quota exceeded.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ Per i dettagli sull'API, consulta [UpdateImageSetMetadata AWS](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)*SDK for SAP* ABAP API reference.
C'è di più su. GitHub Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel [Repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples).
------
Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, consulta[Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md). Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.]