Todos os produtos
Search

Este produto

    Cloud Firewall:DescribeAssetList

    Central de documentação

    Cloud Firewall:DescribeAssetList

    Última atualização: Jun 28, 2026

    Consulta informações sobre ativos protegidos pelo Cloud Firewall.

    Descrição da operação

    Esta API é geralmente usada para consultar informações sobre ativos protegidos pelo Cloud Firewall com paginação.

    Limite de QPS

    O limite de QPS para usuário único desta API é de 10 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Faça as chamadas de forma adequada.

    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

    yundun-cloudfirewall:DescribeAssetList

    get

    *Asset

    acs:cloudfirewall::{#accountId}:asset/{#Type}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    Lang

    string

    Não

    O tipo de idioma da resposta. Valores válidos:

    • zh (padrão): Chinês.

    • en: Inglês.

    zh
    CurrentPage

    string

    Sim

    O número da página atual em uma consulta paginada.

    1
    PageSize

    string

    Sim

    O número de ativos protegidos pelo Cloud Firewall a serem exibidos em cada página em uma consulta paginada.

    10
    RegionNo

    string

    Não

    O ID da região do Cloud Firewall.

    Nota

    Para mais informações sobre as regiões suportadas pelo Cloud Firewall, consulte Regiões suportadas.

    cn-hangzhou
    Status

    string

    Não

    O status do Cloud Firewall. Valores válidos:

    • open: Protegido.

    • opening: Ativando proteção.

    • closed: Não protegido.

    • closing: Desativando proteção.

    Nota

    Se este parâmetro não for definido, todos os status do firewall serão consultados.

    open
    SearchItem

    string

    Não

    O endereço IP ou o ID da instância do ativo.

    192.0.XX.XX
    Type deprecated

    string

    Não

    Este parâmetro foi descontinuado.

    eip
    ResourceType

    string

    Não

    O tipo de ativo. Valores válidos:

    • BastionHostEgressIP: IP de egresso do bastion host.

    • BastionHostIngressIP: IP de ingresso do bastion host.

    • EcsEIP: EIP do ECS.

    • EcsPublicIP: IP público do ECS.

    • EIP: Endereço Elastic IP.

    • EniEIP: EIP da interface de rede elástica.

    • NatEIP: EIP do NAT.

    • SlbEIP: EIP do SLB (EIP do CLB).

    • SlbPublicIP: IP público do SLB (IP público do CLB).

    • NatPublicIP: IP público do NAT.

    • HAVIP: IP virtual de alta disponibilidade.

    • NlbEIP: EIP do NLB.

    • ApiGatewayEIP: IP público do API Gateway.

    • AlbEIP: EIP do ALB.

    • AiGatewayEIP: IP público do AI Gateway.

    • GaEIP: EIP do GA.

    • SwasEIP: IP público do Simple Application Server.

    • EcdEIP: IP público do Elastic Desktop Service.

    • BastionHostIP: IP do bastion host.

    EIP
    SgStatus

    string

    Não

    O status da política do grupo de segurança. Valores válidos:

    • pass: Entregue.

    • block: Não entregue.

    • unsupport: Não suportado.

    Nota

    Se este parâmetro não for definido, todos os status de política do grupo de segurança serão consultados.

    pass
    IpVersion

    string

    Não

    A versão de IP dos ativos protegidos pelo Cloud Firewall. Valores válidos:

    • 4 (padrão): IPv4.

    • 6: IPv6.

    4
    MemberUid

    integer

    Não

    O UID da conta de membro do Cloud Firewall.

    258039427902****
    UserType

    string

    Não

    O tipo de usuário. Valores válidos:

    • buy (padrão): Usuário pago.

    • free: Usuário gratuito.

    buy
    NewResourceTag

    string

    Não

    O momento em que o ativo foi descoberto. Valores válidos:

    • discovered in 1 hour: O ativo foi descoberto em até 1 hora.

    • discovered in 1 day: O ativo foi descoberto em até 1 dia.

    • discovered in 7 days: O ativo foi descoberto em até 7 dias.

    discovered in 1 hour
    OutStatistic

    string

    Não

    Especifica se devem ser consultadas as informações de tráfego de saída.

    true
    SensitiveStatus

    string

    Não

    O status da detecção de vazamento de dados.

    open

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    TotalCount

    integer

    O número total de ativos protegidos pelo Cloud Firewall.

    12
    RequestId

    string

    O ID da solicitação.

    CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D
    Assets

    array<object>

    As informações sobre os ativos protegidos pelo Cloud Firewall.

    object

    RiskLevel

    string

    O nível de risco do ativo. Valores válidos:

    • low: Baixo risco.

    • middle: Risco médio.

    • hight: Alto risco.

    Nota

    Este parâmetro é retornado apenas quando o valor de UserType é free.

    low
    BindInstanceName

    string

    O nome da instância do ativo vinculado.

    instance01
    Type deprecated

    string

    Este parâmetro foi descontinuado.

    eip
    SgStatusTime

    integer

    A última hora de detecção do status do grupo de segurança, em formato de timestamp. Unidade: segundos.

    1615082937
    ResourceInstanceId

    string

    O ID da instância do ativo.

    i-8vbdrjrxzt78****
    MemberUid

    integer

    O UID da conta de membro do Cloud Firewall.

    258039427902****
    IntranetAddress

    string

    O endereço IP privado do servidor.

    192.168.XX.XX
    SyncStatus

    string

    O status de suporte a desvio de tráfego do ativo. Valores válidos:

    • enable: Desvio de tráfego suportado.

    • disable: Desvio de tráfego não suportado.

    enable
    AliUid

    integer

    O UID da conta da Alibaba Cloud.

    Nota

    A conta principal da conta de membro do Cloud Firewall.

    158039427902****
    ProtectStatus

    string

    O status do firewall. Valores válidos:

    • open: Protegido.

    • opening: Ativando proteção.

    • closed: Não protegido.

    • closing: Desativando proteção.

    open
    InternetAddress

    string

    O endereço IP público do servidor.

    192.0.XX.XX
    BindInstanceId

    string

    O ID da instância do ativo vinculado.

    i-8vbdrjrxzt78****
    RegionID

    string

    O ID da região do ativo.

    cn-hangzhou
    RegionStatus

    string

    Indica se a região do ativo suporta a ativação da proteção do Cloud Firewall. Valores válidos:

    • enable: Suportado.

    • disable: Não suportado.

    enable
    ResourceType

    string

    O tipo de ativo. Valores válidos:

    • BastionHostEgressIP: IP de egresso do bastion host.

    • BastionHostIngressIP: IP de ingresso do bastion host.

    • EcsEIP: EIP do ECS.

    • EcsPublicIP: IP público do ECS.

    • EIP: Endereço Elastic IP.

    • EniEIP: EIP da interface de rede elástica.

    • NatEIP: EIP do NAT.

    • SlbEIP: EIP do SLB (EIP do CLB).

    • SlbPublicIP: IP público do SLB (IP público do CLB).

    • NatPublicIP: IP público do NAT.

    • HAVIP: IP virtual de alta disponibilidade.

    • NlbEIP: EIP do NLB.

    • ApiGatewayEIP: IP público do API Gateway.

    • AlbEIP: EIP do ALB.

    • AiGatewayEIP: IP público do AI Gateway.

    • GaEIP: EIP do GA.

    • SwasEIP: IP público do Simple Application Server.

    • EcdEIP: IP público do Elastic Desktop Service.

    • BastionHostIP: IP do bastion host.

    EIP
    IpVersion

    integer

    A versão do endereço IP do ativo protegido pelo Cloud Firewall.

    Valores válidos:

    • 4: Indica um endereço IPv4.

    • 6: Indica um endereço IPv6.

    4
    SgStatus

    string

    A política do grupo de segurança. Valores válidos:

    • pass: Entregue.

    • block: Não entregue.

    • unsupport: Não suportado.

    block
    Note

    string

    As observações do ativo. Valores válidos:

    • REGION_NOT_SUPPORT: Região não suportada.

    • NETWORK_NOT_SUPPORT: Rede não suportada.

    REGION_NOT_SUPPORT
    Name

    string

    O nome da instância do ativo protegido pelo Cloud Firewall.

    instance01
    CreateTimeStamp

    string

    O momento em que o Cloud Firewall descobriu o ativo. Formato de hora: AAAA-MM-DD HH:mm:ss.

    2023-02-28 10:29:58
    NewResourceTag

    string

    O momento em que o ativo foi descoberto. Valores válidos:

    • discovered in 1 hour: O ativo foi descoberto em até 1 hora.

    • discovered in 1 day: O ativo foi descoberto em até 1 dia.

    • discovered in 7 days: O ativo foi descoberto em até 7 dias.

    discovered in 1 hour
    SensitiveDataStatus

    string

    O status da detecção de vazamento de dados.

    open
    Last7DayOutTrafficBytes

    integer

    O tráfego de saída nos últimos 7 dias.

    0

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "TotalCount": 12,
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D",
  "Assets": [
    {
      "RiskLevel": "low",
      "BindInstanceName": "instance01",
      "Type": "eip",
      "SgStatusTime": 1615082937,
      "ResourceInstanceId": "i-8vbdrjrxzt78****",
      "MemberUid": 0,
      "IntranetAddress": "192.168.XX.XX",
      "SyncStatus": "enable",
      "AliUid": 0,
      "ProtectStatus": "open",
      "InternetAddress": "192.0.XX.XX",
      "BindInstanceId": "i-8vbdrjrxzt78****",
      "RegionID": "cn-hangzhou",
      "RegionStatus": "enable",
      "ResourceType": "EIP",
      "IpVersion": 4,
      "SgStatus": "block",
      "Note": "REGION_NOT_SUPPORT",
      "Name": "instance01",
      "CreateTimeStamp": "2023-02-28 10:29:58",
      "NewResourceTag": "discovered in 1 hour",
      "SensitiveDataStatus": "open",
      "Last7DayOutTrafficBytes": 0
    }
  ]
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 ErrorDBSelect An error occurred while querying database. An error occurred while querying database.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.