Todos os produtos
Search
Central de documentação

:RevokeToken

Última atualização: Jul 09, 2026

Revoga um token.

Cenários de uso

O servidor de aplicações chama esta operação para encerrar antecipadamente uma autorização baseada em token existente. Para mais informações, consulte Visão geral da autenticação baseada em token.

Limites

Cada usuário pode enviar até 5 solicitações por segundo. Para aumentar esse limite, entre no grupo 35228338 do DingTalk e contate o suporte técnico do ApsaraMQ forMQTT.

Nota

Cada chamada bem-sucedida à operação

RevokeToken

conta como uma transação de mensagem por segundo (TPS), o que gera cobrança. Para mais informações, consulte

Faturamento

.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para chamar esta operação, pois ele gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

RevokeToken

Operação a ser executada. Defina o valor como RevokeToken.

Token

String

Sim

LzMT+XLFl5s/YWJ/MlDz4t/Lq5HC1iGU1P28HAMaxYxn8aQbALNtml7QZKl9L9kPe6LqUb95tEVo+zUqOogs9+jZwDUSzsd4X4qaD3n2TrBEuMOqKkk1Xdrvu9VBQQvIYbz7MJWZDYC3DlW7gLEr33Cuj54iIhagtBi3epStJitsssWs7otY9zhKOSZxhr49G3d0bh35mwyP18EMvDas8UlzeSozsSrujNUqZXOGK0PEBSd+rWMGDJlCt6GFmJgm2JFY7PJwf/7OOSmUYIYFs5o/PuPpoTMF+hcVXMs+0yDukIMTOzG9m3t8k36PVrghFmnK6pC3Rt3mibjW****ng==

Token a ser revogado.

InstanceId

String

Sim

post-cn-0pp12gl****

ID da instância do ApsaraMQ forMQTT. O valor deve corresponder ao ID da instância usado pelo cliente do ApsaraMQ forMQTT. Obtenha esse ID na página Instance Details do console do ApsaraMQ forMQTT.

Nota

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

Parâmetros comuns

e

Endpoints

.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

833EDFCB-C447-4CE3-B21F-3A4C2D1B****

ID da solicitação. Este é um parâmetro comum. Cada solicitação possui um ID exclusivo.

Exemplos

Exemplos de solicitações

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/?Action=RevokeToken
&InstanceId=post-cn-0pp12gl****
&RegionId=cn-hangzhou
&Token=LzMT+XLFl5s/YWJ/MlDz4t/Lq5HC1iGU1P28HAMaxYxn8aQbALNtml7QZKl9L9kPe6LqUb95tEVo+zUqOogs9+jZwDUSzsd4X4qaD3n2TrBEuMOqKkk1Xdrvu9VBQQvIYbz7MJWZDYC3DlW7gLEr33Cuj54iIhagtBi3epStJitsssWs7otY9zhKOSZxhr49G3d0bh35mwyP18EMvDas8UlzeSozsSrujNUqZXOGK0PEBSd+rWMGDJlCt6GFmJgm2JFY7PJwf/7OOSmUYIYFs5o/PuPpoTMF+hcVXMs+0yDukIMTOzG9m3t8k36PVrghFmnK6pC3Rt3mibjW****ng==
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<RevokeTokenResponse>
<RequestId>833EDFCB-C447-4CE3-B21F-3A4C2D1B****</RequestId>
</RevokeTokenResponse>

Formato JSON

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

{
  "RequestId" : "833EDFCB-C447-4CE3-B21F-3A4C2D1B****"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

CheckAccountInfoFailed

An error occurred while checking the account information by the STS token.

Falha ao analisar as informações da conta do token do Security Token Service (STS).

400

InstancePermissionCheckFailed

An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.

Falha na verificação de permissões da instância. Verifique a propriedade e a política de autorização da instância do ApsaraMQ forMQTT.

400

ParameterCheckFailed

An error occurred while validating the parameters. The parameters may be missing or invalid.

Falha na validação do parâmetro. O parâmetro pode estar ausente ou inválido.

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.

Falha na verificação de permissões do recurso. Verifique as permissões e as políticas de autorização da instância, do tópico e do ID do grupo.

400

RevokeTokenOverFlow

You have revoked tokens too many times. Please try again later.

Revogação de tokens muito frequente. O sistema acionou o limitador de taxa. Tente novamente mais tarde.

400

InvalidParameter.%s

An error occurred while validating the parameter. The parameter may be missing or invalid.

Falha na validação do parâmetro. O parâmetro pode estar ausente ou inválido.

500

InternalError

An error occurred while processing your request. Try again later.

Ocorreu um erro no serviço de back-end da instância do ApsaraMQ forMQTT. Tente novamente.

500

SystemOverFlow

An error occurred while processing your request. Please try again.

O limitador de taxa foi acionado. Tente novamente.

404

ApiNotSupport

The specified API is not supported.

A operação de API especificada não é compatível.

Para obter uma lista completa dos códigos de erro, consulte Códigos de erro do serviço.