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.
Actualización más reciente 2022-11-03 GMT+08:00

Creación de un nombre de dominio

Función

Esta API se utiliza para crear un nombre de dominio.

URI

POST /v1.0/cdn/domains

Parámetros de solicitud

Tabla 1 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

Especifica el token de usuario.

The token can be obtained by calling the IAM API used to obtain a user token. The value of **X-Subject-Token** in the response header is the user token.
Tabla 2 Parámetros de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

domain

DomainBody object

Especifica el cuerpo para crear un nombre de dominio.

Tabla 3 DomainBody

Parámetro

Obligatorio

Tipo

Descripción

domain_name

Yes

String

Especifica el nombre de dominio acelerado. El nombre de dominio consta de una o más partes, que representan dominios en diferentes niveles. Estas partes, conocidas técnicamente como etiquetas, están concatenadas y delimitadas por períodos (.). Una etiqueta consta de letras, números y guiones (-) que no distinguen mayúsculas y minúsculas. El nombre de dominio puede contener hasta 50 caracteres. No inicie o finalice un nombre de dominio con guiones (-).

business_type

String

Especifica el tipo de servicio del nombre de dominio. Valores posibles: web (aceleración estática), download (aceleración de descarga), video (aceleración de streaming de medios) y wholeSite (aceleración de todo el sitio).

sources

Array of Sources 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.

service_area

String

Especifica el ámbito del servicio CDN. Valores posibles: mainland_china (China continental), outside_mainland_china (fuera de China continental) y global (global).

enterprise_project_id

No

String

Proyecto de empresa al que se agrega un nombre de dominio de aceleración. Este parámetro sólo es válido cuando la función de proyecto de empresa está habilitada. Este parámetro es obligatorio cuando se utiliza un usuario de IAM para llamar a esta API.

Tabla 4 Sources

Parámetro

Obligatorio

Tipo

Descripción

domain_id

No

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. Un bucket OBS no tiene un servidor de origen en espera.

enable_obs_web_hosting

No

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.

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

domain

CreateDomainResponseBodyContent object

Especifica la respuesta a la solicitud para crear un nombre de dominio.

Tabla 6 CreateDomainResponseBodyContent

Parámetro

Tipo

Descripción

id

String

Especifica el ID de nombre de dominio acelerado.

domain_name

String

Especifica el nombre de dominio acelerado.

business_type

String

Especifica el tipo de servicio del nombre de dominio. Valores posibles: web (aceleración estática), download (aceleración de descarga), video (aceleración de streaming de medios) y wholeSite (aceleración de todo el sitio).

service_area

String

Especifica el ámbito del servicio CDN. Valores posibles: mainland_china (China continental), outside_mainland_china (fuera de China continental) y global (global).

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 acelerado. Valores posibles: online (CDN habilitado), offline (CDN deshabilitado), configuring (configurando) configure_failed (configuración falló), checking (revisando), check_failed (rechazado después de revisar) y deleting (eliminando).

cname

String

Especifica el registro CNAME del nombre de dominio acelerado.

sources

Array of Sources objects

Especifica el servidor de origen.

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).

range_status

String

Especifica el estado de la recuperación basada en intervalos. Valores posibles: off y on.

follow_status

String

Especifica el estado de la recuperación de redirección 302. Valores posibles: off y on.

origin_status

String

Especifica si la recuperación de contenido está deshabilitada.

auto_refresh_preheat

Integer

Especifica si están habilitados la actualización y el precalentamiento automáticos. Valores posibles: 0 (deshabilitado) y 1 (habilitado).

Tabla 7 Fuentes

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. Un bucket OBS no tiene un servidor de origen en espera.

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.

Tabla 8 DomainOriginHost

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

POST https://cdn.myhuaweicloud.com/v1.0/cdn/domains

{
  "domain" : {
    "domain_name" : "example1.example2.example3.com",
    "business_type" : "web",
    "sources" : [ {
      "ip_or_domain" : "10.62.53.75",
      "origin_type" : "ipaddr",
      "active_standby" : 1
    } ],
    "service_area" : "mainland_china",
    "enterprise_project_id" : "0"
  }
}

Ejemplo de respuestas

Código de estado: 200

OK

{
  "domain" : {
    "sources" : [ {
      "domain_id" : "ff80*************************07b",
      "ip_or_domain" : "10.62.53.75",
      "origin_type" : "ipaddr",
      "active_standby" : 1
    } ],
    "id" : "ff80*************************07b",
    "user_domain_id" : "38***********************5024dcb",
    "domain_name" : "example11.example2.example3.com",
    "business_type" : "web",
    "service_area" : "mainland_china",
    "cname" : "example1.example2.example3.com.c.example4.com",
    "domain_status" : "configuring",
    "https_status" : 0,
    "create_time" : 1513152634467,
    "modify_time" : 1513152634467,
    "domain_origin_host" : {
      "domain_id" : "ff80*************************07b",
      "origin_host_type" : "customize",
      "customize_domain" : "example5.example6.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.