UpdateContextDatabaseWorkspace - 更新 ContextDB Workspace

更新时间:
复制 MD 格式

更新上下文数据库工作空间

接口说明

修改 workspace 名称。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

rdsai:UpdateContextDatabaseWorkspace

update

*全部资源

*

无 无

请求语法

GET / HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

WorkspaceId

string

是

目标业务空间 ID

ws-as1llqmkol****

WorkspaceName

string

是

新的业务空间名称

my-workspace

返回参数

名称

类型

描述

示例值

object

修改成功

RequestId

string

请求 ID

FE9C65D7-930F-57A5-A207-8C396329****

ClusterId

string

工作区所属集群的 ID。共享集群返回 default,专属集群返回对应的集群 ID。

default

WorkspaceId

string

业务空间 ID

ws-as1llqmkol****

WorkspaceName

string

修改后的业务空间名称

my-workspace

Type

string

业务空间类型

personal

Status

string

业务空间状态

Active

CreatedAt

string

创建时间(ISO-8601 格式)

2026-05-28T17:59:55Z

PermissionMode

string

工作区的权限模式。取值:

  • personal_compatibility:兼容模式。

  • advanced:高级权限模式。

advanced

ConsolePermissionMode

string

服务端解析本次调用身份时使用的权限模式。取值:

  • personal_compatibility:兼容模式。

  • advanced:高级权限模式。

该字段描述本次调用的身份上下文;工作区的实际权限模式以 PermissionMode 为准。

advanced

Viewer

object

本次调用的访问者身份信息,包括身份解析模式、调用方账号类型及成员信息。成员相关字段为可选字段。

IdentityMode

string

本次调用的身份解析模式。取值:

  • account_compatibility:账号兼容身份模式。

  • bound_member:绑定成员身份模式。

身份解析模式与工作区的权限模式是不同概念,不能据此推断工作区是否已开启高级权限。

account_compatibility

CallerType

string

本次调用方的账号类型,例如 customer。该字段描述调用方账号,不表示工作区成员的角色。

customer

BoundMemberId

string

本次调用身份信息中绑定的工作区成员 ID。可选;未提供绑定成员信息时无值。

member-example

BoundMemberRole

string

绑定成员在工作区中的角色,例如 Owner。可选;未提供绑定成员角色信息时无值。

Owner

BoundMemberStatus

string

绑定成员的状态,例如 active。可选;未提供绑定成员状态信息时无值。

active

SelectedMemberId

string

账号兼容身份模式下选中的工作区成员 ID。可选;本次调用未选择成员时无值。该字段与绑定成员 ID 分别表示成员选择结果和绑定关系。

member-example

Capabilities

object

本次调用的账号级能力信息,仅表示账号兼容适配器可执行的操作,不代表资源级授权。该字段为可选字段,未提供账号级可执行操作时不返回。

ExecutableActions

array

账号兼容适配器可执行的操作名称列表。列表内容不代表针对具体资源的读写、成员组或访问控制授权。

string

单个操作的名称。示例仅说明操作名称格式,实际可执行操作以本次返回的列表为准。

ListContextDatabaseMembers

示例

正常返回示例

JSON格式

{
  "RequestId": "FE9C65D7-930F-57A5-A207-8C396329****",
  "ClusterId": "default",
  "WorkspaceId": "ws-as1llqmkol****",
  "WorkspaceName": "my-workspace",
  "Type": "personal",
  "Status": "Active",
  "CreatedAt": "2026-05-28T17:59:55Z",
  "PermissionMode": "advanced",
  "ConsolePermissionMode": "advanced",
  "Viewer": {
    "IdentityMode": "account_compatibility",
    "CallerType": "customer",
    "BoundMemberId": "member-example",
    "BoundMemberRole": "Owner",
    "BoundMemberStatus": "active",
    "SelectedMemberId": "member-example"
  },
  "Capabilities": {
    "ExecutableActions": [
      "ListContextDatabaseMembers"
    ]
  }
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter Request parameter is invalid. 请求参数不合法。
401 Unauthorized Unauthorized.
500 InternalError Internal server error. 服务端处理请求失败。
403 NoPermission Permission denied. 没有执行操作的权限。
502 UpstreamError Upstream service returned an error. 上游服务返回错误。
404 ResourceNotFound Resource not found. 指定资源不存在。
503 ServiceUnavailable Dependent service is not configured or unavailable.
503 PermissionModeUnavailable Workspace permission mode is temporarily unavailable.
409 ResourceAlreadyExists Resource state conflict. 资源状态冲突。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。