Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Domain Name Service/ Referência de API/ APIs/ Gerenciamento de linhas personalizadas/ Consulta de uma linha personalizada

Atualizado em 2025-08-19 GMT+08:00

Ver PDF

Consulta de uma linha personalizada

Função

Depuração

Você pode depurar esta API por meio da autenticação automática no Chamada das API ou usar o código de exemplo do SDK gerado pelo API Explorer.

URI

GET /v2.1/customlines

**Tabela 1** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
line_id	Não	String	ID da linha de resolução
name	Não	String	Nome da linha de resolução
limit	Não	Integer	Número de recursos em cada página. O valor varia de 0 a 500. Os valores comumente usados são 10, 20 e 50, o valor padrão é 500.
offset	Não	Integer	Iniciar deslocamento da consulta de paginação. A consulta começará a partir do próximo recurso do valor deslocamento. O valor varia de 0 a 2147483647. O valor padrão é 0. Se o marker não for deixado em branco, a consulta será iniciada a partir do recurso especificado pelo marker.
show_detail	Não	Boolean	Se para consultar informações detalhadas. Opções de valor: true (padrão): informações detalhadas são consultadas. false: informações detalhadas não são consultadas.

Parâmetros de solicitação

**Tabela 2** Parâmetros do cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Ele pode ser obtido pela chamada de uma API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

**Tabela 3** Parâmetros de corpo de resposta
Parâmetro	Tipo	Descrição
lines	Array of line objects	Lista de linhas
metadata	metadata object	Número de recursos que atendem à condição de consulta

**Tabela 4** line
Parâmetro	Tipo	Descrição
line_id	String	ID da linha de resolução
name	String	Nome de linha personalizada
ip_segments	Array of strings	Intervalo de endereços IP
created_at	String	Tempo de criação
updated_at	String	Hora da atualização
status	String	Status do recurso
description	String	Descrição de linha personalizada

**Tabela 5** metadata
Parâmetro	Tipo	Descrição
total_count	Integer	Número de recursos que atendem aos critérios de filtro. O número é irrelevante para limit ou offset.

Exemplo de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Consulta de uma linha personalizada

{
  "lines" : [ {
    "line_id" : "custom_2ce45ef669fc87870169fcbada7a0007",
    "name" : "customline",
    "ip_segments" : [ "1.1.1.1-1.1.1.1", "1.1.1.2-1.1.1.3" ],
    "status" : "ACTIVE",
    "created_at" : "2019-04-10T10:03:17.827",
    "updated_at" : "2019-04-10T10:03:57.207",
    "description" : "1234"
  } ],
  "metadata" : {
    "total_count" : 1
  }
}