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

Descrição da operação

Método de solicitação: há suporte para solicitações POST. Os parâmetros são exibidos em um formulário.
Operações relacionadas: as operações de atualização e prefetch incluem a operação de atualização RefreshObjectCaches e a operação de prefetch PushObjectCache.
Cota diária de prefetch de URL: por padrão, cada conta pode enviar até 1.000 tarefas de prefetch de URL por dia. Se a largura de banda de pico diária da sua conta exceder 200 Mbit/s, você pode abrir um ticket para solicitar uma cota diária maior. O Alibaba Cloud avalia e configura a cota com base nos seus requisitos reais de negócios.
Você pode enviar até 100 tarefas de prefetch de URL por vez.
Regras da fila de prefetch: o tamanho máximo da fila de prefetch para cada conta é de 100.000 URLs. O CDN faz o prefetch das URLs na ordem em que são enviadas. Quando o número de URLs com prefetch pendente na fila atinge 100.000, o CDN rejeita novas tarefas de prefetch.
Número máximo de vezes que cada usuário pode chamar esta operação por segundo: 50.
Para automatizar tarefas de atualização ou prefetch, consulte Scripts para atualização e prefetch.

Antes de começar

Após um nó de prefetch ser enviado e executado com sucesso, os pontos de presença realizam imediatamente a busca na origem para carregar os recursos necessários. O envio de um grande número de nós de prefetch gera muitos nós de download simultâneos, o que causa um aumento na largura de banda e nas solicitações de busca na origem e aumenta a carga no servidor de origem.
O tempo real de execução de um nó de prefetch, do envio à conclusão, depende do tamanho do arquivo pré-carregado e geralmente leva de 5 a 30 minutos. Quanto menor o tamanho médio do arquivo, mais rápido será o prefetch.
Para usar um usuário do Resource Access Management (RAM) para realizar operações de atualização ou prefetch, obtenha primeiro a autorização necessária. Consulte Conceder permissões a um usuário do RAM para atualização e prefetch para concluir a autorização.
O cabeçalho padrão transportado em uma solicitação de prefetch é Accept-Encoding:gzip. Para transportar outros cabeçalhos em solicitações de prefetch ou implementar prefetch de múltiplas cópias, use o parâmetro de solicitação WithHeader para personalizar os cabeçalhos de prefetch.
Durante o prefetch, se o servidor de origem retornar um código de status de redirecionamento, como 307, o nó de prefetch não seguirá a URL de redirecionamento para concluir o prefetch, o que causará falha no prefetch. Se o servidor de origem retornar um código de status 301 ou 302 e o redirecionamento 302 estiver ativado no CDN, o prefetch 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

*Domain

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ObjectPath	string	Sim	A URL para prefetch. O formato é nome de domínio acelerado/arquivo para prefetch. Nota Separe várias URLs com quebras de linha. Cada URL pode ter até 1.024 caracteres.	http://example.com/image/1.png http://example.org/image/2.png
Area	string	Não	A região de prefetch. Valores válidos: domestic: apenas a parte continental da China. overseas: global (exceto a parte continental da China). Se você não definir este parâmetro, a região de prefetch padrão será a região de aceleração do CDN configurada para o seu nome de domínio. Nota Para definir a região de prefetch como global, certifique-se de que a região de aceleração do nome de domínio acelerado esteja definida como global e, em seguida, deixe este parâmetro vazio.	domestic
L2Preload	boolean	Não	Especifica se o conteúdo deve ser pré-carregado diretamente para os nós L2. Valores válidos: true: os níveis de nó de prefetch devem incluir nós L2. false: apenas os nós da camada de retorno à origem passam por prefetch. Este é o valor padrão. Os nós da camada de retorno à origem podem ser nós L2 ou L3.	true
WithHeader	string	Não	O cabeçalho padrão transportado em uma solicitação de prefetch é Accept-Encoding:gzip. Para transportar outros cabeçalhos em solicitações de prefetch ou implementar prefetch de múltiplas cópias, use este parâmetro para personalizar os cabeçalhos de prefetch. Envie o valor no formato JSON. Nota Para excluir o cabeçalho Accept-Encoding durante o prefetch, envie o seguinte: {"Accept-Encoding": [" "]}.	{ "Accept-Encoding": [ "gzip, deflate, br" ] }
QueryHashkey	boolean	Não	Especifica se o modo de consulta de hashkey deve ser ativado ao executar tarefas de prefetch. Valores válidos: false: modo padrão. Este modo é usado quando o parâmetro não é especificado. A URL enviada é usada diretamente como a hashkey do arquivo pré-carregado. true: consulta a hashkey real usada pela URL de prefetch 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 prefetch baseado em hash. Isso implementa a convergência regional de retorno à origem e reduz a largura de banda de retorno à origem gerada pelo prefetch. true: ativa o prefetch baseado em hash. false: comportamento padrão. O prefetch baseado em hash não está ativado. Importante Este parâmetro só entra em vigor 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 prefetch. 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 prefetch (na granularidade de URL) enviadas para o mesmo nome de domínio dentro do mesmo segundo são mescladas em um único PushTaskId. Se mais de 500 tarefas de prefetch (na granularidade de URL) forem enviadas para o mesmo nome de domínio dentro do mesmo segundo, elas serão mescladas em valores PushTaskId em lotes de 500.	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.	The maximum number of URL prefetches on the current day is exceeded.
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.	The number of submitted URLs exceeds the maximum limit.
400	InvalidCustomHeader	Parse preload header failed.	Custom header parsing error.
429	TooManyRequests	System load fluctuates, please try again later.	System load fluctuates, please try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.