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

Notas de uso

Use esta operação para bloquear um ou mais usuários de um bastion host. Se um usuário não precisar acessar o bastion host para operações de O&M durante um período específico, bloqueie-o. Após o bloqueio, o usuário não poderá fazer login nem executar operações de O&M nos hosts aos quais tinha permissão de acesso. Para desbloquear o usuário posteriormente, chame a operação UnlockUsers.

Limite de QPS

O limite desta operação é de 10 chamadas por segundo por conta. Se a frequência de chamadas ultrapassar esse limite, o sistema ativará o throttling, o que pode afetar seus serviços. Considere essa restrição ao chamar esta API.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos chamar esta operação diretamente no OpenAPI Explorer. A ferramenta também gera dinamicamente exemplos de código da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	LockUsers	A operação a ser executada. Defina o valor como LockUsers.
InstanceId	String	Yes	bastionhost-cn-st220aw****	ID do bastion host ao qual os usuários a serem bloqueados pertencem. Nota Chame a operação DescribeInstances para consultar o ID do bastion host.
UserIds	String	Yes	["1","2","3"]	IDs dos usuários a serem bloqueados. O valor deve ser uma string JSON. É possível adicionar até 100 IDs de usuário. Separe vários IDs com vírgulas (,). Nota Chame a operação ListUsers para consultar os IDs dos usuários.
RegionId	String	No	cn-hangzhou	ID da região do bastion host ao qual os usuários a serem bloqueados pertencem. 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 exigem parâmetros de solicitação comuns. Para mais detalhes sobre esses parâmetros, consulte Parâmetros comuns.

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

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE	ID da solicitação, usado para localizar e solucionar problemas.
Results	Array of Item		Resultado da chamada.
Code	String	OK	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 tente chamar a operação novamente. OBJECT_NOT_FOUND: O objeto especificado para a operação não existe. Nota Confirme se o ID do bastion host especificado existe, se os hosts indicados existem e se os IDs desses hosts são válidos. Em seguida, chame a operação novamente. OBJECT_AlREADY_EXISTS: O objeto especificado para a operação já existe.
Message	String	None	Este parâmetro está obsoleto.
UserId	String	1	ID do usuário.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

Formato JSON

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

Códigos de erro

HTTP status code	Error code	Error message	Description
500	InternalError	An unknown error occurred.	Erro desconhecido ocorrido.
400	InvalidParameter	The argument is invalid.	Um ou mais parâmetros são inválidos.

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