All Products
Search
Document Center

Drive and Photo Service:ListAssignment

Last Updated:May 26, 2026

Lists role assignments.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/role/list_assignment HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

domain_id

string

No

The domain ID.

body

object

No

The request body.

manage_resource_type

string

Yes

The type of the managed resource. Supported values include:

  • RT_Group (group)

  • RT_KnowledgeBase (knowledge base)

  • RT_KnowledgeCategory (knowledge category)

RT_Group

manage_resource_id

string

Yes

The ID of the managed resource, such as a group ID.

105***b82

marker

string

No

The pagination marker. The response lists items in alphabetical order, starting after the specified marker. If you omit this parameter, the list starts from the beginning. Default: none.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

limit

integer

No

The maximum number of resources to return. Value range: [1, 100].

50

Response elements

Element

Type

Description

Example

object

The response object.

assignment_list

array<object>

A list of assignments.

object

domain_id

string

The domain ID.

hz1

identity Identity

The assigned identity, which can be a user or a group.

role_id

string

The assigned role ID.

SystemGroupAdmin

manage_resource_type

string

The type of the managed resource. For example, RT_Group indicates a group.

RT_Group

manage_resource_id

string

The ID of the managed resource, such as a group ID.

105***b82

creator

string

The creator ID.

216***c83

created_at

integer

The creation time, in milliseconds since 00:00:00 UTC on January 1, 1970.

1622682267564

next_marker

string

The marker for retrieving the next page of results. This field is empty when there are no more results.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Examples

Success response

JSON format

{
  "assignment_list": [
    {
      "domain_id": "hz1",
      "identity": {
        "identity_type": "IT_User",
        "identity_id": "16435bdf934248b788b7b3771ee9a3dw"
      },
      "role_id": "SystemGroupAdmin",
      "manage_resource_type": "RT_Group",
      "manage_resource_id": "105***b82",
      "creator": "216***c83",
      "created_at": 1622682267564
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.