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.
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
.
Depuração
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. |
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.