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

Consulta a lista de configurações de acesso.

Descrição da operação

Este tópico fornece um exemplo de como consultar as configurações de acesso no diretório d-00fc2p61****. A resposta mostra que existem duas configurações de acesso: VPC-Admin e ECS-Admin.

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:ListAccessConfigurations

list

*AccessConfiguration

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DirectoryId	string	Sim	O ID do diretório.	d-00fc2p61****
NextToken	string	Não	O token para a próxima página de resultados. Você não precisa especificar `NextToken` na primeira chamada da API. Quando você chama esta operação de API pela primeira vez, se o número total de resultados exceder o limite de `MaxResults`, os resultados serão truncados e apenas as entradas correspondentes a `MaxResults` serão retornadas. Nesse caso, o parâmetro `IsTruncated` é definido como `true` e um `NextToken` é retornado. Você pode usar o `NextToken` retornado da chamada anterior para continuar chamando esta operação de API, mantendo os outros parâmetros da solicitação inalterados, a fim de consultar os resultados truncados. Você pode repetir esse processo até que `IsTruncated` seja `false`, o que indica que todos os dados foram recuperados.	K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****
MaxResults	integer	Não	O número máximo de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.	10
Filter	string	Não	A condição de filtro. Formato: . O filtro não diferencia maiúsculas de minúsculas. Atualmente, suporta apenas AccessConfigurationName, e suporta apenas eq (Equals) e sw (Start With). Exemplo: Filter = "AccessConfigurationName sw test" consulta todas as configurações de acesso cujos nomes começam com test. Filter = "AccessConfigurationName eq TestAccessConfiguration" consulta a configuração de acesso chamada TestAccessConfiguration.	AccessConfigurationName sw test
StatusNotifications	string	Não	As informações de notificação de status, usadas como condição de filtro para a consulta. Valores válidos: ReprovisionRequired, que consulta configurações de acesso que precisam ser reprovisionadas.	ReprovisionRequired
Tags	array<object>	Não	A lista de tags.
	object	Não
Key	string	Não	A chave da tag.	TestKey
Value	string	Não	O valor da tag.	TestValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
AccessConfigurations	array<object>	A lista de configurações de acesso.
	array<object>	A lista de configurações de acesso.
AccessConfigurationName	string	O nome da configuração de acesso.	ECS-Admin
SessionDuration	integer	A duração da sessão. A duração máxima de uma sessão quando um usuário do CloudSSO usa a configuração de acesso para acessar uma conta em um diretório de recursos. Unidade: segundos.	900
Description	string	A descrição da configuração de acesso.	Esta é uma configuração de acesso
RelayState	string	A página inicial de acesso. A URL da página inicial exibida quando um usuário do CloudSSO usa a configuração de acesso para acessar uma conta em um diretório de recursos.	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 a configuração de acesso foi modificada pela última vez.	2021-11-02T08:44:23Z
StatusNotifications	array	As informações de notificação de status.
	string	As informações de notificação de status. Valores válidos: Empty: Não existem informações de notificação de status. ReprovisionRequired: A configuração de acesso precisa ser reprovisionada.	ReprovisionRequired
AccessConfigurationId	string	O ID da configuração de acesso.	ac-00jhtfl8thteu6uj****
Tags	array<object>	A lista de tags.
	object
Key	string	A chave da tag.	TestKey
Value	string	O valor da tag.	TestValue
NextToken	string	O token para a próxima página de resultados. Nota Este parâmetro é retornado apenas quando `IsTruncated` é `true`.	K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****
RequestId	string	O ID da solicitação.	2BC0CBAC-45E1-5BD3-BF6E-F69D1D5391C2
MaxResults	integer	O número máximo de entradas por página.	10
TotalCounts	integer	O número total de entradas que correspondem aos parâmetros da solicitação.	2
IsTruncated	boolean	Indica se os resultados estão truncados. Valores válidos: true: Os resultados estão truncados. false: Os resultados não estão truncados.	false

Exemplos

Resposta de sucesso

JSON formato

{
  "AccessConfigurations": [
    {
      "AccessConfigurationName": "ECS-Admin",
      "SessionDuration": 900,
      "Description": "This is an access configuration.",
      "RelayState": "https://cloudsso.console.alibabacloud.com",
      "CreateTime": "2021-11-02T08:44:23Z",
      "UpdateTime": "2021-11-02T08:44:23Z",
      "StatusNotifications": [
        "ReprovisionRequired"
      ],
      "AccessConfigurationId": "ac-00jhtfl8thteu6uj****",
      "Tags": [
        {
          "Key": "TestKey",
          "Value": "TestValue"
        }
      ]
    }
  ],
  "NextToken": "K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****",
  "RequestId": "2BC0CBAC-45E1-5BD3-BF6E-F69D1D5391C2",
  "MaxResults": 10,
  "TotalCounts": 2,
  "IsTruncated": false
}

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.