ListGroupId - - Centre de documentation Alibaba Cloud

Remarque

Chaque appel réussi à l'opération

ListGroupId

est comptabilisé comme une transaction par seconde (TPS) et est donc facturé. Pour plus d'informations, consultez la rubrique

Facturation

.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

ListGroupId

L'opération à effectuer. Définissez la valeur sur ListGroupId.

InstanceId

String

Oui

mqtt-cn-0pp1ldu****

ID de l'instance ApsaraMQ for MQTT dont vous souhaitez lister les identifiants de groupe.

Remarque

Pour plus d'informations sur ces paramètres, consultez les rubriques

Paramètres communs

et

Endpoints

.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Data	Array of MqttGroupIdDo		Détails relatifs à l'identifiant de groupe interrogé.
CreateTime	Long	1564577317000	Date de création de l'identifiant de groupe.
GroupId	String	GID_test1	Identifiant de groupe associé à l'instance ApsaraMQ for MQTT.
IndependentNaming	Boolean	true	Indique si un namespace distinct est configuré pour l'instance ApsaraMQ for MQTT. Valeurs possibles : true : Un namespace distinct est configuré pour l'instance ApsaraMQ for MQTT. Les noms de ressources doivent être uniques au sein de l'instance, mais peuvent être identiques d'une instance à l'autre. false : Aucun namespace distinct n'est configuré pour l'instance ApsaraMQ for MQTT. Les noms de ressources doivent être globalement uniques, au sein de l'instance comme d'une instance à l'autre.
InstanceId	String	post-cn-45910tj****	ID de l'instance ApsaraMQ for MQTT à laquelle appartient l'identifiant de groupe.
UpdateTime	Long	1564577317000	Dernière date de mise à jour de l'identifiant de groupe.
RequestId	String	95996EEB-D894-44FA-A87C-940F5CD9****	ID de la requête.

Exemples

Exemple de requête

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/? Action=ListGroupId
&InstanceId=mqtt-cn-0pp1ldu****
&<Common request parameters>

Exemple de réponse en cas de succès

XML format

<ListGroupIdResponse>
  <RequestId>95996EEB-D894-44FA-A87C-940F5CD9****</RequestId>
  <Data>
        <InstanceId>post-cn-45910tj****</InstanceId>
        <CreateTime>1564577317000</CreateTime>
        <UpdateTime>1564577317000</UpdateTime>
        <IndependentNaming>true</IndependentNaming>
        <GroupId>GID_test2</GroupId>
  </Data>
  <Data>
        <InstanceId>post-cn-45910tj****</InstanceId>
        <CreateTime>1563200655000</CreateTime>
        <UpdateTime>1563200655000</UpdateTime>
        <IndependentNaming>true</IndependentNaming>
        <GroupId>GID_test1</GroupId>
  </Data>
</ListGroupIdResponse>

JSON format

{
  "RequestId": "95996EEB-D894-44FA-A87C-940F5CD9****",
  "Data": [
    {
      "InstanceId": "post-cn-45910tj****",
      "CreateTime": 1564577317000,
      "UpdateTime": 1564577317000,
      "IndependentNaming": true,
      "GroupId": "GID_test2"
    },
    {
      "InstanceId": "post-cn-45910tj****",
      "CreateTime": 1563200655000,
      "UpdateTime": 1563200655000,
      "IndependentNaming": true,
      "GroupId": "GID_test1"
    }
  ]
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	ParameterFieldCheckFailed	Failed to validate the parameters. The parameters may be missing or invalid.	Échec de la validation des paramètres. Ceux-ci sont peut-être manquants ou non valides.
500	InternalError	An error occurred while processing your request. Try again later.	Une erreur interne s'est produite sur l'instance ApsaraMQ for MQTT. Veuillez réessayer.
400	InstancePermissionCheckFailed	An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.	Échec de la vérification des autorisations de l'instance. Vérifiez la propriété et la politique d'autorisation de l'instance ApsaraMQ for MQTT.
400	InstanceNotFound	Failed to find the instance. The instanceId may be invalid.	L'instance spécifiée est introuvable.
400	PermissionCheckFailed	An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.	Échec de la vérification des autorisations des ressources. Vérifiez les autorisations et les politiques d'autorisation de l'instance, du topic et de l'identifiant de groupe.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.