云服务器内容精选

  • 功能介绍 该接口由“创建数据库实例(v3)”接口派生而来,接口请求体新增了“subscription_agency”字段,该字段用于使用 RAM 共享密钥创建包周期RDS实例的场景。该接口用于创建RDS实例,可分为单实例、HA实例和只读副本。 调用接口前,您需要了解API 认证鉴权。 本接口仅支持AK/SK认证。本接口支持在HTTP请求消息头中设置X-Client-Token请求头,保证请求幂等性。详细信息请参考请求幂等性说明。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 id String DDM实例ID。 状态码: 400 表5 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码: 500 表6 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。
  • 请求示例 删除实例,删除关联后端数据库实例上存储的数据。 DELETE https://{endpoint}/v1/{project_id}/instances/{instance_id}?delete_rds_data=true 删除实例,保留关联后端数据库实例上存储的数据。 DELETE https://{endpoint}/v1/{project_id}/instances/{instance_id}?delete_rds_data=false
  • 响应示例 状态码: 200 OK { "id" : "9608ce63-bf66-4342-be8a-44f9b6b15d54" } 状态码: 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码: 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }
  • URI DELETE /v1/{project_id}/instances/{instance_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 String DDM实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 delete_rds_data 否 String 是否同时删除关联后端数据库实例上存储的数据。 取值为空或“true”:删除。 取值为“false”:不删除。 默认值为空。 枚举值: true false
  • 响应示例 状态码: 200 Successful { "instances" : [ { "identity_store_id" : "d-a00aaaa33f", "alias" : "new-store-id-123", "instance_id" : "ins-bd8baaaaaaaade60" } ], "page_info" : { "next_marker" : null, "current_count" : 1 } }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 instances Array of objects IAM 身份中心实例信息列表。 page_info Object 包含分页信息的对象。 表4 instances 参数 参数类型 描述 identity_store_id String 关联到IAM身份中心实例的身份源的全局唯一标识符(ID)。 最小长度:1 最大长度:64 instance_id String IAM身份中心实例的全局唯一标识符(ID)。 最小长度:20 最大长度:20 alias String 用户为身份源标识符定义的别名。 instance_urn String 实例的统一资源名称(URN)。 表5 page_info 参数 参数类型 描述 next_marker String 如果存在,则表示可用的输出比当前响应中包含的输出多。在对操作的后续调用中,在标签请求参数中使用此值,以获取输出的下一部分。您应该重复此操作,直到next_marker响应元素返回为null。 current_count Integer 本页返回条目数量。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误信息。 request_id String 请求唯一标识。 状态码: 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误信息。 request_id String 请求唯一标识。
  • 查看实例状态 在总览页上方的下拉框,选择“ GaussDB (for MySQL)”,展示当前账号下所有GaussDB(for MySQL)标准版实例的状态。 图1 查看实例状态 表1 状态说明 类别 说明 操作 处理建议 实例总数 全部运行状态下,GaussDB(for MySQL)标准版主实例和只读实例的总数。 单击“实例总数”,跳转到实例列表,查看所有实例。 - 异常 运行状态为“异常”的GaussDB(for MySQL)标准版实例总数。 单击“异常”,跳转到实例列表,仅展示异常的实例。 联系客服处理。 磁盘不足 运行状态为“存储空间满”的GaussDB(for MySQL)标准版实例总数。 单击“磁盘不足”,跳转到实例列表,仅展示磁盘不足的实例。 详见GaussDB(for MySQL)标准版实例磁盘满导致实例异常的解决方法。 冻结 运行状态为“冻结”的GaussDB(for MySQL)标准版实例总数。 单击“冻结”,跳转到实例列表,仅展示冻结的实例。 - 等待重启 运行状态为“等待重启”的GaussDB(for MySQL)标准版实例总数。 说明: 数据库参数修改后,有些参数需要重启实例才能生效,未重启前实例状态为“等待重启”。 单击“等待重启”,跳转到实例列表,仅展示等待重启的实例。 重启实例。
  • 查看活动告警 根据设置的告警规则,查看当前账号下所有GaussDB(for MySQL)标准版实例的活动告警记录,包含“告警中(指标)”,“已触发(事件)”。 在活动告警页面上方,单击“设置告警规则”,跳转到 云监控 页面。 系统默认内置一条告警规则,支持修改、停用、删除等操作,详见修改告警规则。 单击“创建告警规则”,为数据库实例新建指标监控或事件监控告警规则。更多操作,情参见创建告警规则和通知。 在活动告警页面上方,选择时间范围,查看告警详情。 支持的监控时间窗:近1小时、近6小时、近12小时、近1天、近1周、近1月。 活动告警从多个模块为用户展示实例告警详情,各模块的详细说明请参见表2和表3。 表2 告警总数TOP5实例 模块项 说明 级别统计 查看不同告警级别下各自触发数。告警级别包括:紧急、重要、次要、提示。 告警总数TOP5实例 查看告警总数TOP5的实例,鼠标悬停可查看当前实例各级别的告警触发数。 单击TOP5实例名称,在下方列表中查看对应实例的告警信息。 表3 告警列表说明 类别 说明 实例名称 触发告警的实例名称,在下拉框选择查看全部告警实例或指定实例的告警信息。 刷新页面后,实时展示最新触发的告警详情。 告警级别 包括:紧急、重要、次要、提示。在告警列表上方选择查看指定告警级别或全部级别的告警信息。 状态 告警中:监控指标数值达到告警配置阈值,资源正在告警中。 已触发:监控的资源触发了告警策略中配置的事件。 最新更新时间 该条告警的最新触发时间。 告警类型 告警规则适用的告警类型。 告警中(指标) 已触发(事件) 告警策略 触发告警规则的告警策略。 当告警类型选择指标监控时,是否触发告警取决于连续周期的数据是否达到阈值。例如:CPU使用率监控周期为5分钟,连续三个周期平均值≥80%,则触发告警。 当告警类型选择事件监控时,触发告警具体的事件为一个瞬间的事件。例如:创建实例业务失败,则触发告警。 告警规则 该条告警所在告警规则的名称/ID。 操作 单击“告警指标”,在右侧弹窗中,查看所选时间段内的指标监控视图。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 x-auth-token 是 String 用户Token。 通过调用IAM服务的“获取用户Token”接口来获取。 表3 请求Body参数 参数 是否必选 参数类型 描述 spec_code 是 String 变更至新规格的资源规格编码。 group_id 否 String 实例默认一个组,此时不需要传入该参数。当使用组功能创建多个组时, 需要传入需要规格变更的对应组的group_id。 is_auto_pay 否 Boolean 变更包年包月实例规格时可指定,表示是否自动从账户中支付,此字段不影响自动续订的支付方式。true,表示自动从账户中支付。false,表示手动从账户中支付,默认为该方式。
  • 响应参数 状态码: 202 表4 响应Body参数 参数 参数类型 描述 job_id String 规格变更的任务ID,仅变更按需实例时会返回该参数。 order_id String 订单ID,仅变更包周期实例时会返回该参数。 状态码: 400 表5 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码: 500 表6 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。
  • 请求示例 变更实例规格为ddm.c6.4xlarge.2。 PUT https://{endpoint}/v3/{project_id}/instances/{instance_id}/flavor { "spec_code" : "ddm.c6.4xlarge.2", "group_id" : "3e5a9063d3b84729b0a3310fad3a0942gr09", "is_auto_pay" : false }
  • 响应消息 正常响应参数说明 表3 响应Body参数 参数 参数类型 描述 versions Array of strings 可变更的内核版本。 current_version String DDM实例当前内核版本。 latest_version String 最新优选版本,属于可变更的内核版本。 current_favored_version String 系列优选版本,如3.0.8系列优选版本为3.0.8.5,属于可变更的内核版本。 previous_version String DDM实例最近一次升级前版本。 正常响应示例 { "versions": [ "3.1.0.7" ], "current_version": "3.0.8.5", "latest_version": "3.1.0.7", "current_favored_version": "3.0.8.5", "previous_version": "3.0.8.3" } 异常响应 请参见异常请求结果。
  • URI URL格式 GET /v3/{project_id}/instances/{instance_id}/database-version/available-versions 参数说明 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 String DDM实例ID。
  • 响应参数 状态码: 202 表36 响应Body参数 参数 参数类型 描述 job Object 批量创建异步任务响应体。 详情请参见表37。 表37 job字段数据结构说明 参数 参数类型 描述 async_job_id String 批量异步创建的任务ID。 状态码: 400 表38 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:1 最大长度:512