云服务器内容精选

  • 响应示例 状态码: 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
  • 请求示例 批量异步创建Oracle到GaussDB分布式版按需实时同步任务,任务模式为全量+增量,公网网络类型。 https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-async-create { "jobs" : [ { "base_info" : { "name" : "DRS-1234", "job_type" : "sync", "engine_type" : "oracle-to-gaussdbv5", "job_direction" : "up", "task_type" : "FULL_INCR_TRANS", "net_type" : "eip", "charging_mode" : "on_demand", "enterprise_project_id" : "0", "description" : "", "expired_days" : "14", "tags" : [ { "key" : "test", "value" : "test" } ] }, "source_endpoint" : [ { "db_type" : "oracle", "endpoint_type" : "offline", "endpoint_role" : "so", "endpoint" : { "endpoint_name" : "oracle", "ip" : "10.154.217.239", "db_port" : "1521", "db_user" : "ORACLE_USER", "db_name" : "serviceName.orcl", "db_password" : "******" }, "ssl" : { "ssl_link" : false } } ], "target_endpoint" : [ { "db_type" : "gaussdbv5", "endpoint_type" : "cloud", "endpoint_role" : "ta", "endpoint" : { "endpoint_name" : "cloud_gaussdbv5", "instance_id" : "c2c7579bc09c490b9d8009db715aeb0ain14", "db_user" : "root", "db_password" : "******" }, "cloud" : { "region" : "cn-north-4", "project_id" : "9dc8c0f3f74c4dbb23c29cf0318ee561", "az_code" : "cn-north-4a,cn-north-4g,cn-north-4c" }, "vpc" : { "vpc_id" : "2cb5d364-ae63-4fbb-85b7-7d59f4a88f8f", "subnet_id" : "2cb54324-ae63-4fbb-85b7-7d59f4a88f8f", "security_group_id" : "039a3s89-665a-43e2-9b4f-bda7d9ee148d" } } ], "alarm_notify" : { "alarm_to_user" : true, "topic_urn" : "urn:smn:cn-north-4:f2c2468c3ee7410c862a461ca073d2f2:test", "delay_time" : 60 }, "speed_limit" : [ { "begin" : "16:00", "end" : "15:59", "speed" : "10" } ], "policy_config" : { "ddl_trans" : false }, "db_object" : { "object_scope" : "table", "target_root_db" : { "db_name" : "target_db_name", "db_encoding" : "utf8" }, "object_info" : { "source_db1" : { "name" : "source_db1", "all" : false, "tables" : { "source_tb1" : { "type" : "table", "name" : "source_tb1", "all" : true }, "source_tb2" : { "type" : "table", "name" : "source_tb2", "all" : true } } } } }, "node_info" : { "spec" : { "node_type" : "medium" } } } ] }
  • 响应参数 状态码: 200 表20 响应Body参数 参数 参数类型 描述 id String 任务ID。 name String 任务名称。 status String 任务状态。 create_time String 任务创建时间。 is_clone_job String 是否为克隆任务。 状态码: 400 表21 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:1 最大长度:512
  • 请求示例 创建Oracle到GaussDB分布式版按需实时同步任务,任务模式为全量+增量,公网网络类型。 https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs { "job" : { "base_info" : { "name" : "DRS-1234", "job_type" : "sync", "engine_type" : "oracle-to-gaussdbv5", "job_direction" : "up", "task_type" : "FULL_INCR_TRANS", "net_type" : "eip", "charging_mode" : "on_demand", "enterprise_project_id" : "0", "description" : "", "expired_days" : "14", "tags" : [ { "key" : "test", "value" : "test" } ] }, "source_endpoint" : [ { "db_type" : "oracle", "endpoint_type" : "offline", "endpoint_role" : "so", "endpoint" : { "endpoint_name" : "oracle", "ip" : "10.154.217.239", "db_port" : "1521", "db_user" : "ORACLE_USER", "db_name" : "serviceName.orcl", "db_password" : "******" }, "ssl" : { "ssl_link" : false } } ], "target_endpoint" : [ { "db_type" : "gaussdbv5", "endpoint_type" : "cloud", "endpoint_role" : "ta", "endpoint" : { "endpoint_name" : "cloud_gaussdbv5", "instance_id" : "c2c7579bc09c490b9d8009db715aeb0ain14", "db_user" : "root", "db_password" : "******" }, "cloud" : { "region" : "cn-north-4", "project_id" : "9dc8c0f3f74c4dbb23c29cf0318ee561", "az_code" : "cn-north-4a,cn-north-4c,cn-north-4g" }, "vpc" : { "vpc_id" : "2cb5d364-ae63-4fbb-85b7-7d59f4a88f8f", "subnet_id" : "2cb54324-ae63-4fbb-85b7-7d59f4a88f8f", "security_group_id" : "039a3s89-665a-43e2-9b4f-bda7d9ee148d" } } ], "node_info" : { "spec" : { "node_type" : "medium" }, "vpc" : { "vpc_id" : "2cb5d364-ae63-4fbb-85b7-7d59f4a88f8f", "subnet_id" : "2cb54324-ae63-4fbb-85b7-7d59f4a88f8f" } } } }
  • 响应示例 状态码: 200 OK { "id" : "c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r", "name" : "DRS-1234", "status" : "CREATING", "create_time" : "2022-11-07T16:15:18Z", "is_clone_job": "false" } 状态码: 400 Bad Request { "error_code" : "DRS.10000001", "error_msg" : "Failed." }
  • 约束限制 转为高可用只读实例时,原只读规格支持SSD云盘、本地盘: SSD云盘:支持通用型、独享型和鲲鹏通用增强型。 本地盘:支持x86通用型和x86独享型。本地盘单机版只读实例如果需要转为高可用只读,请联系客服申请。 DEC用户支持创建高可用只读实例以及只读转高可用,资源类型选择“专属存储”时,默认只显示购买专属分布式存储服务时选择的存储类型。 证书、磁盘加密、端口、子网信息跟已有高可用只读一致(若没有高可用只读,则跟主实例一致)时,非高可用只读才可变更到高可用只读。 创建高可用只读或是变更到高可用只读时,需要保证实例所在子网的可用私有IP数量≥ 3。 不建议修改高可用只读实例的参数,否则会影响到高可用只读的可靠性。 高可用只读不允许进行如下操作:修改端口、转换到非高可用只读实例。