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

Descripción de la operación

Método de solicitud: se admiten 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.
Número máximo de llamadas por usuario: 50 llamadas por segundo.
Para automatizar tareas de actualización o precarga, consulte Scripts para la automatización de actualización y precarga.

Antes de comenzar

Después de enviar un nodo de actualización y ejecutarse correctamente, los recursos en caché correspondientes en los puntos de presencia de CDN quedan invalidados. Cuando envía una nueva solicitud de acceso, el punto de presencia realiza una recuperación desde el origen para obtener los recursos necesarios y los almacena en caché nuevamente. Enviar una gran cantidad de nodos de actualización borra una gran cantidad de caché, lo que provoca picos en el ancho de banda y las solicitudes de recuperación desde el origen, y aumenta la carga en el servidor de origen.
Un nodo de actualización tarda aproximadamente de 5 a 6 minutos en surtir efecto después de enviarse. Si el tiempo de expiración de caché configurado para un archivo o carpeta es inferior a 5 minutos, no necesita realizar una operación de actualización. Espere a que la caché del archivo o carpeta expire y se actualice automáticamente.
Para utilizar un usuario de Resource Access Management (RAM) para realizar operaciones de actualización o precarga, obtenga primero la autorización requerida. Consulte Otorgar permisos de actualización y precarga a un usuario de RAM para completar la autorización.

Cuota de actualización de URL

De forma predeterminada, cada cuenta puede enviar hasta 10,000 solicitudes de actualización de URL y 100 solicitudes de actualización de carpetas por día. La actualización de carpetas incluye subdirectorios. Si el ancho de banda pico diario de su cuenta de Alibaba Cloud supera los 200 Mbit/s, puede solicitar una cuota diaria mayor consultando enviar un ticket. Alibaba Cloud evalúa y configura la cuota según sus requisitos comerciales reales.
De forma predeterminada, cada cuenta puede enviar hasta 20 solicitudes de actualización basadas en expresiones regulares y 100 solicitudes de actualización con filtrado de parámetros por día. Si el ancho de banda pico diario de su cuenta de Alibaba Cloud supera los 10 Gbit/s, puede solicitar una cuota diaria mayor enviando un ticket.
Cada solicitud puede contener hasta 1,000 entradas de actualización de URL, 100 entradas de actualización de carpetas o 1 entrada de actualización basada en expresiones regulares.
Se pueden enviar un máximo de 10,000 entradas de actualización de URL por minuto para un solo nombre de dominio.

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:RefreshObjectCaches

none

*Domain

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ObjectPath	string	Sí	Para enviar varias URL o varias carpetas a la vez, sepárelas con caracteres de salto de línea. El número total de nombres de dominio en todas las URL de un solo nodo enviado no debe exceder 10.	http://example.com/image/1.png http://aliyundoc.com/image/2.png
ObjectType	string	No	El tipo de actualización. Valores válidos: File (predeterminado): URL. Directory: carpeta. Regex: actualización basada en expresiones regulares. IgnoreParams: actualización con filtrado de parámetros. El filtrado de parámetros elimina el carácter `?` y todos los caracteres posteriores a `?` de una URL de solicitud. En una actualización con filtrado de parámetros, usted envía una URL con los parámetros eliminados a través de la API. Luego, la URL enviada se compara con las URL de recursos en caché después de eliminar sus parámetros. Si una URL de recurso en caché coincide con la URL enviada después del filtrado de parámetros, el punto de presencia de CDN ejecuta una actualización en el recurso en caché. Nota Para consultar la descripción de las funciones de actualización de URL y actualización de carpetas, consulte Actualizar y precargar recursos. Una actualización de archivo elimina directamente el recurso del punto de presencia. Cuando llega una nueva solicitud, se recupera el recurso más reciente mediante la recuperación desde el origen. Otros tipos de actualización solo actualizan los recursos modificados de forma predeterminada. Para forzar una actualización, establezca el parámetro Force en true. Para obtener más información, consulte la descripción de la métrica del parámetro Force.	File
Force	boolean	No	Especifica si se debe eliminar directamente la caché en los puntos de presencia de CDN. Valor predeterminado: false. true: elimina directamente la caché en los puntos de presencia de CDN. Esto significa que los recursos en caché especificados se eliminan inmediatamente de todos los puntos de presencia de CDN. La siguiente solicitud del recurso debe acceder al servidor de origen para recuperar la versión más reciente, que luego se almacena en caché nuevamente. Esto garantiza que todas las solicitudes subsiguientes devuelvan el contenido más reciente después de la eliminación. Esta opción es adecuada para escenarios que requieren actualizaciones inmediatas de caché, como correcciones de emergencia de vulnerabilidades de seguridad o la publicación de actualizaciones críticas. Tenga en cuenta que esto puede aumentar temporalmente la carga en el servidor de origen porque todas las solicitudes relacionadas necesitan acceder al servidor de origen. false: marca la caché en los puntos de presencia de CDN como expirada. Después de marcar un recurso en caché como expirado, la siguiente solicitud del recurso activa el punto de presencia de CDN para autenticar la versión más reciente mediante la recuperación desde el origen. Si la versión coincide con la caché actual, el recurso en caché se devuelve directamente. De lo contrario, se recupera el recurso más reciente mediante la recuperación desde el origen, se devuelve al usuario y se almacena en caché nuevamente. Este método permite actualizaciones graduales de la caché en lugar de una purga completa inmediata. Es adecuado para escenarios que requieren transiciones suaves y reduce el aumento de carga en el servidor de origen que podría resultar de eliminar una gran cantidad de caché a la vez. Nota Este parámetro solo surte efecto cuando utiliza actualización de carpetas, actualización basada en expresiones regulares o actualización con filtrado de parámetros.	false
ReplicaTag	string	No	Este parámetro no está activo.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RefreshTaskId	string	El ID de nodo devuelto para la solicitud de actualización. Varios ID de nodo se separan con comas (,). Los ID de nodo devueltos se combinan según las siguientes reglas: Los nodos de actualización (a nivel de URL) enviados para el mismo nombre de dominio dentro del mismo segundo se combinan en un solo RefreshTaskId. Si se envían más de 2,000 nodos de actualización (a nivel de URL) para el mismo nombre de dominio dentro del mismo segundo, se combinan en grupos de 2,000, y a cada grupo se le asigna un RefreshTaskId independiente.	704222901
RequestId	string	El ID de la solicitud.	D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RefreshTaskId": "704222901",
  "RequestId": "D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}

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	InvalidObjectType.Malformed	The specified ObjectType is invalid.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.
400	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.	Refresh quantity exceeds daily quota limit.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.
400	QuotaPerMinuteExceeded.Refresh	You tried to refresh too frequently, please try again later.
400	TooMany.Refresh	The refresh queue is full, please try again later.
429	TooManyRequests	Too many requests, please try again later

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.