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/ Gestión de sitios web protegidos en modo Cloud/ Consulta de un nombre de dominio por ID en modo de cloud
Actualización más reciente 2022-11-02 GMT+08:00
Ver PDF
Compartir

Consulta de un nombre de dominio por ID en modo de cloud

Función

Consulta de un nombre de dominio por ID en modo cloud

URI

GET /v1/{project_id}/waf/instance/{instance_id}

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto

instance_id

Sí

String

ID de nombre de dominio. Se puede obtener llamando a la API ListHost para la nube WAF.
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

protocol

String

Tipo de protocolo de backend. El valor puede ser HTTPS, HTTP o HTTP&HTTPS.

certificateid

String

ID de certificado HTTPS.

certificatename

String

Nombre del certificado

server

Array of CloudWafServer objects

Detalles del servidor de origen

proxy

Boolean

Si el proxy está habilitado.

timestamp

Long

Hora en que se agrega un nombre de dominio a WAF.

exclusive_ip

Boolean

Si se utiliza una dirección IP dedicada
Tabla 5 CloudWafServer

Parámetro

Tipo

Descripción

front_protocol

String

Protocolo del cliente

Valores de enumeración:

  • HTTP
  • HTTPS

back_protocol

String

Protocolo de servidor

Valores de enumeración:

  • HTTP
  • HTTPS

address

String

Dirección del servidor

port

Integer

Puerto del servidor

type

String

La dirección del servidor de origen es una dirección IPv4 o IPv6.

Valores de enumeración:

  • ipv4
  • ipv6

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 estad: 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}/waf/instance/{instance_id}?enterprise_project_id=0

Ejemplo de respuestas

Código de estado: 200

OK

{
  "id" : "31af669f567246c289771694f2112289",
  "hostname" : "www.demo.com",
  "protocol" : "HTTP",
  "server" : [ {
    "address" : "x.x.x.x",
    "port" : 80,
    "type" : "ipv4",
    "http2" : false,
    "weight" : 1,
    "front_protocol" : "HTTP",
    "back_protocol" : "HTTP"
  } ],
  "proxy" : false,
  "locked" : 0,
  "timestamp" : 1650527546420,
  "flag" : {
    "pci_3ds" : "false",
    "pci_dss" : "false",
    "ipv6" : "false",
    "cname" : "new",
    "is_dual_az" : "true"
  },
  "description" : "",
  "policyid" : "41cba8aee2e94bcdbf57460874205494",
  "domainid" : "d4ecb00b031941ce9171b7bc3386883f",
  "projectid" : "0456cf04d6f64725ab02ed5bd2efdfa4",
  "enterprise_project_id" : "0",
  "protect_status" : 0,
  "access_status" : 0,
  "access_code" : "1b18879b9d064f8bbcbf8abce7294cac",
  "block_page" : {
    "template" : "default"
  },
  "web_tag" : "",
  "exclusive_ip" : false,
  "http2_enable" : false
}

Códigos de estado

Código de estado

Descripción

200

OK

400

Error de solicitud.

401

Permisos de token insuficientes.

500

Error de servidor interno.

Códigos de error

Consulte Códigos de error.