CreateGroupId - - Centre de documentation Alibaba Cloud

Remarque

Chaque appel réussi à l'opération CreateGroupId compte comme une transaction de message par seconde (TPS). De cette manière, vous êtes facturé pour l'appel. 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. L'outil 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	CreateGroupId	Opération à effectuer. Définissez la valeur sur CreateGroupId.
GroupId	String	Oui	GID_test	ID de groupe à créer. La valeur doit respecter les exigences suivantes : La valeur doit commencer par GID_ ou GID- et peut contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_). Elle doit compter entre 7 et 64 caractères. Un ID de groupe est immuable après sa création. Pour plus d'informations, consultez la rubrique Termes.
InstanceId	String	Oui	mqtt-cn-0pp1ldu****	ID de l'instance ApsaraMQ for MQTT à laquelle appartient l'ID de groupe.
RegionId	String	Oui	cn-hangzhou	ID de la région de l'instance ApsaraMQ for MQTT à laquelle appartient l'ID 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
RequestId	String	2C7D722D-0F3D-4415-A9CD-A464D82C****	ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

<CreateGroupIdResponse>
  <RequestId>2C7D722D-0F3D-4415-A9CD-A464D82C****</RequestId>
</CreateGroupIdResponse>

Format JSON

{
  "RequestId": "2C7D722D-0F3D-4415-A9CD-A464D82C****"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
500	CreateGroupIdError	Failed to create GroupId. Try again later.	Échec de la création de l'ID de groupe. Veuillez réessayer.
400	GroupIdAlreadyExsited	The specified GroupId already exists.	L'ID de groupe spécifié existe déjà.
400	GroupIdAlreadyUsedByOtherUsers	The current GroupId is used by another user. Please change to a different GroupId.	L'ID de groupe est utilisé par un autre utilisateur. Veuillez utiliser un autre ID de groupe.
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	ParameterFieldCheckFailed	Failed to validate the parameters. The parameters may be missing or invalid.	Échec de la validation des paramètres. Un paramètre est peut-être manquant ou invalide.
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'ID de groupe.

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