Write IAM Policies that Control Access to VB Studio
Identity and Access Management (IAM) is an Oracle service that helps you manage the permissions that control which OCI resources your users can access. You use IAM to control who is authenticated (signed in) and who is authorized (has permissions) to use resources. In essence, IAM ensures that the right users have the appropriate access to resources. For VB Studio, that means the vbstudio-instance resource. This topic provides information you can use to write policies that control this access.
Supported Variables
You use variables when you add conditions to a policy. These conditions are evaluated by the OCI authorization service when API requests are authorized.
For the complete list of general variables that are applicable to all requests, including those that can be used in policy statements authorizing VB Studio API requests, see General Variables for All Requests.
Details for Meta-Verb + Resource-Type Combinations
The following table shows the visualbuilder-instance resource type permissions and API operations that are covered by each meta-verb. The level of access is cumulative as you go from inspect to read to use to manage.
Verb | Permissions | APIs Fully Covered | APIs Partially Covered |
---|---|---|---|
INSPECT |
|
|
None |
READ |
|
|
None |
USE |
|
|
None |
MANAGE |
|
|
None |
Permissions Required for Each API Operation
These are the permissions that are required for each API operation for instances and work requests.
API Operation | Permissions Required to Use the Operation | Description |
---|---|---|
ListVbsInstances |
VBS_INSTANCE_INSPECT |
List the VB Studio instances |
GetVbsInstance |
VBS_INSTANCE_READ |
Get the VB Studio instance |
CreateVbsInstance |
VBS_INSTANCE_CREATE |
Create a VB Studio instance |
DeleteVbsInstance |
VBS_INSTANCE_DELETE |
Delete a VB Studio instance |
UpdateVbsInstance |
VBS_INSTANCE_UPDATE |
Update a VB Studio instance |
ListWorkRequests |
VBS_INSTANCE_INSPECT |
List a Visual Builder instance's work requests |
GetWorkRequest |
VBS_INSTANCE_READ |
Get a Visual Builder instance's work request |
ListWorkRequestErrors |
VBS_INSTANCE_READ |
List a Visual Builder instance's work request errors |
ListWorkRequestLogs |
VBS_INSTANCE_READ |
List a Visual Builder instance's work request logs |
Sample OCI IAM Policy Statements that Grant These Permissions
This example grants fine-grained permissions to a group called devteam1:
Allow devteam1 to {VBS_INSTANCE_INSPECT,VBS_INSTANCE_READ,VBS_INSTANCE_CREATE,VBS_INSTANCE_UPDATE,VBS_INSTANCE_DELETE,VBS_INSTANCE_MOVE} in tenancy
Here's another example that uses the friendlier meta-verbs to grant the same permissions to group devteam1 and a lesser set to another group, devteam2:
Allow devteam1 to manage vbstudio-instances in tenancy Allow devteam2 to use vbstudio-instances in tenancy