11openapi: 3.0.1
22info:
3- version: 4.168 .0
3+ version: 4.169 .0
44 title: Linode API
55 license:
66 name: Apache 2.0
@@ -538,6 +538,91 @@ paths:
538538 --state PA \
539539 --tax_id ATU99999999 \
540540 --zip 19102
541+ /account/availability:
542+ x-linode-cli-command: availability
543+ get:
544+ tags:
545+ - account
546+ summary: Account Availability
547+ description: |
548+ Returns service unavailability for all available regions.
549+
550+ Only authorized Users can access this endpoint.
551+
552+ *This endpoint is currently in **Beta**, and should not be used for production workloads.*
553+ operationId: getAvailability
554+ security:
555+ - personalAccessToken: []
556+ - oauth:
557+ - account:read_only
558+ x-linode-cli-action: getAvailability
559+ x-linode-grant: read_only
560+ responses:
561+ '200':
562+ description: |
563+ Returns a paginated list of regions and their unavailable resources.
564+ content:
565+ application/json:
566+ schema:
567+ allOf:
568+ - type: object
569+ properties:
570+ data:
571+ type: array
572+ items:
573+ $ref: '#/components/schemas/AccountAvailability'
574+ - $ref: '#/components/schemas/PaginationEnvelope'
575+ default:
576+ $ref: '#/components/responses/ErrorResponse'
577+ x-code-samples:
578+ - lang: Shell
579+ source: >
580+ curl https://api.linode.com/v4/account/availability \
581+ -H "Authorization: Bearer $TOKEN"
582+ - lang: CLI
583+ source: >
584+ linode-cli account availability getAvailability
585+ /account/availability/{id}:
586+ x-linode-cli-command: availability
587+ parameters:
588+ - name: id
589+ in: path
590+ description: The id of the data center.
591+ required: true
592+ schema:
593+ type: string
594+ get:
595+ tags:
596+ - account
597+ summary: Region Service Availability
598+ description: |
599+ Returns a single region's service availability.
600+
601+ Only authorized Users can access this.
602+ operationId: getAccountAvailability
603+ security:
604+ - personalAccessToken: []
605+ - oauth:
606+ - account:read_only
607+ x-linode-cli-action: getAccountAvailability
608+ x-linode-grant: read_only
609+ responses:
610+ '200':
611+ description: Returns an object with a region and the region's unavailable resources.
612+ content:
613+ application/json:
614+ schema:
615+ $ref: '#/components/schemas/AccountAvailability'
616+ default:
617+ $ref: '#/components/responses/ErrorResponse'
618+ x-code-samples:
619+ - lang: Shell
620+ source: >
621+ curl https://api.linode.com/v4/account/availability/us-east \
622+ -H "Authorization: Bearer $TOKEN"
623+ - lang: CLI
624+ source: >
625+ linode-cli account availability getAccountAvailability us-east
541626 /account/betas:
542627 x-linode-cli-command: betas
543628 get:
@@ -5973,6 +6058,10 @@ paths:
59736058 type: string
59746059 description: >
59756060 A detailed description of this Image.
6061+ cloud_init:
6062+ type: boolean
6063+ description: Whether this Image supports cloud-init.
6064+ example: true
59766065 responses:
59776066 '200':
59786067 description: New private Image created successfully.
@@ -6064,6 +6153,10 @@ paths:
60646153 type: string
60656154 description: Description for the uploaded Image.
60666155 example: This is an example image in the docs.
6156+ cloud_init:
6157+ type: boolean
6158+ description: Whether the uploaded Image supports cloud-init.
6159+ example: true
60676160 responses:
60686161 '200':
60696162 description: Image Upload object including the upload URL and Image object.
@@ -17943,11 +18036,13 @@ paths:
1794318036 x-linode-cli-action: view-avail
1794418037 responses:
1794518038 '200':
17946- description: A single Region object .
18039+ description: The availability data for a single Region.
1794718040 content:
1794818041 application/json:
1794918042 schema:
17950- $ref: '#/components/schemas/RegionAvailability'
18043+ type: array
18044+ items:
18045+ $ref: '#/components/schemas/RegionAvailability'
1795118046 default:
1795218047 $ref: '#/components/responses/ErrorResponse'
1795318048 x-code-samples:
@@ -19468,6 +19563,24 @@ components:
1946819563 - May only consist of letters, numbers, spaces, and hyphens.
1946919564 - Must not contain more than 9 letter or number characters.
1947019565 example: 19102-1234
19566+ AccountAvailability:
19567+ type: object
19568+ description: Account Service Availability object
19569+ properties:
19570+ region:
19571+ type: string
19572+ readOnly: true
19573+ description: >
19574+ Displays the data center represented by a slug.
19575+ example: us-east
19576+ x-linode-cli-display: 1
19577+ unavailable:
19578+ type: list
19579+ readOnly: true
19580+ description: >
19581+ A list of strings of unavailable services.
19582+ example: ["Linodes", "Block Storage"]
19583+ x-linode-cli-display: 2
1947119584 AccountSettings:
1947219585 type: object
1947319586 description: Account Settings object
@@ -20102,6 +20215,16 @@ components:
2010220215 description: The Managed Database engine version.
2010320216 x-linode-filterable: true
2010420217 x-linode-cli-display: 3
20218+ total_disk_size_gb:
20219+ type: integer
20220+ example: 15
20221+ description: The total disk size of the database in GB.
20222+ x-linode-cli-display: 4
20223+ used_disk_size_gb:
20224+ type: integer
20225+ example: 2
20226+ description: The used space of the database in GB.
20227+ x-linode-cli-display: 5
2010520228 DatabaseMySQL:
2010620229 type: object
2010720230 description: Managed MySQL Databases object.
@@ -20120,14 +20243,14 @@ components:
2012020243 description: The Managed Database engine type.
2012120244 example: mysql
2012220245 x-linode-filterable: true
20123- x-linode-cli-display: 6
20246+ x-linode-cli-display: 8
2012420247 readOnly: true
2012520248 version:
2012620249 type: string
2012720250 description: The Managed Database engine version.
2012820251 example: "8.0.26"
2012920252 x-linode-filterable: true
20130- x-linode-cli-display: 7
20253+ x-linode-cli-display: 9
2013120254 readOnly: true
2013220255 region:
2013320256 $ref: '#/components/schemas/Database/properties/region'
@@ -20149,7 +20272,7 @@ components:
2014920272 $ref: '#/components/schemas/Database/properties/allow_list'
2015020273 cluster_size:
2015120274 $ref: '#/components/schemas/Database/properties/cluster_size'
20152- x-linode-cli-display: 5
20275+ x-linode-cli-display: 7
2015320276 hosts:
2015420277 $ref: '#/components/schemas/Database/properties/hosts'
2015520278 ssl_connection:
@@ -20187,6 +20310,16 @@ components:
2018720310 $ref: '#/components/schemas/Database/properties/updated'
2018820311 updates:
2018920312 $ref: '#/components/schemas/Database/properties/updates'
20313+ total_disk_size_gb:
20314+ type: integer
20315+ example: 15
20316+ description: The total disk size of the database in GB.
20317+ x-linode-cli-display: 5
20318+ used_disk_size_gb:
20319+ type: integer
20320+ example: 2
20321+ description: The used space of the database in GB.
20322+ x-linode-cli-display: 6
2019020323 DatabaseMySQLRequest:
2019120324 type: object
2019220325 description: Managed MySQL Database request object.
@@ -20333,6 +20466,16 @@ components:
2033320466 $ref: '#/components/schemas/Database/properties/updated'
2033420467 updates:
2033520468 $ref: '#/components/schemas/Database/properties/updates'
20469+ total_disk_size_gb:
20470+ type: integer
20471+ example: 15
20472+ description: The total disk size of the database in GB.
20473+ x-linode-cli-display: 8
20474+ used_disk_size_gb:
20475+ type: integer
20476+ example: 2
20477+ description: The used space of the database in GB.
20478+ x-linode-cli-display: 9
2033620479 DatabasePostgreSQLRequest:
2033720480 type: object
2033820481 description: Managed PostgreSQL Database request object.
0 commit comments