curl --request GET \
--url https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images \
--header 'Authorization: Bearer <token>'import requests
url = "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images', 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}/images",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"images": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"digest": "sha256:1f3c9e0b8d7a6f5e4c3b2a190807f6e5d4c3b2a1908f7e6d5c4b3a2019f8e7d6c",
"media_type": "application/vnd.oci.image.manifest.v1+json",
"tags": [
"v1.4.2",
"latest"
],
"size_bytes": 87654321,
"is_index": true,
"pushed_at": "2023-11-07T05:31:56Z",
"artifact_type": "application/vnd.oci.image.config.v1+json",
"config_digest": "<string>",
"subject": "<string>",
"manifest_size_bytes": 123,
"last_pulled_at": "2023-11-07T05:31:56Z"
}
],
"meta": {
"total": 150,
"limit": 20,
"marker": "550e8400-e29b-41d4-a716-446655440000",
"has_more": true
}
}{
"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"
}
}Listar imágenes
Lista los manifiestos y sus etiquetas. Use tag_status=untagged para encontrar imágenes sin etiquetas tras mover una etiqueta como :latest.
curl --request GET \
--url https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images \
--header 'Authorization: Bearer <token>'import requests
url = "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images', 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}/images",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://registry.{region}.basaltic.sh/v1/repositories/{repository_id}/images")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"images": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"digest": "sha256:1f3c9e0b8d7a6f5e4c3b2a190807f6e5d4c3b2a1908f7e6d5c4b3a2019f8e7d6c",
"media_type": "application/vnd.oci.image.manifest.v1+json",
"tags": [
"v1.4.2",
"latest"
],
"size_bytes": 87654321,
"is_index": true,
"pushed_at": "2023-11-07T05:31:56Z",
"artifact_type": "application/vnd.oci.image.config.v1+json",
"config_digest": "<string>",
"subject": "<string>",
"manifest_size_bytes": 123,
"last_pulled_at": "2023-11-07T05:31:56Z"
}
],
"meta": {
"total": 150,
"limit": 20,
"marker": "550e8400-e29b-41d4-a716-446655440000",
"has_more": true
}
}{
"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"
}
}registry:DescribeImages. 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
"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
Parámetros de consulta
Restringe a un conjunto. untagged encuentra imágenes que perdieron sus etiquetas tras moverlas.
tagged, untagged, any "untagged"
Devuelve solo imágenes con una etiqueta que empiece por este prefijo.
"prod-"
ID del último elemento de la página anterior.
"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
Cantidad máxima de elementos devueltos.
1 <= x <= 20050

