Scaleway logo
IAM API
IAM API

Permission sets

Download schema

Permission sets are the main components of IAM rulesOpen in new context. They consist of sets of one or multiple permissionsOpen in new context.

Permission set names contain descriptions that clearly explain their purpose. For example, a permission set that grants access to all actions you can perform on Instances is called:\ InstancesFullAccess.

Permissions sets (eg.InstanceReadAccess) and their scopeOpen in new context (eg. "on Project A only") make up IAM rules, which define the access rights that a principalOpen in new context (user, group or application) should have.

List permission sets

GET
https://api.scaleway.com
/iam/v1alpha1/permission-sets

List permission sets available for given Organization. You must define the organization_id in the query path of your request.

List permission sets › query Parameters

organization_id
​string · required

Filter by Organization ID.

Criteria for sorting results.

Enum values:
name_asc
name_desc
created_at_asc
created_at_desc
Default: name_asc
page_size
​integer · uint32

Number of results per page. Value must be between 1 and 100.

page
​integer · int32

Page number. Value must be greater than 1.

List permission sets › Responses

200
scaleway.iam.v1alpha1.ListPermissionSetsResponse

List of permission sets.

total_count
​integer · uint32

Total count of permission sets.

RulesQuotas