Ops Manager Administration API 错误代码

注意

注意：群组和项目是同义词。您的 {PROJECT-ID} 与您的项目 ID 相同。对于现有群组，群组/项目 ID 保持不变。当引用说明时，此页面将使用“群组”这个更为人熟知的术语。端点仍如文档中所述。

如果在向 Ops Manager Administration API 发出请求时遇到错误，Ops Manager 将返回以下错误代码之一：

错误	HTTP Code	说明
`ACKNOWLEDGEMENT_COMMENT_TOO_LONG`	400	致谢评论太长。不得超过`<number>`字符。
`ADDRESS_ALREADY_IN_ACCESS_LIST`	409	地址`<address>`已在访问列表中。
`ALERT_CONFIG_NOT_FOUND`	404	群组`<group>`中不存在 ID 为`<ID>`的警报配置。
`ALERT_NOT_FOUND`	404	群组`<group>`中不存在 ID 为`<ID>`的警报。
`API_KEY_CANNOT_CREATE_GROUP`	401	API密钥无法创建群组。
`API_KEY_CANNOT_CREATE_ORG`	401	API 密钥无法创建组织。
`API_KEY_NOT_FOUND`	400	不存在 ID 为 {API-KEY-ID} 的 API 密钥。
`API_KEY_ACCESS_LIST_ACCESS_DENIED`	400	API 密钥访问列表只能由 API 密钥或用户管理员访问。
`API_KEY_ACCESS_LIST_NOT_FOUND`	404	指定的 IP 地址在相应的 API 密钥访问列表中不存在。
`ATTRIBUTE_NEGATIVE_OR_ZERO`	400	属性`<attribute>`不能为负数或零。
`ATTRIBUTE_NEGATIVE`	400	属性`<attribute>`不能为负数。
`ATTRIBUTE_READ_ONLY`	400	属性`<attribute>`为只读属性，用户无法更改。
`AUTH_MECHANISM_REQUIRES_SSL`	400	身份验证机制`<mechanism>`需要 SSL。
`AUTOMATION_CONFIG_CONCURRENT_MODIFICATION`	409	其他会话或用户已发布更改。
`AUTOMATION_CONFIG_NOT_FOUND`	404	群组`<group>`不存在自动化配置。
`BACKUP_CONFIG_NOT_FOUND`	404	群组`<group>`中的集群`<cluster>`不存在备份配置。
`BAD_USERNAME_IN_GROUP_REF`	400	用户`<username>`不在群组`<group>`中。
`BAD_USERNAME_REF`	400	不存在用户名为`<username>`的用户。
`BAD_ACCESS_LIST_ADD_REQUEST`	400	不应同时指定 IP 地址和 CIDR 区块。
`BILLING_UNSUPPORTED`	401	Ops Manager 不支持计费管理员角色。
`BLOCKED_USERNAME`	400	不允许指定的用户名`<username>` 。
`CANNOT_ADD_GLOBAL_ROLE`	403	不支持添加全局角色。
`CANNOT_CHANGE_GROUP_NAME`	403	当前用户无权更改群组名称。
`CANNOT_CLOSE_ACCOUNT_ACTIVE_BACKUP`	409	当群组具有活动备份时，无法关闭帐户；请终止所有备份。
`CANNOT_CLOSE_ACCOUNT_FAILED_INVOICES`	402	无法关闭帐户，因为存在未完成的发票。
`CANNOT_DELETE_FROM_CLUSTER_SNAPSHOT`	403	无法单独删除作为集群快照一部分的快照。
`CANNOT_DELETE_LAST_OWNER`	403	无法从群组中删除最后一个所有者。如果您尝试通过删除所有用户来关闭群组，请改为删除群组。
`CANNOT_DEMOTE_LAST_ORG_OWNER`	403	无法降级组织的最后一个所有者。
`CANNOT_DEMOTE_LAST_OWNER`	403	无法降级群组的最后一个所有者。
`CANNOT_DOWNLOAD_EXPIRED_JOB`	403	无法下载处于`EXPIRED`状态的日志collection请求作业。
`CANNOT_DOWNLOAD_JOB_IN_PROGRESS`	403	无法下载处于`IN_PROGRESS`状态的日志collection请求作业。
`CANNOT_EXTEND_EXPIRED_JOB`	403	无法延长已过期日志的持续时间。
`CANNOT_GET_BACKUP_CONFIG_INVALID_STATE`	409	如果集群未受监控，则无法获取备份配置。
`CANNOT_MODIFY_MANAGED_HOST`	403	无法修改主机`<host>` ，因为它由自动化托管。
`CANNOT_MODIFY_SHARD_BACKUP_CONFIG`	409	无法修改单个分片的备份配置；对整个集群使用集群 ID `<ID>` 。
`CANNOT_REMOVE_CALLER_FROM_ACCESS_LIST`	400	无法从访问列表中删除调用者的 IP 地址`<address>` 。
`CANNOT_SET_BACKUP_AUTH_FOR_MANAGED_CLUSTER`	409	无法为管理的集群手动设置用户名和密码。
`CANNOT_SET_CLUSTER_CHECKPOINT_INTERVAL_FOR_REPLICA_SET`	400	只能为分片集群设置集群检查点间隔，而不能为副本集设置集群检查点间隔。
`CANNOT_SET_CREDENTIALS_FOR_AUTH_MECHANISM`	400	仅身份验证机制`MONGODB_CR`或`PLAIN`支持用户名和密码字段。
`CANNOT_SET_PASSWORD_FOR_AUTH_MECHANISM`	400	除非身份验证机制为`MONGODB_CR`或`PLAIN` ，否则无法更改密码。
`CANNOT_SET_POINT_IN_TIME_WINDOW`	400	不允许设置给定时间点窗口。
`CANNOT_SET_REF_TIME_OF_DAY`	400	不支持设置一天中的参考点时间。
`CANNOT_START_BACKUP_INVALID_STATE`	409	除非集群处于`INACTIVE`或`STOPPED`状态，否则无法启动备份。
`CANNOT_START_RESTORE_JOB_FOR_DELETED_CLUSTER_SNAPSHOT`	409	无法为已删除的集群快照启动恢复任务。
`CANNOT_START_RESTORE_JOB_FOR_DELETED_SNAPSHOT`	409	无法为已删除的快照启动恢复作业。
`CANNOT_START_RESTORE_JOB_FOR_INCOMPLETE_CLUSTER_SNAPSHOT`	409	无法为不完整的集群快照启动恢复作业。
`CANNOT_STOP_BACKUP_INVALID_STATE`	409	除非集群处于 STARTED 状态，否则无法停止备份。
`CANNOT_TERMINATE_BACKUP_INVALID_STATE`	409	除非集群处于`STOPPED`状态，否则无法终止备份。
`CHECKPOINT_NOT_FOUND`	404	集群`<cluster>`不存在 ID 为`<ID>`的检查点。
`CLUSTER_NOT_FOUND`	404	群组`<group>`中不存在 ID 为`<ID>`的集群。
`CONFIG_RESTORE_JOB_NOT_FOUND`	404	配置服务器`<config server>`不存在 ID 为`<ID>`的恢复作业。
`CONFIG_SNAPSHOT_NOT_FOUND`	404	配置服务器`<config server>`不存在 ID 为`<ID>`的快照。
`DATABASE_NAME_REQUIRED`	400	指标`<metric>`要求提供数据库名称。
`DATABASE_NOT_FOUND`	404	主机`<host>`上不存在名为`<name>`的数据库。
`DEVICE_NAME_REQUIRED`	400	指标`<metric>`要求提供设备名称。
`DEVICE_NOT_FOUND`	404	主机`<host>`上不存在名为`<name>`的设备。
`DISALLOWED_ATTRIBUTE_TURN_ON_LDAP`	400	不允许使用属性`<attribute>` 。要启用它，请在 Ops Manager 配置中将身份验证更改为 LDAP。
`DUPLICATE_ADDRESSES_IN_INPUT`	400	添加到访问列表中的两个或多个 IP 地址是相同的。
`DUPLICATE_ROLE_ENTRY_IN_LDAP_MAPPING`	400	每个角色名称只能出现在一个条目中。 `<Entry>`被多次使用。
`EMAIL_OR_SMS_REQUIRED_FOR_GROUP_NOTIFICATION`	400	组通知必须启用电子邮件和/或短信功能。
`EMAIL_OR_SMS_REQUIRED_FOR_USER_NOTIFICATION`	400	必须启用电子邮件和/或短信以提供用户通知。
`EXPIRATION_DATE_MUST_BE_IN_FUTURE`	400	日志收集请求作业的到期日期必须是将来的日期。
`EXPIRATION_DATE_TOO_DISTANT`	400	日志collection请求作业的到期日期最多只能是未来 6 个月。
`FEATURE_UNSUPPORTED`	403	当前帐户级别不支持此功能。
`FRACTIONAL_TIMESTAMP`	400	时间戳必须是整数秒数。
`GLOBAL_ALERT_CONFIG_NOT_FOUND`	404	不存在 ID 为`<ID>`的全局警报配置。
`GLOBAL_ALERTS_ONLY`	400	指定的事件类型`<type>`只能用于全局警报。
`GROUP_ALREADY_EXISTS`	409	已存在名称为`<name>`的群组。
`GROUP_API_KEY_NOT_FOUND`	404	不存在 API 密钥`<key>`的群组。
`GROUP_MISMATCH`	400	指定的群组 ID（group ID） `<ID>`与 URL 不匹配。
`GROUP_NAME_NOT_FOUND`	404	不存在名为`<name>`的群组。
`GROUP_NOT_FOUND`	404	不存在 ID 为`<ID>`的群组。
`HOST_LAST_PING_NOT_FOUND`	404	群组`<group>`中的主机`<host>`不存在最后的网络探测（ping）操作。
`HOST_NOT_FOUND`	404	群组`<group>`中不存在 ID 为`<ID>`的主机。
`HOSTNAME_AND_PORT_NOT_FOUND`	404	群组`<group>`中不存在主机名和端口`<name:port>`的主机。
`INVALID_AGENT_TYPE_NAME`	400	指定的代理类型名称`<name>`无效。
`INVALID_ALERT_CONFIG_ID`	404	指定的警报配置 ID `<ID>`无效。
`INVALID_ALERT_ID`	404	指定的警报 ID `<ID>`无效。
`INVALID_ALERT_STATUS`	400	指定的警报状态`<status>`无效。
`INVALID_ATTRIBUTE`	400	指定的属性`<attribute>`无效。
`INVALID_AUTH_MECHANISM`	400	身份验证机制`<mechanism>`无效。
`INVALID_AUTH_TYPE_NAME`	400	指定的身份验证类型名称`<name>`无效。
`INVALID_CHECKPOINT_ID`	404	指定的检查点 ID `<ID>`无效。
`INVALID_CLUSTER_CHECKPOINT_INTERVAL`	400	集群检查点间隔必须为 15、30 或 60 分钟。
`INVALID_CLUSTER_ID`	404	指定的集群 ID `<ID>`无效。
`INVALID_DAILY_SNAPSHOT_RETENTION_PERIOD`	400	每日快照保留期必须介于 1 到 365 天之间。
`INVALID_DIRECTORY`	400	指定的目录名称`<name>`无效。
`INVALID_EMAIL_ADDRESS`	400	指定了无效的电子邮件地址。
`INVALID_ENUM_VALUE`	400	指定的枚举值`<value>`无效。
`INVALID_EVENT_TYPE_FOR_ALERT`	400	警报不支持事件类型`<type>` 。
`INVALID_FILTERLIST`	400	备份配置不能同时指定包含的命名空间和排除的命名空间。
`INVALID_GRANULARITY`	400	指定的粒度`<granularity>`无效。
`INVALID_GROUP_ID`	404	指定的群组 ID（group ID） `<ID>`无效。
`INVALID_GROUP_NAME_10GEN`	400	群组名称不能包含“10gen-”或“-10gen”。
`INVALID_GROUP_NAME`	400	指定的群组名称`<name>`无效。
`INVALID_GROUP_TOKEN`	400	群组标签必须是长度不超过`<MAX_TAG_LENGTH>`个字符的字符串（字母数字、句点、下划线和破折号）。
`INVALID_HOST_PORT`	400	主机端口`<number>`无效。
`INVALID_HOSTNAME_PREFIX`	400	主机名前缀`<prefix>`无效。它必须仅包含字母数字字符和连字符，不得以连字符 ("-") 开头或结尾，且长度不得超过 63 个字符。
`INVALID_HOSTNAME`	400	主机名`<name>`无效。
`INVALID_JOB_ID`	404	指定的恢复作业 ID `<ID>`无效。
`INVALID_JSON_ATTRIBUTE`	400	收到的`<attribute>`属性的 JSON 与预期格式不匹配。
`INVALID_JSON`	400	收到的 JSON 不符合预期格式。
`INVALID_KEY_ID`	404	指定的密钥 ID `<ID>`无效。
`INVALID_LOG_REQUEST_SIZE`	400	日志请求大小必须是正数。
`INVALID_MACHINE_ID`	404	指定的机器 ID `<ID>`无效。
`INVALID_MACHINE_IMAGE`	400	指定的机器映像无效。
`INVALID_METRIC_NAME`	404	指定的指标名称`<name>`无效。
`INVALID_MONGODB_USERNAME`	400	用户名`<username>`不是有效的 MongoDB 登录名。
`INVALID_MONITORING_STATE`	409	没有此进程的监控数据。
`INVALID_MONTHLY_SNAPSHOT_RETENTION_PERIOD`	400	每月快照保留期必须介于 1 到 36 个月之间。
`INVALID_OPERATOR_FOR_EVENT_TYPE`	400	操作符`<operator>`与事件类型`<type>`不兼容。
`INVALID_PERIOD`	400	指定的时段无效。
`INVALID_QUERY_PARAMETER`	400	指定的查询参数`<parameter>`无效。
`INVALID_REFERENCE_HOUR_OF_DAY`	400	快照计划基准小时必须在 0 到 23 之间（含这两个值）。
`INVALID_REFERENCE_MINUTE_OF_HOUR`	400	快照计划参考分钟数必须介于 0 到 59（含）之间。
`INVALID_REFERENCE_TIMEZONE_OFFSET`	400	快照计划时区偏移必须符合 ISO-8601 时间偏移格式，例如“+0000”。
`INVALID_ROLE_FOR_GROUP`	400	角色`<role>`对于群组`<group>`无效。
`INVALID_SNAPSHOT_ID`	404	指定的快照 ID `<ID>`无效。
`INVALID_SNAPSHOT_INTERVAL`	400	快照间隔必须为 6、8、12 或 24 小时。
`INVALID_SNAPSHOT_RETENTION_PERIOD`	400	快照保留期必须介于 1 到 5 天之间。
`INVALID_SSH_KEY`	400	指定的 SSH 密钥无效。
`INVALID_USER_ID`	404	指定的用户 ID `<ID>`无效。
`INVALID_USERNAME`	400	指定的用户名不是有效的电子邮件地址。
`INVALID_USER`	400	不存在用户`<username>` 。
`INVALID_WEEKLY_SNAPSHOT_RETENTION_PERIOD`	400	每周快照保留期必须介于 1 到 52 周之间。
`INVALID_WINDOW_ID`	404	指定的维护窗口 ID `<ID>`无效。
`INVITATION_ONLY_MODE_OR_LDAP`	403	在邀请模式下或使用 LDAP 后端时禁止。
`IP_ADDRESS_NOT_ON_ACCESS_LIST`	403	不允许 IP 地址`<address>`访问此资源。
`LAST_PING_NOT_FOUND`	404	群组`<group>`不存在最后一次网络探测（ping）。
`LINK_EXPIRATION_AFTER_SNAPSHOT_DELETION`	409	无法将 HTTP 链接过期时间设置为快照删除时间之后。
	404	该群组中不存在具有给定 ID 的作业。
`MAINTENANCE_WINDOW_NOT_FOUND`	404	`<group>`组中不存在 ID 为`<ID>`的维护窗口。
`MAINTENANCE_WINDOW_START_DATE_AFTER_END_DATE`	400	维护窗口配置必须指定结束日期之前的开始日期。
`MAX_USERS_PER_TEAM_EXCEEDED`	400	尝试添加用户时，超出了每个团队的最大 Ops Manager 用户数。团队限制为 250 名用户。
`MAX_TEAMS_PER_ORG_EXCEEDED`	400	尝试添加团队时，超出了每个组织的最大团队数。组织仅限于 250 个团队。
`METRIC_THRESHOLD_PRESENT`	400	指标阈值应仅特定于主机指标警报。
`MISSING_ALERT_CONFIG_ID`	404	找不到警报配置 ID。
`MISSING_ATTRIBUTE`	400	未指定必需属性`<attribute>` 。
`MISSING_CREDENTIALS_FOR_AUTH_MECHANISM`	400	身份验证机制`<mechanism>`需要用户名和密码。
`MISSING_MAINTENANCE_WINDOW_ALERT_TYPE_NAME`	400	维护窗口配置必须至少指定一种警报类型。
`MISSING_MAINTENANCE_WINDOW_END_DATE`	400	维护窗口配置必须指定结束日期。
`MISSING_MAINTENANCE_WINDOW_START_DATE`	400	维护窗口配置必须指定开始日期。
`MISSING_METRIC_THRESHOLD`	400	必须为主机指标警报指定一个指标阈值。
`MISSING_NOTIFICATIONS`	400	必须为警报配置至少指定一个通知。
`MISSING_ONE_OF_ATTRIBUTES`	400	必须指定`<attribute>`属性或`<attribute>`属性。
`MISSING_ONE_OF_THREE_ATTRIBUTES`	400	必须指定`<attribute>`属性、 `<attribute>`属性或`<attribute>`属性。
`MISSING_OR_INVALID_ATTRIBUTE`	400	指定的必需属性`<attribute>`不正确或被省略。
`MISSING_PASSWORD`	400	如果不指定密码，则无法更改用户名。
`MISSING_QUERY_PARAMETER`	400	未指定所需的查询参数`<parameter>` 。
`MISSING_ROLE_ENTRY_IN_LDAP_MAPPING`	400	LDAP 群组映射中缺少`<role>`角色或缺少其值。
`MISSING_ROLES_FOR_GROUP_NOTIFICATION`	400	组通知不能指定空角色列表。
`MISSING_SYNC_SOURCE`	409	更改storage engine需要重新同步，因此必须提供同步源。
`MISSING_THRESHOLD`	400	必须为节点运行状况警报指定阈值。
`MULTIPLE_GROUPS`	409	存在多个具有指定名称的组。
`MUTUALLY_EXCLUSIVE_QUERY_PARAMETERS`	400	应指定`<parameter>`查询参数或`<parameter>`查询参数，但不能同时指定两者。
`NO_CHECKPOINT_FOR_PIT_RESTORE`	409	无法为指定的时间点恢复找到合适的检查点。
`NO_CURRENT_USER`	401	没有当前用户。
`NO_GROUP_SSH_KEY`	409	群组`<group>`不存在群组 SSH 密钥。
`NONZERO_DELAY_REQUIRED`	400	指定的指标要求所有通知的延迟不为零。
`NOT_CONFIG_SERVER`	404	主机`<host>`不是 SCCC 配置服务器。
`NOT_DATABASE_OR_DISK_METRIC`	404	指标`<metric>`既不是数据库指标，也不是磁盘指标。
`NOT_GLOBAL_USER_ADMIN`	401	当前登录的用户没有全局用户管理员。
`NOT_GROUP_USER_ADMIN`	401	当前登录的用户在`<group>`群组中没有用户管理员角色。
`NOT_IN_GROUP`	401	当前用户不在组中，或者组不存在。
`NOT_ORG_ADMIN`	401	当前登录的用户在组织`<organization>`中没有管理员角色。
`NOT_SHARDED`	400	只能修补分片集群和副本集。
`NOT_USER_ADMIN`	401	当前登录的用户不具有包含用户`<username>`的任何群组、团队或组织的用户管理员角色。
`NOTIFICATION_INTERVAL_OUT_OF_RANGE`	400	通知必须至少间隔 5 分钟。
`NOTIFICATION_TYPE_IS_GLOBAL_ONLY`	400	至少一个通知是仅可用于全局警报配置的类型。
`ONLY_FAILED_JOB_CAN_BE_RESTARTED`	400	只有处于`FAILED`状态的日志collection请求作业才能重新启动。
`ORG_NOT_FOUND`	404	不存在 ID 为`<ID>`的组织。
`RATE_LIMITED`	429	资源`<resource>`被限制为每`<number>`分钟`<number>`个请求。
`RESOURCE_NOT_FOUND`	404	找不到资源`<resource>` 。
`RESTORE_JOB_NOT_FOUND_IN_GROUP`	404	群组`<group>`中不存在 ID 为`<ID>`的恢复作业。
`RESTORE_JOB_NOT_FOUND`	404	集群`<cluster>`不存在 ID 为`<ID>`的恢复作业。
`ROLE_NEEDS_GROUP_ID`	400	群组特定角色`<role>`需要群组 ID。
`ROLE_NEEDS_NO_GROUP_ID`	400	不能使用群组 ID（group ID）指定全局角色`<role>` 。
`ROLE_NEEDS_NO_ORG_ID`	400	角色`<role>`不能与组织 ID 一起指定。
`ROLE_NEEDS_ORG_ID`	400	角色`<role>`需要组织 ID。
`ROLES_SPECIFIED_FOR_USER`	403	为用户指定的角色。
`SNAPSHOT_NOT_FOUND`	404	集群`<cluster>`不存在 ID 为`<ID>`的快照。
`THRESHOLD_PRESENT`	400	应仅针对节点运行状况警报设置阈值。
`TOO_MANY_GROUP_NOTIFICATIONS`	400	最多可为警报配置指定一个组通知。
`TOO_MANY_GROUP_TOKENS`	400	群组仅限于`<MAX_TAGS_PER_GROUP>`标签。
`TOTAL_MODE_DEPRECATED`	400	不再支持模式`TOTAL` 。
`UNEXPECTED_ERROR`	500	意外错误。
`UNITS_MISMATCH`	400	阈值单位不能转换为指标单位。
`UNSUPPORTED_AUTOMATION_AGENT_VERSION`		自动化代理版本低于可接受的最低版本。
`UNSUPPORTED_DELIVERY_METHOD`	400	不支持指定的传送方式。
`UNSUPPORTED_FOR_CURRENT_CONFIG`	403	当前配置不支持操作。
`UNSUPPORTED_FOR_CURRENT_PLAN`	403	当前计划不支持操作。
`UNSUPPORTED_NOTIFICATION_TYPE`	400	不支持通知类型`<type>` 。
`UNSUPPORTED_SET_BACKUP_STATE`	403	不支持将备份状态设置为`<state>` 。
`UPGRADE_FOR_CLUSTER_CHECKPOINT_INTERVAL`	409	此备份版本不支持集群检查点间隔；请升级。
`UPGRADE_FOR_EXCLUDED_NAMESPACES`	409	此备份版本不支持已排除的命名空间；请升级。
`UPGRADE_FOR_INCLUDED_NAMESPACES`	409	此备份版本不支持包含的命名空间；请升级。
`USER_ALREADY_EXISTS`	409	已存在用户名为`<username>`的用户。
`USER_NOT_FOUND`	404	不存在 ID 为`<ID>`的用户。
`USER_NOT_IN_GROUP`	404	用户`<username>`不在群组`<group>`中。
`USER_UNAUTHORIZED`	401	当前用户无权执行此操作。
`USERNAME_NOT_FOUND`	404	不存在用户名为`<username>`的用户。
`WEAK_PASSWORD`	400	指定的密码强度不够高。
`WEBHOOK_URL_NOT_SET`	400	添加 Webhook 通知之前，必须在组中设置 Webhook URL。
`ACCESS_LIST_ACCESS_DENIED`	401	无法检索当前未登录的用户`<username>`的访问列表。
`ACCESS_LIST_NOT_FOUND`	404	IP 地址`<address>`不在用户`<username>`的访问列表中。

后退

返回组织之间的连接状态

来年

配置 API 访问