Supprime un groupe.
Notes d'utilisation
Appelez cette opération pour supprimer un groupe lorsque vous devez libérer les ressources associées. Par exemple, après la mise hors service d'une application, supprimez les groupes qu'elle utilise.
Le backend de Message Queue for Apache RocketMQ libère les ressources du groupe supprimé. Cette opération peut prendre un certain temps. Nous vous déconseillons de créer immédiatement un nouveau groupe portant le même nom qu'un groupe récemment supprimé. Si la suppression échoue, résolvez le problème en vous basant sur le code d'erreur.
Les consommateurs du groupe cessent immédiatement de recevoir des messages après sa suppression. Utilisez cette opération avec précaution.
Limite de requêtes
Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 10 fois par seconde. Si le nombre de requêtes envoyées en une seconde atteint cette limite, les nouvelles requêtes échouent, ce qui peut interrompre votre activité. Pour plus d'informations sur les limites de débit de chaque opération, consultez les Limites de débit des API.
Autorisation
Par défaut, seuls les comptes Alibaba Cloud peuvent appeler cette opération. Un utilisateur RAM (Resource Access Management) ne peut l'appeler qu'après avoir reçu les autorisations nécessaires. Le tableau ci-dessous décrit les autorisations à accorder à un utilisateur RAM pour appeler cette opération. Pour savoir comment accorder des autorisations, consultez les Stratégies et exemples.
|
API |
Action |
Resource in an instance that uses a namespace |
Resource in an instance that does not use a namespace |
|
OnsGroupDelete |
mq:QueryInstanceBaseInfo mq:DeleteGroup |
acs:mq:::{instanceId}%{groupId} |
acs:mq:::{groupId} |
Paramètres de requête
|
Parameter |
Type |
Required |
Example |
Description |
|
Action |
String |
Yes |
OnsGroupDelete |
Opération à effectuer. Définissez la valeur sur OnsGroupDelete. |
|
GroupId |
String |
Yes |
GID_test_groupId |
ID du groupe de consommateurs à supprimer. |
|
InstanceId |
String |
Yes |
MQ_INST_111111111111_DOxxxxxx |
ID de l'instance Message Queue for Apache RocketMQ contenant le groupe spécifié. |
Paramètres de réponse
|
Parameter |
Type |
Example |
Description |
|
RequestId |
String |
A07E3902-B92E-44A6-B6C5-6AA111111**** |
ID de la requête. Le système génère un ID unique pour chaque requête. Vous pouvez résoudre les problèmes en vous basant sur cet ID. |
Exemples
Exemple de requête
http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupDelete
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&<Common request parameters>Exemple de réponse réussie
Format XML
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsGroupDeleteResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupDeleteResponse>Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"
}Codes d'erreur
Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.
Supprimer un groupe dans la console
Vous pouvez également supprimer un groupe dans la console Message Queue for Apache RocketMQ. Pour plus d'informations, consultez Gérer les groupes.