PreloadDcdnObjectCaches - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

Descrição da operação

Operações relacionadas: As operações de atualização e pré-carregamento incluem a operação de atualização RefreshDcdnObjectCaches e a operação de pré-carregamento PreloadDcdnObjectCaches.
Método de solicitação: há suporte para solicitações POST. Os parâmetros são exibidos em um formulário.
Cota diária de pré-carregamento de URL: por padrão, cada 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 uma cota diária maior por meio do envio de um ticket. O 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: a fila de pré-carregamento de cada conta pode conter até 100.000 URLs. O DCDN processa as tarefas de pré-carregamento na ordem em que as URLs são enviadas. Quando o número de tarefas pendentes na fila de pré-carregamento atinge 100.000, o DCDN usa um mecanismo de fila. Isso significa que a próxima tarefa de pré-carregamento de URL só pode ser enviada após a conclusão da tarefa de pré-carregamento de URL mais antiga na fila.
Frequência máxima de invocação por usuário: 15 vezes por segundo.

Antes de começar

Após uma tarefa de pré-carregamento ser enviada e executada com êxito, os pontos de presença buscam imediatamente os recursos necessários do servidor de origem por meio de solicitações de retorno à origem. O envio de um grande número de tarefas de pré-carregamento de uma só vez gera muitas tarefas de download simultâneas, o que causa um aumento na largura de banda e nas solicitações de retorno à origem e aumenta a carga no servidor de origem.
O tempo necessário para concluir uma tarefa de pré-carregamento após o envio depende do tamanho do arquivo pré-carregado. Leva aproximadamente de 5 a 30 minutos. Quanto menor o tamanho médio do arquivo, mais rápido será o pré-carregamento.
Para usar um usuário do Resource Access Management (RAM) para realizar operações de atualização e pré-carregamento, obtenha primeiro a autorização necessária. Para obter mais informações, consulte Conceder permissões a um usuário do RAM para atualização e pré-carregamento.

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

dcdn:PreloadDcdnObjectCaches

none

*domain

acs:dcdn:*:{#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. O formato é nome de domínio acelerado/arquivo a ser pré-carregado. Nota Separe várias URLs com quebras de linha. Cada URL pode ter até 1.024 caracteres.	http://example.com/examplefile.txt http://example.com/examplefile2.txt
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 será, por padrão, a região de aceleração do DCDN configurada para o seu nome de domínio: Se a região de aceleração do nome de domínio for Apenas a parte continental da China, a região de pré-carregamento será apenas a parte continental da China. Se a região de aceleração do nome de domínio for Global, a região de pré-carregamento será global. Se a região de aceleração do nome de domínio for Global (exceto a parte continental da China), a região de pré-carregamento será 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 L2. Valores válidos: true: a hierarquia de nós de pré-carregamento deve incluir nós L2. false (padrão): apenas os nós da camada de origem são pré-carregados. Os nós da camada de origem podem ser nós L2 ou nós L3.	true
WithHeader	string	Não	Os cabeçalhos de pré-carregamento personalizados. Especifique o valor no formato JSON.	{ "Accept-Encoding": [ "gzip" ] }
QueryHashkey	boolean	Não	Este parâmetro é usado quando determinadas regras (como reescrita de URL ou filtragem de parâmetros) são configuradas. Especifica se o modo de consulta de hashkey deve ser ativado ao executar tarefas de pré-carregamento. Valores válidos: false: modo padrão. Este modo é usado quando este parâmetro não é especificado. A URL enviada é usada diretamente como o hashkey do arquivo pré-carregado. true: consulta o hashkey real usado pela URL de pré-carregamento com base na configuração do nome de domínio.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PreloadTaskId	string	Os IDs das tarefas 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 no mesmo segundo são mescladas em um único RushTaskId. Se mais de 500 tarefas de pré-carregamento (na granularidade de URL) forem enviadas para o mesmo nome de domínio no mesmo segundo, as tarefas serão mescladas em RushTaskIds em lotes de 500.	95248880
RequestId	string	O ID da solicitação.	E5BD4B50-7A02-493A-AE0B-97B9024B4135

Exemplos

Resposta de sucesso

JSON formato

{
  "PreloadTaskId": "95248880",
  "RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
}

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 refresh attempts have exceeded the daily limit.	The maximum number of refresh and prefetch requests on the current day has been reached.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.	The ObjectPath parameter is set to an invalid value. Specify a valid value and try again.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.	Wildcard domain names are not supported.
400	PreloadQueueFull	The warming queue is full; please try again later.	The maximum number of URLs of the objects that are being prefetched has been reached. Try again later.
400	InvalidObjectPath.ExceedsMaximum	The maximum number of urls is exceeded.	The number of submitted URLs exceeds the maximum limit.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.