Todos os produtos
Search

Este produto

    Anti-DDoS:DescribeInstances

    Central de documentação

    Anti-DDoS:DescribeInstances

    Última atualização: Oct 14, 2026

    Consulta os detalhes das instâncias do Anti-DDoS Pro ou Anti-DDoS Premium.

    Descrição da operação

    Consulta os detalhes das instâncias do Anti-DDoS Pro ou Anti-DDoS Premium pertencentes à conta atual do Alibaba Cloud usando paginação. Os detalhes incluem o ID da instância, a edição, o horário de expiração e o status de encaminhamento de tráfego de serviço.

    Limite de QPS

    O limite de QPS para um único usuário é de 10 invocações por segundo. Se o limite for excedido, as invocações de API serão limitadas, o que pode afetar seus serviços. Invoque esta operação com base nos requisitos do seu negócio.

    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-ddoscoo:DescribeInstances

    get

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos ao qual a instância do Anti-DDoS Pro ou Anti-DDoS Premium pertence no Resource Management.

    Se você não especificar este parâmetro, o grupo de recursos padrão será usado.

    rg-acfm2pz25js****
    PageNumber

    string

    Sim

    O número da página para paginação.

    1
    PageSize

    string

    Sim

    O número de instâncias por página para paginação. Valores válidos: 1 a 50.

    10
    Ip

    string

    Não

    O endereço IP da instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada.

    203.107.XX.XX
    Remark

    string

    Não

    A observação da instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada. Há suporte para correspondência aproximada.

    doc-test
    Edition

    integer

    Não

    A edição do plano de mitigação da instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada. Valores válidos:

    • 0: Edição Insurance do Anti-DDoS Pro e Anti-DDoS Premium (fora da China continental).

    • 1: Edição Unlimited do Anti-DDoS Pro e Anti-DDoS Premium (fora da China continental).

    • 2: Linha de aceleração do Anti-DDoS Pro e Anti-DDoS Premium (fora da China continental).

    • 9: Edição Professional do Anti-DDoS Pro e Anti-DDoS Premium (China continental).

    9
    Enabled

    integer

    Não

    O status de encaminhamento de tráfego de serviço da instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada. Valores válidos:

    • 0: O encaminhamento de tráfego de serviço está parado.

    • 1: O encaminhamento de tráfego de serviço está normal.

    1
    ExpireStartTime

    integer

    Não

    O horário de expiração mais antigo das instâncias do Anti-DDoS Pro ou Anti-DDoS Premium a serem consultadas. Isso significa que apenas as instâncias cujo horário de expiração é posterior ao valor de ExpireStartTime são consultadas. O valor é um carimbo de data/hora UNIX em milissegundos.

    1640361500000
    ExpireEndTime

    integer

    Não

    O horário de expiração mais recente das instâncias do Anti-DDoS Pro ou Anti-DDoS Premium a serem consultadas. Isso significa que apenas as instâncias cujo horário de expiração é anterior ao valor de ExpireEndTime são consultadas. O valor é um carimbo de data/hora UNIX em milissegundos.

    1640361700000
    InstanceIds

    array

    Não

    Os IDs das instâncias do Anti-DDoS Pro ou Anti-DDoS Premium a serem consultadas. Você pode especificar até 200 instâncias do Anti-DDoS Pro ou Anti-DDoS Premium.

    string

    Não

    O ID da instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada.

    ddoscoo-cn-7pp2g9ed****
    Status

    array

    Não

    Os status das instâncias do Anti-DDoS Pro ou Anti-DDoS Premium a serem consultadas. Você pode especificar até 2 status de instância do Anti-DDoS Pro ou Anti-DDoS Premium.

    integer

    Não

    O status da instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada. Valores válidos:

    • 1: Normal.

    • 2: Expirado.

    1
    Tag

    array<object>

    Não

    As tags anexadas às instâncias do Anti-DDoS Pro ou Anti-DDoS Premium a serem consultadas.

    object

    Não

    Key

    string

    Não

    A chave de tag anexada à instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada. Valor máximo de N: 200, o que significa que você pode especificar até 200 chaves de tag. As regras de configuração são as seguintes:

    • Cada tag consiste em uma chave de tag (Key) e um valor de tag (Value), separados por uma vírgula (,).

    • As tags são separadas por vírgulas (,).

    Nota

    A chave de tag (Key) e o valor de tag (Value) devem aparecer em pares.

    test-key
    Value

    string

    Não

    O valor de tag anexado à instância do Anti-DDoS Pro ou Anti-DDoS Premium a ser consultada. Valor máximo de N: 200, o que significa que você pode especificar até 200 valores de tag. As regras de configuração são as seguintes:

    • Cada tag consiste em uma chave de tag (Key) e um valor de tag (Value), separados por uma vírgula (,).

    • As tags são separadas por vírgulas (,).

    Nota

    A chave de tag (Key) e o valor de tag (Value) devem aparecer em pares.

    test-value

    Além dos parâmetros de solicitação descritos neste tópico, você também deve incluir parâmetros de solicitação comuns ao chamar esta operação de API. Para obter mais informações sobre os parâmetros de solicitação comuns, consulte Parâmetros comuns.

    Para obter mais informações sobre o formato da solicitação, consulte a seção Exemplos neste tópico.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Instances

    array<object>

    Os detalhes das instâncias do Anti-DDoS Pro ou Anti-DDoS Premium.

    object

    CreateTime

    integer

    A hora em que a instância foi criada. O valor é um carimbo de data/hora UNIX em milissegundos.

    1637751953000
    DebtStatus

    integer

    O status de pagamento em atraso da instância. O valor é fixo como 0, o que indica que não há pagamentos em atraso, porque o Anti-DDoS Pro e o Anti-DDoS Premium atualmente suportam apenas o método de faturamento por assinatura.

    0
    Edition

    integer

    A edição do plano de mitigação da instância. Valores válidos:

    • 0: Edição Insurance do Anti-DDoS Pro e Anti-DDoS Premium (fora da China continental).

    • 1: Edição Unlimited do Anti-DDoS Pro e Anti-DDoS Premium (fora da China continental).

    • 2: Linha de aceleração do Anti-DDoS Pro e Anti-DDoS Premium (fora da China continental).

    • 9: Edição Professional do Anti-DDoS Pro e Anti-DDoS Premium (China continental).

    9
    Enabled

    integer

    O status de encaminhamento de tráfego de serviço da instância. Valores válidos:

    • 0: O encaminhamento de tráfego de serviço está parado.

    • 1: O encaminhamento de tráfego de serviço está normal.

    1
    ExpireTime

    integer

    O horário de expiração da instância. O valor é um carimbo de data/hora UNIX em milissegundos.

    1640361600000
    InstanceId

    string

    O ID da instância.

    ddoscoo-cn-7pp2g9ed****
    Ip

    string

    O endereço IP da instância do Anti-DDoS Pro ou Anti-DDoS Premium.

    203.199.XX.XX
    IpMode

    string

    O modo de encaminhamento de IP da instância. Valores válidos:

    • fnat: As versões de IP do servidor de origem e do cliente são as mesmas. As solicitações de clientes IPv4 são encaminhadas para servidores de origem IPv4, e as solicitações de clientes IPv6 são encaminhadas para servidores de origem IPv6.

    • v6tov4: As solicitações de clientes IPv6 são encaminhadas para servidores de origem IPv4.

    fnat
    IpVersion

    string

    A versão do protocolo IP da instância. Valores válidos:

    • Ipv4: IPv4.

    • Ipv6: IPv6.

    Ipv4
    IsFirstOpenBw

    integer

    Indica se o método de medição de largura de banda de limpeza burstável no 95º percentil foi ativado para a instância. Valores válidos:

    • 0: Não.

    • 1: Sim.

    0
    IsFirstOpenQps

    integer

    Indica se o método de medição de QPS burstável no 95º percentil foi ativado para a instância. Valores válidos:

    • 0: Não.

    • 1: Sim.

    0
    Remark

    string

    A descrição da instância.

    doc-test
    Status

    integer

    O status da instância. Valores válidos:

    • 1: Normal.

    • 2: Expirado.

    1
    RequestId

    string

    O ID da solicitação, que é um identificador exclusivo gerado pelo Alibaba Cloud para a solicitação e pode ser usado para solucionar problemas.

    A0AF40CC-814A-5A86-AEAA-6F19E88B8A39
    TotalCount

    integer

    O número total de instâncias do Anti-DDoS Pro ou Anti-DDoS Premium consultadas.

    1

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "Instances": [
    {
      "CreateTime": 1637751953000,
      "DebtStatus": 0,
      "Edition": 9,
      "Enabled": 1,
      "ExpireTime": 1640361600000,
      "InstanceId": "ddoscoo-cn-7pp2g9ed****",
      "Ip": "203.199.XX.XX",
      "IpMode": "fnat",
      "IpVersion": "Ipv4",
      "IsFirstOpenBw": 0,
      "IsFirstOpenQps": 0,
      "Remark": "doc-test",
      "Status": 1
    }
  ],
  "RequestId": "A0AF40CC-814A-5A86-AEAA-6F19E88B8A39",
  "TotalCount": 1
}

    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.