Function postUploadImage

postUploadImage<ThrowOnError extends boolean = true>(
    options?: Options<PostUploadImageData, ThrowOnError>,
): RequestResult<
    PostUploadImageResponses,
    PostUploadImageErrors,
    ThrowOnError,
    "data",
>
Upload an image

Creates a new private image container and returns a URL as the upload_to object in the response. Use this URL to upload your own disk image to the container.

👍 There's a tutorial

This operation has specific requirements for use. Check out its workflow for details.

<>
- CLI.
```
# Run the operation to just get the upload_to URL
linode-cli images upload \
--description "Optional details about the Image" \
--label "Example Image" \
--region us-east

# Upload the image file in a single step
linode-cli image-upload \
--description "Optional details about the Image" \
--label "Example Image" \
--region us-east \
/path/to/image-file.img.gz
```
Learn more...
- OAuth scopes.
```
images:read_write
```
Learn more...
Type Parameters
- ThrowOnError extends boolean = true
Parameters
- Optionaloptions: Options<PostUploadImageData, ThrowOnError>
Returns RequestResult<
    PostUploadImageResponses,
    PostUploadImageErrors,
    ThrowOnError,
    "data",
>
- Defined in packages/openapi-ts/src/sdk.gen.ts:5144