Skip to content

Commit 817a066

Browse files
authored
Merge pull request #896 from linode/release-4.169.0
Release-4.169.0
2 parents 245268f + ddc4c3c commit 817a066

File tree

1 file changed

+149
-6
lines changed

1 file changed

+149
-6
lines changed

openapi.yaml

Lines changed: 149 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
openapi: 3.0.1
22
info:
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

Comments
 (0)