PushObjectCache - CDN - Centro de documentación de Alibaba Cloud

Descripción de la operación

Método de solicitud: Admite solicitudes POST. Los parámetros se muestran en un formulario.
Operaciones relacionadas: Las operaciones de actualización y precarga incluyen la operación de actualización RefreshObjectCaches y la operación de precarga PushObjectCache.
Cuota de precarga de URL (diaria): De forma predeterminada, una cuenta puede enviar hasta 1,000 tareas de precarga de URL por día. Si el ancho de banda máximo diario de su cuenta supera los 200 Mbit/s, puede solicitar un aumento de la cuota diaria mediante el envío de un ticket. Alibaba Cloud evalúa y configura la cuota en función de sus requisitos comerciales reales.
Puede enviar hasta 100 tareas de precarga de URL a la vez.
Reglas de la cola de precarga: El tamaño máximo de la cola de precarga para cada cuenta es de 100,000 URL. CDN precarga las URL en el orden en que se envían. Cuando el número de URL en espera de precarga en la cola alcanza las 100,000, CDN rechazará las nuevas tareas de precarga.
Frecuencia de invocación por usuario: 50 veces por segundo.
Para automatizar la actualización o la precarga, consulte Scripts por lotes para actualización y precarga.

Precauciones

Después de enviar y ejecutar correctamente una tarea de precarga, el punto de presencia realiza inmediatamente una solicitud al origen para cargar los recursos necesarios. Por lo tanto, enviar una gran cantidad de tareas de precarga genera muchas tareas de descarga simultáneas, lo que provoca un aumento repentino en el ancho de banda y las solicitudes al origen, y aumenta la carga en el servidor de origen.
El tiempo de ejecución real desde el envío hasta la finalización de una tarea de precarga depende del tamaño de los archivos precargados y tarda entre 5 y 30 minutos aproximadamente. Cuanto menor sea el tamaño promedio del archivo, más rápida será la velocidad de precarga.
Si utiliza un usuario de Resource Access Management (RAM) para realizar operaciones de actualización o precarga, primero debe obtener la autorización. Para obtener más información, consulte Otorgar a un usuario de RAM los permisos para actualizar y precargar recursos para completar la autorización.
De forma predeterminada, las solicitudes de precarga incluyen el encabezado Accept-Encoding:gzip. Si necesita que las solicitudes de precarga incluyan otros encabezados o implementar la precarga de múltiples réplicas, puede utilizar el parámetro de solicitud WithHeader para personalizar los encabezados de precarga.
Durante la precarga, si el servidor de origen devuelve códigos de estado relacionados con la redirección, como 307, la tarea de precarga no sigue la dirección de redirección para continuar con la precarga, lo que finalmente resulta en un error en la tarea de precarga. Si el servidor de origen devuelve un código de estado 301 o 302 y la función de redirección 301/302 está habilitada en el punto de presencia, la precarga normal no se ve afectada.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

cdn:PushObjectCache

none

*Domain.

acs:cdn:*:{#accountId}:domain/{#DomainName}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ObjectPath	string	Sí	Las URL a precargar. Formato: nombre de dominio acelerado/archivo a precargar. Nota Separe varias URL con saltos de línea. La longitud máxima de un solo ObjectPath es de 1,024 caracteres.	http://example.com/image/1.png http://example.org/image/2.png
Area	string	No	La región de precarga. Valores válidos: domestic: solo China continental overseas: global (excluida China continental) Si no especifica este parámetro, la región de precarga predeterminada es la región de aceleración de CDN configurada para su nombre de dominio. Nota Si desea establecer la región de precarga en global, asegúrese de que la región de aceleración del nombre de dominio acelerado esté establecida en global y no especifique este parámetro. Valores válidos: domestic : Solo China continental. overseas : Global (excluida China continental).	domestic
L2Preload	boolean	No	Especifica si se debe precargar contenido directamente en los nodos de capa 2 (L2). Valores válidos: true: Precarga contenido en los nodos L2. false: Precarga contenido solo en los nodos de solicitud al origen. Este es el valor predeterminado. Los nodos de solicitud al origen pueden ser nodos L2 o de capa 3 (L3).	true
WithHeader	string	No	De forma predeterminada, las solicitudes de precarga incluyen el encabezado Accept-Encoding:gzip. Si necesita que las solicitudes de precarga incluyan otros encabezados o implementar la precarga de múltiples réplicas, puede utilizar este parámetro para personalizar los encabezados de precarga. Envíe el valor en formato JSON. Nota Si no necesita el encabezado Accept-Encoding durante la precarga, envíe el valor de la siguiente manera: {"Accept-Encoding": [" "]}	{ "Accept-Encoding": [ "gzip, deflate, br" ] }
QueryHashkey	boolean	No	Especifica si se debe habilitar el modo de consulta de clave hash al ejecutar tareas de precarga. Valores válidos: false: El modo predeterminado. Se utiliza cuando no se especifica este parámetro. La URL enviada se utiliza directamente como clave hash del archivo precargado. true: Consulta la clave hash real utilizada para la URL de precarga en función de la configuración del nombre de dominio.	true
ConsistencyHash	boolean	No	Si la región de aceleración del nombre de dominio es China continental y la solicitud al origen basada en hash está habilitada, puede utilizar este parámetro para habilitar la precarga basada en hash. Esto implementa la convergencia de solicitudes al origen regionales y reduce el ancho de banda de retorno al origen generado por la precarga. Valores válidos: true: Habilita la precarga basada en hash. false: La lógica predeterminada. La precarga basada en hash está deshabilitada. Importante Este parámetro solo es válido para nombres de dominio cuya región de aceleración es China continental.	true

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
PushTaskId	string	El ID de la tarea de precarga. Los ID de múltiples tareas se separan con comas (,). Los ID de tareas devueltos se fusionan según las siguientes reglas: Las tareas de precarga (a nivel de URL) enviadas para el mismo nombre de dominio dentro del mismo segundo se fusionan en el mismo PushTaskId. Si el número de tareas de precarga (a nivel de URL) enviadas para el mismo nombre de dominio dentro del mismo segundo supera las 500, las tareas se fusionan en un PushTaskId por cada 500 tareas.	9524xxxx
RequestId	string	El ID de la solicitud.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Ejemplos

Respuesta exitosa

JSON Formato

{
  "PushTaskId": "9524xxxx",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	QuotaExceeded.Preload	Your preload attempts have exceeded the daily limit.	Se ha superado la cuota diaria de precarga.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.
400	PreloadQueueFull	The warming queue is full,please try again later.
400	QuotaPerMinuteExceeded.Refresh	You have exceeded the prescribed preload limits per minute.
400	InvalidObjectPath.ExceedsMaximum	The maximum number of urls is exceeded.	El número de URL enviadas supera el límite máximo.
400	InvalidCustomHeader	Parse preload header failed.	Ocurrió un error al analizar el encabezado personalizado.
429	TooManyRequests	System load fluctuates, please try again later.	El servidor está ocupado. Inténtelo de nuevo más tarde.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.