Skip to main content
POST
Criar regra de cache de imagens
Exige a ação IAM registry:CreatePullThroughCacheRule. Veja REGISTRY permissões para a lista completa, o escopo de cada ação e um exemplo de política.

Autorizações

Authorization
string
header
obrigatório

Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.

Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.

Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.

Cabeçalhos

Idempotency-Key
string

Chave opcional gerada pelo cliente que torna uma criação segura para reprodução. A reintentar uma solicitação com a mesma chave retorna o resultado original literalmente em vez de criar um recurso duplicado. A reutilização de uma chave com um corpo de solicitação diferente é rejeitada (422); uma solicitação cuja chave ainda está sendo processada retorna 409. Os registros são honrados por 24 horas. Use um UUID ou token exclusivo semelhante.

Maximum string length: 255

Corpo

application/json
prefix
string
obrigatório

Um ou dois componentes minúsculos de nome de repositório. Formam o início do caminho de todos os repositórios criados pela regra.

Exemplo:

"hub"

upstream_registry
string
obrigatório

Hostname com porta opcional. O prefixo https:// é aceito e removido; outros esquemas são recusados porque a conexão pode transportar credenciais.

Exemplo:

"docker.io"

upstream_prefix
string

Caminho opcional adicionado antes do nome na origem.

Exemplo:

"library"

upstream_username
string

Opcional. Autenticar no Docker Hub pode aumentar os limites de pull mesmo para imagens públicas.

upstream_secret
string<password>

Senha ou token somente para escrita, criptografado em repouso e nunca retornado. Obrigatório junto com upstream_username; credenciais parciais são rejeitadas.

Resposta

Regra criada. Nenhum conteúdo foi buscado.

pull_through_cache_rule
object
obrigatório