Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Domain Name Service/ Referencia de la API/ Las API/ Gestión de líneas personalizadas/ Consulta de una línea personalizada

Actualización más reciente 2023-04-24 GMT+08:00

Ver PDF

Consulta de una línea personalizada

Función

Depuración

Puede depurar esta API mediante la autenticación automática en API Explorer o usar el código de ejemplo del SDK generado por API Explorer.

URI

GET /v2.1/customlines

**Tabla 1** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
line_id	No	String	ID de línea de resolución
name	No	String	Nombre de línea de resolución
limit	No	Integer	Número de recursos en cada página. El valor oscila entre 0 y 500. Los valores más utilizados son 10, 20 y 50 y el valor predeterminado es 500.
offset	No	Integer	Iniciar desplazamiento de la consulta de paginación. La consulta comenzará a partir del siguiente recurso del valor de desplazamiento. El valor oscila entre 0 y 2147483647. El valor predeterminado es 0. Si marker no se deja en blanco, la consulta comienza desde el recurso especificado por marker.
show_detail	No	Boolean	Si desea consultar información detallada. Opciones de valor: true (predeterminado): Se consulta la información detallada. false No se consulta información detallada.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener mediante invocación a una API de IAM. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
lines	Array of line objects	Lista de líneas
metadata	metadata object	Número de recursos que cumplen la condición de consulta

**Tabla 4** line
Parámetro	Tipo	Descripción
line_id	String	ID de línea de resolución
name	String	Nombre de línea personalizado
ip_segments	Array of strings	Rango de direcciones IP
created_at	String	Hora de creación
updated_at	String	Hora de actualización
status	String	Estado del recurso
description	String	Descripción de línea personalizada

**Tabla 5** metadata
Parámetro	Tipo	Descripción
total_count	Integer	Número de recursos que cumplen los criterios de filtro. El número es irrelevante para limit o offset.

Solicitudes de ejemplo

Ninguna

Ejemplo de respuestas

Código de estado: 200

Consulta de una línea 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
  }
}