PushObjectCache - CDN: Central de Documentação do Alibaba Cloud

Descrição da operação

Método de solicitação: suporta solicitações POST. Os parâmetros são exibidos em um formulário.
Operações relacionadas: as operações de atualização e pré-carregamento incluem a operação de atualização RefreshObjectCaches e a operação de pré-carregamento PushObjectCache.
Cota de pré-carregamento de URL (diária): por padrão, uma conta pode enviar até 1.000 tarefas de pré-carregamento de URL por dia. Se a largura de banda de pico diária da sua conta exceder 200 Mbit/s, você pode solicitar o aumento da cota diária usando o envio de um ticket. A Alibaba Cloud avalia e configura a cota com base nos seus requisitos reais de negócios.
Você pode enviar até 100 tarefas de pré-carregamento de URL por vez.
Regras da fila de pré-carregamento: o tamanho máximo da fila de pré-carregamento para cada conta é de 100.000 URLs. O CDN pré-carrega as URLs na ordem em que são enviadas. Quando o número de URLs aguardando para serem pré-carregadas na fila atinge 100.000, o CDN negará novas tarefas de pré-carregamento.
Frequência de invocação por usuário: 50 vezes por segundo.
Para automatizar a atualização ou o pré-carregamento, consulte Scripts em lote para atualização e pré-carregamento.

Precauções

Após uma tarefa de pré-carregamento ser enviada e executada com sucesso, o ponto de presença realiza imediatamente uma busca na origem para carregar os recursos necessários. Portanto, o envio de um grande número de tarefas de pré-carregamento gera muitas tarefas de download simultâneas, o que causa um aumento repentino na largura de banda e nas solicitações de busca na origem, além de aumentar a carga no servidor de origem.
O tempo real de execução, desde o envio até a conclusão de uma tarefa de pré-carregamento, depende do tamanho dos arquivos pré-carregados e leva de 5 a 30 minutos. Quanto menor o tamanho médio do arquivo, mais rápida será a velocidade de pré-carregamento.
Se você usar um usuário do Resource Access Management (RAM) para realizar operações de atualização ou pré-carregamento, precisará obter autorização primeiro. Para mais informações, consulte Conceder a um usuário do RAM as permissões para atualizar e pré-carregar recursos para concluir a autorização.
Por padrão, as solicitações de pré-carregamento carregam o cabeçalho Accept-Encoding:gzip. Se você precisar que as solicitações de pré-carregamento carreguem outros cabeçalhos ou implementem o pré-carregamento de múltiplas réplicas, poderá usar o parâmetro de solicitação WithHeader para personalizar os cabeçalhos de pré-carregamento.
Durante o pré-carregamento, se o servidor de origem retornar códigos de status relacionados a redirecionamento, como 307, a tarefa de pré-carregamento não seguirá o endereço de redirecionamento para continuar o pré-carregamento, o que resulta em uma falha na tarefa. Se o servidor de origem retornar um código de status 301 ou 302 e o recurso de redirecionamento 301/302 estiver ativado no ponto de presença, o pré-carregamento normal não será afetado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cdn:PushObjectCache

none

*Domínio.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ObjectPath	string	Sim	As URLs a serem pré-carregadas. Formato: nome de domínio acelerado/arquivo a ser pré-carregado. Nota Separe várias URLs com quebras de linha. O comprimento máximo de um único ObjectPath é de 1.024 caracteres.	http://example.com/image/1.png http://example.org/image/2.png
Area	string	Não	A região de pré-carregamento. Valores válidos: domestic: apenas a parte continental da China overseas: global (exceto a parte continental da China) Se você não especificar este parâmetro, a região de pré-carregamento padrão será a região de aceleração de CDN configurada para o seu nome de domínio. Nota Se você quiser definir a região de pré-carregamento como global, certifique-se de que a região de aceleração do nome de domínio acelerado esteja definida como global e não especifique este parâmetro. Valores válidos: domestic : Apenas a parte continental da China. overseas : Global (exceto a parte continental da China).	domestic
L2Preload	boolean	Não	Especifica se o conteúdo deve ser pré-carregado diretamente para os nós da Camada 2 (L2). Valores válidos: true: pré-carrega o conteúdo para os nós L2. false: pré-carrega o conteúdo apenas para os nós de busca na origem. Este é o valor padrão. Os nós de busca na origem podem ser nós L2 ou da Camada 3 (L3).	true
WithHeader	string	Não	Por padrão, as solicitações de pré-carregamento carregam o cabeçalho Accept-Encoding:gzip. Se você precisar que as solicitações de pré-carregamento carreguem outros cabeçalhos ou implementem o pré-carregamento de múltiplas réplicas, poderá usar este parâmetro para personalizar os cabeçalhos de pré-carregamento. Envie o valor no formato JSON. Nota Se você não precisar do cabeçalho Accept-Encoding durante o pré-carregamento, envie o valor da seguinte forma: {"Accept-Encoding": [" "]}	{ "Accept-Encoding": [ "gzip, deflate, br" ] }
QueryHashkey	boolean	Não	Especifica se o modo de consulta de chave de hash deve ser ativado ao executar tarefas de pré-carregamento. Valores válidos: false: o modo padrão. Usado quando este parâmetro não é especificado. A URL enviada é usada diretamente como a chave de hash do arquivo pré-carregado. true: consulta a chave de hash real usada para a URL de pré-carregamento com base na configuração do nome de domínio.	true
ConsistencyHash	boolean	Não	Se a região de aceleração do nome de domínio for a parte continental da China e a busca na origem baseada em hash estiver ativada, você poderá usar este parâmetro para ativar o pré-carregamento baseado em hash. Isso implementa a convergência de busca na origem regional e reduz a largura de banda de retorno à origem gerada pelo pré-carregamento. Valores válidos: true: ativa o pré-carregamento baseado em hash. false: a lógica padrão. O pré-carregamento baseado em hash está desativado. Importante Este parâmetro é válido apenas para nomes de domínio cuja região de aceleração é a parte continental da China.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PushTaskId	string	O ID da tarefa de pré-carregamento. Vários IDs de tarefa são separados por vírgulas (,). Os IDs de tarefa retornados são mesclados com base nas seguintes regras: As tarefas de pré-carregamento (na granularidade de URL) enviadas para o mesmo nome de domínio dentro do mesmo segundo são mescladas no mesmo PushTaskId. Se o número de tarefas de pré-carregamento (na granularidade de URL) enviadas para o mesmo nome de domínio dentro do mesmo segundo exceder 500, as tarefas serão mescladas em um PushTaskId para cada 500 tarefas.	9524xxxx
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	QuotaExceeded.Preload	Your preload attempts have exceeded the daily limit.	A cota diária de pré-busca foi excedida.
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.	O número de URLs enviadas excede o limite máximo.
400	InvalidCustomHeader	Parse preload header failed.	Ocorreu um erro ao analisar o cabeçalho personalizado.
429	TooManyRequests	System load fluctuates, please try again later.	O servidor está ocupado. Tente novamente mais tarde.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.