Atualização de um mapeamento
Função
Esta API é fornecida para que o administrador atualize um mapeamento.
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
PATCH /v3/OS-FEDERATION/mappings/{id}
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
id |
Sim |
String |
ID do mapeamento a ser atualizado. |
Parâmetros de 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âmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
Object |
Informações de mapeamento. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
Array of objects |
Regra usada para mapear usuários federados para usuários locais. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
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. |
|
Sim |
Array of objects |
Informações de usuário federadas no sistema IdP. Se SAML for usado, esse campo é uma expressão que consiste em atributos e operadores de asserção, e o valor desse campo é determinado pela asserção. Se o protocolo OIDC for usado, o valor desse campo será determinado pelo token de ID. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Não |
user object |
Nome de um usuário federado na plataforma de nuvem. |
|
Não |
group object |
Grupo de usuários ao qual um usuário federado pertence na plataforma de nuvem. |
|
Não |
groups object |
Grupos de usuários aos quais um usuário federado pertence na plataforma de nuvem. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
name |
Sim |
string |
Nome de um usuário federado na plataforma de nuvem. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
name |
Sim |
string |
Grupo de usuários ao qual um usuário federado pertence na plataforma de nuvem. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
name |
Sim |
string |
Grupos de usuários aos quais um usuário federado pertence na plataforma de nuvem. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
type |
Sim |
String |
Asserção de IdP. |
any_one_of |
Não |
Array of strings |
A regra é correspondida somente se as cadeias 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 |
Não |
Array of strings |
A regra é correspondida somente se as cadeias 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. |
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
Object |
Informações de mapeamento. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
id |
String |
Mapeamento de ID. |
Object |
Mapeamento de informações de link de recurso. |
|
Array of objects |
Regra usada para mapear usuários federados para usuários locais. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
Array<Map<String,Object>> |
Informações de usuários federados na plataforma de nuvem. user indica o nome de um usuário federado e group indica o grupo ao qual o usuário federado pertence. |
|
Array<Object> |
Informações de usuário federadas no sistema IdP. Se SAML for usado, esse campo é uma expressão que consiste em atributos e operadores de asserção, e o valor desse campo é determinado pela asserção. Se o protocolo OIDC for usado, o valor desse campo será determinado pelo token de ID. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
user object |
Nome de um usuário federado na plataforma de nuvem. |
|
group object |
Grupo de usuários ao qual um usuário federado pertence na plataforma de nuvem. |
|
groups object |
Grupos de usuários aos quais um usuário federado pertence na plataforma de nuvem. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
name |
string |
Nome de um usuário federado na plataforma de nuvem. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
name |
string |
Grupo de usuários ao qual um usuário federado pertence na plataforma de nuvem. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
name |
string |
Grupos de usuários aos quais um usuário federado pertence na plataforma de nuvem. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
type |
String |
Afirmação de IdP (SAML) ou token de ID (OIDC) |
any_one_of |
Array of strings |
A regra é correspondida somente se as cadeias 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 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
PATCH https://iam.myhuaweicloud.com/v3/OS-FEDERATION/mappings/{id}
{ "mapping": { "rules": [ { "local": [ { "user": { "name": "LocalUser" } }, { "group": { "name": "LocalGroup" } } ], "remote": [ { "type": "UserName" }, { "type": "orgPersonType", "not_any_of": [ "Contractor", "Guest" ] } ] } ] } }
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 |
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. |
409 |
Ocorre um conflito de recursos. |
413 |
A entidade de solicitação é muito grande. |
500 |
Erro de servidor interno. |
503 |
Serviço indisponível. |
Códigos de erro
Nenhum