Skip to content

Account Maintenance List out of beta #732

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jan 10, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 15 additions & 16 deletions openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -1228,22 +1228,15 @@ paths:
get:
x-linode-grant: read_only
servers:
- url: https://api.linode.com/v4
- url: https://api.linode.com/v4beta
tags:
- Account
summary: Maintenance List
description: >
Returns a collection of Maintenance objects for any entity
a user has permissions to view.

description: |
Returns a collection of Maintenance objects for any entity a user has permissions to view. Cancelled Maintenance objects are not returned.

Currently, Linodes are the only entities available for viewing.


**Beta**: This endpoint is in beta. 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.
operationId: getMaintenance
x-linode-cli-action: maintenance-list
security:
Expand Down Expand Up @@ -1273,7 +1266,7 @@ paths:
- lang: Shell
source: >
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4beta/account/maintenance
https://api.linode.com/v4/account/maintenance
- lang: CLI
source: >
linode-cli account maintenance-list
Expand Down Expand Up @@ -18014,6 +18007,7 @@ paths:
Arbitrary JSON of your choosing. Overwrites any existing preferences for this user.

Total length cannot exceed 65,535 characters.
maxLength: 65535
responses:
'200':
description: Returns an object of user preferences.
Expand Down Expand Up @@ -20809,10 +20803,12 @@ components:
example:
gh_username: linode
description: |
This field is required only if the StackScript being deployed requires input
data from the User for successful completion. See
[User Defined Fields (UDFs)](/docs/products/tools/stackscripts/guides/write-a-custom-script/#declare-user-defined-fields-udfs)
for more details. This field is required to be valid JSON.
This field is required only if the StackScript being deployed requires input data from the User for successful completion. See [User Defined Fields (UDFs)](/docs/guides/writing-scripts-for-use-with-linode-stackscripts-a-tutorial/#user-defined-fields-udfs) for more details.

This field is required to be valid JSON.

Total length cannot exceed 65,535 characters.
maxLength: 65535
Domain:
type: object
description: >
Expand Down Expand Up @@ -24036,10 +24032,13 @@ components:
x-linode-filterable: true
type: string
enum:
- completed
- pending
- started
description: >
description: |
The maintenance status.

Maintenance progresses in the following sequence: pending, started, then completed.
example: started
reason:
type: string
Expand Down