Role Management Interfaces
Updated at：2025-10-27
Create role
Create a role with the following code
Go
1 roleName := "test_role_sdk_go"
2 args := &api.CreateRoleArgs{
3 Name: roleName,
4 Description: "description",
5 AssumeRolePolicyDocument: "{\"version\":\"v1\",\"accessControlList\":[{\"service\":\"bce:iam\",\"permission\"" +
6 ":[\"AssumeRole\"],\"region\":\"*\",\"grantee\":[{\"id\":\"grantee-id\"}],\"effect\":\"Allow\"}]}",
7 }
8 result, err := client.CreateRole(args)
9 if err != nil {
10 fmt.Println("Create role failed", err)
11 } else {
12 fmt.Println("Create role success", result)
13 }Prompt:
- For detailed parameter configuration and constraints, refer to the IAM API documentation Create Role
Query role
Query a role with the following codes
Go
1 roleName := "test_role_sdk_go"
2 result, err := client.GetRole(roleName)
3 if err != nil {
4 fmt.Println("Get role failed", err)
5 } else {
6 fmt.Println("Get role success", result)
7 }Prompt:
- For detailed parameter configuration and constraints, refer to the IAM API documentation Query Role
Update role
Query a role with the following codes
Go
1 args := &api.UpdateRoleArgs{
2 Description: "newDescription",
3 AssumeRolePolicyDocument: "{\"version\":\"v1\",\"accessControlList\":[{\"service\":\"bce:iam\",\"permission\"" +
4 ":[\"AssumeRole\"],\"region\":\"*\",\"grantee\":[{\"id\":\"grantee-id\"}],\"effect\":\"Allow\"}]}",
5 }
6 roleName := "test_role_sdk_go"
7 result, err := client.UpdateRole(roleName, args)
8 if err != nil {
9 fmt.Println("Update role failed", err)
10 } else {
11 fmt.Println("Update role success", result)
12 }Prompt:
- For detailed parameter configuration and constraints, refer to the IAM API documentation Update Role
Delete role
Query a role with the following codes
Go
1 roleName := "test_role_sdk_go"
2 err = client.DeleteRole(roleName)
3 if err != nil {
4 fmt.Println("Delete role failed", err)
5 } else {
6 fmt.Println("Delete role success", roleName)
7 }Prompt:
- For detailed parameter configuration and constraints, refer to the IAM API documentation Delete Role
List roles
List roles with the following code
Go
1 result, err := client.ListRole()
2 if err != nil {
3 fmt.Println("List role failed", err)
4 } else {
5 fmt.Println("List role success", result)
6 }Prompt:
- For detailed parameter configuration and constraints, refer to the IAM API documentation List Roles