# 删除角色与处理依赖

删除工作区角色前，先查询该角色的删除影响、成员绑定及名下所有权对象，完成所有权转移与成员解绑后再提交删除请求。

(sdk-ai-studio-role-delete-flow)=
## 任务流程

```text
工作区 IAM 句柄
    │
    ▼
1. 读取待删除角色的删除影响、成员绑定与所有权对象列表
    │
    ▼
2. 转移对象所有权并调整成员角色绑定
    │
    ▼
3. 重新核验无阻断项 ──▶ 提交删除请求并确认角色状态
```

(sdk-ai-studio-role-delete-prepare)=
## 准备

1. 已完成 [使用 SDK](../../../quickstart/ai-studio/sdk.md) 中的服务地址、个人访问令牌与工作区配置。
2. 当前身份具备目标工作区的角色管理与对象所有权转移权限。
3. 确定待删除的角色 ID 以及用于接收对象所有权的目标角色 ID；可按 [管理角色与对象权限](管理角色和权限.md#sdk-ai-studio-iam-s1) 列出工作区角色目录获取。
4. 为转移和删除操作分别准备唯一请求标识，在结果不确定时复用同一请求标识确认状态。

(sdk-ai-studio-role-delete-inspect)=
## 1. 读取影响和依赖

读取待删除角色的当前生命周期版本后，查询删除预检影响、绑定该角色的成员列表以及由该角色持有所有权的资源列表。成员列表与所有权对象列表均返回下一页游标，记录较多时可传入游标继续翻页。

:::::{tab-set}
:sync-group: sdk-language

::::{tab-item} Python
:sync: python

```python
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)
```

::::

::::{tab-item} Go
:sync: go

```go
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
}
```

::::

:::::

(sdk-ai-studio-role-delete-dependencies)=
## 2. 处理成员和对象依赖

当删除预检返回阻断状态时，须先解除阻塞项：

- **转移对象所有权**：针对所有权列表中的每项资源，传入资源类型、资源 ID、当前所有权版本与接收角色 ID 提交转移请求。
- **调整成员角色绑定**：若仍有成员绑定待删除角色或将其设为默认角色，先读取对应成员的角色绑定版本并替换为其他有效角色。
- **评估继承影响**：删除角色会同步清理关联的角色继承边，执行前请按 [配置角色继承](配置角色继承.md) 核查依赖该角色继承权限的下级角色。

以下示例将所有权列表中的对象逐一转移给接收角色：

:::::{tab-set}
:sync-group: sdk-language

::::{tab-item} Python
:sync: python

```python
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)
```

::::

::::{tab-item} Go
:sync: go

```go
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())
}
```

::::

:::::

(sdk-ai-studio-role-delete-submit)=
## 3. 提交删除

处理完全部成员绑定与对象所有权依赖后，重新读取角色生命周期版本与删除预检结果，确认不再阻断后提交删除请求。

:::::{tab-set}
:sync-group: sdk-language

::::{tab-item} Python
:sync: python

```python
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)
```

::::

::::{tab-item} Go
:sync: go

```go
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` 重试或回查角色列表与已转移对象状态，切勿直接更换新的请求标识盲目重发。

(sdk-ai-studio-role-delete-next)=
## 下一步

- [管理角色与对象权限](管理角色和权限.md)
- [配置角色继承](配置角色继承.md)
