按邀请 ID 更新一个项目邀请
MongoDB Ops Manager v6.0 将于 2025 1 月 EOL。 尽快升级到更高的MongoDB Ops Manager版本。
由 {INVITATION-ID}
更新对您指定的 Ops Manager 项目的一项待处理邀请。
使用获取所有项目邀请端点检索所有待处理项目邀请的 ID。
所需角色
您可以使用Project User Admin
角色成功调用此端点。
Resource
基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
PATCH /groups/{GROUP-ID}/invites/{INVITATION-ID}
请求路径参数
路径元素 | 类型 | 必要性 | 说明 |
---|---|---|---|
群组 ID(group ID) | 字符串 | 必需 | 用于标识项目的唯一的 24 位十六进制数字字符串。 |
INVITATION-ID | 字符串 | 必需 | 标识该邀请的唯一 24 位十六进制数字字符串。 |
请求查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 Prettyprint 的标志 格式。 | false | ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
| false |
请求正文参数
正文参数 | 类型 | 必要性 | 说明 |
---|---|---|---|
角色 | 字符串数组 | 必需 | 要分配给受邀用户的 Ops Manager角色。 如果用户接受邀请,Ops Manager 就会为其分配这些角色。 重要Ops Manager 将邀请中的角色替换为您在此请求中提供的角色。 确保在此请求中包含要分配给用户的所有角色。 |
响应
名称 | 类型 | 说明 |
---|---|---|
createdAt | 字符串 | ISO8601 MongoDB Ops Manager格式的时间戳 发送邀请时的日期和时间格式( UTC 格式)。 |
expiresAt | 字符串 | ISO8601 格式的时间戳 邀请过期时的日期和时间格式( UTC 格式)。 用户有 30 天的时间接受 Ops Manager 项目邀请。 |
groupId | 字符串 | 用于标识项目的唯一的 24 位十六进制数字字符串。 |
groupName | 字符串 | 项目名称。 |
id | 字符串 | 标识该邀请的唯一 24 位十六进制数字字符串。 |
InviterUsername | 字符串 | 邀请用户名加入项目的 Ops Manager 用户。 |
角色 | 字符串数组 | 要分配给受邀用户的 Ops Manager角色。 如果用户接受邀请,Ops Manager 就会为其分配这些角色。 |
用户名 | 字符串 | Ops Manager 向其发送邀请的电子邮件地址。 如果用户接受邀请,他们将使用此电子邮件地址作为 Ops Manager 用户名。 |
请求示例
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --include \ 2 --header "Accept: application/json" \ 3 --header "Content-Type: application/json" \ 4 --request PATCH "https://opsmanager.example.com/api/public/v1.0/groups/{GROUP-ID}/invites/{INVITATION-ID}?pretty=true" \ 5 --data ' 6 { 7 "roles": [ 8 "GROUP_OWNER" 9 ] 10 }'
响应示例
响应标头
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
响应体
1 { 2 "createdAt": "2021-02-18T18:51:46Z", 3 "expiresAt": "2021-03-20T18:51:46Z", 4 "groupId": "{GROUP-ID}", 5 "groupName": "group", 6 "id": "{INVITATION-ID}", 7 "inviterUsername": "admin@example.com", 8 "roles": [ 9 "GROUP_OWNER" 10 ], 11 "username": "jane.smith@example.com" 12 }