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/ Listagem de mapeamentos

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

Ver PDF

Listagem de mapeamentos

Função

Essa API é usada para listar todos os mapeamentos.

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

GET /v3/OS-FEDERATION/mappings

Parâmetros de solicitação

**Tabela 1** 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	Consulte Ações.

Parâmetros de resposta

**Tabela 2** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
links	Linksobjeto	Informações sobre o link do recurso.
mappings	Array ofMappingResultobjects	Informações de mapeamento.

**Tabela 3** links
Parâmetro	Tipo	Descrição
self	String	Link de recursos.
previous	String	Link do recurso anterior.
next	String	Próximo link de recurso.

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

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

**Tabela 6** mappings.rules
Parâmetro	Tipo	Descrição
local	Array of RulesLocal objects	Informações do usuário federado 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 de usuário federadas no sistema 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	groups object	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** mappings.rules.remote
Parâmetro	Tipo	Descrição
type	String	Asserção de IdP (SAML) ou token de ID (OIDC)
any_one_of	Array of strings	A regra é correspondida somente se as strings especificadas aparecerem no tipo de atributo. O resultado da condição é booleano 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 simultaneamente.
not_any_of	Array of strings	A regra é correspondida somente se as cadeias de caracteres especificadas não aparecerem no tipo de atributo. O resultado da condição é booleano 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 simultaneamente.

Exemplo de solicitação

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

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "mappings": [
        {
            "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"
            }
        }
    ],
    "links": {
        "self": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/mappings",
        "previous": null,
        "next": null
    }
}

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.
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.