Todos os produtos
Search
Central de documentação

CloudSSO:ListAccessConfigurationProvisionings

Última atualização: Oct 20, 2026

Consulta os provisionamentos de configurações de acesso.

Descrição da operação

Este tópico fornece um exemplo de consulta da lista de implantações da configuração de acesso ac-00ccule7tadaijxc****. A resposta mostra que a configuração de acesso está implantada em duas contas, cada uma sendo uma conta em um diretório de recursos.

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

list

Configuração de acesso.

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

Configuração de acesso.

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

Nenhuma 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

Não

O ID da configuração de acesso usado como condição de filtro para a consulta.

ac-00ccule7tadaijxc****

TargetType

string

Não

O tipo de destino usado como condição de filtro para a consulta.

Valores válidos:

  • RD-Account: O destino é uma conta em um diretório de recursos.

Nota

Você deve especificar TargetId e TargetType para que eles tenham efeito como condições de filtro.

RD-Account

TargetId

string

Não

O ID do destino usado como condição de filtro para a consulta.

Nota

Você deve especificar TargetId e TargetType para que eles tenham efeito como condições de filtro.

114240524784****

ProvisioningStatus

string

Não

O status de provisionamento usado como condição de filtro para a consulta. Valores válidos:

  • Provisioned: O provisionamento foi bem-sucedido.

  • ReprovisionRequired: O reprovisionamento é necessário.

  • DeprovisionFailed: O provisionamento falhou.

Provisioned

NextToken

string

Não

O token usado para retornar a próxima página de resultados da consulta. Você não precisa especificar NextToken ao chamar esta operação pela primeira vez.

Ao chamar esta operação pela primeira vez, se o número total de entradas retornadas exceder o valor de MaxResults, os resultados retornados serão truncados. Apenas o número de entradas especificado por MaxResults é retornado, o parâmetro IsTruncated é definido como true e um NextToken é retornado. Você pode usar o NextToken retornado para chamar esta operação novamente e consultar as entradas truncadas, mantendo os outros parâmetros da solicitação inalterados. Você pode repetir esse processo até que IsTruncated seja definido como false, o que indica que todas as entradas foram retornadas.

K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****

MaxResults

integer

Não

O número máximo de entradas a serem retornadas em cada página.

Valores válidos: 1 a 20.

Valor padrão: 10.

10

OriginTargetId

string

Não

O ID da conta Alibaba Cloud do destino de provisionamento.

114240524784****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

NextToken

string

O token usado para retornar a próxima página de resultados da consulta.

Nota

Este parâmetro é retornado apenas quando IsTruncated é definido como true.

K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****

RequestId

string

O ID da solicitação.

6BA1BDF1-D845-5D2C-B742-74BE2970E4C1

AccessConfigurationProvisionings

array<object>

A lista de provisionamentos de configurações de acesso.

object

A lista de provisionamentos de configurações de acesso.

Status

string

O status de provisionamento. Valores válidos:

  • Provisioned: O provisionamento foi bem-sucedido.

  • ReprovisionRequired: O reprovisionamento é necessário.

  • DeprovisionFailed: O provisionamento falhou.

Provisioned

SAMLProviderName

string

O nome do IdP SAML criado na conta em um diretório de recursos.

AliyunReservedSSO-d-00fc2p61****

TargetPath

string

O ID do caminho do destino no diretório de recursos.

rd-3G****/r-Wm****/fd-pjM8oy****/101522521960****

CreateTime

string

A hora em que o primeiro provisionamento foi bem-sucedido. A hora é exibida em UTC e segue o padrão RFC 3339 no formato AAAA-MM-DDTHH:mm:ssZ.

2021-07-26T08:54:14Z

TargetName

string

O nome do destino.

SharedServices_5009****

TargetId

string

O ID do destino.

Se o tipo de destino for RD-Account, este parâmetro indica o UID da conta em um diretório de recursos.

101522521960****

RAMRoleName

string

O nome da função RAM criada na conta em um diretório de recursos.

AliyunReservedSSO-VPC-Admin

AccessConfigurationName

string

O nome da configuração de acesso.

VPC-Admin

TargetPathName

string

O nome do caminho do destino no diretório de recursos.

rd-3G****/root/Core/SharedServices_5009****

TargetType

string

O tipo de destino.

Valores válidos:

  • RD-Account: O destino é uma conta em um diretório de recursos.

RD-Account

UpdateTime

string

A hora em que o provisionamento mais recente foi bem-sucedido. A hora é exibida em UTC e segue o padrão RFC 3339 no formato AAAA-MM-DDTHH:mm:ssZ.

2021-07-26T08:54:18Z

RAMPolicyNames

array

O nome da política personalizada criada na conta em um diretório de recursos.

string

O nome da política personalizada criada na conta em um diretório de recursos.

Nota

Este parâmetro é retornado apenas quando a configuração de acesso possui uma política integrada.

AliyunReservedSSO-VPC-Admin-InlinePolicy

AccessConfigurationId

string

O ID da configuração de acesso.

ac-00ccule7tadaijxc****

OriginTargetId

string

O ID da conta Alibaba Cloud do destino de provisionamento.

114240524784****

MaxResults

integer

O número máximo de entradas retornadas em cada página.

10

IsTruncated

boolean

Indica se os resultados retornados são truncados. Valores válidos:

  • true: Os resultados são truncados.

  • false: Os resultados não são truncados.

false

TotalCounts

integer

O número total de entradas que atendem às condições de filtro especificadas nos parâmetros da solicitação.

2

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****",
  "RequestId": "6BA1BDF1-D845-5D2C-B742-74BE2970E4C1",
  "AccessConfigurationProvisionings": [
    {
      "Status": "Provisioned",
      "SAMLProviderName": "AliyunReservedSSO-d-00fc2p61****",
      "TargetPath": "rd-3G****/r-Wm****/fd-pjM8oy****/101522521960****",
      "CreateTime": "2021-07-26T08:54:14Z",
      "TargetName": "SharedServices_5009****",
      "TargetId": "101522521960****",
      "RAMRoleName": "AliyunReservedSSO-VPC-Admin",
      "AccessConfigurationName": "VPC-Admin",
      "TargetPathName": "rd-3G****/root/Core/SharedServices_5009****",
      "TargetType": "RD-Account",
      "UpdateTime": "2021-07-26T08:54:18Z",
      "RAMPolicyNames": [
        "AliyunReservedSSO-VPC-Admin-InlinePolicy"
      ],
      "AccessConfigurationId": "ac-00ccule7tadaijxc****",
      "OriginTargetId": "114240524784****"
    }
  ],
  "MaxResults": 10,
  "IsTruncated": false,
  "TotalCounts": 2
}

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.