更新时间:2025-09-03 GMT+08:00
        
          
          
        
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
  
      
      
      
        
查询消费组消息位点
功能介绍
查询消费组消息位点。
URI
GET /v2/{engine}/{project_id}/instances/{instance_id}/groups/{group}/message-offset
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        engine  | 
      
        是  | 
      
        String  | 
      
        消息引擎。  | 
     
| 
        project_id  | 
      
        是  | 
      
        String  | 
      
        项目ID,获取方式请参见获取项目ID。  | 
     
| 
        instance_id  | 
      
        是  | 
      
        String  | 
      
        实例ID。  | 
     
| 
        group  | 
      
        是  | 
      
        String  | 
      
        消费组名称。  | 
     
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        topic  | 
      
        否  | 
      
        String  | 
      
        topic名称。  | 
     
| 
        partition  | 
      
        否  | 
      
        String  | 
      
        分区名称。  | 
     
| 
        offset  | 
      
        否  | 
      
        String  | 
      
        偏移值。  | 
     
| 
        limit  | 
      
        否  | 
      
        String  | 
      
        最大值。  | 
     
请求参数
无
响应参数
状态码:200
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        group_message_offsets  | 
      
        Array of GroupMessageOffsetsDetailEntity objects  | 
      
        消费组消息位点详情  | 
     
| 
        total  | 
      
        Integer  | 
      
        总数  | 
     
请求示例
查询消费组消息位点
GET https://{endpoint}/v2/{engine}/{project_id}/instances/{instance_id}/groups/{group}/message-offset
 响应示例
状态码:200
查询成功
{
  "group_message_offsets" : [ ],
  "total" : 0
}
 状态码
| 
        状态码  | 
      
        描述  | 
     
|---|---|
| 
        200  | 
      
        查询成功  | 
     
错误码
请参见错误码。
   父主题: 消费组管理