成员资格不同于邀请
邀请接受后才成为有效成员资格。UpdateSpaceMember 可修改 role,不能替换关联用户。name 末尾是用户名。ADMIN 只管理此空间;实例管理员仍需空间成员资格才能执行 SpaceService 管理操作。
此结构在哪里使用
以下链接根据协议快照中的直接引用生成。认证、可写字段和运行行为应以调用操作为准;可复用资源结构本身并不是完整的写入请求。
- POSTAccept Space Invitation
/api/v1/spaces/{space}/invitations/{invitation}:accept - GETGet Space Member
/api/v1/spaces/{space}/members/{member} - PATCHUpdate Space Member
/api/v1/spaces/{space}/members/{member}
被以下组件结构引用:
结构与字段
object
SpaceMember is a user's membership and governance role in a space.
| 字段 | 类型 / 是否必需 | 描述 |
|---|---|---|
name | string | The resource name. Format: spaces/{space}/members/{username}. |
user | string 必需 | Required. The member user. Format: users/{username}. |
role | string (enum)ROLE_UNSPECIFIED · ADMIN · USER必需 | Required. The member's role within this space. |
完整结构
约束与嵌套结构请以这份完整 JSON 定义为准。字段出现在这里,并不意味着每位调用者都能修改它。
{
"required": [
"user",
"role"
],
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The resource name. Format: spaces/{space}/members/{username}."
},
"user": {
"type": "string",
"description": "Required. The member user. Format: users/{username}."
},
"role": {
"enum": [
"ROLE_UNSPECIFIED",
"ADMIN",
"USER"
],
"type": "string",
"description": "Required. The member's role within this space.",
"format": "enum"
}
},
"description": "SpaceMember is a user's membership and governance role in a space."
}