访问控制

from tencentdb_agent_memory.v3 import MetadataClient

def grant_acl(self, p: Dict[str, Any]) -> Dict[str, Any]

def revoke_acl(self, acl_id: str) -> Dict[str, Any]

def list_acl(
    self,
    asset_id_or_request: Union[str, Dict[str, Any], None] = None,
    *,
    pagination: Optional[Dict[str, Any]] = None,
) -> Dict[str, Any]

def check_acl(self, p: Dict[str, Any]) -> Dict[str, Any]

from tencentdb_agent_memory.v3 import MetadataClient

metadata = MetadataClient(
    endpoint="https://memory.tdai.tencentyun.com",
    api_key="sk-xxxxxxxxxxxxxxxx",
    service_id="tdai-mem-xxxxxxxx",
)

resp = metadata.grant_acl({
    "asset_id": "asset-456",           # 必填，资产 ID
    "user_id": "user-123",             # 必填，被授权的用户 ID
    "permission": "read",              # 必填，权限类型（read/write/admin）
})
print(resp)

resp = metadata.check_acl({
    "asset_id": "asset-456",
    "user_id": "user-123",
})
print(resp["allowed"])

resp = metadata.list_acl("asset-456", pagination={"limit": 50})
for acl in resp["items"]:
    print(acl["user_id"], acl["permission"])

resp = metadata.revoke_acl("acl-001")
print(resp)

{
  "acl_id": "acl-550e8400-e29b-41d4-a716-446655440000",
  "asset_id": "asset-456",
  "user_id": "user-123",
  "permission": "read",
  "granted_at_ms": 1723968000000
}

{
  "allowed": true,
  "permission": "read",
  "asset_id": "asset-456",
  "user_id": "user-123"
}

{
  "items": [
    {
      "acl_id": "acl-001",
      "user_id": "user-123",
      "permission": "read",
      "granted_at_ms": 1723900000000
    },
    {
      "acl_id": "acl-002",
      "user_id": "user-456",
      "permission": "write",
      "granted_at_ms": 1723800000000
    }
  ],
  "total": 2
}