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

Descrição da operação

Método de solicitação: Solicitações POST são suportadas. 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 RefreshDcdnObjectCaches e a operação de pré-carregamento PreloadDcdnObjectCaches.
Cota de atualização de URLs (diária): Por padrão, cada conta pode enviar até 10.000 solicitações de atualização de URL e 100 solicitações de atualização de diretório por dia. A atualização de diretório inclui subdiretórios. Se a largura de banda de pico diária da sua conta Alibaba Cloud exceder 200 Mbit/s, você pode solicitar uma cota diária maior por meio de envio de ticket. A Alibaba Cloud avaliará e configurará a cota com base nos seus requisitos reais de negócio.
Cada solicitação suporta até 1.000 solicitações de atualização de URL ou 100 solicitações de atualização de diretório.
Um máximo de 10.000 solicitações de atualização de URL podem ser enviadas por minuto para um único nome de domínio.
Frequência máxima de invocação por usuário: 30 vezes por segundo.

Considerações

Após uma tarefa de atualização ser enviada e executada com sucesso, os recursos em cache nos pontos de presença (POPs) do DCDN são invalidados. Quando você envia uma solicitação de acesso novamente, o ponto de presença (POP) recupera os recursos necessários do servidor de origem via back-to-origin e os armazena em cache no POP novamente. O envio de um grande número de tarefas de atualização limpa uma grande quantidade de cache, o que causa picos na largura de banda e nas solicitações de back-to-origin e aumenta a carga no servidor de origem.
Uma tarefa de atualização leva aproximadamente 5 a 6 minutos para entrar em vigor após ser enviada. Se o tempo de vida (TTL) configurado para um arquivo ou diretório for inferior a 5 minutos, você não precisa realizar uma operação de atualização. Aguarde o cache do arquivo ou diretório expirar e ser atualizado automaticamente.
Para usar um usuário Resource Access Management (RAM) para realizar operações de atualização ou pré-carregamento, obtenha autorização primeiro. Para mais informações, consulte Conceder permissões de atualização e pré-carregamento a usuários RAM.

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

none

*domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ObjectPath	string	Sim	Separe múltiplas URLs ou diretórios com quebras de linha ao enviá-los em uma única solicitação. O número total de nomes de domínio em todas as URLs em uma única solicitação não deve exceder 10.	http://example.com/example.txt http://example.com/example2.txt
ObjectType	string	Não	O tipo de atualização. Valores válidos: File (padrão): URL. Directory: atualização de diretório. Regex: atualização baseada em expressão regular. IgnoreParams: purga por URL com parâmetros ignorados. Isso se refere à remoção do `?` e de todos os caracteres após `?` da URL da solicitação. Quando você envia uma URL com parâmetros removidos por meio da API, a URL enviada é comparada com as URLs de recursos em cache após seus parâmetros também serem removidos. Se uma URL de recurso em cache corresponder à URL enviada após a remoção dos parâmetros, o ponto de presença executa uma atualização no recurso em cache. Nota Para a descrição do recurso de atualização de URL e atualização de diretório, consulte Atualizar e pré-carregar recursos. A atualização de arquivo exclui diretamente o recurso no ponto de presença (POP). Quando uma nova solicitação é recebida, o novo recurso é recuperado do servidor de origem via back-to-origin. Outros tipos de atualização atualizam apenas recursos alterados por padrão. Para forçar uma atualização, defina o parâmetro Force como true. Para mais informações, consulte a descrição do parâmetro Force.	File
Force	boolean	Não	Especifica se todos os recursos dentro do escopo correspondente devem ser atualizados quando o conteúdo de back-to-origin é consistente com os recursos do servidor de origem. Valor padrão: false. true: Atualiza todos os recursos dentro do escopo correspondente. Quando "Atualizar Todos os Recursos" é selecionado, se o conteúdo solicitado corresponder a um recurso dentro do escopo correspondente, o ponto de presença (POP) do DCDN recupera o novo recurso do servidor de origem via back-to-origin, retorna-o ao usuário e armazena o recurso em cache novamente. false: Atualiza apenas os recursos alterados dentro do escopo correspondente. Quando "Atualizar Recursos Alterados" é selecionado, se o conteúdo solicitado corresponder a um recurso dentro do escopo correspondente, o ponto de presença (POP) do DCDN recupera as informações de Last-Modified do recurso do servidor de origem via back-to-origin. Se as informações forem consistentes com o recurso atualmente em cache, o recurso em cache é retornado diretamente. Se as informações forem inconsistentes, o novo recurso é recuperado do servidor de origem via back-to-origin, retornado ao usuário e armazenado em cache novamente. Nota Este parâmetro entra em vigor para todos os tipos de atualização, exceto atualização de arquivo.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RefreshTaskId	string	O ID da tarefa retornado para a atualização. Múltiplos IDs são separados por vírgulas (,).	95248880
RequestId	string	O ID da solicitação.	E5BD4B50-7A02-493A-AE0B-97B9024B4135

Exemplos

Resposta de sucesso

JSON formato

{
  "RefreshTaskId": "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	InvalidObjectType.Malformed	The specified ObjectType is invalid.	The ObjectType parameter is set to an invalid value. Specify a valid value and try again.
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	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.	The number of refresh tasks on the current day has reached the upper limit. You can call the refresh API operation to query the remaining number of refresh tasks that you want to run on the current day.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.	Wildcard domain names are not supported.
400	QuotaPerMinuteExceeded.Refresh	You tried to refresh too frequently; please try again later.	Refresh requests are submitted too frequently. Try again later.
400	TooMany.Refresh	The refresh queue is full; please try again later.	The maximum number of refresh requests for a domain name has been reached. Try again later.
429	TooManyRequests	Too many requests, 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.