From 0eac4230cc7780b374963ccef8509b4e9b73e777 Mon Sep 17 00:00:00 2001 From: Eric Mutta Date: Sun, 6 Sep 2020 00:44:41 +0300 Subject: [PATCH 1/7] Update openapi.yaml Fix description of `created` and `updated` fields for disks so they mention "Disk" instead of "Linode" --- openapi.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 06913775d..8e89dbf90 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -13850,13 +13850,13 @@ components: created: type: string format: date-time - description: When this Linode was created. + description: When this Disk was created. example: '2018-01-01T00:01:01' readOnly: true updated: type: string format: date-time - description: When this Linode was last updated. + description: When this Disk was last updated. example: '2018-01-01T00:01:01' readOnly: true DiskRequest: From 150a5432df07579e9e2e990ebf3d52bcb3adbe47 Mon Sep 17 00:00:00 2001 From: vgood Date: Thu, 10 Sep 2020 13:31:18 -0400 Subject: [PATCH 2/7] Fixed createObjectStorageKeys response fixes linode/linode-cli#199 --- openapi.yaml | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 673c505cf..83e46afe7 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -10763,14 +10763,7 @@ paths: content: application/json: schema: - allOf: - - $ref: '#/components/schemas/ObjectStorageKey' - - type: object - properties: - secret_key: - type: string - description: This keypair’s secret key. **Only returned on key creation**. - example: OiA6F5r0niLs3QA2stbyq7mY5VCV7KqOzcmitmHw + $ref: '#/components/schemas/ObjectStorageKey' default: $ref: '#/components/responses/ErrorResponse' x-code-samples: @@ -17813,6 +17806,11 @@ components: description: This keypair's access key. This is not secret. example: KVAKUTGBA4WTR2NSJQ81 readOnly: true + secret_key: + type: string + description: This keypair's secret key. Only returned on key creation. + example: OiA6F5r0niLs3QA2stbyq7mY5VCV7KqOzcmitmHw + readOnly: true limited: type: boolean description: Whether or not this key is a limited access key. Will return `false` if this key grants full access to all buckets on the user's account. From 50e8a20bfb32f3d11043cd88d107e1e706d71ab3 Mon Sep 17 00:00:00 2001 From: hzoppetti Date: Tue, 15 Sep 2020 17:03:40 -0400 Subject: [PATCH 3/7] added beta server tags for list and view firewall devices and list firewall rules --- openapi.yaml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/openapi.yaml b/openapi.yaml index 7d0f3c9c5..e7e56a8a1 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -9508,6 +9508,8 @@ paths: x-linode-cli-command: firewalls get: x-linode-grant: read_only + servers: + - url: https://api.linode.com/v4beta tags: - Networking parameters: @@ -9642,6 +9644,8 @@ paths: x-linode-cli-command: firewalls get: x-linode-grant: read_only + servers: + - url: https://api.linode.com/v4beta tags: - Networking summary: View Firewall Device @@ -9734,6 +9738,8 @@ paths: x-linode-cli-command: firewalls get: x-linode-grant: read_only + servers: + - url: https://api.linode.com/v4beta tags: - Networking summary: List Firewall Rules From 454a9849bbdc069cc5c5cd4a45c9eccc647f121c Mon Sep 17 00:00:00 2001 From: hzoppetti Date: Thu, 17 Sep 2020 11:33:10 -0400 Subject: [PATCH 4/7] clarify timezone note in profile --- openapi.yaml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 7d0f3c9c5..2290754fe 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -18983,8 +18983,9 @@ components: timezone: type: string description: > - The timezone you prefer to see times in. This is not used by the API, and is - for the benefit of clients only. All times the API returns are in UTC. + The timezone you prefer to see times in. This is not used by the API directly. + It is provided for the benefit of clients such as the Linode Cloud Manager and + other clients built on the API. All times returned by the API are in UTC. example: US/Eastern email_notifications: type: boolean From b119cc5b24b1ea1e69052c45356beef495fe2e03 Mon Sep 17 00:00:00 2001 From: Josh Sager Date: Fri, 18 Sep 2020 11:12:49 -0400 Subject: [PATCH 5/7] Changed language for app expiry Changed the description to be more clear as to what steps to take based on what the return value of expiry is. If it's a public app no refresh token is created. If it's a private app, a refresh token is created and never expires, so the API is correct in its map output. --- openapi.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 3edd095fb..667045d5c 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -14450,8 +14450,8 @@ components: type: string format: date-time description: > - When this app's access token expires. Please note that apps may still have active - refresh tokens after this time passes. + When the app's access to your account expires. If `null`, the app's + access must be revoked manually. example: '2018-01-15T00:01:01' readOnly: true x-linode-cli-display: 6 From 79b129e7f016d0f02365e7dd18aef825707a905a Mon Sep 17 00:00:00 2001 From: leslitagordita Date: Fri, 18 Sep 2020 17:50:19 -0400 Subject: [PATCH 6/7] Add note about empty bucket_access array --- openapi.yaml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/openapi.yaml b/openapi.yaml index fadc94d35..12dfd87fa 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -18816,6 +18816,10 @@ components: * [list all buckets](/api/v4/object-storage-buckets/) available on this Account, but cannot perform any actions on a bucket unless it has access to the bucket. * [create new buckets](/api/v4/object-storage-buckets/#post), but do not have any access to the buckets it creates, unless explicitly given access to them. + + + **Note:** You can create an Object Storage Limited Access Key without access to any buckets. + This is achieved by sending a request with an empty `bucket_access` array. items: type: object properties: From 72db48cb1de4c759c5bbf7b8f0c1452add9610a9 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 21 Sep 2020 11:46:32 -0400 Subject: [PATCH 7/7] Bump version to 4.76.0 --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index 12dfd87fa..878e34278 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -1,6 +1,6 @@ openapi: 3.0.1 info: - version: 4.75.0 + version: 4.76.0 title: Linode API description: |