CreateGroupId - : Central de Documentação do Alibaba Cloud

Nota

Cada chamada bem-sucedida à operação

CreateGroupId

é contabilizada como uma transação de mensagem por segundo (TPS). Portanto, essa chamada é faturada. Para mais informações, consulte

Faturamento

.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateGroupId	A operação a ser executada. Defina o valor como CreateGroupId.
GroupId	String	Sim	GID_test	O group ID a ser criado. O valor deve atender aos seguintes requisitos: Deve começar com GID_ ou GID- e pode conter letras, dígitos, hifens (-) e sublinhados (_). O comprimento deve ser de 7 a 64 caracteres. Não é possível modificar um group ID após a criação. Para mais informações, consulte Termos.
InstanceId	String	Sim	mqtt-cn-0pp1ldu****	O ID da instância do ApsaraMQ for MQTT à qual o group ID pertence.
RegionId	String	Sim	cn-hangzhou	O ID da região da instância do ApsaraMQ for MQTT à qual o group ID pertence.

Nota

Para mais informações sobre esses parâmetros, consulte

Parâmetros comuns

e

Endpoints

.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	2C7D722D-0F3D-4415-A9CD-A464D82C****	O ID da solicitação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

Formato JSON

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	CreateGroupIdError	Failed to create GroupId. Try again later.	Mensagem retornada porque a solicitação para criar o group ID falhou. Tente novamente.
400	GroupIdAlreadyExsited	The specified GroupId already exists.	Mensagem retornada porque o group ID já existe.
400	GroupIdAlreadyUsedByOtherUsers	The current GroupId is used by another user. Please change to a different GroupId.	Mensagem retornada porque outro usuário está utilizando o group ID. Utilize um group ID diferente.
500	InternalError	An error occurred while processing your request. Try again later.	Mensagem retornada devido a um erro interno na instância do ApsaraMQ for MQTT. Tente novamente.
400	ParameterFieldCheckFailed	Failed to validate the parameters. The parameters may be missing or invalid.	Mensagem retornada porque a validação dos parâmetros falhou. O parâmetro pode estar ausente ou inválido.
400	InstancePermissionCheckFailed	An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.	Mensagem retornada porque a validação de permissões da instância falhou. Verifique a propriedade e a política de autorização da instância do ApsaraMQ for MQTT.
400	InstanceNotFound	Failed to find the instance. The instanceId may be invalid.	Mensagem retornada porque a instância especificada não foi encontrada.
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.	Mensagem retornada porque a validação de permissões do recurso falhou. Verifique as permissões e políticas de autorização da instância, do tópico e do group ID.

Para obter uma lista de códigos de erro, visite a Central de Erros da API.