CreateImage
POST {{baseUrl}}/images
Creates a boot disk image for the specified instance or imports an exported image from the Oracle Cloud Infrastructure Object Storage service.
When creating a new image, you must provide the OCID of the instance you want to use as the basis for the image, and the OCID of the compartment containing that instance. For more information about images, see Managing Custom Images.
When importing an exported image from Object Storage, you specify the source information in ImageSourceDetails.
When importing an image based on the namespace, bucket name, and object name, use ImageSourceViaObjectStorageTupleDetails.
When importing an image based on the Object Storage URL, use ImageSourceViaObjectStorageUriDetails. See Object Storage URLs and Using Pre-Authenticated Requests for constructing URLs for image import/export.
For more information about importing exported images, see Image Import/Export.
You may optionally specify a display name for the image, which is simply a friendly name or description. It does not have to be unique, and you can change it. See UpdateImage. Avoid entering confidential information.
Request Body
{"compartmentId"=>"AVAILABLE", "displayName"=>"pariatur eiusmod elit", "imageSourceDetails"=>{"sourceType"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "operatingSystem"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "operatingSystemVersion"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "sourceImageType"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, "instanceId"=>"consectetur adipisicing dolor", "launchMode"=>"NATIVE", "launchOptions"=>{"bootVolumeType"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "firmware"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "isConsistentVolumeNamingEnabled"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "isPvEncryptionInTransitEnabled"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "networkType"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "remoteDataVolumeType"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
opc-retry-token | string | A token that uniquely identifies a request so it can be retried in case of a timeout or | |
server error without risk of executing that same action again. Retry tokens expire after 24 | |||
hours, but can be invalidated before then due to conflicting operations (for example, if a resource | |||
has been deleted and purged from the system, then a retry of the original creation request | |||
may be rejected). | |||
Content-Type | string | ||
Date | string | (Required) Current Date | |
Authorization | string | (Required) Signature Authentication on Authorization header | |
x-content-sha256 | string | (Required) Content sha256 for POST, PUT and PATCH operations |
RESPONSES
status: OK
{"compartmentId":"dolor commodo in","id":"eu dolor Duis dolore irure","lifecycleState":"AVAILABLE","timeCreated":"1985-05-13T06:46:51.335Z","operatingSystem":"deserunt cillum elit","operatingSystemVersion":"sint et mollit do","createImageAllowed":true,"agentFeatures":{"isManagementSupported":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isMonitoringSupported":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"baseImageId":"cillum exercitation voluptate non ullamco","billableSizeInGBs":16490567,"definedTags":{},"displayName":"qui laborum ad","freeformTags":{},"launchMode":"PARAVIRTUALIZED","launchOptions":{"bootVolumeType":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"firmware":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isConsistentVolumeNamingEnabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isPvEncryptionInTransitEnabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"networkType":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remoteDataVolumeType":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"sizeInMBs":57090852}