Trigger sync for global OCI registry

POST

/api/v1/global-registries/oci/{id}/sync

const url = 'http://localhost:3000/api/v1/global-registries/oci/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sync';
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/global-registries/oci/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sync \
  --header 'X-API-Key: <X-API-Key>'

Triggers a manual sync operation for a global OCI registry. This discovers applications in the registry and imports them to the catalog. Requires Super Admin privileges.

Authorizations

api-key
bearer

Parameters

Path Parameters

required

string format: uuid

OCI registry UUID

Responses

200

Sync operation completed successfully

application/json

object

success

required

Whether the sync operation completed successfully

boolean

registryId

required

The ID of the registry that was synced

string

scope

required

The scope of the sync (always “global” for global registries)

string

Allowed values: global

repositoriesFound

required

Number of OCI repositories found in the registry

number

applicationsFound

required

Number of applications found in the registry

number

applicationsImported

required

Number of new applications imported

number

applicationsUpdated

required

Number of existing applications updated

number

errors

required

Array of error messages encountered during sync

Array<string>

syncDuration

required

Duration of the sync operation in milliseconds

number

Example

{
  "success": true,
  "registryId": "550e8400-e29b-41d4-a716-446655440000",
  "scope": "global",
  "repositoriesFound": 10,
  "applicationsFound": 5,
  "applicationsImported": 2,
  "applicationsUpdated": 3,
  "errors": [],
  "syncDuration": 1234
}

401

Unauthorized

403

Forbidden - Super Admin required

404

OCI registry not found

409

OCI registry is disabled

503

Application service unavailable