From 34fc125d27f68fd661631047f03715c108b42ad9 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Tue, 25 Jul 2023 14:45:37 -0400 Subject: [PATCH 1/2] Added API v4.159.0 release notes --- docs/release-notes/api/v4.159.0.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 docs/release-notes/api/v4.159.0.md diff --git a/docs/release-notes/api/v4.159.0.md b/docs/release-notes/api/v4.159.0.md new file mode 100644 index 00000000000..abbf6ba9647 --- /dev/null +++ b/docs/release-notes/api/v4.159.0.md @@ -0,0 +1,30 @@ +--- +title: API v4.159.0 +date: 2023-07-25 +version: 4.159.0 +--- + +### Added + +- **Authorized Apps List** ([GET /profile/apps](/docs/api/profile/#authorized-apps-list)) + - Responses to this command can now be filtered by the "label" property. + +- **Users List** ([GET /account/users](/docs/api/account/#users-list)) + + **User View** ([GET /account/users/{username}](/docs/api/account/#user-view)) + + - Responses to these commands now include the "last_login" property, which contains data relating to the most recent login attempt for the requested User. + +### Changed + +- **Managed MySQL Database Backup Restore** ([POST /databases/mysql/instances/{instanceId}/backups/{backupId}/restore](/docs/api/databases/#managed-mysql-database-backup-restore)) + + **Managed PostgreSQL Database Backup Restore** ([POST /databases/postgresql/instances/{instanceId}/backups/{backupId}/restore](/docs/api/databases/#managed-postgresql-database-backup-restore)) + + - These commands can now also be performed on Managed Databases with a `failed` or `degraded` status. Previously, these commands could only be performed on `active` Managed Databases. + +- **Service Transfers List** ([GET /account/service-transfers](/docs/api/account/#service-transfers-list)) + + **Service Transfer View** ([GET /account/service-transfers/{token}](/docs/api/account/#service-transfer-view)) + + - The `cancelled` status is now the `canceled` status in responses to these commands. From 1fe4b90532915c850e315d39e0ac0ac5b2399a96 Mon Sep 17 00:00:00 2001 From: bbiggerr Date: Tue, 25 Jul 2023 15:16:23 -0400 Subject: [PATCH 2/2] Update API reference to API spec v4.159.0 --- .../linode/linode-api-docs/v4/openapi.yaml | 78 ++++++++++++------- _vendor/modules.txt | 2 +- go.mod | 2 +- go.sum | 2 + 4 files changed, 56 insertions(+), 28 deletions(-) diff --git a/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml b/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml index c1f8391d943..a316a90fbe4 100644 --- a/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml +++ b/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml @@ -1,6 +1,6 @@ openapi: 3.0.1 info: - version: 4.158.1 + version: 4.159.0 title: Linode API description: | @@ -566,7 +566,7 @@ paths: example: "I'm consolidating multiple accounts into one." responses: '200': - description: Account cancelled + description: Account canceled content: application/json: schema: @@ -591,7 +591,7 @@ paths: reason: type: string description: > - A string explaining that the account could not be cancelled + A string explaining that the account could not be canceled because there is an outstanding balance on the account that must be paid first. example: > @@ -811,7 +811,7 @@ paths: responses: '200': description: > - Entity Transfer cancelled. + Entity Transfer canceled. content: application/json: schema: @@ -1268,7 +1268,7 @@ paths: - Account summary: Maintenance List description: | - Returns a collection of Maintenance objects for any entity a user has permissions to view. Cancelled Maintenance objects are not returned. + Returns a collection of Maintenance objects for any entity a user has permissions to view. Canceled Maintenance objects are not returned. Currently, Linodes are the only entities available for viewing. operationId: getMaintenance @@ -2431,7 +2431,7 @@ paths: While a transfer is pending, any unrestricted user *of any account* can access this command. After a transfer has been accepted, it can only be viewed by unrestricted users of the accounts that created and - accepted the transfer. If cancelled or expired, only unrestricted users of the account that created the + accepted the transfer. If canceled or expired, only unrestricted users of the account that created the transfer can view it. operationId: getServiceTransfer x-linode-cli-action: view @@ -2464,12 +2464,9 @@ paths: - account summary: Service Transfer Cancel description: | - Cancels the Service Transfer for the provided token. Once cancelled, a transfer cannot be accepted or otherwise - acted on in any way. If cancelled in error, the transfer must be - [created](/docs/api/account/#service-transfer-create) again. + Cancels the Service Transfer for the provided token. Once canceled, a transfer cannot be accepted or otherwise acted on in any way. If canceled in error, the transfer must be [created](/docs/api/account/#service-transfer-create) again. - When cancelled, an email notification for the cancellation is sent to the account that created - this transfer. Transfers can not be cancelled if they are expired or have been accepted. + When canceled, an email notification for the cancellation is sent to the account that created this transfer. Transfers can not be canceled if they are expired or have been accepted. This command can only be accessed by the unrestricted users of the account that created this transfer. operationId: deleteServiceTransfer @@ -2481,7 +2478,7 @@ paths: responses: '200': description: > - Service Transfer cancelled. + Service Transfer canceled. content: application/json: schema: @@ -3786,7 +3783,7 @@ paths: Requires `read_write` access to the Database. - The Database must have an `active` status to perform this command. + The Database must have an `active`, `degraded`, or `failed` status to perform this command. **Note**: Restoring from a backup will erase all existing data on the database instance and replace it with backup data. @@ -4542,7 +4539,7 @@ paths: Requires `read_write` access to the Database. - The Database must have an `active` status to perform this command. + The Database must have an `active`, `degraded`, or `failed` status to perform this command. **Note**: Restoring from a backup will erase all existing data on the database instance and replace it with backup data. @@ -5721,7 +5718,7 @@ paths: with the URL to which image data can be uploaded. - Image data must be uploaded within 24 hours of creation or the - upload will be cancelled and the image deleted. + upload will be canceled and the image deleted. - Image uploads should be made as an HTTP PUT request to the URL returned in the `upload_to` response parameter, with a `Content-type: application/octet-stream` header included in the @@ -6508,7 +6505,7 @@ paths: - linodes:read_write responses: '200': - description: Backup service was cancelled for the specified Linode. + description: Backup service was canceled for the specified Linode. content: application/json: schema: @@ -18990,6 +18987,7 @@ components: The name of the application you've authorized. example: example-app readOnly: true + x-linode-filterable: true x-linode-cli-display: 2 thumbnail_url: type: string @@ -19417,7 +19415,7 @@ components: description: | The label for the Database snapshot backup. - * Must include only ASCII letters or numbers. + * Must include only ASCII letters, numbers, or underscores. * Must be unique among other backup labels for this Database. example: db-snapshot target: @@ -20359,7 +20357,7 @@ components: x-linode-filterable: true x-linode-cli-color: accepted: yellow - cancelled: red + canceled: red completed: green failed: red pending: yellow @@ -20368,7 +20366,7 @@ components: type: string enum: - accepted - - cancelled + - canceled - completed - failed - pending @@ -20381,7 +20379,7 @@ components: Transfers can take up to 3 hours to complete. - `cancelled`: The transfer has been cancelled by the sender. + `canceled`: The transfer has been canceled by the sender. `completed`: The transfer has completed successfully. @@ -20394,7 +20392,7 @@ components: `stale`: The transfer has exceeded its expiration date. It can no longer be accepted or - cancelled. + canceled. example: 'pending' created: type: string @@ -24891,7 +24889,7 @@ components: properties: cancel_url: type: string - description: The URL to have PayPal redirect to when Payment is cancelled. + description: The URL to have PayPal redirect to when Payment is canceled. example: https://example.org redirect_url: type: string @@ -25880,6 +25878,7 @@ components: A boolean value indicating if the User has Two Factor Authentication (TFA) enabled. See the Create Two Factor Secret ([POST /profile/tfa-enable](/docs/api/profile/#two-factor-secret-create)) endpoint to enable TFA. + example: true verified_phone_number: type: string format: phone @@ -25902,6 +25901,33 @@ components: `null` if this User has not created a password yet. example: "2018-01-01T01:01:01" + last_login: + type: object + readOnly: true + nullable: true + description: | + Information for the most recent login attempt for this User. + + `null` if no login attempts have been made since creation of this User. + + Access the [User Logins List All](/docs/api/account/#user-logins-list-all) command for additional login information. + properties: + login_datetime: + type: string + format: date-time + readOnly: true + description: | + The date and time of this User's most recent login attempt. + example: "2018-01-01T01:01:01" + status: + type: string + readOnly: true + enum: + - successful + - failed + description: | + The result of the most recent login attempt for this User. + example: successful UserDefinedField: type: object required: @@ -26065,7 +26091,7 @@ components: x-linode-filterable: true x-linode-cli-color: accepted: yellow - cancelled: red + canceled: red completed: green failed: red pending: yellow @@ -26074,7 +26100,7 @@ components: type: string enum: - accepted - - cancelled + - canceled - completed - failed - pending @@ -26085,7 +26111,7 @@ components: `accepted`: The transfer has been accepted by another user and is currently in progress. Transfers can take up to 3 hours to complete. - `cancelled`: The transfer has been cancelled by the sender. + `canceled`: The transfer has been canceled by the sender. `completed`: The transfer has completed successfully. @@ -26094,7 +26120,7 @@ components: `pending`: The transfer is ready to be accepted. `stale`: The transfer has exceeded its expiration date. It can no longer be accepted or - cancelled. + canceled. example: 'pending' created: type: string diff --git a/_vendor/modules.txt b/_vendor/modules.txt index 508067fef63..2b33172ae3a 100644 --- a/_vendor/modules.txt +++ b/_vendor/modules.txt @@ -5,4 +5,4 @@ # github.com/bep/turbo/v7 v7.20001.20100 # github.com/gohugoio/hugo-mod-jslibs/instantpage v0.5.1 # github.com/instantpage/instant.page v5.1.1+incompatible -# github.com/linode/linode-api-docs/v4 v4.158.1 +# github.com/linode/linode-api-docs/v4 v4.159.0 diff --git a/go.mod b/go.mod index 9456a5fcc04..0aeb074d590 100644 --- a/go.mod +++ b/go.mod @@ -4,6 +4,6 @@ go 1.15 require ( github.com/hotwired/turbo v7.0.1+incompatible // indirect - github.com/linode/linode-api-docs/v4 v4.158.1 // indirect + github.com/linode/linode-api-docs/v4 v4.159.0 // indirect github.com/linode/linode-docs-theme v0.0.0-20230706164309-cc2dbdeb7143 // indirect ) diff --git a/go.sum b/go.sum index b2b31f1a2c9..93873b59195 100644 --- a/go.sum +++ b/go.sum @@ -83,6 +83,8 @@ github.com/linode/linode-api-docs/v4 v4.157.1 h1:kFoXDhAUr9Dyhl+7TZK3+q9WbB18uox github.com/linode/linode-api-docs/v4 v4.157.1/go.mod h1:JRT7kOTjArLJngT4KkAnxWNGszYSP+zlQg2OHQ407RI= github.com/linode/linode-api-docs/v4 v4.158.1 h1:eoxpIOxmCeSsHqImWuzqsWOOamJRklwD12r1fooCHN4= github.com/linode/linode-api-docs/v4 v4.158.1/go.mod h1:JRT7kOTjArLJngT4KkAnxWNGszYSP+zlQg2OHQ407RI= +github.com/linode/linode-api-docs/v4 v4.159.0 h1:bhdOZjK+EjAav0CR4/DAGeRoP4n4G8qXDAc+Jo+WqdA= +github.com/linode/linode-api-docs/v4 v4.159.0/go.mod h1:JRT7kOTjArLJngT4KkAnxWNGszYSP+zlQg2OHQ407RI= github.com/linode/linode-docs-theme v0.0.0-20220622135843-166f108e1933 h1:QchGQS6xESuyjdlNJEjvq2ftGX0sCTAhPhD5hAOJVMI= github.com/linode/linode-docs-theme v0.0.0-20220622135843-166f108e1933/go.mod h1:6kYeZt+rMvJFZ9Wbnm4CDSn8Sg1MuYjr2Kx6W/awiQM= github.com/linode/linode-docs-theme v0.0.0-20220718150422-ea48dbf69943 h1:BE3OgPTfmSdYeNUxcC1clIpJZhdMmYByCCCap0njwyY=