List the role bindings for a user in a group
GET /accounts/{account_id}/core/v1/groups/{group_id}/users/{user_id}/roleBindings
Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.
Parameters
Name | Type | In | Required | Description |
---|---|---|---|---|
account_id |
string |
path |
True |
ID of the containing account resource
|
group_id |
string |
path |
True |
ID of the containing group resource |
user_id |
string |
path |
True |
ID of the containing user resource |
include |
string |
query |
False |
Indicates which fields should be returned when listing a collection. URL examples: "include=id", "include=id,name" OpenAPI examples: "id"
|
limit |
string |
query |
False |
Indicates the maximum number of resources to return when listing a collection. URL examples: "limit=2" OpenAPI examples: "2" |
filter |
string |
query |
False |
Indicates which fields should be matched in order to return a resource when listing a collection. Supported operators are:
URL example: "filter=field%20eq%20%27value%27" OpenAPI examples: "field eq 'value'" |
orderBy |
string |
query |
False |
Indicates the sort order of resource when listing a collection. URL examples: "orderBy=name", "orderBy=name%20desc" OpenAPI examples: "name desc" |
skip |
string |
query |
False |
Indicates the number of resources to skip over when listing a collection. URL examples: "skip=1" OpenAPI examples: "1" |
count |
string |
query |
False |
Indicates if the total number of resources should be returned in the metadata object. URL examples: "count=true" OpenAPI examples: "true" |
continue |
query |
False |
Indicates the token to resume listing from. URL examples: "continue= OpenAPI examples: " |
Response
Status: 200, Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.
Name | Type | Required | Description |
---|---|---|---|
items |
array[Any of: roleBinding_1.1_get_response_body, array[]] |
True |
|
metadata |
True |
Example response
Response
Status: 401, Unauthorized
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
Example response
Response
Status: 400, Bad request
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
|
invalidParams |
array[invalidParams] |
False |
List of invalid query parameters |
Example response
Response
Status: 403, Forbidden
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
Example response
Error
Status: 404, Not found
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
Example error response
Definitions
See Definitions
type_astra_label
Name | Type | Required | Description |
---|---|---|---|
name |
string |
True |
|
value |
string |
True |
type_astra_metadata_update
Client and service-specified metadata associated with the resource. Defined values are:
-
Conforms to the Astra Metadata Schema If not specified on create, a metadata object will be created with no labels. If not specified on update, the metadata object's labels, creationTimestamp and createdBy, will be preserved without modification.
Name | Type | Required | Description |
---|---|---|---|
labels |
array[type_astra_label] |
False |
|
creationTimestamp |
string |
False |
|
modificationTimestamp |
string |
False |
|
createdBy |
string |
False |
|
modifiedBy |
string |
False |
roleBinding_1.1_get_response_body
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
Media type of the resource. Defined values are:
|
version |
string |
True |
Version of the resource. Defined values are:
|
id |
string |
True |
Globally unique identifier of the resource. Defined values are:
|
principalType |
string |
True |
JSON string representing the type of the principal this binding is associated with. Defined values are:
|
userID |
string |
True |
JSON string containing a user resource ID. Defined values are:
|
groupID |
string |
True |
JSON string containing a group resource ID. Defined values are:
|
accountID |
string |
True |
JSON string containing the ID of an account resource. For create, this must match the account ID in the request URI. Defined values are:
|
role |
string |
True |
JSON string containing one of the four defined roles. Defined values are:
|
roleConstraints |
array[string] |
False |
JSON array of JSON strings specifying the scope of the role assignment. Defined values are:
|
metadata |
True |
Client and service-specified metadata associated with the resource. Defined values are:
|
type_astra_metadata_list
Name | Type | Required | Description |
---|---|---|---|
continue |
string |
False |
|
count |
number |
False |
|
labels |
array[type_astra_label] |
False |
|
creationTimestamp |
string |
False |
|
modificationTimestamp |
string |
False |
|
createdBy |
string |
False |
|
modifiedBy |
string |
False |
invalidParams
Name | Type | Required | Description |
---|---|---|---|
name |
string |
True |
Name of the invalid query parameter |
reason |
string |
True |
Reason why the query parameter is invalid |