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

Observações de uso

Após chamar a operação LockUsers para bloquear um ou mais usuários de um bastion host, utilize esta operação para desbloqueá-los. Depois do desbloqueio, os usuários poderão executar operações de O&M por meio do bastion host.

Limite de QPS

Esta operação permite até 10 chamadas por segundo por conta. Se o número de chamadas por segundo exceder esse limite, o throttling será acionado, o que pode afetar seus negócios. Recomendamos observar esse limite ao chamar esta operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UnlockUsers	A operação que você deseja executar. Defina o valor como UnlockUsers.
InstanceId	String	Sim	bastionhost-cn-st220aw****	O ID do bastion host ao qual pertencem os usuários a serem desbloqueados. Nota Chame a operação DescribeInstances para consultar o ID do bastion host.
UserIds	String	Sim	["1","2"]	Os IDs dos usuários que você deseja desbloquear. O valor é uma string JSON. É possível adicionar até 100 IDs de usuário. Caso especifique vários IDs, separe-os com vírgulas (,). Nota Chame a operação ListUsers para consultar os IDs dos usuários.
RegionId	String	Não	cn-hangzhou	O ID da região do bastion host ao qual pertencem os usuários a serem desbloqueados. Nota Para obter mais informações sobre o mapeamento entre IDs e nomes de regiões, consulte Regiões e zonas.

Todas as operações de API da Alibaba Cloud devem incluir parâmetros de solicitação comuns. Para obter mais informações sobre esses parâmetros, consulte Parâmetros comuns.

Para obter mais informações sobre exemplos de solicitações, consulte a seção "Exemplos" deste tópico.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Results	Array of Item		O resultado da chamada.
Code	String	OK	O código de retorno que indica se a chamada foi bem-sucedida. Valores válidos: OK: A chamada foi bem-sucedida. UNEXPECTED: Ocorreu um erro desconhecido. INVALID_ARGUMENT: Um parâmetro da solicitação é inválido. Nota Verifique se os parâmetros da solicitação são válidos e chame a operação novamente. OBJECT_NOT_FOUND: O objeto especificado no qual você deseja executar a operação não existe. Nota Verifique se o ID especificado do bastion host existe, se os hosts especificados existem e se os IDs dos hosts especificados são válidos. Em seguida, chame a operação novamente. OBJECT_AlREADY_EXISTS: O objeto especificado no qual você deseja executar a operação já existe.
Message	String	None	Este parâmetro está obsoleto.
UserId	String	1	O ID do usuário.
RequestId	String	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE	O ID da solicitação, usado para localizar e solucionar problemas.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=UnlockUsers
&InstanceId=bastionhost-cn-st220aw****
&UserIds=["1","2"]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<UnlockUsersResponse>
      <RequestId>EC9BF0F4-8983-491A-BC8C-1B4DD94976DE</RequestId>
      <Results>
            <Message></Message>
            <UserId>1</UserId>
            <Code>OK</Code>
      </Results>
</UnlockUsersResponse>

Formato JSON

{
	"RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
	"Results": [{
		"Message": "",
		"UserId": "1",
		"Code": "OK"
	}]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	InternalError	An unknown error occurred.	A mensagem de erro retornada porque ocorreu um erro desconhecido.
400	InvalidParameter	The argument is invalid.	A mensagem de erro retornada porque um ou mais parâmetros são inválidos.

Para obter uma lista de códigos de erro, visite o API Error Center.