删除角色与处理依赖¶
删除工作区角色前,先查询该角色的删除影响、成员绑定及名下所有权对象,完成所有权转移与成员解绑后再提交删除请求。
任务流程¶
工作区 IAM 句柄
│
▼
1. 读取待删除角色的删除影响、成员绑定与所有权对象列表
│
▼
2. 转移对象所有权并调整成员角色绑定
│
▼
3. 重新核验无阻断项 ──▶ 提交删除请求并确认角色状态
准备¶
1. 读取影响和依赖¶
读取待删除角色的当前生命周期版本后,查询删除预检影响、绑定该角色的成员列表以及由该角色持有所有权的资源列表。成员列表与所有权对象列表均返回下一页游标,记录较多时可传入游标继续翻页。
import os
import uuid
import moi_product_sdk as sdk
client = sdk.new_with_personal_access_token(
os.environ["PRODUCT_API_BASE_URL"],
os.environ["PRODUCT_API_KEY"],
)
iam = client.iam(os.environ["WORKSPACE_ID"])
role_id = os.environ["ROLE_ID"]
view = iam.role_permission_view(role_id)
impact = iam.role_delete_impact(role_id, view.expected_role_lifecycle_version)
members = iam.role_members(role_id)
owned = iam.role_delete_ownerships(role_id)
print("Blocked:", impact.blocked)
print("Bindings:", impact.direct_binding_count, "Defaults:", impact.default_role_count)
print("Owned objects:", impact.active_ownership_count, "Pending ops:", impact.pending_operation_count)
for member in members.members:
print("member:", member.user_id, "default_role:", member.default_role)
for item in owned.items:
print("owned:", item.resource_type, item.resource_id, item.display_name, item.ownership_version)
package main
import (
"context"
"fmt"
"os"
"time"
sdk "github.com/matrixorigin/matrixflow/sdk/go-sdk"
)
func main() {
ctx := context.Background()
client, err := sdk.NewWithPersonalAccessToken(
os.Getenv("PRODUCT_API_BASE_URL"),
os.Getenv("PRODUCT_API_KEY"),
)
if err != nil {
panic(err)
}
iam := client.IAM(os.Getenv("WORKSPACE_ID"))
roleID := os.Getenv("ROLE_ID")
view, err := iam.RolePermissionView(ctx, roleID)
if err != nil {
panic(err)
}
impact, err := iam.RoleDeleteImpact(ctx, roleID, view.GetExpectedRoleLifecycleVersion())
if err != nil {
panic(err)
}
fmt.Println("Blocked:", impact.GetBlocked())
fmt.Println("Bindings:", impact.GetDirectBindingCount(), "Defaults:", impact.GetDefaultRoleCount())
fmt.Println("Owned objects:", impact.GetActiveOwnershipCount(), "Pending ops:", impact.GetPendingOperationCount())
members, err := iam.RoleMembers(ctx, roleID)
if err != nil {
panic(err)
}
for _, member := range members.GetMembers() {
fmt.Println("member:", member.GetUserId(), "default_role:", member.GetDefaultRole())
}
owned, err := iam.RoleDeleteOwnerships(ctx, roleID)
if err != nil {
panic(err)
}
for _, item := range owned.GetItems() {
fmt.Println("owned:", item.GetResourceType(), item.GetResourceId(), item.GetDisplayName(), item.GetOwnershipVersion())
}
_ = time.Now
}
2. 处理成员和对象依赖¶
当删除预检返回阻断状态时,须先解除阻塞项:
转移对象所有权:针对所有权列表中的每项资源,传入资源类型、资源 ID、当前所有权版本与接收角色 ID 提交转移请求。
调整成员角色绑定:若仍有成员绑定待删除角色或将其设为默认角色,先读取对应成员的角色绑定版本并替换为其他有效角色。
评估继承影响:删除角色会同步清理关联的角色继承边,执行前请按 配置角色继承 核查依赖该角色继承权限的下级角色。
以下示例将所有权列表中的对象逐一转移给接收角色:
recipient_role_id = os.environ["RECIPIENT_ROLE_ID"]
for item in owned.items:
transferred = iam.transfer_object_ownership(
item.resource_type,
item.resource_id,
sdk.IAMObjectOwnershipTransferRequest(
target_role_id=recipient_role_id,
expected_ownership_version=item.ownership_version,
request_id=str(uuid.uuid4()),
),
)
print("transferred:", item.resource_type, item.resource_id, "->", transferred.owner.role_id)
recipientRoleID := os.Getenv("RECIPIENT_ROLE_ID")
for index, item := range owned.GetItems() {
transferred, err := iam.TransferObjectOwnership(
ctx,
item.GetResourceType(),
item.GetResourceId(),
&sdk.IAMObjectOwnershipTransferRequest{
TargetRoleId: recipientRoleID,
ExpectedOwnershipVersion: item.GetOwnershipVersion(),
RequestId: fmt.Sprintf("owner-transfer-%d-%d", time.Now().UnixNano(), index),
},
)
if err != nil {
panic(err)
}
fmt.Println("transferred:", item.GetResourceType(), item.GetResourceId(), "->", transferred.GetOwner().GetRoleId())
}
3. 提交删除¶
处理完全部成员绑定与对象所有权依赖后,重新读取角色生命周期版本与删除预检结果,确认不再阻断后提交删除请求。
view = iam.role_permission_view(role_id)
impact = iam.role_delete_impact(role_id, view.expected_role_lifecycle_version)
if impact.blocked:
raise SystemExit("Resolve remaining blockers before deleting the role")
result = iam.delete_role(
role_id,
sdk.IAMRoleDeleteRequest(
reason_code="retired",
expected_lifecycle_version=view.expected_role_lifecycle_version,
request_id=os.environ["DELETE_REQUEST_ID"],
),
)
print("Deleted role:", result.role.role_id, "state:", result.role.lifecycle_state)
view, err = iam.RolePermissionView(ctx, roleID)
if err != nil {
panic(err)
}
impact, err = iam.RoleDeleteImpact(ctx, roleID, view.GetExpectedRoleLifecycleVersion())
if err != nil {
panic(err)
}
if impact.GetBlocked() {
panic("Resolve remaining blockers before deleting the role")
}
result, err := iam.DeleteRole(ctx, roleID, &sdk.IAMRoleDeleteRequest{
ReasonCode: "retired",
ExpectedLifecycleVersion: view.GetExpectedRoleLifecycleVersion(),
RequestId: os.Getenv("DELETE_REQUEST_ID"),
})
if err != nil {
panic(err)
}
fmt.Println("Deleted role:", result.GetRole().GetRoleId(), "state:", result.GetRole().GetLifecycleState())
提交删除时若遇到网络超时,请保留原 DELETE_REQUEST_ID 重试或回查角色列表与已转移对象状态,切勿直接更换新的请求标识盲目重发。
下一步¶
最后更新于