From 7af0ce7956845885c849d733a574e293bad194fe Mon Sep 17 00:00:00 2001 From: Ryan Lonergan Date: Wed, 27 Apr 2022 14:02:36 -0400 Subject: [PATCH 01/10] added autoscaler to the Node Pool Update request body schema --- openapi.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/openapi.yaml b/openapi.yaml index cd4457b97..ba9d25faf 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -9051,6 +9051,8 @@ paths: properties: count: $ref: '#/components/schemas/LKENodePoolRequestBody/properties/count' + autoscaler: + $ref: '#/components/schemas/LKENodePoolRequestBody/properties/autoscaler' responses: '200': description: Node Pool was successfully modified. From 23c6a15c6ab968c9ce2be3755c4ff8fef5d9da9c Mon Sep 17 00:00:00 2001 From: rsyracuse Date: Wed, 27 Apr 2022 17:46:51 -0400 Subject: [PATCH 02/10] update-samples --- openapi.yaml | 33 ++++++++++++++++++++++++--------- 1 file changed, 24 insertions(+), 9 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index ba9d25faf..5bd702b79 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -8597,7 +8597,7 @@ paths: -X POST -d '{ "label": "cluster12345", "region": "us-central", - "k8s_version": "1.21", + "k8s_version": "1.23", "tags": ["ecomm", "blogs"], "control_plane": { "high_availability": true @@ -8624,9 +8624,13 @@ paths: linode-cli lke cluster-create \ --label cluster12345 \ --region us-central \ - --k8s_version 1.21 \ + --k8s_version 1.23 \ + --control_plane.high_availability true \ --node_pools.type g6-standard-4 --node_pools.count 6 \ --node_pools.type g6-standard-8 --node_pools.count 3 \ + --node_pools.autoscaler.enabled true \ + --node_pools.autoscaler.max 12 \ + --node_pools.autoscaler.min 3 \ --tags ecomm /lke/clusters/{clusterId}: parameters: @@ -8779,6 +8783,8 @@ paths: source: > linode-cli lke cluster-update 12345 \ --label lkecluster54321 \ + --control_plane.high_availability true \ + --k8s_version 1.23 \ --tags ecomm \ --tags blog \ --tags prod \ @@ -8940,7 +8946,10 @@ paths: linode-cli lke pool-create 12345 \ --type g6-standard-4 \ --count 6 \ - --tags example-tag + --tags example-tag \ + --autoscaler.enabled true \ + --autoscaler.max 12 \ + --autoscaler.min 3 /lke/clusters/{clusterId}/recycle: parameters: - name: clusterId @@ -9066,13 +9075,20 @@ paths: curl -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ -X PUT -d '{ - "count": 6 + "count": 6, + "autoscaler": { + "enabled": true, + "max": 12, + "min": 3 }' \ https://api.linode.com/v4/lke/clusters/12345/pools/456 - lang: CLI source: > linode-cli lke pool-update 12345 456 \ --count 6 \ + --autoscaler.enabled true \ + --autoscaler.max 12 \ + --autoscaler.min 3 delete: operationId: deleteLKENodePool x-linode-cli-action: pool-delete @@ -9584,11 +9600,10 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4/lke/versions/1.21 + https://api.linode.com/v4/lke/versions/1.23 - lang: CLI source: > - linode-cli lke version-view 1.21 - /longview/clients: + linode-cli lke version-view 1.23 x-linode-cli-command: longview get: x-linode-grant: read_only @@ -21122,7 +21137,7 @@ components: description: > The desired Kubernetes version for this Kubernetes cluster in the format of <major>.<minor>, and the latest supported patch version will be deployed. - example: "1.21" + example: "1.23" control_plane: type: object description: > @@ -21323,7 +21338,7 @@ components: A Kubernetes version number available for deployment to a Kubernetes cluster in the format of <major>.<minor>, and the latest supported patch version. - example: "1.21" + example: "1.23" LongviewClient: type: object description: > From a651144395d62be115acd12905bfed55faa0c3cf Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 2 May 2022 10:12:27 -0400 Subject: [PATCH 03/10] Remove all DBaaS beta notices references --- openapi.yaml | 180 +++++++++++---------------------------------------- 1 file changed, 36 insertions(+), 144 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index cd4457b97..3c255373f 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -3065,6 +3065,7 @@ paths: summary: Managed Database Engines List operationId: getDatabasesEngines servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: engines parameters: @@ -3072,13 +3073,6 @@ paths: - $ref: '#/components/parameters/pageSize' description: | Display all available Managed Database engine types and versions. Engine IDs are used when creating new Managed Databases. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. responses: '200': description: Returns a paginated list of all available Managed Database engines and versions. @@ -3098,7 +3092,7 @@ paths: x-code-samples: - lang: Shell source: > - curl https://api.linode.com/v4beta/databases/engines/ + curl https://api.linode.com/v4/databases/engines/ - lang: CLI source: > linode-cli databases engines @@ -3117,6 +3111,7 @@ paths: summary: Managed Database Engine View operationId: getDatabasesEngine servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: engine-view parameters: @@ -3124,13 +3119,6 @@ paths: - $ref: '#/components/parameters/pageSize' description: | Display information for a single Managed Database engine type and version. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. responses: '200': description: Returns information for a single Managed Database engine type and version. @@ -3143,7 +3131,7 @@ paths: x-code-samples: - lang: Shell source: > - curl https://api.linode.com/v4beta/databases/engines/mysql/5.7.30 + curl https://api.linode.com/v4/databases/engines/mysql/5.7.30 - lang: CLI source: > linode-cli databases engine-view mysql/5.7.30 @@ -3155,6 +3143,7 @@ paths: summary: Managed Databases List operationId: getDatabasesInstances servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: list x-linode-grant: read_only @@ -3167,13 +3156,6 @@ paths: Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. For more detailed information on a particular Database instance, make a request to its `instance_uri`. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3197,7 +3179,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/databases/instances + https://api.linode.com/v4/databases/instances - lang: CLI source: > linode-cli databases list @@ -3209,6 +3191,7 @@ paths: summary: Managed MySQL Databases List operationId: getDatabasesMySQLInstances servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-list x-linode-grant: unrestricted only @@ -3216,13 +3199,6 @@ paths: Display all accessible Managed MySQL Databases on your Account. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3246,7 +3222,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/databases/mysql/instances/ + https://api.linode.com/v4/databases/mysql/instances/ - lang: CLI source: > linode-cli databases mysql-list @@ -3256,6 +3232,7 @@ paths: summary: Managed MySQL Database Create operationId: postDatabasesMySQLInstances servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-create x-linode-grant: unrestricted only @@ -3283,13 +3260,6 @@ paths: * **The database software is not updated automatically.** To upgrade to a new database engine version, consider deploying a new Managed Database with your preferred version. You can then [migrate your databases](/docs/products/databases/managed-databases/guides/migrate-mysql/) from the original Managed Database cluster to the new one. * To modify update the maintenance window for a Database, use the **Managed MySQL Database Update** ([PUT /databases/mysql/instances/{instanceId}](/docs/api/databases/#managed-mysql-database-update)) command. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3331,7 +3301,7 @@ paths: "192.0.1.0/24" ] }' \ - https://api.linode.com/v4beta/databases/mysql/instances + https://api.linode.com/v4/databases/mysql/instances - lang: CLI source: > linode-cli databases mysql-create \ @@ -3360,6 +3330,7 @@ paths: summary: Managed MySQL Database View operationId: getDatabasesMySQLInstance servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-view x-linode-grant: unrestricted only @@ -3367,13 +3338,6 @@ paths: Display information for a single, accessible Managed MySQL Database on your Account. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3390,7 +3354,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/databases/mysql/instances/123 + https://api.linode.com/v4/databases/mysql/instances/123 - lang: CLI source: > linode-cli databases mysql-view 123 @@ -3400,6 +3364,7 @@ paths: summary: Managed MySQL Database Delete operationId: deleteDatabasesMySQLInstance servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-delete x-linode-grant: unrestricted only @@ -3409,13 +3374,6 @@ paths: The Database must have an `active` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3433,7 +3391,7 @@ paths: source: > curl -H "Authorization: Bearer $TOKEN" \ -X DELETE \ - https://api.linode.com/v4beta/databases/mysql/instances/123 + https://api.linode.com/v4/databases/mysql/instances/123 - lang: CLI source: > linode-cli databases mysql-delete 123 @@ -3443,6 +3401,7 @@ paths: summary: Managed MySQL Database Update operationId: putDatabasesMySQLInstance servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-update x-linode-grant: unrestricted only @@ -3466,13 +3425,6 @@ paths: * If your database cluster is configured with a single node, you will experience downtime during this maintenance window when any updates occur. It's recommended that you adjust this window to match a time that will be the least disruptive for your application and users. You may also want to consider upgrading to a high availability plan to avoid any downtime due to maintenance. * **The database software is not updated automatically.** To upgrade to a new database engine version, consider deploying a new Managed Database with your preferred version. You can then [migrate your databases](/docs/products/databases/managed-databases/guides/migrate-mysql/) from the original Managed Database cluster to the new one. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3519,7 +3471,7 @@ paths: "week_of_month": 3, } }' \ - https://api.linode.com/v4beta/databases/mysql/instances/123 + https://api.linode.com/v4/databases/mysql/instances/123 - lang: CLI source: > linode-cli databases mysql-update 123 \ @@ -3546,6 +3498,7 @@ paths: summary: Managed MySQL Database Backups List operationId: getDatabasesMySQLInstanceBackups servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-backups-list x-linode-grant: unrestricted only @@ -3559,13 +3512,6 @@ paths: Database `auto` type backups are created every 24 hours at 0:00 UTC. Each `auto` backup is retained for 7 days. Database `snapshot` type backups are created by accessing the **Managed MySQL Database Backup Snapshot Create** ([POST /databases/mysql/instances/{instanceId}/backups](/docs/api/databases/#managed-mysql-database-backup-snapshot-create)) command. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3589,7 +3535,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/databases/mysql/instances/123/backups + https://api.linode.com/v4/databases/mysql/instances/123/backups - lang: CLI source: > linode-cli databases mysql-backups-list 123 @@ -3599,6 +3545,7 @@ paths: summary: Managed MySQL Database Backup Snapshot Create operationId: postDatabasesMySQLInstanceBackup servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-backup-snapshot x-linode-grant: unrestricted only @@ -3610,13 +3557,6 @@ paths: The Database must have an `active` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3668,7 +3608,7 @@ paths: "label": "db-snapshot", "target": "primary" }' \ - https://api.linode.com/v4beta/databases/mysql/instances/123/backups/ + https://api.linode.com/v4/databases/mysql/instances/123/backups/ - lang: CLI source: > linode-cli databases mysql-backup-snapshot 123 \ @@ -3695,6 +3635,7 @@ paths: summary: Managed MySQL Database Backup View operationId: getDatabasesMySQLInstanceBackup servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-backup-view x-linode-grant: unrestricted only @@ -3704,13 +3645,6 @@ paths: The Database must not be provisioning to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3727,7 +3661,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/databases/mysql/instances/123/backups/456 + https://api.linode.com/v4/databases/mysql/instances/123/backups/456 - lang: CLI source: > linode-cli databases mysql-backup-view 123 456 @@ -3752,6 +3686,7 @@ paths: summary: Managed MySQL Database Backup Restore operationId: postDatabasesMySQLInstanceBackupRestore servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-backup-restore x-linode-grant: unrestricted only @@ -3765,13 +3700,6 @@ paths: **Note**: Restoring from a backup will erase all existing data on the database instance and replace it with backup data. **Note**: Currently, restoring a backup after resetting Managed Database credentials results in a failed cluster. Please contact Customer Support if this occurs. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3788,7 +3716,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - -X POST https://api.linode.com/v4beta/databases/mysql/instances/123/backups/456/restore + -X POST https://api.linode.com/v4/databases/mysql/instances/123/backups/456/restore - lang: CLI source: > linode-cli databases mysql-backup-restore 123 456 @@ -3807,6 +3735,7 @@ paths: summary: Managed MySQL Database Credentials View operationId: getDatabasesMySQLInstanceCredentials servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-creds-view x-linode-grant: unrestricted only @@ -3816,13 +3745,6 @@ paths: The Database must have an `active` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3839,7 +3761,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/databases/mysql/instances/123/credentials/ + https://api.linode.com/v4/databases/mysql/instances/123/credentials/ - lang: CLI source: > linode-cli databases mysql-creds-view 123 @@ -3858,6 +3780,7 @@ paths: summary: Managed MySQL Database Credentials Reset operationId: postDatabasesMySQLInstanceCredentialsReset servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-creds-reset x-linode-grant: unrestricted only @@ -3871,13 +3794,6 @@ paths: Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. **Note**: Note that it may take several seconds for credentials to reset. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3894,7 +3810,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - -X POST https://api.linode.com/v4beta/databases/mysql/instances/123/credentials/reset + -X POST https://api.linode.com/v4/databases/mysql/instances/123/credentials/reset - lang: CLI source: > linode-cli databases mysql-creds-reset 123 @@ -3913,6 +3829,7 @@ paths: summary: Managed MySQL Database SSL Certificate View operationId: getDatabasesMySQLInstanceSSL servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-ssl-cert x-linode-grant: unrestricted only @@ -3922,13 +3839,6 @@ paths: The Database must have an `active` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -3945,7 +3855,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/databases/mysql/instances/123/ssl + https://api.linode.com/v4/databases/mysql/instances/123/ssl - lang: CLI source: > linode-cli databases mysql-ssl-cert 123 @@ -3964,6 +3874,7 @@ paths: summary: Managed MySQL Database Patch operationId: postDatabasesMySQLInstancePatch servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: mysql-patch x-linode-grant: unrestricted only @@ -3979,13 +3890,6 @@ paths: * If your database cluster is configured with a single node, you will experience downtime during this maintenance. Consider upgrading to a high availability plan to avoid any downtime due to maintenance. * **The database software is not updated automatically.** To upgrade to a new database engine version, consider deploying a new Managed Database with your preferred version. You can then [migrate your databases](/docs/products/databases/managed-databases/guides/migrate-mysql/) from the original Managed Database cluster to the new one. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. security: - personalAccessToken: [] - oauth: [] @@ -4002,7 +3906,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - -X POST https://api.linode.com/v4beta/databases/mysql/instances/123/patch + -X POST https://api.linode.com/v4/databases/mysql/instances/123/patch - lang: CLI source: > linode-cli databases mysql-patch 123 @@ -4014,6 +3918,7 @@ paths: summary: Managed Database Types List operationId: getDatabasesTypes servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: types parameters: @@ -4023,13 +3928,6 @@ paths: Display all Managed Database node types. The type and number of nodes determine the resources and price of a Managed Database instance. Each Managed Database can have one node type. In the case of a high availabilty Database, all nodes are provisioned according to the chosen type. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. responses: '200': description: Returns a paginated list of all Managed Database types. @@ -4063,7 +3961,7 @@ paths: x-code-samples: - lang: Shell source: > - curl https://api.linode.com/v4beta/databases/types + curl https://api.linode.com/v4/databases/types - lang: CLI source: > linode-cli databases types @@ -4082,6 +3980,7 @@ paths: summary: Managed Database Type View operationId: getDatabasesType servers: + - url: https://api.linode.com/v4 - url: https://api.linode.com/v4beta x-linode-cli-action: type-view parameters: @@ -4089,13 +3988,6 @@ paths: - $ref: '#/components/parameters/pageSize' description: | Display the details of a single Managed Database type. The type and number of nodes determine the resources and price of a Managed Database instance. - - **Beta**: This endpoint is in **open** beta. During the beta period, Managed Databases will not incur any charges. - If you deploy a Managed Database during this time, you will receive a notice with pricing details in advance of the - GA (general availability) release. - When accessing this endpoint, please make sure to prepend all requests with `/v4beta` instead of `/v4`, and be - aware that this endpoint may receive breaking updates in the future. This notice will be removed when this - endpoint is out of beta. responses: '200': description: Returns a single Managed Database type. @@ -4122,7 +4014,7 @@ paths: x-code-samples: - lang: Shell source: > - curl https://api.linode.com/v4beta/databases/types/g6-nanode-1 + curl https://api.linode.com/v4/databases/types/g6-nanode-1 - lang: CLI source: > linode-cli databases type-view g6-nanode-1 From 16d8ab8215f065b21b2a1142203de47e8a5790ea Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 2 May 2022 10:26:38 -0400 Subject: [PATCH 04/10] Update Database Delete required status --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index cd4457b97..bf64e310e 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -3406,7 +3406,7 @@ paths: description: | Remove a Managed MySQL Database from your Account. - The Database must have an `active` status to perform this command. + The Database must have an `active`, `failed`, or `degraded` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. From 3bfcc276f8ae7a0e849ad3a741e332389d23ece6 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Tue, 26 Apr 2022 11:47:41 -0400 Subject: [PATCH 05/10] Add engines to Database Types --- openapi.yaml | 55 ++++++++++++++++++++++++++++++---------------------- 1 file changed, 32 insertions(+), 23 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index cd4457b97..9203fe123 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -18174,30 +18174,16 @@ components: type: string description: A human-readable string that describes each plan type. For display purposes only. readOnly: true - example: DBaaS MySQL - Nanode 1GB + example: DBaaS Cluster - Nanode 1GB x-linode-cli-display: 2 - cluster_size: - type: array - description: A pricing list depending on the number of nodes. - items: - type: object - properties: - quantity: - type: integer - description: The number of nodes. - example: 1 - price: - type: object - description: Cost in US dollars, broken down into hourly and monthly charges. - properties: - hourly: - type: number - description: Cost (in US dollars) per hour. - example: 0.03 - monthly: - type: number - description: Cost (in US dollars) per month. - example: 20 + engines: + type: object + properties: + mysql: + type: array + description: Pricing details for MySQL Managed Databases. + items: + $ref: '#/components/schemas/DatabaseTypeEngine' memory: type: integer description: The amount of RAM allocated to Database created of this plan type. The value is represented in megabytes. @@ -18223,6 +18209,29 @@ components: type: string description: The compute class category. example: nanode + DatabaseTypeEngine: + type: object + properties: + quantity: + type: integer + enum: + - 1 + - 2 + - 3 + description: The number of nodes for the Managed Database cluster for this subscription tier. + example: 1 + price: + type: object + description: Cost in US dollars, broken down into hourly and monthly charges. + properties: + hourly: + type: number + description: Cost (in US dollars) per hour for this subscription tier. + example: 0.03 + monthly: + type: number + description: Maximum cost (in US dollars) per month for this subscription tier. + example: 20 Device: type: object description: > From bc336cd252ac1f8966b7d96c006e8bba85dfdb46 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 2 May 2022 10:42:09 -0400 Subject: [PATCH 06/10] Update example type label --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index 9203fe123..0d5a81a89 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -18174,7 +18174,7 @@ components: type: string description: A human-readable string that describes each plan type. For display purposes only. readOnly: true - example: DBaaS Cluster - Nanode 1GB + example: DBaaS - Nanode 1GB x-linode-cli-display: 2 engines: type: object From c6a8d4821c820209d9be3b10cab8cdbb9b29ed09 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 2 May 2022 10:59:51 -0400 Subject: [PATCH 07/10] Add postgresql and mongodb engines to Database Types --- openapi.yaml | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/openapi.yaml b/openapi.yaml index 0d5a81a89..405e85037 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -18184,6 +18184,16 @@ components: description: Pricing details for MySQL Managed Databases. items: $ref: '#/components/schemas/DatabaseTypeEngine' + postgresql: + type: array + description: Pricing details for PostgreSQL Managed Databases. + items: + $ref: '#/components/schemas/DatabaseTypeEngine' + mongodb: + type: array + description: Pricing details for MongoDB Managed Databases. + items: + $ref: '#/components/schemas/DatabaseTypeEngine' memory: type: integer description: The amount of RAM allocated to Database created of this plan type. The value is represented in megabytes. From cae85df7b1d9331dce0ae62431190e784b4e72c0 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 2 May 2022 11:52:15 -0400 Subject: [PATCH 08/10] Bump version to 4.122.0 --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index 27f455679..15b799f81 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -1,6 +1,6 @@ openapi: 3.0.1 info: - version: 4.120.1 + version: 4.122.0 title: Linode API description: | From 8f762e85785c923d667a047263d937ec6dc63fe4 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 2 May 2022 12:05:02 -0400 Subject: [PATCH 09/10] Fix accidental path deletion --- openapi.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/openapi.yaml b/openapi.yaml index 15b799f81..3d12ca251 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -9496,6 +9496,7 @@ paths: - lang: CLI source: > linode-cli lke version-view 1.23 + /longview/clients: x-linode-cli-command: longview get: x-linode-grant: read_only From f13347353eb8349a7dc2d0ff3798bb11161614a9 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Mon, 2 May 2022 12:06:43 -0400 Subject: [PATCH 10/10] Update Node Pool Update description to include autoscaler --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index 3d12ca251..384e5aadd 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -8939,7 +8939,7 @@ paths: - Linode Kubernetes Engine (LKE) summary: Node Pool Update description: | - Updates a Node Pool's count. + Updates a Node Pool's count and autoscaler configuration. Linodes will be created or deleted to match changes to the Node Pool's count.