openapi: 3.0.0 info: version: '2023-07-19' x-release: v4 title: AWS Health Imaging Datastore API description:
This is the AWS HealthImaging API Reference. AWS HealthImaging is an AWS service for storing, accessing, and analyzing medical images. For an introduction to the service, see the AWS HealthImaging Developer Guide .
We recommend using one of the AWS Software Development Kits (SDKs) for your programming language, as they take care of request authentication, serialization, and connection management. For more information, see Tools to build on AWS.
For information about using AWS HealthImaging API actions in one of the language-specific AWS SDKs, refer to the See Also link at the end of each section that describes an API action or data type.
The following sections list AWS HealthImaging API actions categorized according to functionality. Links are provided to actions within this Reference, along with links back to corresponding sections in the AWS HealthImaging Developer Guide so you can view console procedures and CLI/SDK code examples.
Data store actions
Import job actions
Image set access actions
Image set modification actions
CopyImageSet – See Copying an image set.
Tagging actions
TagResource – See Tagging a data store and Tagging an image set.
ListTagsForResource – See Tagging a data store and Tagging an image set.
UntagResource – See Tagging a data store and Tagging an image set.
Delete a data store.
Before a data store can be deleted, you must first delete all image sets within it.
removableAttributes and updatableAttributes.
summary: Amazon HealthImaging Update Image Set Metadata
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Datastore
components:
schemas:
Arn:
type: string
pattern: arn:aws((-us-gov)|(-iso)|(-iso-b)|(-cn))?:medical-imaging:[a-z0-9-]+:[0-9]{12}:datastore/[0-9a-z]{32}(/imageset/[0-9a-z]{32})?
SearchFilterValuesList:
type: array
items:
$ref: '#/components/schemas/SearchByAttributeValue'
minItems: 1
maxItems: 2
DICOMStudyDateAndTime:
type: object
required:
- DICOMStudyDate
properties:
DICOMStudyDate:
allOf:
- $ref: '#/components/schemas/DICOMStudyDate'
- description: The DICOM study date provided in yyMMdd format.
DICOMStudyTime:
allOf:
- $ref: '#/components/schemas/DICOMStudyTime'
- description: The DICOM study time provided in HHmmss.FFFFFF format.
description: The aggregated structure to store DICOM study date and study time for search capabilities.
Operator:
type: string
enum:
- EQUAL
- BETWEEN
ResourceNotFoundException: {}
CopySourceImageSetInformation:
type: object
required:
- latestVersionId
properties:
latestVersionId:
allOf:
- $ref: '#/components/schemas/ImageSetExternalVersionId'
- description: The latest version identifier for the source image set.
description: Copy source image set information.
ImageSetProperties:
type: object
required:
- imageSetId
- versionId
- imageSetState
properties:
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier.
versionId:
allOf:
- $ref: '#/components/schemas/ImageSetExternalVersionId'
- description: The image set version identifier.
imageSetState:
allOf:
- $ref: '#/components/schemas/ImageSetState'
- description: The image set state.
ImageSetWorkflowStatus:
allOf:
- $ref: '#/components/schemas/ImageSetWorkflowStatus'
- description: The image set workflow status.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the image set properties were created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the image set properties were updated.
deletedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the image set properties were deleted.
message:
allOf:
- $ref: '#/components/schemas/Message'
- description: The error message thrown if an image set action fails.
description: The image set properties.
ListDatastoresResponse:
type: object
properties:
datastoreSummaries:
allOf:
- $ref: '#/components/schemas/DatastoreSummaries'
- description: The list of summaries of data stores.
nextToken:
allOf:
- $ref: '#/components/schemas/NextToken'
- description: The pagination token used to retrieve the list of data stores on the next page.
DICOMUpdates:
type: object
properties:
removableAttributes:
allOf:
- $ref: '#/components/schemas/DICOMAttribute'
- description: The DICOM tags to be removed from ImageSetMetadata.
updatableAttributes:
allOf:
- $ref: '#/components/schemas/DICOMAttribute'
- description: The DICOM tags that need to be updated in ImageSetMetadata.
description: The object containing removableAttributes and updatableAttributes.
UpdateImageSetMetadataResponse:
type: object
required:
- datastoreId
- imageSetId
- latestVersionId
- imageSetState
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier.
latestVersionId:
allOf:
- $ref: '#/components/schemas/ImageSetExternalVersionId'
- description: The latest image set version identifier.
imageSetState:
allOf:
- $ref: '#/components/schemas/ImageSetState'
- description: The image set state.
imageSetWorkflowStatus:
allOf:
- $ref: '#/components/schemas/ImageSetWorkflowStatus'
- description: The image set workflow status.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when image set metadata was created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when image set metadata was updated.
message:
allOf:
- $ref: '#/components/schemas/Message'
- description: The error message thrown if an update image set metadata action fails.
ImageSetsMetadataSummaries:
type: array
items:
$ref: '#/components/schemas/ImageSetsMetadataSummary'
DICOMStudyDate:
type: string
minLength: 0
maxLength: 18
format: password
NextToken:
type: string
pattern: \p{ASCII}{0,8192}
minLength: 1
maxLength: 8192
CopySourceImageSetProperties:
type: object
required:
- imageSetId
- latestVersionId
properties:
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier for the copied source image set.
latestVersionId:
allOf:
- $ref: '#/components/schemas/ImageSetExternalVersionId'
- description: The latest version identifier for the copied source image set.
imageSetState:
allOf:
- $ref: '#/components/schemas/ImageSetState'
- description: The image set state of the copied source image set.
imageSetWorkflowStatus:
allOf:
- $ref: '#/components/schemas/ImageSetWorkflowStatus'
- description: The workflow status of the copied source image set.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the source image set properties were created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the source image set properties were updated.
imageSetArn:
allOf:
- $ref: '#/components/schemas/Arn'
- description: The Amazon Resource Name (ARN) assigned to the source image set.
description: Copy source image set properties.
DICOMStudyInstanceUID:
type: string
pattern: (?:[1-9][0-9]*|0)(\.(?:[1-9][0-9]*|0))*
minLength: 0
maxLength: 64
format: password
ImageSetWorkflowStatus:
type: string
enum:
- CREATED
- COPIED
- COPYING
- COPYING_WITH_READ_ONLY_ACCESS
- COPY_FAILED
- UPDATING
- UPDATED
- UPDATE_FAILED
- DELETING
- DELETED
DICOMAccessionNumber:
type: string
minLength: 0
maxLength: 16
format: password
ImageSetExternalVersionId:
type: string
pattern: \d+
PayloadBlob:
type: string
DICOMPatientName:
type: string
minLength: 0
maxLength: 256
format: password
ConflictException: {}
DatastoreSummary:
type: object
required:
- datastoreId
- datastoreName
- datastoreStatus
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
datastoreName:
allOf:
- $ref: '#/components/schemas/DatastoreName'
- description: The data store name.
datastoreStatus:
allOf:
- $ref: '#/components/schemas/DatastoreStatus'
- description: The data store status.
datastoreArn:
allOf:
- $ref: '#/components/schemas/Arn'
- description: The Amazon Resource Name (ARN) for the data store.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the data store was created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the data store was last updated.
description: List of summaries of data stores.
DatastoreId:
type: string
pattern: '[0-9a-z]{32}'
DatastoreProperties:
type: object
required:
- datastoreId
- datastoreName
- datastoreStatus
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
datastoreName:
allOf:
- $ref: '#/components/schemas/DatastoreName'
- description: The data store name.
datastoreStatus:
allOf:
- $ref: '#/components/schemas/DatastoreStatus'
- description: The data store status.
kmsKeyArn:
allOf:
- $ref: '#/components/schemas/KmsKeyArn'
- description: The Amazon Resource Name (ARN) assigned to the AWS Key Management Service (AWS KMS) key for accessing encrypted data.
datastoreArn:
allOf:
- $ref: '#/components/schemas/Arn'
- description: The Amazon Resource Name (ARN) for the data store.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the data store was created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the data store was last updated.
description: The properties associated with the data store.
DICOMPatientBirthDate:
type: string
minLength: 0
maxLength: 18
format: password
KmsKeyArn:
type: string
pattern: arn:aws[a-zA-Z-]{0,16}:kms:[a-z]{2}(-[a-z]{1,16}){1,3}-\d{1}:\d{12}:((key/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})|(alias/[a-zA-Z0-9:/_-]{1,256}))
description: ARN referencing a KMS key or KMS key alias.
minLength: 1
maxLength: 512
DICOMPatientId:
type: string
minLength: 0
maxLength: 64
format: password
DICOMStudyTime:
type: string
minLength: 0
maxLength: 28
format: password
ImageSetsMetadataSummary:
type: object
required:
- imageSetId
properties:
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier.
version:
allOf:
- $ref: '#/components/schemas/Integer'
- description: The image set version.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The time an image set is created in AWS HealthImaging. Sample creation date is provided in 1985-04-12T23:20:50.52Z format.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The time when an image was last updated in AWS HealthImaging.
DICOMTags:
allOf:
- $ref: '#/components/schemas/DICOMTags'
- description: The DICOM tags associated with the image set.
description: Summary of the image set metadata.
DICOMTags:
type: object
properties:
DICOMPatientId:
allOf:
- $ref: '#/components/schemas/DICOMPatientId'
- description: The unique identifier for a patient in a DICOM Study.
DICOMPatientName:
allOf:
- $ref: '#/components/schemas/DICOMPatientName'
- description: The patient name.
DICOMPatientBirthDate:
allOf:
- $ref: '#/components/schemas/DICOMPatientBirthDate'
- description: The patient birth date.
DICOMPatientSex:
allOf:
- $ref: '#/components/schemas/DICOMPatientSex'
- description: The patient sex.
DICOMStudyInstanceUID:
allOf:
- $ref: '#/components/schemas/DICOMStudyInstanceUID'
- description: The DICOM provided identifier for studyInstanceUid.>
DICOMStudyId:
allOf:
- $ref: '#/components/schemas/DICOMStudyId'
- description: The DICOM provided studyId.
DICOMStudyDescription:
allOf:
- $ref: '#/components/schemas/DICOMStudyDescription'
- description: The description of the study.
DICOMNumberOfStudyRelatedSeries:
allOf:
- $ref: '#/components/schemas/DICOMNumberOfStudyRelatedSeries'
- description: The total number of series in the DICOM study.
DICOMNumberOfStudyRelatedInstances:
allOf:
- $ref: '#/components/schemas/DICOMNumberOfStudyRelatedInstances'
- description: The total number of instances in the DICOM study.
DICOMAccessionNumber:
allOf:
- $ref: '#/components/schemas/DICOMAccessionNumber'
- description: The accession number for the DICOM study.
DICOMStudyDate:
allOf:
- $ref: '#/components/schemas/DICOMStudyDate'
- description: The study date.
DICOMStudyTime:
allOf:
- $ref: '#/components/schemas/DICOMStudyTime'
- description: The study time.
description: The DICOM attributes returned as a part of a response. Each image set has these properties as part of a search result.
DatastoreSummaries:
type: array
items:
$ref: '#/components/schemas/DatastoreSummary'
ListImageSetVersionsResponse:
type: object
required:
- imageSetPropertiesList
properties:
imageSetPropertiesList:
allOf:
- $ref: '#/components/schemas/ImageSetPropertiesList'
- description: Lists all properties associated with an image set.
nextToken:
allOf:
- $ref: '#/components/schemas/NextToken'
- description: The pagination token used to retrieve the list of image set versions on the next page.
ImageSetState:
type: string
enum:
- ACTIVE
- LOCKED
- DELETED
DICOMPatientSex:
type: string
minLength: 0
maxLength: 16
format: password
CopyDestinationImageSet:
type: object
required:
- imageSetId
- latestVersionId
properties:
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier for the destination image set.
latestVersionId:
allOf:
- $ref: '#/components/schemas/ImageSetExternalVersionId'
- description: The latest version identifier for the destination image set.
description: Copy the destination image set.
Integer:
type: integer
Date:
type: string
format: date-time
TagValue:
type: string
minLength: 0
maxLength: 256
Message:
type: string
pattern: '[\w -:]+'
minLength: 1
maxLength: 2048
SearchByAttributeValue:
type: object
properties:
DICOMPatientId:
allOf:
- $ref: '#/components/schemas/DICOMPatientId'
- description: The patient ID input for search.
DICOMAccessionNumber:
allOf:
- $ref: '#/components/schemas/DICOMAccessionNumber'
- description: The DICOM accession number for search.
DICOMStudyId:
allOf:
- $ref: '#/components/schemas/DICOMStudyId'
- description: The DICOM study ID for search.
DICOMStudyInstanceUID:
allOf:
- $ref: '#/components/schemas/DICOMStudyInstanceUID'
- description: The DICOM study instance UID for search.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The created at time of the image set provided for search.
DICOMStudyDateAndTime:
allOf:
- $ref: '#/components/schemas/DICOMStudyDateAndTime'
- description: The aggregated structure containing DICOM study date and study time for search.
description: The search input attribute value.
CopyImageSetResponse:
type: object
required:
- datastoreId
- sourceImageSetProperties
- destinationImageSetProperties
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
sourceImageSetProperties:
allOf:
- $ref: '#/components/schemas/CopySourceImageSetProperties'
- description: The properties of the source image set.
destinationImageSetProperties:
allOf:
- $ref: '#/components/schemas/CopyDestinationImageSetProperties'
- description: The properties of the destination image set.
DatastoreName:
type: string
pattern: '[A-Za-z0-9._/#-]+'
minLength: 1
maxLength: 256
ThrottlingException: {}
DatastoreStatus:
type: string
enum:
- CREATING
- CREATE_FAILED
- ACTIVE
- DELETING
- DELETED
SearchImageSetsResponse:
type: object
required:
- imageSetsMetadataSummaries
properties:
imageSetsMetadataSummaries:
allOf:
- $ref: '#/components/schemas/ImageSetsMetadataSummaries'
- description: The model containing the image set results.
nextToken:
allOf:
- $ref: '#/components/schemas/NextToken'
- description: The token for pagination results.
DeleteImageSetResponse:
type: object
required:
- datastoreId
- imageSetId
- imageSetState
- imageSetWorkflowStatus
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier.
imageSetState:
allOf:
- $ref: '#/components/schemas/ImageSetState'
- description: The image set state.
imageSetWorkflowStatus:
allOf:
- $ref: '#/components/schemas/ImageSetWorkflowStatus'
- description: The image set workflow status.
DICOMAttribute:
type: string
minLength: 1
maxLength: 10000
format: password
GetDatastoreResponse:
type: object
required:
- datastoreProperties
properties:
datastoreProperties:
allOf:
- $ref: '#/components/schemas/DatastoreProperties'
- description: The data store properties.
DICOMNumberOfStudyRelatedSeries:
type: integer
minimum: 0
maximum: 10000
CreateDatastoreResponse:
type: object
required:
- datastoreId
- datastoreStatus
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
datastoreStatus:
allOf:
- $ref: '#/components/schemas/DatastoreStatus'
- description: The data store status.
ImageSetPropertiesList:
type: array
items:
$ref: '#/components/schemas/ImageSetProperties'
ImageFrameId:
type: string
pattern: '[0-9a-z]{32}'
GetImageSetMetadataResponse:
type: object
required:
- imageSetMetadataBlob
properties:
imageSetMetadataBlob:
allOf:
- $ref: '#/components/schemas/ImageSetMetadataBlob'
- description: The blob containing the aggregated metadata information for the image set.
DeleteDatastoreResponse:
type: object
required:
- datastoreId
- datastoreStatus
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
datastoreStatus:
allOf:
- $ref: '#/components/schemas/DatastoreStatus'
- description: The data store status.
ValidationException: {}
DICOMStudyDescription:
type: string
minLength: 0
maxLength: 64
format: password
ImageSetId:
type: string
pattern: '[0-9a-z]{32}'
CopyDestinationImageSetProperties:
type: object
required:
- imageSetId
- latestVersionId
properties:
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier of the copied image set properties.
latestVersionId:
allOf:
- $ref: '#/components/schemas/ImageSetExternalVersionId'
- description: The latest version identifier for the destination image set properties.
imageSetState:
allOf:
- $ref: '#/components/schemas/ImageSetState'
- description: The image set state of the destination image set properties.
imageSetWorkflowStatus:
allOf:
- $ref: '#/components/schemas/ImageSetWorkflowStatus'
- description: The image set workflow status of the destination image set properties.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the destination image set properties were created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the destination image set properties were last updated.
imageSetArn:
allOf:
- $ref: '#/components/schemas/Arn'
- description: The Amazon Resource Name (ARN) assigned to the destination image set.
description: Copy the image set properties of the destination image set.
ImageSetMetadataBlob:
type: string
GetImageFrameResponse:
type: object
required:
- imageFrameBlob
properties:
imageFrameBlob:
allOf:
- $ref: '#/components/schemas/PayloadBlob'
- description: The blob containing the aggregated image frame information.
DICOMNumberOfStudyRelatedInstances:
type: integer
minimum: 0
maximum: 10000
DICOMStudyId:
type: string
minLength: 0
maxLength: 16
format: password
SearchCriteriaFiltersList:
type: array
items:
$ref: '#/components/schemas/SearchFilter'
minItems: 1
maxItems: 2
ServiceQuotaExceededException: {}
GetImageSetResponse:
type: object
required:
- datastoreId
- imageSetId
- versionId
- imageSetState
properties:
datastoreId:
allOf:
- $ref: '#/components/schemas/DatastoreId'
- description: The data store identifier.
imageSetId:
allOf:
- $ref: '#/components/schemas/ImageSetId'
- description: The image set identifier.
versionId:
allOf:
- $ref: '#/components/schemas/ImageSetExternalVersionId'
- description: The image set version identifier.
imageSetState:
allOf:
- $ref: '#/components/schemas/ImageSetState'
- description: The image set state.
imageSetWorkflowStatus:
allOf:
- $ref: '#/components/schemas/ImageSetWorkflowStatus'
- description: The image set workflow status.
createdAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when image set properties were created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when image set properties were updated.
deletedAt:
allOf:
- $ref: '#/components/schemas/Date'
- description: The timestamp when the image set properties were deleted.
message:
allOf:
- $ref: '#/components/schemas/Message'
- description: The error message thrown if an image set action fails.
imageSetArn:
allOf:
- $ref: '#/components/schemas/Arn'
- description: The Amazon Resource Name (ARN) assigned to the image set.
AccessDeniedException: {}
InternalServerException: {}
SearchFilter:
type: object
required:
- values
- operator
properties:
values:
allOf:
- $ref: '#/components/schemas/SearchFilterValuesList'
- description: The search filter values.
operator:
allOf:
- $ref: '#/components/schemas/Operator'
- description: The search filter operator for imageSetDateTime.
description: The search filter.
parameters:
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
externalDocs:
description: Amazon Web Services documentation
url: https://docs.aws.amazon.com/medical-imaging/
x-hasEquivalentPaths: true