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

Tagging actions

x-logo: url: https://twitter.com/awscloud/profile_image?size=original backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: medical-imaging x-aws-signingName: medical-imaging x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/medical-imaging-2023-07-19.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://medical-imaging.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The AWS Health Imaging multi-region endpoint - url: https://medical-imaging.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The AWS Health Imaging multi-region endpoint - url: http://medical-imaging.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The AWS Health Imaging endpoint for China (Beijing) and China (Ningxia) - url: https://medical-imaging.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The AWS Health Imaging endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: Datastore paths: /datastore/{datastoreId}/imageSet/{sourceImageSetId}/copyImageSet: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CopyImageSet description: Copy an image set. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CopyImageSetResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '486': description: ServiceQuotaExceededException content: application/json: schema: $ref: '#/components/schemas/ServiceQuotaExceededException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: sourceImageSetId in: path required: true description: The source image set identifier. schema: type: string pattern: '[0-9a-z]{32}' requestBody: required: true content: application/json: schema: type: object required: - copyImageSetInformation properties: copyImageSetInformation: description: Copy image set information. type: object properties: sourceImageSet: allOf: - $ref: '#/components/schemas/CopySourceImageSetInformation' - description: The source image set. destinationImageSet: allOf: - $ref: '#/components/schemas/CopyDestinationImageSet' - description: The destination image set. summary: Amazon HealthImaging Copy Image Set x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreateDatastore description: Create a data store. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CreateDatastoreResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ServiceQuotaExceededException content: application/json: schema: $ref: '#/components/schemas/ServiceQuotaExceededException' parameters: [] requestBody: required: true content: application/json: schema: type: object required: - clientToken properties: datastoreName: description: The data store name. type: string pattern: '[A-Za-z0-9._/#-]+' minLength: 1 maxLength: 256 clientToken: description: A unique identifier for API idempotency. type: string pattern: '[A-Za-z0-9._-]+' minLength: 1 maxLength: 64 tags: description: The tags provided when creating a data store. type: object additionalProperties: $ref: '#/components/schemas/TagValue' kmsKeyArn: description: ARN referencing a KMS key or KMS key alias. 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})) minLength: 1 maxLength: 512 summary: Amazon HealthImaging Create Datastore x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore get: operationId: ListDatastores description: List data stores created by this AWS account. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListDatastoresResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '482': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '483': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' parameters: - name: datastoreStatus in: query required: false description: The data store status. schema: type: string enum: - CREATING - CREATE_FAILED - ACTIVE - DELETING - DELETED - name: nextToken in: query required: false description: The pagination token used to request the list of data stores on the next page. schema: type: string pattern: \p{ASCII}{0,8192} minLength: 1 maxLength: 8192 - name: maxResults in: query required: false description: 'Valid Range: Minimum value of 1. Maximum value of 50.' schema: type: integer minimum: 1 maximum: 50 summary: Amazon HealthImaging List Datastores x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' delete: operationId: DeleteDatastore description:

Delete a data store.

Before a data store can be deleted, you must first delete all image sets within it.

responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DeleteDatastoreResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' summary: Amazon HealthImaging Delete Datastore x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore get: operationId: GetDatastore description: Get data store properties. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetDatastoreResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '482': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '483': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '484': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' summary: Amazon HealthImaging Get Datastore x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}/imageSet/{imageSetId}/deleteImageSet: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: DeleteImageSet description: Delete an image set. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DeleteImageSetResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: imageSetId in: path required: true description: The image set identifier. schema: type: string pattern: '[0-9a-z]{32}' summary: Amazon HealthImaging Delete Image Set x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}/imageSet/{imageSetId}/getImageFrame: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: GetImageFrame description: Get an image frame (pixel data) for an image set. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetImageFrameResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: imageSetId in: path required: true description: The image set identifier. schema: type: string pattern: '[0-9a-z]{32}' requestBody: required: true content: application/json: schema: type: object required: - imageFrameInformation properties: imageFrameInformation: description: Information about the image frame (pixel data) identifier. type: object properties: imageFrameId: allOf: - $ref: '#/components/schemas/ImageFrameId' - description: The image frame (pixel data) identifier. summary: Amazon HealthImaging Get Image Frame x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}/imageSet/{imageSetId}/getImageSet: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: GetImageSet description: Get image set properties. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetImageSetResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: imageSetId in: path required: true description: The image set identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: version in: query required: false description: The image set version identifier. schema: type: string pattern: \d+ summary: Amazon HealthImaging Get Image Set x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}/imageSet/{imageSetId}/getImageSetMetadata: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: GetImageSetMetadata description: Get metadata attributes for an image set. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetImageSetMetadataResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: imageSetId in: path required: true description: The image set identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: version in: query required: false description: The image set version identifier. schema: type: string pattern: \d+ summary: Amazon HealthImaging Get Image Set Metadata x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}/imageSet/{imageSetId}/listImageSetVersions: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: ListImageSetVersions description: List image set versions. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListImageSetVersionsResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: imageSetId in: path required: true description: The image set identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: nextToken in: query required: false description: The pagination token used to request the list of image set versions on the next page. schema: type: string pattern: \p{ASCII}{0,8192} minLength: 1 maxLength: 8192 - name: maxResults in: query required: false description: The max results count. schema: type: integer minimum: 1 maximum: 50 summary: Amazon HealthImaging List Image Set Versions x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}/searchImageSets: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: SearchImageSets description: Search image sets based on defined input attributes. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/SearchImageSetsResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' parameters: - name: datastoreId in: path required: true description: The identifier of the data store where the image sets reside. schema: type: string pattern: '[0-9a-z]{32}' - name: maxResults in: query required: false description: The maximum number of results that can be returned in a search. schema: type: integer minimum: 1 maximum: 50 - name: nextToken in: query required: false description: The token used for pagination of results returned in the response. Use the token returned from the previous request to continue results where the previous request ended. schema: type: string pattern: \p{ASCII}{0,8192} minLength: 1 maxLength: 8192 requestBody: required: true content: application/json: schema: type: object properties: searchCriteria: description: The search criteria. type: object properties: filters: allOf: - $ref: '#/components/schemas/SearchCriteriaFiltersList' - description: The filters for the search criteria. summary: Amazon HealthImaging Search Image Sets x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Datastore /datastore/{datastoreId}/imageSet/{imageSetId}/updateImageSetMetadata#latestVersion: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: UpdateImageSetMetadata description: Update image set metadata attributes. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/UpdateImageSetMetadataResponse' '480': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '481': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' '482': description: AccessDeniedException content: application/json: schema: $ref: '#/components/schemas/AccessDeniedException' '483': description: ValidationException content: application/json: schema: $ref: '#/components/schemas/ValidationException' '484': description: InternalServerException content: application/json: schema: $ref: '#/components/schemas/InternalServerException' '485': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '486': description: ServiceQuotaExceededException content: application/json: schema: $ref: '#/components/schemas/ServiceQuotaExceededException' parameters: - name: datastoreId in: path required: true description: The data store identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: imageSetId in: path required: true description: The image set identifier. schema: type: string pattern: '[0-9a-z]{32}' - name: latestVersion in: query required: true description: The latest image set version identifier. schema: type: string pattern: \d+ requestBody: required: true content: application/json: schema: type: object required: - updateImageSetMetadataUpdates properties: updateImageSetMetadataUpdates: description: Contains DICOMUpdates. type: object properties: DICOMUpdates: allOf: - $ref: '#/components/schemas/DICOMUpdates' - description: The object containing 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