You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: openapi.yaml
+18-9Lines changed: 18 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
openapi: 3.0.1
2
2
info:
3
-
version: 4.106.0
3
+
version: 4.106.1
4
4
5
5
title: Linode API
6
6
description: |
@@ -3858,15 +3858,16 @@ paths:
3858
3858
- Uploaded image data should be compressed in gzip (`.gz`) format. The uncompressed disk should be in raw
3859
3859
disk image (`.img`) format. A maximum compressed file size of 5GB is supported for upload at this time.
3860
3860
3861
-
- To initiate and complete and upload in a single step, see our guide on how to [Upload an Image](/docs/products/tools/images/guides/upload-an-image/) using Cloud Manager or the Linode CLI.
3861
+
**Note:** To initiate and complete an Image upload in a single step, see our guide on how to [Upload an Image](/docs/products/tools/images/guides/upload-an-image/) using Cloud Manager or the Linode CLI `image-upload` plugin.
3862
3862
x-linode-cli-action: upload
3863
-
x-linode-cli-skip: true
3864
3863
security:
3865
3864
- personalAccessToken: []
3866
3865
- oauth:
3867
3866
- images:read_write
3868
3867
requestBody:
3869
3868
description: The uploaded Image details.
3869
+
x-linode-cli-allowed-defaults:
3870
+
- region
3870
3871
content:
3871
3872
application/json:
3872
3873
schema:
@@ -3890,7 +3891,7 @@ paths:
3890
3891
example: This is an example image in the docs.
3891
3892
responses:
3892
3893
'200':
3893
-
description: The new Image upload URL.
3894
+
description: Image Upload object including the upload URL and Image object.
3894
3895
content:
3895
3896
application/json:
3896
3897
schema:
@@ -3899,6 +3900,7 @@ paths:
3899
3900
upload_to:
3900
3901
type: string
3901
3902
description: The URL to upload the Image to.
3903
+
x-linode-cli-display: 1
3902
3904
image:
3903
3905
$ref: '#/components/schemas/Image'
3904
3906
default:
@@ -3909,18 +3911,25 @@ paths:
3909
3911
curl -H "Content-Type: application/json" \
3910
3912
-H "Authorization: Bearer $TOKEN" \
3911
3913
-X POST -d '{
3912
-
"description": "This is an example Machine Image.",
3913
-
"label": "example-machine-image-label",
3914
+
"description": "Optional details about the Image",
3915
+
"label": "Example Image",
3914
3916
"region": "us-east"
3915
3917
}' \
3916
3918
https://api.linode.com/v4/images/upload
3917
3919
- lang: CLI
3918
-
source: >
3920
+
source: |
3921
+
# Upload the Image file in a single step
3919
3922
linode-cli image-upload \
3923
+
--description "Optional details about the Image" \
3920
3924
--label "Example Image" \
3921
-
--description "Some details about the image" \
3922
3925
--region us-east \
3923
-
~/Downloads/image-file.img.gz
3926
+
/path/to/image-file.img.gz
3927
+
3928
+
# Returns the upload_to URL
3929
+
linode-cli images upload \
3930
+
--description "Optional details about the Image" \
0 commit comments