Todos os produtos
Search

Este produto

    Identity as a Service:ListConditionalAccessPolicies

    Central de documentação

    Identity as a Service:ListConditionalAccessPolicies

    Última atualização: Sep 20, 2026

    Lista as políticas de acesso condicional.

    Descrição da operação

    Consulta as políticas de acesso condicional por página.

    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

    eiam:ListConditionalAccessPolicies

    list

    *ConditionalAccessPolicy

    acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/conditionalaccesspolicy/*

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    InstanceId

    string

    Sim

    O ID da instância.

    idaas_ue2jvisn35ea5lmthk267xxxxx
    NextToken

    string

    Não

    O token de paginação para a próxima página.

    NTxxxxxexample
    MaxResults

    integer

    Não

    O número de entradas por página em uma consulta paginada.

    20
    PreviousToken

    string

    Não

    O token de paginação para a página anterior.

    PTxxxxxexample

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação.

    0441BD79-92F3-53AA-8657-F8CE4A2B912A
    TotalCount

    integer

    O número total de entradas na lista.

    100
    NextToken

    string

    O valor do token de consulta (Token) retornado por esta chamada.

    NTxxxexample
    ConditionalAccessPolicies

    array<object>

    A coleção de políticas de acesso condicional.

    array<object>

    InstanceId

    string

    O ID da instância.

    idaas_ksvv5c7f2l6uzh6oqspeks23ni
    ConditionalAccessPolicyId

    string

    O ID da política de acesso condicional.

    cp_xxxxx
    ConditionalAccessPolicyName

    string

    O nome da política de acesso condicional.

    Minha política
    Description

    string

    A descrição da política de acesso condicional.

    Minha descrição de política
    ConditionalAccessPolicyType

    string

    O tipo da política de acesso condicional.

    arn:alibaba:idaas:authn:access:policy:system
    Status

    string

    O status ativado ou desativado da política de acesso condicional.

    disabled
    DecisionType

    string

    O tipo de decisão da política de acesso condicional.

    enforcement
    EvaluateAt

    string

    O ponto de avaliação da política de acesso condicional.

    arn:alibaba:idaas:authn:access:rule:eval_at:after_step1
    Priority

    integer

    A prioridade. Valores válidos: 1 a 100.

    1
    DecisionConfig

    object

    A configuração da ação de decisão da política de acesso condicional.

    Effect

    string

    A ação de decisão da política de acesso condicional. Valores válidos:

    • deny: Negar.

    • allow: Permitir.

    deny
    MfaType

    string

    O tipo de MFA da política de acesso condicional.

    directly_access
    MfaAuthenticationIntervalSeconds

    integer

    O intervalo de reautenticação MFA da política de acesso condicional, em segundos. Valores válidos: 300 a 86400.

    300
    MfaAuthenticationMethods

    array

    Os métodos de MFA permitidos pela política de acesso condicional.

    string

    O método de MFA permitido pela política de acesso condicional. Valores válidos:

    • ia_otp_sms: Código de verificação por SMS.

    • ia_otp_email: Código de verificação por e-mail.

    • ia_totp: Senha dinâmica OTP.

    • ia_webauthn: WebAuthn.

    ia_otp_email
    ActiveSessionReuseStatus

    string

    Indica se a reutilização de sessão de autenticação secundária está ativada.

    disabled
    ConditionsConfig

    object

    A configuração de condições da política de acesso condicional.

    Applications

    object

    As aplicações de destino da política de acesso condicional.

    IncludeApplications

    array

    As aplicações incluídas.

    string

    O ID da aplicação.

    app_xxxxx
    ExcludeApplications

    array

    As aplicações excluídas.

    string

    O ID da aplicação.

    app_xxxxx
    Users

    object

    Os usuários de destino da política de acesso condicional.

    IncludeUsers

    array

    Os usuários incluídos.

    string

    O ID do usuário.

    user_xxxxx
    ExcludeUsers

    array

    Os usuários excluídos.

    string

    O ID do usuário.

    user_xxxxx
    IncludeGroups

    array

    Os grupos de usuários incluídos.

    string

    O ID do grupo de usuários.

    group_xxxxx
    ExcludeGroups

    array

    Os grupos de usuários excluídos.

    string

    O ID do grupo de usuários.

    group_xxxxx
    IncludeOrganizationalUnits

    array

    As unidades organizacionais incluídas.

    string

    O ID da unidade organizacional.

    ou_xxxxx
    ExcludeOrganizationalUnits

    array

    As unidades organizacionais excluídas.

    string

    O ID da unidade organizacional.

    ou_xxxxx
    NetworkZones

    object

    As zonas de rede da política de acesso condicional.

    IncludeNetworkZones

    array

    As zonas de rede incluídas.

    string

    O ID da zona de rede incluída.

    network_xxxxx
    ExcludeNetworkZones

    array

    As zonas de rede excluídas.

    string

    O ID da zona de rede excluída.

    network_xxxxx
    CreateTime

    integer

    A hora de criação. O valor é um carimbo de data/hora UNIX em milissegundos.

    1741857554000
    LastUpdatedTime

    integer

    A hora da última atualização. Este valor é um carimbo de data/hora UNIX. Unidade: milissegundos.

    1741857554000
    PreviousToken

    string

    O token de paginação para a página anterior.

    PTxxxxxexample

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "TotalCount": 100,
  "NextToken": "NTxxxexample",
  "ConditionalAccessPolicies": [
    {
      "InstanceId": "idaas_ksvv5c7f2l6uzh6oqspeks23ni",
      "ConditionalAccessPolicyId": "cp_xxxxx",
      "ConditionalAccessPolicyName": "我的策略",
      "Description": "我的策略描述",
      "ConditionalAccessPolicyType": "arn:alibaba:idaas:authn:access:policy:system",
      "Status": "disabled",
      "DecisionType": "enforcement",
      "EvaluateAt": "arn:alibaba:idaas:authn:access:rule:eval_at:after_step1",
      "Priority": 1,
      "DecisionConfig": {
        "Effect": "deny",
        "MfaType": "directly_access",
        "MfaAuthenticationIntervalSeconds": 300,
        "MfaAuthenticationMethods": [
          "ia_otp_email"
        ],
        "ActiveSessionReuseStatus": "disabled"
      },
      "ConditionsConfig": {
        "Applications": {
          "IncludeApplications": [
            "app_xxxxx"
          ],
          "ExcludeApplications": [
            "app_xxxxx"
          ]
        },
        "Users": {
          "IncludeUsers": [
            "user_xxxxx"
          ],
          "ExcludeUsers": [
            "user_xxxxx"
          ],
          "IncludeGroups": [
            "group_xxxxx"
          ],
          "ExcludeGroups": [
            "group_xxxxx"
          ],
          "IncludeOrganizationalUnits": [
            "ou_xxxxx"
          ],
          "ExcludeOrganizationalUnits": [
            "ou_xxxxx"
          ]
        },
        "NetworkZones": {
          "IncludeNetworkZones": [
            "network_xxxxx"
          ],
          "ExcludeNetworkZones": [
            "network_xxxxx"
          ]
        }
      },
      "CreateTime": 1741857554000,
      "LastUpdatedTime": 1741857554000
    }
  ],
  "PreviousToken": "PTxxxxxexample"
}

    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.