Configure los permisos de lectura de un grupo de consumidores.
Nota
Esta operación permite especificar si los consumidores de un grupo determinado pueden leer mensajes. Úsela cuando necesite impedir que los consumidores de un grupo específico lean mensajes.
Límite de solicitudes
Cada cuenta de Alibaba Cloud puede invocar esta operación hasta 10 veces por segundo. Si el número de solicitudes enviadas en un segundo alcanza este límite, las nuevas solicitudes fallarán y podrían interrumpir su servicio. Para obtener más información sobre los límites de cada operación, consulte Límites de solicitudes de API.
Autorización
De forma predeterminada, las cuentas de Alibaba Cloud pueden invocar esta operación. Un usuario de Resource Access Management (RAM) solo podrá hacerlo después de recibir los permisos necesarios. La siguiente tabla describe los permisos que se deben otorgar a un usuario de RAM para invocar esta operación. Para más detalles sobre cómo asignar permisos, consulte Políticas.
|
API |
Action |
Resource en una instancia con espacio de nombres |
Resource en una instancia sin espacio de nombres |
|
OnsGroupConsumerUpdate |
mq:QueryInstanceBaseInfo mq:UpdateGroupConsumer |
acs:mq:::{instanceId}%{groupId} |
acs:mq:::{groupId} |
Parámetros de solicitud
| Parámetro | Tipo | Obligatorio | Ejemplo | Descripción |
| Action | String | Sí | OnsGroupConsumerUpdate | La operación que desea ejecutar. Establezca el valor como OnsGroupConsumerUpdate. |
| GroupId | String | Sí | GID_test_groupId | El ID del grupo de consumidores cuyos permisos de lectura desea configurar. |
| ReadEnable | Boolean | Sí | true | Especifique si se autoriza al grupo de consumidores indicado a leer mensajes. Valores válidos:
Valor predeterminado: true. |
| InstanceId | String | Sí | MQ_INST_111111111111_DOxxxxxx | El ID de la instancia de Message Queue for Apache RocketMQ que contiene el grupo de consumidores especificado. |
Parámetros de respuesta
|
Parámetro |
Tipo |
Ejemplo |
Descripción |
|
RequestId |
String |
A07E3902-B92E-44A6-B6C5-6AA111111**** |
El ID de la solicitud. El sistema genera un ID único para cada solicitud, el cual sirve para solucionar problemas. |
Ejemplos
Solicitudes de ejemplo
http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupConsumerUpdate
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&ReadEnable=true
&<Common request parameters>Respuestas exitosas de ejemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsGroupConsumerUpdateResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupConsumerUpdateResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"
}Códigos de error
Para consultar la lista de códigos de error, visite el Centro de errores de API.