Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Gerenciamento de chaves de acesso/ Modificação de uma chave de acesso permanente

Atualizado em 2023-02-16 GMT+08:00

Ver PDF

Modificação de uma chave de acesso permanente

Função

Essa API pode ser usada pelo administrador para modificar a chave de acesso permanente especificada de um usuário do IAM ou usada por um usuário do IAM para modificar uma de suas próprias chaves de acesso permanente.

A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.

URI

PUT /v3.0/OS-CREDENTIAL/credentials/{access_key}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatoriedade	Tipo	Descrição
access_key	Sim	String	AK da chave de acesso a ser modificada.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatoriedade	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 neste campo.
X-Auth-Token	Sim	String	Se o administrador estiver solicitando a modificação de uma chave de acesso permanente especificada de um usuário do IAM, consulte Ações. Se um usuário do IAM estiver solicitando a modificação de uma de suas próprias chaves de acesso permanente, será necessário o token do usuário (sem requisitos de permissão especiais).

**Tabela 3** Parâmetros no corpo da solicitação
Parâmetro	Obrigatoriedade	Tipo	Descrição
credential	Sim	Object	Informações da autenticação.

**Tabela 4** credential
Parâmetro	Obrigatoriedade	Tipo	Descrição
status	Não	String	Status da chave de acesso a ser alterada. Opções: active: habilitado inactive: desabilitado
description	Não	String	Descrição da chave de acesso.

Parâmetros de resposta

**Tabela 5** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
credential	Object	Informações da autenticação.

**Tabela 6** credential
Parâmetro	Tipo	Descrição
user_id	String	ID do usuário do IAM.
access	String	AK.
status	String	Status da chave de acesso.
create_time	String	Hora em que a chave de acesso foi criada.
description	String	Descrição da chave de acesso.

Exemplo de solicitação

PUT https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials/{access_key}

{
    "credential": {
        "status": "inactive",
        "description": "IAMDescription"
    }
}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "credential": {
        "status": "inactive",
        "access": "LOSZM4YRVLKOY9...",
        "create_time": "2020-01-08T06:26:08.123059Z",
        "user_id": "07609fb9358010e21f7bc00375..."
    }
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
400	Parâmetros inválidos.
401	Autenticação falhou.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
500	Erro de servidor interno.