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/ Web Application Firewall/ Referencia de la API/ API/ Consulta de un nombre de dominio de una cuenta/ Consultar un nombre de dominio por ID

Actualización más reciente 2022-11-02 GMT+08:00

Ver PDF

Consultar un nombre de dominio por ID

Función

Esta API se utiliza para consultar un nombre de dominio protegido por ID.

URI

GET /v1/{project_id}/composite-waf/host/{host_id}

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto
host_id	Sí	String	ID de nombre de dominio. En el modo de nube, se puede obtener llamando a la API ListHost. En el modo dedicado, se puede obtener llamando a la API ListPremiumHost.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	No	String	ID del proyecto de empresa. Se puede obtener mediante el llamado API ListEnterpriseProject de EPS.

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener llamando a la API IAM (valor de X-Subject-Token en el encabezado de respuesta).
Content-Type	Sí	String	Tipo de contenido Predeterminado: application/json;charset=utf8

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
id	String	ID de nombre de dominio
hostname	String	Nombre de dominio agregado a la nube WAF.
policyid	String	ID de política
access_code	String	Prefijo de CNAME
protect_status	Integer	Estado de protección del nombre de dominio. \n - -1: Se omite la protección WAF. Las solicitudes del nombre de dominio se envían directamente al servidor backend y no pasan a través de WAF. \n - 0: La protección WAF está suspendida. WAF solo reenvía solicitudes del nombre de dominio y no detecta ataques. \n - 1: La protección WAF está habilitada. WAF detecta ataques basados en la política configurada.
access_status	Integer	Estado de acceso
proxy	Boolean	Si el proxy está habilitado.
timestamp	Long	Hora en que se agrega un nombre de dominio a WAF.
paid_type	String	Modo de pago basado en paquetes. Actualmente, solo se admite el método de prepago.
flag	HostFlag object	Configuración del nombre de dominio
waf_type	String	Modo de WAF que se utiliza para proteger el nombre de dominio. El valor puede ser cloud o premium. cloud: El WAF cloud se utiliza para proteger el dominio.premium: se utiliza una instancia WAF dedicada para proteger el nombre de dominio.

**Tabla 5** HostFlag
Parámetro	Tipo	Descripción
pci_dss	String	Verdadero/Falso
pci_3ds	String	Verdadero/Falso
cname	String	antiguo/nuevo
is_dual_az	String	Verdadero/Falso
ipv6	String	Verdadero/Falso

Código de estado: 400

**Tabla 6** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estado: 401

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estado: 500

**Tabla 8** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Solicitudes de ejemplo

GET https://{Endpoint}/v1/{project_id}/composite-waf/host/{host_id}?enterprise_project_id=0

Ejemplo de respuestas

Código de estado: 200

{
  "id" : "31af669f567246c289771694f2112289",
  "hostid" : "31af669f567246c289771694f2112289",
  "description" : "",
  "type" : 1,
  "proxy" : false,
  "flag" : {
    "pci_3ds" : "false",
    "pci_dss" : "false",
    "ipv6" : "false",
    "cname" : "new",
    "is_dual_az" : "true"
  },
  "region" : "cn-north-4",
  "hostname" : "www.demo.com",
  "access_code" : "1b18879b9d064f8bbcbf8abce7294cac",
  "policyid" : "41cba8aee2e94bcdbf57460874205494",
  "timestamp" : 1650527546454,
  "protect_status" : 0,
  "access_status" : 0,
  "exclusive_ip" : false,
  "web_tag" : "",
  "paid_type" : "prePaid",
  "waf_type" : "cloud"
}