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 autenticação de identidade federada/ Provedores de identidade/ Modificação de um provedor de identidade SAML

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Modificação de um provedor de identidade SAML

Função

Esta API é fornecida para que o administrador modifique um provedor de identidade SAML.

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

URI

PATCH /v3/OS-FEDERATION/identity_providers/{id}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	ID do provedor de identidade a ser atualizado.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 nesse campo.
X-Auth-Token	Sim	String	Token de acesso emitido para um usuário para suportar sua identidade e permissões. Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações.

**Tabela 3** Parâmetros no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
identity_provider	Sim	Object	Informações do provedor de identidade.

**Tabela 4** identity_provider
Parâmetro	Obrigatório	Tipo	Descrição
description	Não	String	Descrição do provedor de identidade.
enabled	Não	Boolean	Status de ativação do provedor de identidade. true indica que o provedor de identidade está ativado. false indica que o provedor de identidade está desativado. O valor padrão é false.

Parâmetros de resposta

**Tabela 5** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
identity_provider	Object	Informações do provedor de identidade.

**Tabela 6** identity_provider
Parâmetro	Tipo	Descrição
sso_type	string	Tipo de provedor de identidade.
id	String	ID do provedor de identidade.
description	String	Descrição do provedor de identidade.
enabled	Boolean	Status de ativação do provedor de identidade. true indica que o provedor de identidade está ativado. false indica que o provedor de identidade está desativado. O valor padrão é false.
remote_ids	Array of strings	Lista de IDs de usuários federados configurados para o provedor de identidade.
links	Object	Link de recurso do provedor de identidade.

**Tabela 7** identity_provider.links
Parâmetro	Tipo	Descrição
self	String	Link de recurso do provedor de identidade.
protocols	String	Link de recurso de protocolo.

Exemplo de solicitação

Solicitação para desativar o provedor de identidade SAML

PATCH https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/{id}

{
    "identity_provider": {
        "description": "Stores ACME identities.",
        "enabled": false
    }
}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "identity_provider": {
        "remote_ids": [],
        "enabled": false,
        "id": "ACME",
        "sso_type": "iam_user_sso",
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME",
            "protocols": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME/protocols"
        },
        "description": "Stores ACME identities."
    }
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
400	Parâmetros inválidos.
401	Falha na autenticação.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
405	O método especificado na solicitação não é permitido para o recurso solicitado.
409	Ocorre um conflito de recursos.
413	A entidade de solicitação é muito grande.
500	Erro de servidor interno.
503	Serviço indisponível.