更新一个项目
注意
注意:群组和项目是同义词。您的 {PROJECT-ID}
与您的项目 ID 相同。对于现有群组,群组/项目 ID 保持不变。当引用说明时,此页面将使用“群组”这个更为人熟知的术语。端点仍如文档中所述。
使用此端点可对一个项目进行以下任何更改:
更改一个项目的名称。
在一个项目中添加和删除标签。
将 个LDAP群组映射到一个项目的MongoDB Ops Manager角色。
基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
PATCH /groups/{PROJECT-ID}
请求参数
请求路径参数
名称 | 类型 | 说明 |
---|---|---|
PROJECT-ID | 字符串 | (必需。) 项目的唯一标识符。 |
请求查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 Prettyprint 的标志 格式。 |
| ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
|
|
请求正文参数
您必须在请求正文中至少包含以下字段之一:
名称 | 类型 | 必要性 | 说明 |
---|---|---|---|
名称 | 字符串 | Optional | 项目的新名称。 |
标记 | 字符串数组 | Optional | |
ldapGroupMappings | 对象数组 | Optional | 对于LDAP支持的MongoDB Ops Manager ,指LDAP群组到MongoDB Ops Manager项目角色的映射。 仅接受LDAP支持的MongoDB Ops Manager 。 |
响应
名称 | 类型 | 说明 | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ActiveAgentCount | 整型 | 定期向 Ops Manager 发送网络探测(ping)的活动代理数量。 该值大约每24小时刷新并缓存。 如果启动新代理或停止现有代理,则更改最多可能需要30分钟才能显示在 | ||||||||||||||||||
hostCounts | 对象 | 按类型划分的主机总数。 嵌入式字段应该是不言自明的。 | ||||||||||||||||||
id | 字符串 | 项目的唯一标识符。 | ||||||||||||||||||
lastActiveAgent | 字符串 | 时间 Ops Manager 上次更新了项目的 | ||||||||||||||||||
ldapGroupMappings | 对象数组 | 对于支持 LDAP 的 Ops Manager,这是LDAP 群组到 Ops Manager 项目角色的映射。 仅适用于支持 LDAP 的 Ops Manager。 | ||||||||||||||||||
ldapGroupMappings .roleName | 字符串 | Ops Manager user role. 项目角色到
| ||||||||||||||||||
ldapGroupMappings .ldapGroups | 字符串数组 | 映射到 Ops Manager 角色的 LDAP 项目。 | ||||||||||||||||||
链接 | 对象数组 | 指向子资源和/或相关资源的一个或多个链接。 响应中的所有 | ||||||||||||||||||
名称 | 字符串 | 项目的显示名称。 | ||||||||||||||||||
orgId | 字符串 | 项目所属组织的唯一标识符。 | ||||||||||||||||||
publicApiEnabled | 布尔 | 指示为此项目启用API的标志。 这是一个始终为 | ||||||||||||||||||
replicaSetCount | 整型 | 此项目的副本集总数。 | ||||||||||||||||||
shardCount | 整型 | 此项目的分片总数。 | ||||||||||||||||||
标记 | 字符串数组 | 分配给项目的标签,用于以编程方式标识项目。
一个项目最多可以有 10 个标签。 标签遵循以下规则:
|
请求示例
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PATCH "https://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}?pretty=true" \ --data ' { "ldapGroupMappings": [{ "roleName": "GROUP_OWNER", "ldapGroups": [ "project-owner" ] }], "name": "Project Name 1", "tags": [ "DEV", "PRODUCT" ] }'
响应示例
响应标头
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 "id": "{PROJECT-ID}", 3 "name": Project Name 1", 4 "orgId" : "{ORG-ID}", 5 "hostCounts": { 6 "arbiter": 2, 7 "config": 1, 8 "primary": 4, 9 "secondary": 8, 10 "mongos": 2 11 }, 12 "lastActiveAgent": ISODate("2016-08-05T07:23:34Z"), 13 "activeAgentCount": 1, 14 "replicaSetCount": 3, 15 "shardCount": 2, 16 "publicApiEnabled": true, 17 "agentApiKey": "{API-KEY}", 18 "tags": [ "DEV", "PRODUCT" ], 19 "ldapGroupMappings" : [ { 20 "roleName": "GROUP_OWNER", 21 "ldapGroups": [ "project-owner" ] 22 }, ... ], 23 "links" : [] 24 }