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