Definir política de ciclo de vida
curl --request PUT \
--url https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rules": [
{
"priority": 1,
"selection": {
"count_number": 10,
"tag_prefixes": [
"prod-"
],
"tag_patterns": [
"release-*"
],
"count_unit": "days"
},
"action": "expire",
"description": "Keep the last 10 prod builds"
}
]
}
'import requests
url = "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy"
payload = { "rules": [
{
"priority": 1,
"selection": {
"count_number": 10,
"tag_prefixes": ["prod-"],
"tag_patterns": ["release-*"],
"count_unit": "days"
},
"action": "expire",
"description": "Keep the last 10 prod builds"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
rules: [
{
priority: 1,
selection: {
count_number: 10,
tag_prefixes: ['prod-'],
tag_patterns: ['release-*'],
count_unit: 'days'
},
action: 'expire',
description: 'Keep the last 10 prod builds'
}
]
})
};
fetch('https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'rules' => [
[
'priority' => 1,
'selection' => [
'count_number' => 10,
'tag_prefixes' => [
'prod-'
],
'tag_patterns' => [
'release-*'
],
'count_unit' => 'days'
],
'action' => 'expire',
'description' => 'Keep the last 10 prod builds'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy"
payload := strings.NewReader("{\n \"rules\": [\n {\n \"priority\": 1,\n \"selection\": {\n \"count_number\": 10,\n \"tag_prefixes\": [\n \"prod-\"\n ],\n \"tag_patterns\": [\n \"release-*\"\n ],\n \"count_unit\": \"days\"\n },\n \"action\": \"expire\",\n \"description\": \"Keep the last 10 prod builds\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rules\": [\n {\n \"priority\": 1,\n \"selection\": {\n \"count_number\": 10,\n \"tag_prefixes\": [\n \"prod-\"\n ],\n \"tag_patterns\": [\n \"release-*\"\n ],\n \"count_unit\": \"days\"\n },\n \"action\": \"expire\",\n \"description\": \"Keep the last 10 prod builds\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rules\": [\n {\n \"priority\": 1,\n \"selection\": {\n \"count_number\": 10,\n \"tag_prefixes\": [\n \"prod-\"\n ],\n \"tag_patterns\": [\n \"release-*\"\n ],\n \"count_unit\": \"days\"\n },\n \"action\": \"expire\",\n \"description\": \"Keep the last 10 prod builds\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"policy": {
"rules": [
{
"priority": 1,
"selection": {
"tag_status": "tagged",
"count_type": "image_count_more_than",
"count_number": 10,
"tag_prefixes": [
"prod-"
],
"tag_patterns": [
"release-*"
],
"count_unit": "days"
},
"action": "expire",
"description": "Keep the last 10 prod builds"
}
],
"updated_at": "2023-11-07T05:31:56Z",
"last_evaluated_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Política de ciclo de vida
Definir política de ciclo de vida
Las reglas se evalúan por priority; la primera coincidencia se asigna la imagen y la protege de reglas posteriores. Así, conservar las 10 imágenes prod-* más recientes puede preceder al vencimiento general tras 90 días.
Solo una regla puede usar tag_status: any, y necesita el mayor número de prioridad. Las reglas tagged exigen prefijo o patrón; se rechaza el patrón aislado * para no eludir esa restricción. Instalar la política reinicia last_evaluated_at, pues la nueva configuración aún no se ha evaluado.
PUT
/
v1
/
repositories
/
{repository_id}
/
lifecycle-policy
Definir política de ciclo de vida
curl --request PUT \
--url https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rules": [
{
"priority": 1,
"selection": {
"count_number": 10,
"tag_prefixes": [
"prod-"
],
"tag_patterns": [
"release-*"
],
"count_unit": "days"
},
"action": "expire",
"description": "Keep the last 10 prod builds"
}
]
}
'import requests
url = "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy"
payload = { "rules": [
{
"priority": 1,
"selection": {
"count_number": 10,
"tag_prefixes": ["prod-"],
"tag_patterns": ["release-*"],
"count_unit": "days"
},
"action": "expire",
"description": "Keep the last 10 prod builds"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
rules: [
{
priority: 1,
selection: {
count_number: 10,
tag_prefixes: ['prod-'],
tag_patterns: ['release-*'],
count_unit: 'days'
},
action: 'expire',
description: 'Keep the last 10 prod builds'
}
]
})
};
fetch('https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'rules' => [
[
'priority' => 1,
'selection' => [
'count_number' => 10,
'tag_prefixes' => [
'prod-'
],
'tag_patterns' => [
'release-*'
],
'count_unit' => 'days'
],
'action' => 'expire',
'description' => 'Keep the last 10 prod builds'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy"
payload := strings.NewReader("{\n \"rules\": [\n {\n \"priority\": 1,\n \"selection\": {\n \"count_number\": 10,\n \"tag_prefixes\": [\n \"prod-\"\n ],\n \"tag_patterns\": [\n \"release-*\"\n ],\n \"count_unit\": \"days\"\n },\n \"action\": \"expire\",\n \"description\": \"Keep the last 10 prod builds\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rules\": [\n {\n \"priority\": 1,\n \"selection\": {\n \"count_number\": 10,\n \"tag_prefixes\": [\n \"prod-\"\n ],\n \"tag_patterns\": [\n \"release-*\"\n ],\n \"count_unit\": \"days\"\n },\n \"action\": \"expire\",\n \"description\": \"Keep the last 10 prod builds\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/lifecycle-policy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rules\": [\n {\n \"priority\": 1,\n \"selection\": {\n \"count_number\": 10,\n \"tag_prefixes\": [\n \"prod-\"\n ],\n \"tag_patterns\": [\n \"release-*\"\n ],\n \"count_unit\": \"days\"\n },\n \"action\": \"expire\",\n \"description\": \"Keep the last 10 prod builds\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"policy": {
"rules": [
{
"priority": 1,
"selection": {
"tag_status": "tagged",
"count_type": "image_count_more_than",
"count_number": 10,
"tag_prefixes": [
"prod-"
],
"tag_patterns": [
"release-*"
],
"count_unit": "days"
},
"action": "expire",
"description": "Keep the last 10 prod builds"
}
],
"updated_at": "2023-11-07T05:31:56Z",
"last_evaluated_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Requiere la acción IAM
registry:PutLifecyclePolicy. Consulte REGISTRY permisos para la lista completa, el alcance de cada acción y un ejemplo de política.Autorizaciones
Un token bearer de OAuth 2.0, enviado como Authorization: Bearer <token>. Esta es la forma recomendada de autenticación.
Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en POST /v1/oauth/token con grant_type=client_credentials. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \ https://iam.basaltic.sh/v1/oauth/token
Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación.
Parámetros de ruta
Ejemplo:
"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
Cuerpo
application/json
Maximum array length:
25Show child attributes
Show child attributes
Respuesta
Política almacenada.
Show child attributes
Show child attributes