This endpoint allows you to claim an image share provided to your organization by another organization using NVIDIA DSX Air. The `image_share` payload value is the `id` of the image share instance the source organization created. The claim process will create a new image in your organization and asynchronously copy the image content from the source organization.
**Process:**
1. The image is duplicated with your organization as the owner
2. Image content is copied asynchronously in the background
3. The image share record is deleted upon successful claim
4. The new image will transition from `COPYING_FROM_IMAGE_SHARE` to `COMPLETE` once the content transfer finishes
**Note:** Only non-expired shares for your specific organization can be claimed.
**Required scopes (any one):**
- `air:image_write` (roles: `air_image_publisher`, `air_image_uploader`)
- `air:image_claiming` (roles: `air_image_claimer`)
This endpoint expects an object.
image_sharestringRequiredformat: "uuid"
The image share “claim code” — which is just the id of the image share record that was created by the source organization.
namestringOptional1-128 characters
The name of the image. This must be unique with the version.
versionstringOptional1-64 characters
The version of the image. This must be unique with the name.
Response
idstringRead-onlyformat: "uuid"
namestring1-128 characters
The name of the image. This must be unique with the version.
versionstring1-64 characters
The version of the image. This must be unique with the name.
creatorstring or nullRead-only
The email of the user who created the image.
modifieddatetimeRead-only
default_usernamestring<=64 characters
The default username for authenticating with the operating system.
default_passwordstring<=64 characters
The default password for authenticating with the operating system.
publishedbooleanRead-only
Whether the image is published.
publicly_publishedbooleanRead-only
Whether the image is published to all users (public) vs restricted to an allow-list. Always false for unpublished images.
publish_access_record_idstring or nullRead-only
The id of the image publish access record. Returned only to the owning organization, Air admins, and SREs; null otherwise.
upload_statusenum
The upload status of the image file.
READY - ReadyUPLOADING - UploadingVALIDATING - ValidatingCOMPLETE - CompletePUBLISHING - PublishingUNPUBLISHING - UnpublishingCOPYING_FROM_IMAGE_SHARE - Copying from image sharePENDING_PUBLISH - Pending PublishPENDING_UNPUBLISH - Pending Unpublish
last_uploaded_atdatetime or nullRead-only
The date and time the image was last uploaded.
sizeintegerRead-only
The size of the image file in bytes.
hashstringRead-only
The hash of the image file. This is used to check if the content of the image has changed.
is_owned_by_clientbooleanRead-only
If the image is owned by the client. When true, the client can share/publish/unpublish the image.
mountpointstring or nullOptional1-128 characters
Partition that hosts the operating system root file system.
minimum_resourcesobjectOptional
The minimum resources required to run the image.
includes_air_agentbooleanOptionalDefaults to false
Whether the image includes the Air Agent service.
cpu_archenumOptionalDefaults to x86
The CPU architecture of the image.
emulation_typelist of stringsOptional
The types of emulation the image supports.
emulation_versionstringOptional<=64 characters
The version of the emulation the image supports.
providerenumOptionalDefaults to VM
The provider of the image.
VM - VMCONTAINER - CONTAINER
notesstringOptional<=4096 characters
Notes about the image.
release_notesstringOptional<=4096 characters
Release notes for the image.
user_manualstringOptional<=4096 characters
User manual for the image.
