Role Management Interfaces
Updated at：2025-10-27
Create role
Create a role with reference to the following codes:
Java
1public void createRole(IamClient client) {
2
3 CreateRoleRequest createRoleRequest = new CreateRoleRequest();
4 // Set role name
5 createRoleRequest.setName("test_role_name");
6 // Set role description
7 createRoleRequest.setDescription("test_description");
8 // Specify the carriers allowed to assume this role
9 createRoleRequest.setAssumeRolePolicyDocument("{\"version\":\"v1\",\"accessControlList\":[{\"service\":\"bce:iam\"," +
10 "\"permission\":[\"AssumeRole\"],\"region\":\"*\",\"grantee\":[{\"id\":\"grantee-id\"}],\"effect\":\"Allow\"}]}");
11
12 client.createRole(createRoleRequest);
13}Query role
Query a role with reference to the following codes:
Java
1public void getRole(IamClient client) {
2 // Role name
3 String roleName = "test_role_name";
4 client.getRole(roleName);
5}Update role
Update a role with reference to the following codes:
Java
1public void updateRole(IamClient client) {
2 // Old role name
3 String roleName = "old_role_name";
4 UpdateRoleRequest updateRoleRequest = new UpdateRoleRequest();
5 // Set updated role name
6 updateRoleRequest.setName("new_role_name");
7 // Updated role description
8 updateRoleRequest.setDescription("new_role_description");
9 // Updated allowed role assumption carriers
10 updateRoleRequest.setAssumeRolePolicyDocument("{\"version\":\"v1\",\"accessControlList\":[{\"service\":\"bce:iam\"," +
11 "\"permission\":[\"AssumeRole\"],\"region\":\"*\",\"grantee\":[{\"id\":\"grantee-id\"}],\"effect\":\"Allow\"}]}");
12
13 client.updateUser(roleName, updateRoleRequest);
14}Delete role
Delete a role with reference to the following codes:
Java
1public void deleteRole(IamClient client) {
2 // Role name
3 String roleName = "test_role_name";
4
5 client.deleteRole(roleName);
6}List roles
List a role with reference to the following codes:
Java
1public void listUser(IamClient client) {
2 client.listUser();
3}