云服务器内容精选

  • 概览 数据库智能运维(DMS)是一个为GaussDB(DWS)数据库提供多维度监控服务的系统,为用户数据库的快速、稳定运行提供保驾护航的能力。该功能对业务数据库所使用磁盘、网络、OS指标数据,集群运行关键性能指标数据进行收集、监控、分析。通过综合收集到的多种类型指标,对数据库主机、实例及业务SQL进行诊断,及时暴露数据库中关键故障及性能问题,指导用户进行优化解决。 8.1.1.200及以上版本支持数据库监控功能。 实时数仓(单机部署)暂不支持DMS功能。 DMS与Cloud Eye监控的数据源不同,采集数据库的大小为该数据库使用的全部磁盘空间,会包含膨胀表的数据。
  • 请求示例 POST https://{endpoint}/v2/{project_id}/queues/{queue_id}/groups/{consumer_group_id}/deadletters/ack{ "message" : [ { "handler" : "eyJjb25zdW1lckdyb3VwIjoibXFzX2NvbnN1bWVyXzMiLCJjb25zdW1lckluc3RhbmNlIjoicmVzdC1jb25zdW1lci1hMWM5YTRlMy1mNTY5LTQyYTgtOTQ1Ni1hYmU0NDVmZjUxYzkiLCJjb3VudCI6MSwib2Zmc2V0IjowLCJvZmZzZXRJbmRleCI6LTEsInBhcnRpdGlvbiI6MiwidG9waWMiOiJxLWI3OGE5MGFlMmExMzRiNGI4YjJiYTMwYWNhYjRlMjNhLTA3NWFlN2RhLTZjZTUtNDk2Ni05NDBjLTE3YzE5ZmI1MTc1ZSJ9", "status" : "success" } ]}
    DMS
  • 功能介绍 确认已经消费指定的死信消息。 在消费者消费死信消息期间,死信消息仍然停留在队列中,但死信消息从被消费开始的30秒内不能被该消费组再次消费,若在这30秒内没有被消费者确认消费,则DMS认为死信消息未消费成功,将可以被继续消费。 如果死信消息被确认消费成功,该死信消息将不能被该消费组再次消费,死信消息的保留时间为72小时(除非消费组被删除),72小时后会被删除。 消息批量消费确认时,必须严格按照消息消费的顺序提交确认,DMS按顺序判定消息是否消费成功,如果某条消息未确认或消费失败,则不再继续检测,默认后续消息全部消费失败。建议当对某一条消息处理失败时,不再需要继续处理本批消息中的后续消息,直接对已正确处理的消息进行确认。 仅NORMAL队列和FIFO队列可以开启死信消息,因为只有NORMAL队列和FIFO队列可消费死信消息。
    DMS
  • 响应示例 状态码: 200 查询成功。 { "queues" : [ { "id" : "ef808d2d-58c2-4a36-9e58-d018b2193f80", "name" : "aaa_fifo_525", "description" : "test_fifo_detail", "queue_mode" : "NORMAL", "reservation" : 4320, "created" : 1495701557000, "max_msg_size_byte" : 524288, "produced_messages" : 1, "redrive_policy" : "enable", "max_consume_count" : 3, "eff_date" : 1495701557000, "group_count" : 0 } ], "total" : 1}
    DMS
  • URI GET /v2/{project_id}/queues 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 include_deadletter 否 Boolean 是否包含死信信息。 支持的值如下: true:包含死信消息。 false:不包含死信消息。 默认值为:false。 Kafka队列没有死信功能,该参数对于Kafka队列无效。
    DMS
  • 实例状态说明 表1 实例状态说明 状态 说明 Creating 申请实例后,在实例状态进入运行中之前的状态。 Running 实例正常运行状态。在这个状态的实例可以运行您的业务。 Faulty 实例处于故障的状态。 Restarting 实例正在进行重启操作。 Resizing Kafka专享版实例正在进行规格变更、开启转储、开启公网访问等操作。 Resizing failed Kafka专享版实例处于规格变更、开启转储、开启公网访问操作失败的状态。 FROZEN 实例处于已冻结状态,用户可以在“我的订单”中续费开启冻结的实例。 父主题: 附录
    DMS
  • 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”,其中{Endpoint}为IAM的终端节点,可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下,其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "cn-north-4", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" }}
    DMS
  • 响应消息 响应参数 响应参数如表3所示。 表3 响应参数 参数 类型 描述 id String 队列ID。 name String 队列的名称。 kafka_topic String 仅Kafka队列才有该响应参数。 使用Kafka SDK时的Kafka topic的ID。 响应示例 创建FIFO队列: { "id": "9bf46390-38a2-462d-b392-4d5b2d519c55", "name": "queue_001"} 创建Kafka队列: { "id" : "3ec7a4a2-541b-430a-9c2b-77fa4b64ed8", "name" : "queue_002", "kafka_topic" : "k-fdc60cfe407a4b2a96a498efda55c785-3ec7a4a2-541b-430a-9c2b-77fa4b64ed8"}
    DMS
  • URI GET /v1.0/{project_id}/queues?include_deadletter={include_deadletter} 参数说明请参见表1。 表1 参数说明 名称 类型 是否必选 说明 project_id String 是 项目ID。 include_deadletter Boolean 否 是否包含死信信息。 支持的值如下: true:包含死信消息。 false:不包含死信消息。 默认值为:false。 Kafka队列没有死信功能,该参数对于Kafka队列无效。 示例 GET v1.0/b78a90ae2a134b4b8b2ba30acab4e23a/queues?&include_deadletter=true
    DMS
  • 响应消息 响应参数 响应参数如表2和表3所示。 表2 响应参数 参数 类型 描述 total Integer 该租户的所有队列总数。 queues Array 该租户的所有队列数组。 表3 queues参数 参数 类型 描述 id String 队列ID。 name String 队列的名称。 created String 创建队列的时间。 description String 队列的描述信息。 queue_mode String 队列类型。 reservation Integer 消息在队列中允许保留的时长(单位分钟)。 max_msg_size_byte Integer 队列中允许的最大消息大小(单位Byte)。 produced_messages Integer 队列的消息总数。 redrive_policy String 该队列是否开启死信消息。仅当include_deadletter为true时,才有该响应参数。 enable:表示开启。 disable:表示不开启。 max_consume_count Integer 最大确认消费失败的次数,当达到最大确认失败次数后,DMS会将该条消息转存到死信队列中。 仅当include_deadletter为true时,才有该响应参数。 group_count Integer 该队列下的消费组数量。 eff_date String 创建队列的时间。 响应示例 { "queues" : [{ "id" : "ef808d2d-58c2-4a36-9e58-d018b2193f80", "name" : "aaa_fifo_525", "description" : "test_fifo_detail", "queue_mode" : "NORMAL", "reservation" : 4320, "created" : 1495701557000, "max_msg_size_byte" : 524288, "produced_messages" : 1, "redrive_policy" : "enable", "max_consume_count" : 3, "eff_date": 1495701557000, "group_count" : 0 }, { "id" : "bc0ac1ec-a4d6-4490-84cb-9d475f1ec3c5", "name" : "aaa_normal_525", "description" : "test", "queue_mode" : "NORMAL", "reservation" : 4320, "created" : 1495701490000, "max_msg_size_byte" : 524288, "produced_messages" : 0, "redrive_policy" : "enable", "max_consume_count" : 3, "eff_date": 1495701490000, "group_count" : 0 }, { "id" : "1aaf34d0-7bb0-43be-9b71-f4b719d7ca47", "name" : "queue-normal", "description" : null, "queue_mode" : "NORMAL", "reservation" : 4320, "created" : 1495447342000, "max_msg_size_byte" : 524288, "produced_messages" : 2, "redrive_policy" : "enable", "max_consume_count" : 3, "eff_date": 1495447342000, "group_count" : 0 }, { "id" : "f685ed59-43f4-4cf9-b609-7f333820d72d", "name" : "queue-835807102", "description" : "", "reservation" : 2160, "created" : 1517379348000, "queue_mode" : "KAFKA_HA", "max_msg_size_byte" : 524288, "produced_messages" : 0, "eff_date": 1517379348000, "group_count" : 0 } ], "total" : 4}
    DMS
  • 请求消息体 请求消息体通常以结构化格式发出,与请求消息头中Content-type对应,传递除请求消息头之外的内容。若请求消息体中参数支持中文,则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于获取用户Token接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示,加粗的斜体字段需要根据实际值填写,其中username为用户名,domainname为用户所属的帐号名称,********为用户登录密码,xxxxxxxxxxxxxxxxxx为project的名称,如“cn-north-1”,您可以从地区和终端节点获取,对应地区和终端节点页面的“区域”字段的值。 scope参数定义了Token的作用域,上面示例中获取的Token仅能访问project下的资源。您还可以设置Token作用域为某个帐号下所有资源或帐号的某个project下的资源,详细定义请参见获取用户Token。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } }} 到这里为止这个请求需要的内容就具备齐全了,您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口,返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后,您就可以使用Token认证调用其他API。
    DMS
  • 请求消息头 附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type:消息体的类型(格式),必选,默认取值为“application/json”,有其他取值时会在具体接口中专门说明。 X-Auth-Token:用户Token,可选,当使用Token方式认证时,必须填充该字段。用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。 DMS API同时支持使用AK/SK认证,AK/SK认证是使用SDK对请求进行签名,签名过程会自动往请求中添加Authorization(签名认证信息)和X-Sdk-Date(请求发送的时间)请求头。 AK/SK认证的详细说明请参见AK/SK认证。 对于获取用户Token接口,由于不需要认证,所以只添加“Content-Type”即可,添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json
    DMS
  • 请求方法 HTTP请求方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。 GET:请求服务器返回指定资源。 PUT:请求服务器更新指定资源。 POST:请求服务器新增资源或执行特殊操作。 DELETE:请求服务器删除指定资源,如删除对象等。 HEAD:请求服务器资源头部。 PATCH:请求服务器更新资源的部分内容。当资源不存在的时候,PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分,您可以看到其请求方法为“POST”,则其请求为: POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens
    DMS
  • 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中,但大多数语言或框架都要求您从请求消息中单独传递它,所以在此单独强调。 URI-scheme: 表示用于传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint: 指定承载REST服务端点的服务器域名或IP,不同服务不同区域的Endpoint不同,您可以地区和终端节点获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path: 资源路径,也即API访问路径。从具体API的URI模块获取,例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string: 查询参数,是可选部分,并不是每个API都有查询参数。查询参数前面需要带一个“?”,形式为“参数名=参数取值”,例如“limit=10”,表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京一”区域的Token,则需使用“华北-北京一”区域的Endpoint(iam.cn-north-1.myhuaweicloud.com),并在获取用户Token的URI部分找到resource-path(/v3/auth/tokens),拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便,在每个具体API的URI部分,只给出resource-path部分,并将请求方法写在一起。这是因为URI-scheme都是HTTPS,同一个服务的Endpoint在同一个区域也相同,所以简洁起见将这两部分省略。
    DMS
  • 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 groups 是 Array of GroupEntity objects 消费组信息。 每个队列最多能创建3个消费组,如果请求中的消费组个数超过3个,请求校验不通过,无法创建消费组。 表3 GroupEntity 参数 是否必选 参数类型 描述 name 是 String 消费组的名称。 长度不超过32位的字符串,仅包含a~z,A~Z,0~9、下划线(_)和中划线(-)。
    DMS