UpdateAccessConfiguration - CloudSSO: Central de Documentação do Alibaba Cloud

Modifica informações sobre uma configuração de acesso.

Descrição da operação

Você pode modificar os parâmetros Description, SessionDuration e RelayState de uma configuração de acesso.

Este tópico fornece um exemplo de como alterar a página web inicial na configuração de acesso ac-00jhtfl8thteu6uj**** para https://cloudsso.console.alibabacloud.com.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cloudsso:UpdateAccessConfiguration

update

*AccessConfiguration

acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DirectoryId	string	Sim	O ID do diretório.	d-00fc2p61****
AccessConfigurationId	string	Sim	O ID da configuração de acesso.	ac-00jhtfl8thteu6uj****
NewDescription	string	Não	A nova descrição da configuração de acesso. A descrição pode ter no máximo 1.024 caracteres.	This is an access configuration.
NewSessionDuration	integer	Não	A nova duração de uma sessão na qual um usuário do CloudSSO acessa uma conta no seu diretório de recursos usando a configuração de acesso. Unidade: segundos. Valores válidos: 900 a 43200. O valor 900 indica 15 minutos. O valor 43200 indica 12 horas.	3600
NewRelayState	string	Não	A nova página web inicial que é exibida após um usuário do CloudSSO acessar uma conta no seu diretório de recursos usando a configuração de acesso. A página web deve ser uma página do Console de Gerenciamento da Alibaba Cloud.	https://cloudsso.console.alibabacloud.com

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	9B13E4EE-3853-5852-9165-597C32AD8FB7
AccessConfiguration	object	As informações sobre a configuração de acesso.
AccessConfigurationName	string	O nome da configuração de acesso.	ECS-Admin
SessionDuration	integer	A duração de uma sessão na qual um usuário do CloudSSO acessa uma conta no seu diretório de recursos usando a configuração de acesso. Unidade: segundos.	3600
Description	string	A descrição da configuração de acesso.	This is an access configuration.
RelayState	string	A página web inicial que é exibida após um usuário do CloudSSO acessar uma conta no seu diretório de recursos usando a configuração de acesso.	https://cloudsso.console.alibabacloud.com
CreateTime	string	A hora em que a configuração de acesso foi criada.	2021-11-02T08:44:23Z
UpdateTime	string	A hora em que as informações sobre a configuração de acesso foram modificadas.	2021-11-02T10:10:01Z
StatusNotifications	array	As notificações de status.
	string	A notificação de status. Valores válidos: Empty: Nenhuma notificação de status é enviada. ReprovisionRequired: A configuração de acesso precisa ser reprovisionada.	ReprovisionRequired
AccessConfigurationId	string	O ID da configuração de acesso.	ac-00jhtfl8thteu6uj****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "9B13E4EE-3853-5852-9165-597C32AD8FB7",
  "AccessConfiguration": {
    "AccessConfigurationName": "ECS-Admin",
    "SessionDuration": 3600,
    "Description": "This is an access configuration.",
    "RelayState": "https://cloudsso.console.alibabacloud.com",
    "CreateTime": "2021-11-02T08:44:23Z",
    "UpdateTime": "2021-11-02T10:10:01Z",
    "StatusNotifications": [
      "ReprovisionRequired"
    ],
    "AccessConfigurationId": "ac-00jhtfl8thteu6uj****"
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.