Consulta de un nombre de dominio
Función
Esta API se utiliza para consultar un nombre de dominio acelerado.
URI
GET /v1.0/cdn/domains/{domain_id}/detail
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
domain_id |
Sí |
String |
Especifica el ID de nombre de dominio acelerado. Para obtener más información, consulte Consulta de detalles sobre un nombre de dominio. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
enterprise_project_id |
No |
String |
Proyecto de empresa al que pertenece el recurso. Este parámetro sólo es válido cuando la función de proyecto de empresa está habilitada. El valor all indica todos los proyectos. Este parámetro es obligatorio cuando se utiliza un usuario de IAM para llamar a esta API. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
String |
Especifica el token de usuario. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. 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
Parámetro |
Tipo |
Descripción |
---|---|---|
domain |
DomainsWithPort object |
Especifica los detalles del nombre de dominio. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID de nombre de dominio. |
domain_name |
String |
Especifica el nombre de dominio. |
business_type |
String |
Especifica el tipo de servicio del nombre de dominio. Valores posibles: web (aceleración de sitio web), download (aceleración de descarga de archivos), video (aceleración de VOD) y wholeSite (aceleración de sitio completo). |
user_domain_id |
String |
Especifica el ID de dominio del propietario del nombre de dominio. |
domain_status |
String |
Especifica el estado del nombre de dominio. Valores posibles: online (CDN habilitado), offline (CDN deshabilitado), configuring (en proceso de configuración), configure_failed (en proceso de configuración fallido), checking (en proceso de revisión), check_failed (en proceso de revisión fallido) y deleting (en proceso de eliminación). |
cname |
String |
Especifica el registro CNAME del nombre de dominio. |
sources |
Array of SourceWithPort objects |
Especifica la dirección del servidor de origen. El tipo de dirección puede ser dirección IP o nombre de dominio. Si el tipo de dirección del servidor de origen es dirección IP, solo se admiten direcciones IPv4. Si hay varias direcciones IP, debe especificar varios objetos para pasar estas direcciones respectivamente, y los valores de los parámetros excepto la dirección IP en estos objetos deben ser los mismos. Puede especificar hasta 15 direcciones IP para el servidor de origen principal o en espera. Si el tipo de dirección del servidor de origen es nombre de dominio, solo se admite un nombre de dominio. El tipo de dirección puede ser dirección IP o nombre de dominio. |
domain_origin_host |
DomainOriginHost object |
Especifica la configuración de recuperación del nombre de dominio. |
https_status |
Integer |
Especifica si la aceleración HTTPS está habilitada. |
create_time |
Long |
Especifica la hora a la que se creó el nombre de dominio. El valor es el número de milisegundos desde la época UNIX (1 de enero de 1970). |
modify_time |
Long |
Especifica la hora a la que se modificó el nombre de dominio. El valor es el número de milisegundos desde la época UNIX (1 de enero de 1970). |
disabled |
Integer |
Especifica si el dominio está prohibido. Valores posibles: 0 (no prohibido) y 1 (prohibido). |
locked |
Integer |
Especifica si el dominio está bloqueado. Valores posibles: 0 (no bloqueado) y 1 (bloqueado). |
auto_refresh_preheat |
Integer |
Especifica si están habilitados la actualización y el precalentamiento automáticos. Valores posibles: 0 (deshabilitado) y 1 (habilitado). |
service_area |
String |
Especifica el área de servicio de CDN. Valores posibles: mainland_china (China continental), outside_mainland_china (fuera de China continental) y global (global). |
range_status |
String |
Especifica si está habilitada la recuperación basada en intervalos. |
follow_status |
String |
Especifica si está habilitada la recuperación de redirección. |
origin_status |
String |
Especifica si la recuperación de contenido está deshabilitada. |
banned_reason |
String |
Especifica el motivo para deshabilitar el nombre de dominio. |
locked_reason |
String |
Especifica el motivo por el que se bloquea el nombre de dominio. |
enterprise_project_id |
String |
ID del proyecto de empresa al que pertenece el recurso. Este parámetro sólo es válido cuando la función de proyecto de empresa está habilitada. Si no se especifica este parámetro, se consulta el proyecto predeterminado. Este parámetro es obligatorio cuando se utiliza un usuario de IAM para llamar a esta API. |
Parámetro |
Tipo |
Descripción |
---|---|---|
domain_id |
String |
ID de nombre de dominio. |
ip_or_domain |
String |
Especifica la dirección IP o el nombre de dominio del servidor de origen. |
origin_type |
String |
Especificó el tipo del servidor de origen. Valores posibles: ipaddr (dirección IP del servidor de origen), domain (nombre de dominio del servidor de origen), andobs_bucket (nombre de dominio de un bucket OBS). |
active_standby |
Integer |
Especifica si el servidor de origen está activo o en espera. Valores posibles: 1 (activo) y 0 (en espera). Un servidor de origen activo es obligatorio, mientras que un servidor de origen en espera es opcional. |
enable_obs_web_hosting |
Integer |
Especifica si el alojamiento estático está habilitado para un bucket OBS. Valores posibles: 0 (deshabilitado) y 1 (habilitado). Este parámetro se pasa solo cuando origin_type se establece en obs_bucket. |
http_port |
Integer |
Especifica el puerto HTTP. Valor predeterminado: 80. |
https_port |
Integer |
Especifica el puerto HTTPS. Valor predeterminado: 443. |
Parámetro |
Tipo |
Descripción |
---|---|---|
domain_id |
String |
Especifica el ID de nombre de dominio. Para obtener más información, consulte Consulta de detalles sobre un nombre de dominio. |
origin_host_type |
String |
Especifica el tipo del host de recuperación. |
customize_domain |
String |
Especifica el nombre de dominio personalizado del host de recuperación. |
Solicitudes de ejemplo
GET https://cdn.myhuaweicloud.com/v1.0/cdn/domains/12a***********************345d671/detail?enterprise_project_id=1
Ejemplo de respuestas
Código de estado: 200
OK
{ "domain" : { "sources" : [ { "domain_id" : "12a***********************345d671", "origin_type" : "ipaddr", "ip_or_domain" : "10.62.53.75", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ], "cname" : "www.example1.com.c.example2.com", "id" : "12a***********************345d671", "user_domain_id" : "1a23***********************4a441", "domain_name" : "www.example1.com", "business_type" : "web", "service_area" : "mainland_china", "domain_status" : "online", "https_status" : 0, "create_time" : 1516861994806, "modify_time" : 1532405346365, "domain_origin_host" : { "domain_id" : "12a***********************345d671", "origin_host_type" : "customize", "customize_domain" : "www.example4.com" }, "disabled" : 0, "locked" : 0, "range_status" : "off", "follow_status" : "off", "origin_status" : "on", "auto_refresh_preheat" : 0 } }
Códigos de estado
Código de estado |
Descripción |
---|---|
200 |
OK |
Códigos de error
Consulte Códigos de error.