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/ Mapeamentos/ Consulta de detalhes de mapeamento

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

Ver PDF

Consulta de detalhes de mapeamento

Função

Essa API é usada para consultar os detalhes de um mapeamento.

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

GET /v3/OS-FEDERATION/mappings/{id}

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

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.

Parâmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
mapping	Object	Informações de mapeamento.

**Tabela 4** mapping
Parâmetro	Tipo	Descrição
id	String	ID de mapeamento.
links	Object	Informações sobre link de recurso de mapeamento.
rules	Array of objects	Regra usada para mapear usuários federados para usuários locais.

**Tabela 5** mapping.links
Parâmetro	Tipo	Descrição
self	String	Link de recurso.

**Tabela 6** mappings.rules
Parâmetro	Tipo	Descrição
local	Array of RulesLocal objects	Informações de usuários federados na plataforma de nuvem. user indica o nome de um usuário federado na plataforma de nuvem. group indica o grupo ao qual um usuário federado pertence na plataforma de nuvem.
remote	Array<Object>	Informações do usuário federado no sistema de IdP. Esse campo é uma expressão que consiste em atributos e operadores de asserção. O valor deste campo é determinado pela asserção.

**Tabela 7** mappings.rules.local
Parâmetro	Tipo	Descrição
user	user object	Nome de um usuário federado na plataforma de nuvem.
group	group object	Grupo de usuários ao qual um usuário federado pertence na plataforma de nuvem.
groups	String	Grupos de usuários aos quais um usuário federado pertence na plataforma de nuvem.

**Tabela 8** mappings.rules.local.user
Parâmetro	Tipo	Descrição
name	string	Nome de um usuário federado na plataforma de nuvem.

**Tabela 9** mappings.rules.local.group
Parâmetro	Tipo	Descrição
name	string	Grupo de usuários ao qual um usuário federado pertence na plataforma de nuvem.

**Tabela 10** mappings.rules.local.groups
Parâmetro	Tipo	Descrição
name	string	Grupos de usuários aos quais um usuário federado pertence na plataforma de nuvem.

**Tabela 11** mapping.rules.remote
Parâmetro	Tipo	Descrição
type	String	Asserção IdP (SAML) ou token de ID (OIDC)
any_one_of	Array of strings	A regra será correspondida somente se as cadeias especificadas aparecerem no tipo de atributo. O resultado da condição é Boolean em vez do argumento que é passado como entrada. Em uma matriz remote, any_one_of e not_any_of são mutuamente exclusivos e não podem ser definidos ao mesmo tempo.
not_any_of	Array of strings	A regra será correspondida somente se as cadeias especificadas não aparecerem no tipo de atributo. O resultado da condição é Boolean em vez do argumento que é passado como entrada. any_one_of e not_any_of são mutuamente exclusivos e não podem ser definidos ao mesmo tempo.

Exemplo de solicitação

Solicitação para consultar detalhes do mapeamento

GET https://iam.myhuaweicloud.com/v3/OS-FEDERATION/mappings/{id}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "mapping": {
        "rules": [
            {
                "local": [
                    {
                        "user": {
                            "name": "LocalUser"
                        }
                    },
                    {
                        "group": {
                            "name": "LocalGroup"
                        }
                    }
                ],
                "remote": [
                    {
                        "type": "UserName"
                    },
                    {
                        "type": "orgPersonType",
                        "not_any_of": [
                            "Contractor",
                            "Guest"
                        ]
                    }
                ]
            }
        ],
        "id": "ACME",
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/mappings/ACME"
        }
    }
}

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.
413	A entidade de solicitação é muito grande.
500	Erro de servidor interno.
503	Serviço indisponível.