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.
Cómputo
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Cloud Phone Host
Huawei Cloud EulerOS
Redes
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
VPC Endpoint
Cloud Connect
Enterprise Router
Enterprise Switch
Global Accelerator
Gestión y gobernanza
Cloud Eye
Identity and Access Management
Cloud Trace Service
Resource Formation Service
Tag Management Service
Log Tank Service
Config
Resource Access Manager
Simple Message Notification
Application Performance Management
Application Operations Management
Organizations
Optimization Advisor
Cloud Operations Center
Resource Governance Center
Migración
Server Migration Service
Object Storage Migration Service
Cloud Data Migration
Migration Center
Cloud Ecosystem
KooGallery
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP Filing
Support Plans
My Credentials
Customer Operation Capabilities
Partner Support Plans
Professional Services
Análisis
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
IoT
IoT Device Access
Otros
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Seguridad y cumplimiento
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Situation Awareness
Managed Threat Detection
Blockchain
Blockchain Service
Servicios multimedia
Media Processing Center
Video On Demand
Live
SparkRTC
Almacenamiento
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Storage Disaster Recovery Service
Scalable File Service
Volume Backup Service
Cloud Server Backup Service
Data Express Service
Dedicated Distributed Storage Service
Contenedores
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Bases de datos
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GeminiDB
GaussDB
Distributed Database Middleware
Database and Application Migration UGO
TaurusDB
Middleware
Distributed Cache Service
API Gateway
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
EventGrid
Dedicated Cloud
Dedicated Computing Cluster
Aplicaciones empresariales
ROMA Connect
Message & SMS
Domain Name Service
Edge Data Center Management
Meeting
AI
Face Recognition Service
Graph Engine Service
Content Moderation
Image Recognition
Data Lake Factory
Optical Character Recognition
ModelArts
ImageSearch
Conversational Bot Service
Speech Interaction Service
Huawei HiLens
Developer Tools
SDK Developer Guide
API Request Signing Guide
Terraform
Koo Command Line Interface
Distribución de contenido y cómputo de borde
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Soluciones
SAP Cloud
High Performance Computing
Servicios para desarrolladores
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
Cloud Application Engine
aPaaS MacroVerse
KooPhone
KooDrive
Centro de ayuda/ Content Delivery Network/ Referencia de la API/ API/ Configuración del nombre de dominio/ Modificación de la configuración completa del dominio

Modificación de la configuración completa del dominio

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

Función

Esta API se utiliza para modificar la configuración completa del nombre de dominio, incluyendo encabezado de solicitud de recuperación, encabezado HTTP, autenticación de URL, certificado, servidor de origen, protocolo de recuperación, redirección forzada, compresión inteligente, parámetro URL de caché, IPv6, edad de caché de código de estado, Recuperación basada en rango, lista negra o lista blanca de agente de usuario, reescritura de URL de solicitud de recuperación y configuración de página de error personalizada.

URI

PUT /v1.1/cdn/configuration/domains/{domain_name}/configs

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

domain_name

String

Especifica el nombre de dominio acelerado.

Tabla 2 Parámetros de Query

Parámetro

Obligatorio

Tipo

Descripción

enterprise_project_id

No

String

Proyecto de empresa al que pertenece el nombre de dominio que se va a modificar. 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

Tabla 3 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 4 Parámetros de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

configs

No

Configs object

Elementos de configuración.

Tabla 5 Configs

Parámetro

Obligatorio

Tipo

Descripción

origin_request_header

No

Array of OriginRequestHeader objects

Configuración de encabezado de solicitud de recuperación. La configuración original de todos los encabezados se sobrescribirá. Cuando utilice esta API, cargue información de todos los encabezados.

http_response_header

No

Array of HttpResponseHeader objects

Configuración de encabezado HTTP. La configuración original de todos los encabezados se sobrescribirá. Cuando utilice esta API, cargue información de todos los encabezados.

url_auth

No

UrlAuth object

Firma de URL.

https

No

HttpPutBody object

Configuración del certificado.

sources

No

Array of SourcesConfig objects

Configuración del servidor de origen.

origin_protocol

No

String

Protocolo de recuperación de contenido. Valores posibles: follow (igual que las peticiones del usuario), http (HTTP, valor predeterminado) y https (HTTPS).

force_redirect

No

ForceRedirectConfig object

Forzar redireccionamiento.

compress

No

Compress object

Compresión inteligente.

cache_url_parameter_filter

No

CacheUrlParameterFilter object

Configuración para almacenar en caché los parámetros de URL.

ipv6_accelerate

No

Integer

Configuración de IPv6 (1: habilitado; 0: deshabilitado).

error_code_cache

No

Array of ErrorCodeCache objects

Vigencia de la caché del código de estado.

origin_range_status

No

String

Recuperación basada en rango, es decir, recuperación de contenido basada en segmentos. Para habilitar la recuperación basada en rango, el servidor de origen debe admitir solicitudes de rango, es decir, solicitudes con el campo Rango en los encabezados. De lo contrario, la recuperación de contenido puede fallar. on: Habilitarlo. off: Desactivarlo.

user_agent_filter

No

UserAgentFilter object

Lista negra o lista blanca del agente de usuario.

origin_request_url_rewrite

No

Array of OriginRequestUrlRewrite objects

Reescritura de URL de solicitud de recuperación. Se pueden configurar hasta 20 URLs.

error_code_redirect_rules

No

Array of ErrorCodeRedirectRules objects

Página de error personalizada.

Tabla 6 OriginRequestHeader

Parámetro

Obligatorio

Tipo

Descripción

name

String

Encabezado de solicitud de recuperación. Un encabezado contiene de 1 a 64 caracteres, incluyendo letras, dígitos y guiones (-).

value

No

String

Valor del encabezado de solicitud de recuperación. Este parámetro es opcional para la operación de eliminación. Un valor contiene de 1 a 512 caracteres. Las variables, por ejemplo, $client_ip y $remote_port, no son compatibles.

action

String

Tipo de operación del encabezado de solicitud de recuperación.El valor se puede eliminar o establecer. set: Si el encabezado no existe en la solicitud de recuperación original, agregue el encabezado antes de establecer su valor.

Tabla 7 HttpResponseHeader

Parámetro

Obligatorio

Tipo

Descripción

name

String

Encabezado de respuesta HTTP. Valores posibles: Content-Disposition, Content-Language, Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Max-Age, Access-Control-Expose-Headers, o custom headers. Un encabezado contiene de 1 a 100 caracteres, incluyendo letras, dígitos y guiones (-) y comienza con una letra.

value

No

String

Valor del encabezado de respuesta HTTP. Un valor contiene de 1 a 256 caracteres, incluidas letras, dígitos y caracteres especiales (.-_*#!%&+|^~'/:;,=@?).

action

String

Tipo de operación del encabezado de respuesta HTTP. El valor se puede establecer o eliminar. Algunos encabezados solo se pueden establecer. Algunos encabezados personalizados no se pueden eliminar ni establecer.

Tabla 8 UrlAuth

Parámetro

Obligatorio

Tipo

Descripción

status

String

Estado del método de firma de URL A/B/C. El valor puede estar off o on.

type

No

String

Método de firma type_a:Método A type_b:Método B type_c1:Método C1 type_c2:Método C2

key

No

String

Una clave de autenticación contiene de 6 a 32 caracteres, incluyendo letras y dígitos.

time_format

No

String

Formato de tiempo. dec:Decimal hex:Hexadecimal Método A:Solo se admite el formato decimal. Método B: Solo se admite el formato decimal. Método C1: Solo se admite el formato hexadecimal. Método C2: Los formatos decimal y hexadecimal son compatibles.

expire_time

No

Integer

Tiempo de caducidad. El valor varía de 0 a 31536000, en segundos.

Tabla 9 HttpPutBody

Parámetro

Obligatorio

Tipo

Descripción

https_status

No

String

Si se debe habilitar HTTPS. on: activado; off: desactivado.

certificate_name

No

String

Nombre del certificado. El valor contiene de 3 a 32 caracteres. Este parámetro es obligatorio cuando se configura un certificado.

certificate_value

No

String

Contenido del certificado utilizado por el protocolo HTTPS. Este parámetro es obligatorio cuando se configura un certificado. El valor está en formato PEM.

private_key

No

String

Clave privada utilizada por el protocolo HTTPS. Este parámetro es obligatorio cuando se configura un certificado. El valor está en formato PEM.

certificate_source

No

Integer

Tipo de certificado. 1: certificado gestionado por Huawei; 0: su propio certificado. Valor predeterminado: 0. Este parámetro es obligatorio cuando se configura un certificado.

http2_status

No

String

Si se utiliza HTTP/2. on: sí; off: no. Valor predeterminado: off. Cuando https_status se establece en off, este parámetro no tiene efecto.

tls_version

No

String

Seguridad de la capa de transporte (TLS). Actualmente, TLSv1.0, TLSv1.1, TLSv1.2, y TLSv1.3 son compatibles. De forma predeterminada, todas las versiones están habilitadas. Puede habilitar una sola versión o versiones consecutivas. Para habilitar varias versiones, utilice comas (,) para separar versiones, por ejemplo, TLSv1.1,TLSv1.2.

Tabla 10 SourcesConfig

Parámetro

Obligatorio

Tipo

Descripción

origin_addr

String

Dirección IP o nombre de dominio del servidor de origen.

origin_type

String

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

priority

Integer

Prioridad de servidor de origen. Valores posibles: 70 (primario) y 30 (en espera).

obs_web_hosting_status

No

String

Si desea habilitar el alojamiento de sitios web estático para el bucket OBS. Este parámetro es obligatorio cuando el tipo de servidor de origen es obs_bucket. Valores posibles: off (deshabilitado) y on (habilitado).

http_port

No

Integer

Puerto HTTP. Valor predeterminado: 80.

https_port

No

Integer

Puerto HTTPS. Valor predeterminado: 443.

host_name

No

String

Host de recuperación. El valor predeterminado es el nombre de dominio de aceleración.

Tabla 11 ForceRedirectConfig

Parámetro

Obligatorio

Tipo

Descripción

status

String

Si se debe activar la redirección forzada. Valores posibles: on (activado) y off (desactivado).

type

No

String

Forzar el tipo de redirección. Valores posibles: http (forzar la redirección a HTTP) y https (forzar la redirección a HTTPS).

Tabla 12 Compress

Parámetro

Obligatorio

Tipo

Descripción

status

String

Ya sea para habilitar la compresión inteligente. Valores posibles: on (activado) y off (desactivado).

type

No

String

Tipo de compresión inteligente. Valores posibles: gzip (gzip) y br (Brotli).

Tabla 13 CacheUrlParameterFilter

Parámetro

Obligatorio

Tipo

Descripción

type

No

String

Tipo de operación para almacenar en caché los parámetros de URL. full_url: cache todos los parámetros; ignore_url_params: ignore todos los parámetros; del_args: ignore parámetros de URL específicos; reserve_args: parámetros de URL especificados de reserva.

value

No

String

Valores de parámetros. Múltiples valores están separados por punto y coma (;).

Tabla 14 ErrorCodeCache

Parámetro

Obligatorio

Tipo

Descripción

code

No

Integer

Los códigos de error 400, 403, 404, 405, 414, 500, 501, 502, 503 y 504 están disponibles.

ttl

No

Integer

Vigencia de la caché del código de error, en segundos. The value ranges from 0 to 31,536,000 (365 days each year by default).

Tabla 15 UserAgentFilter

Parámetro

Obligatorio

Tipo

Descripción

type

String

Tipo de lista negra o blanca de agente de usuario. off: La lista negra y la lista blanca del agente de usuario están deshabilitadas. black: Lista negra del agente de usuario. white: Lista blanca del agente de usuario.

value

No

String

Lista negra o lista blanca del agente de usuario. Este parámetro es opcional cuando type se establece en off. Se pueden configurar hasta 10 reglas. Una sola regla contiene hasta 100 caracteres. Las reglas están separadas por comas (,).

Tabla 16 OriginRequestUrlRewrite

Parámetro

Obligatorio

Tipo

Descripción

priority

Integer

Prioridad de una regla de reescritura de URL. La prioridad de una regla es obligatoria y debe ser única. La regla con la prioridad más alta se usará primero para hacer coincidir. La prioridad es un entero que oscila entre 1 y 100. Un número mayor indica una prioridad más alta.

match_type

String

Tipo de coincidencia. all: todos los archivos. file_path: ruta URL. wildcard

source_url

No

String

URL que se va a reescribir. Una URL comienza con una barra (/) y no contiene http://, https://, ni el nombre de dominio. Una URL contiene hasta 512 caracteres. Se admiten comodines (*), por ejemplo, /test/*/*.mp4. Cuando el modo de coincidencia es Path, las cadenas de consulta de la URL original se eliminarán después de reescribir.

target_url

String

Una URL comienza con una barra (/) y no contiene http://, https://, ni el nombre de dominio. Una URL contiene hasta 256 caracteres. El campo n-ésimo comodín (*) se puede sustituir por $n, donde n = 1, 2, 3..., por ejemplo, /newtest/$1/$2.jpg.

Tabla 17 ErrorCodeRedirectRules

Parámetro

Obligatorio

Tipo

Descripción

error_code

String

Código de error de redirección. Actualmente, se admiten los siguientes códigos de estado: 4xx: 400, 403, 404, 405, 414, 416, 451 5xx: 500, 501, 502, 503, 504

target_code

String

Código de estado de redirección. El valor puede ser 301 o 302.

target_link

String

URL de destino para redireccionamiento.

Parámetros de respuesta

Ninguno

Solicitudes de ejemplo

{
  "configs" : {
    "origin_request_header" : [ {
      "name" : "test_name",
      "value" : "test_value",
      "action" : "set"
    } ],
    "http_response_header" : [ {
      "name" : "test_name",
      "value" : "test_value",
      "action" : "set"
    } ],
    "url_auth" : {
      "status" : "off"
    },
    "compress" : {
      "status" : "off"
    },
    "force_redirect" : {
      "status" : "on",
      "type" : "http"
    },
    "origin_protocol" : "follow",
    "sources" : [ {
      "origin_addr" : "192.168.1.1",
      "origin_type" : "ipaddr",
      "priority" : 70,
      "http_port" : 80,
      "https_port" : 443
    } ]
  }
}

Ejemplo de respuestas

Ninguno

Códigos de estado

Código de estado

Descripción

204

OK

Códigos de error

Consulte Códigos de error.

Utilizamos cookies para mejorar nuestro sitio y tu experiencia. Al continuar navegando en nuestro sitio, tú aceptas nuestra política de cookies. Descubre más

Comentarios

Comentarios

Comentarios

0/500

Seleccionar contenido

Enviar el contenido seleccionado con los comentarios