Enable OCI registry

POST

/api/v1/registries/oci/{id}/enable

const url = 'http://localhost:3000/api/v1/registries/oci/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/enable';
const options = {method: 'POST', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url http://localhost:3000/api/v1/registries/oci/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/enable \
  --header 'X-API-Key: <X-API-Key>'

Enables an OCI registry.

Authorizations

api-key
bearer

Parameters

Path Parameters

required

string format: uuid

OCI registry UUID

Responses

200

OCI registry enabled successfully

application/json

object

required

Unique identifier

string

organizationId

required

Organization ID that owns this registry

string

name

required

Registry name

string

description

Registry description

string

nullable

url

required

OCI registry URL

string

registryType

required

Registry type

string

Allowed values: GENERIC

authType

required

Authentication type

string

Allowed values: NONE BASIC TOKEN

hasCredentials

required

Whether credentials are configured

boolean

verifyTls

required

Whether TLS verification is enabled

boolean

lastHealthCheck

Last health check timestamp

string format: date-time

nullable

healthStatus

Health status (healthy, unhealthy, unknown)

string

nullable

lastSyncAt

Last sync timestamp

string format: date-time

nullable

lastSyncError

Last sync error message

string

nullable

syncIntervalMinutes

required

Sync interval in minutes

number

enabled

required

Whether the registry is enabled

boolean

repositories

required

Explicit repository list used for sync. When non-empty, /v2/_catalog discovery is skipped.

Array<string>

createdAt

required

Creation timestamp

string format: date-time

updatedAt

required

Last update timestamp

string format: date-time

Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "organizationId": "550e8400-e29b-41d4-a716-446655440001",
  "name": "my-container-registry",
  "description": "Production container images",
  "url": "https://registry.example.com",
  "registryType": "GENERIC",
  "authType": "NONE",
  "hasCredentials": false,
  "verifyTls": true,
  "lastHealthCheck": "2024-01-15T10:30:00Z",
  "healthStatus": "healthy",
  "lastSyncAt": "2024-01-15T10:30:00Z",
  "syncIntervalMinutes": 60,
  "enabled": true,
  "repositories": [],
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

401

Unauthorized

403

Forbidden

404

OCI registry not found