OnsGroupCreate - - Centro de documentación de Alibaba Cloud

Cree un grupo.

Notas de uso

Cuando se publica una nueva versión de la aplicación o se implementa una nueva lógica de negocio, se requieren nuevos grupos. Llame a esta operación para crear un grupo.

Límite de solicitudes

Cada cuenta de Alibaba Cloud puede llamar a 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, lo cual podría interrumpir su servicio. Para obtener más información sobre los límites de cada operación, consulte Límites de velocidad de la API.

Autorización

De forma predeterminada, solo las cuentas de Alibaba Cloud pueden llamar a esta operación. Un usuario de Resource Access Management (RAM) solo podrá hacerlo después de recibir los permisos necesarios. La tabla a continuación describe los permisos que se deben otorgar a un usuario de RAM para ejecutar esta operación. Para más detalles sobre cómo asignar permisos, consulte Políticas y ejemplos.

API

Action

Resource

OnsGroupCreate

mq:QueryInstanceBaseInfo

mq:CreateGroup

acs:mq:::{instanceId}

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	OnsGroupCreate	La operación que desea ejecutar. Establezca el valor en OnsGroupCreate.
GroupId	String	Sí	GID_test_groupId	El ID del grupo que desea crear. Especifique el ID del grupo siguiendo estas reglas: Debe tener entre 2 y 64 caracteres, y solo puede contener letras, dígitos, guiones (-) y guiones bajos (_). Si la instancia de Message Queue for Apache RocketMQ donde creará el grupo utiliza un espacio de nombres, el ID del grupo debe ser único dentro de esa instancia. No puede coincidir con ningún otro ID de grupo ni nombre de tema existente en la misma instancia, pero sí puede repetirse en otra instancia con espacio de nombres distinto. Por ejemplo, si la Instancia A y la Instancia B usan espacios de nombres diferentes, un ID de grupo en la Instancia A puede ser igual a un ID de grupo o nombre de tema en la Instancia B. Si la instancia no usa espacio de nombres, el ID del grupo debe ser único globalmente en todas las instancias y regiones. No puede coincidir con ningún ID de grupo o nombre de tema existente en las instancias de Message Queue for Apache RocketMQ asociadas a su cuenta de Alibaba Cloud. Nota Una vez creado el grupo, no es posible modificar su ID. Para comprobar si una instancia utiliza espacio de nombres, inicie sesión en la consola de Message Queue for Apache RocketMQ, vaya a la página Instance Details y revise el valor del campo Namespace en la sección Basic Information.
Remark	String	No	test	La descripción del grupo.
InstanceId	String	Sí	MQ_INST_111111111111_DOxxxxxx	El ID de la instancia de Message Queue for Apache RocketMQ donde desea crear el grupo.
GroupType	String	No	tcp	El protocolo mediante el cual los clientes del grupo se comunican con el broker de Message Queue for Apache RocketMQ. Todos los clientes dentro de un mismo grupo deben usar el mismo protocolo. Debe crear grupos separados para clientes TCP y HTTP. Valores válidos: tcp: Los clientes del grupo publican o reciben mensajes a través de TCP. Este es el valor predeterminado. http: Los clientes del grupo publican o reciben mensajes a través de HTTP.

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=OnsGroupCreate
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Remark=test
&GroupType=tcp
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<OnsGroupCreateResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupCreateResponse>

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, consulte el Centro de errores de la API.

Crear un grupo desde la consola

También puede crear un grupo desde la consola de Message Queue for Apache RocketMQ. Para más información, consulte Gestionar grupos.