{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To create a new custom image, send a POST request to /v2/images.\nThe body must contain a url attribute pointing to a Linux virtual machine\nimage to be imported into DigitalOcean.\nThe image must be in the raw, qcow2, vhdx, vdi, or vmdk format.\nIt may be compressed using gzip or bzip2 and must be smaller than 100 GB after\n being decompressed.\n","properties":{"body":{"$ref":"#/definitions/image_new_custom"}},"required":["body"],"additionalProperties":false,"definitions":{"image_new_custom":{"type":"object","allOf":[{"$ref":"#/definitions/image_update"},{"properties":{"url":{"type":"string","description":"A URL from which the custom Linux virtual machine image may be retrieved.  The image it points to must be in the raw, qcow2, vhdx, vdi, or vmdk format.  It may be compressed using gzip or bzip2 and must be smaller than 100 GB after being decompressed.","examples":["http://cloud-images.ubuntu.com/minimal/releases/bionic/release/ubuntu-18.04-minimal-cloudimg-amd64.img"]},"region":{"$ref":"#/definitions/region_slug"},"tags":{"$ref":"#/definitions/tags_array"}}}],"required":["name","url","region"],"examples":[{"name":"ubuntu-18.04-minimal","url":"http://cloud-images.ubuntu.com/minimal/releases/bionic/release/ubuntu-18.04-minimal-cloudimg-amd64.img","distribution":"Ubuntu","region":"nyc3","description":"Cloud-optimized image w/ small footprint","tags":["base-image","prod"]}]},"image_update":{"type":"object","properties":{"name":{"$ref":"#/definitions/image_name"},"distribution":{"$ref":"#/definitions/distribution"},"description":{"$ref":"#/definitions/image_description"}}},"region_slug":{"type":"string","description":"The slug identifier for the region where the resource will initially be  available.","enum":["ams1","ams2","ams3","blr1","fra1","lon1","nyc1","nyc2","nyc3","sfo1","sfo2","sfo3","sgp1","tor1","syd1"],"examples":["nyc3"]},"tags_array":{"type":["array","null"],"items":{"type":"string"},"description":"A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags. <br><br>Requires `tag:create` scope.","examples":[["base-image","prod"]]},"image_name":{"type":"string","description":"The display name that has been given to an image.  This is what is shown in the control panel and is generally a descriptive title for the image in question.","examples":["Nifty New Snapshot"]},"distribution":{"type":"string","description":"The name of a custom image's distribution. Currently, the valid values are  `Arch Linux`, `CentOS`, `CoreOS`, `Debian`, `Fedora`, `Fedora Atomic`,  `FreeBSD`, `Gentoo`, `openSUSE`, `RancherOS`, `Rocky Linux`, `Ubuntu`, and `Unknown`.  Any other value will be accepted but ignored, and `Unknown` will be used in its place.","enum":["Arch Linux","CentOS","CoreOS","Debian","Fedora","Fedora Atomic","FreeBSD","Gentoo","openSUSE","RancherOS","Rocky Linux","Ubuntu","Unknown"],"examples":["Ubuntu"]},"image_description":{"type":"string","description":"An optional free-form text field to describe an image.","examples":[" "]}}},"name":"Create a Custom Image","id":"digitalocean.images_create_custom","example":{"body":{"name":"ubuntu-18.04-minimal","url":"http://cloud-images.ubuntu.com/minimal/releases/bionic/release/ubuntu-18.04-minimal-cloudimg-amd64.img","distribution":"Ubuntu","region":"nyc3","description":"Cloud-optimized image w/ small footprint","tags":["base-image","prod"]}},"maxRequests":1,"summary":false}}