Skip to content

Commit a888459

Browse files
bbiggerrbbiggerr
committed
Update DBaaS user grants
1 parent 1f81578 commit a888459

File tree

1 file changed

+36
-43
lines changed

1 file changed

+36
-43
lines changed

‎openapi.yaml‎

Lines changed: 36 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -2987,6 +2987,7 @@ paths:
29872987
"global": {
29882988
"add_linodes": true,
29892989
"add_nodebalancers": false,
2990+
"add_databases": true;
29902991
"add_domains": true,
29912992
"add_longview": false,
29922993
"add_stackscripts": true,
@@ -3214,9 +3215,7 @@ paths:
32143215
- $ref: '#/components/parameters/pageOffset'
32153216
- $ref: '#/components/parameters/pageSize'
32163217
description: |
3217-
Display all accessible Managed Databases on your Account, regardless of engine type.
3218-
3219-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3218+
Display all Managed Databases that are accessible by your User, regardless of engine type.
32203219

32213220
For more detailed information on a particular Database instance, make a request to its `instance_uri`.
32223221
security:
@@ -3258,11 +3257,9 @@ paths:
32583257
- url: https://api.linode.com/v4
32593258
- url: https://api.linode.com/v4beta
32603259
x-linode-cli-action: mysql-list
3261-
x-linode-grant: unrestricted only
3260+
x-linode-grant: read_only
32623261
description: |
3263-
Display all accessible Managed MySQL Databases on your Account.
3264-
3265-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3262+
Display all accessible Managed MySQL Databases.
32663263
security:
32673264
- personalAccessToken: []
32683265
- oauth:
@@ -3300,11 +3297,11 @@ paths:
33003297
- url: https://api.linode.com/v4
33013298
- url: https://api.linode.com/v4beta
33023299
x-linode-cli-action: mysql-create
3303-
x-linode-grant: unrestricted only
3300+
x-linode-grant: add_databases
33043301
description: |
33053302
Provision a Managed MySQL Database.
33063303

3307-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3304+
Restricted Users must have the `add_databases` grant to use this command.
33083305

33093306
New instances can take approximately 15 to 30 minutes to provision.
33103307

@@ -3399,11 +3396,9 @@ paths:
33993396
- url: https://api.linode.com/v4
34003397
- url: https://api.linode.com/v4beta
34013398
x-linode-cli-action: mysql-view
3402-
x-linode-grant: unrestricted only
3399+
x-linode-grant: read_only
34033400
description: |
3404-
Display information for a single, accessible Managed MySQL Database on your Account.
3405-
3406-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3401+
Display information for a single, accessible Managed MySQL Database.
34073402
security:
34083403
- personalAccessToken: []
34093404
- oauth:
@@ -3434,10 +3429,12 @@ paths:
34343429
- url: https://api.linode.com/v4
34353430
- url: https://api.linode.com/v4beta
34363431
x-linode-cli-action: mysql-delete
3437-
x-linode-grant: unrestricted only
3432+
x-linode-grant: read_write
34383433
description: |
34393434
Remove a Managed MySQL Database from your Account.
34403435

3436+
Requires `read_write` access to the Database.
3437+
34413438
The Database must have an `active`, `failed`, or `degraded` status to perform this command.
34423439

34433440
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
@@ -3472,13 +3469,13 @@ paths:
34723469
- url: https://api.linode.com/v4
34733470
- url: https://api.linode.com/v4beta
34743471
x-linode-cli-action: mysql-update
3475-
x-linode-grant: unrestricted only
3472+
x-linode-grant: read_write
34763473
description: |
34773474
Update a Managed MySQL Database.
34783475

3479-
The Database must have an `active` status to perform this command.
3476+
Requires `read_write` access to the Database.
34803477

3481-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3478+
The Database must have an `active` status to perform this command.
34823479

34833480
Updating addresses in the `allow_list` overwrites any existing addresses.
34843481

@@ -3570,14 +3567,12 @@ paths:
35703567
- url: https://api.linode.com/v4
35713568
- url: https://api.linode.com/v4beta
35723569
x-linode-cli-action: mysql-backups-list
3573-
x-linode-grant: unrestricted only
3570+
x-linode-grant: read_only
35743571
description: |
3575-
Display all backups for an accessible Managed MySQL Database on your Account.
3572+
Display all backups for an accessible Managed MySQL Database.
35763573

35773574
The Database must not be provisioning to perform this command.
35783575

3579-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3580-
35813576
Database `auto` type backups are created every 24 hours at 0:00 UTC. Each `auto` backup is retained for 7 days.
35823577

35833578
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.
@@ -3618,15 +3613,15 @@ paths:
36183613
- url: https://api.linode.com/v4
36193614
- url: https://api.linode.com/v4beta
36203615
x-linode-cli-action: mysql-backup-snapshot
3621-
x-linode-grant: unrestricted only
3616+
x-linode-grant: read_write
36223617
description: |
36233618
Creates a snapshot backup of a Managed MySQL Database.
36243619

3620+
Requires `read_write` access to the Database.
3621+
36253622
Backups generated by this command have the type `snapshot`. Snapshot backups may take several minutes to complete, after which they will be accessible to view or restore.
36263623

36273624
The Database must have an `active` status to perform this command.
3628-
3629-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
36303625
security:
36313626
- personalAccessToken: []
36323627
- oauth:
@@ -3709,13 +3704,11 @@ paths:
37093704
- url: https://api.linode.com/v4
37103705
- url: https://api.linode.com/v4beta
37113706
x-linode-cli-action: mysql-backup-view
3712-
x-linode-grant: unrestricted only
3707+
x-linode-grant: read_only
37133708
description: |
3714-
Display information for a single backup for an accessible Managed MySQL Database on your Account.
3709+
Display information for a single backup for an accessible Managed MySQL Database.
37153710

37163711
The Database must not be provisioning to perform this command.
3717-
3718-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
37193712
security:
37203713
- personalAccessToken: []
37213714
- oauth:
@@ -3799,13 +3792,13 @@ paths:
37993792
- url: https://api.linode.com/v4
38003793
- url: https://api.linode.com/v4beta
38013794
x-linode-cli-action: mysql-backup-restore
3802-
x-linode-grant: unrestricted only
3795+
x-linode-grant: read_write
38033796
description: |
38043797
Restore a backup to a Managed MySQL Database on your Account.
38053798

3806-
The Database must have an `active` status to perform this command.
3799+
Requires `read_write` access to the Database.
38073800

3808-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3801+
The Database must have an `active` status to perform this command.
38093802

38103803
**Note**: Restoring from a backup will erase all existing data on the database instance and replace it with backup data.
38113804

@@ -3849,13 +3842,11 @@ paths:
38493842
- url: https://api.linode.com/v4
38503843
- url: https://api.linode.com/v4beta
38513844
x-linode-cli-action: mysql-creds-view
3852-
x-linode-grant: unrestricted only
3845+
x-linode-grant: read_only
38533846
description: |
3854-
Display the the root username and password for a Managed MySQL Database.
3847+
Display the the root username and password for an accessible Managed MySQL Database.
38553848

38563849
The Database must have an `active` status to perform this command.
3857-
3858-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
38593850
security:
38603851
- personalAccessToken: []
38613852
- oauth:
@@ -3895,11 +3886,11 @@ paths:
38953886
- url: https://api.linode.com/v4
38963887
- url: https://api.linode.com/v4beta
38973888
x-linode-cli-action: mysql-creds-reset
3898-
x-linode-grant: unrestricted only
3889+
x-linode-grant: read_write
38993890
description: |
39003891
Reset the root password for a Managed MySQL Database.
39013892

3902-
The Database must have an `active` status to perform this command.
3893+
Requires `read_write` access to the Database.
39033894

39043895
A new root password is randomly generated and accessible with the **Managed MySQL Database Credentials View** ([GET /databases/mysql/instances/{instanceId}/credentials](/docs/api/databases/#managed-mysql-database-credentials-view)) command.
39053896

@@ -3945,13 +3936,11 @@ paths:
39453936
- url: https://api.linode.com/v4
39463937
- url: https://api.linode.com/v4beta
39473938
x-linode-cli-action: mysql-ssl-cert
3948-
x-linode-grant: unrestricted only
3939+
x-linode-grant: read_only
39493940
description: |
39503941
Display the SSL CA certificate for an accessible Managed MySQL Database.
39513942

39523943
The Database must have an `active` status to perform this command.
3953-
3954-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
39553944
security:
39563945
- personalAccessToken: []
39573946
- oauth:
@@ -3991,13 +3980,13 @@ paths:
39913980
- url: https://api.linode.com/v4
39923981
- url: https://api.linode.com/v4beta
39933982
x-linode-cli-action: mysql-patch
3994-
x-linode-grant: unrestricted only
3983+
x-linode-grant: read_write
39953984
description: |
39963985
Apply security patches and updates to the underlying operating system of the Managed MySQL Database. This function runs during regular maintenance windows, which are configurable with the **Managed MySQL Database Update** ([PUT /databases/mysql/instances/{instanceId}](/docs/api/databases/#managed-mysql-database-update)) command.
39973986

3998-
The Database must have an `active` status to perform this command.
3987+
Requires `read_write` access to the Database.
39993988

4000-
Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.
3989+
The Database must have an `active` status to perform this command.
40013990

40023991
**Note**
40033992

@@ -19698,6 +19687,10 @@ components:
1969819687
type: boolean
1969919688
description: If true, this User may add Firewalls.
1970019689
example: true
19690+
add_databases:
19691+
type: boolean
19692+
description: if true, this User may add Managed Databases.
19693+
example: true
1970119694
linode:
1970219695
type: array
1970319696
items:

0 commit comments

Comments
 (0)