cdnca

API reference

/v1/admin/system-cleanup-settings

2 operations

← All groups · First call? Read the tutorial: auth, permissions, requests and responses, common failures

MethodPathSummaryAuth
GET/v1/admin/system-cleanup-settingsRead platform cleanup and backup settingsSession
PUT/v1/admin/system-cleanup-settingsUpdate platform cleanup and backup settingsSession

Contract file：api/control-system-cleanup-settings.openapi.yaml

Operation details

GET /v1/admin/system-cleanup-settings

Read platform cleanup and backup settings

operationId
getPlatformSystemCleanupSettings
Auth
  • Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
Required permissions

All of：system_configuration.read

Responses

getPlatformSystemCleanupSettings Responses
StatusDescription
200Current retention and backup policy

Fields：schema: const cdnca.platform-system-cleanup-settings/v1 revision: integer updated_at?: string(date-time) value: Settings

401Unauthenticated
403Permission denied
500Unexpected internal failure
503Settings storage or policy is unavailable

What to do on failure

  • 401 Check the credential format and whether it expired or was rotated.
  • 403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.
  • 500 Outcome unknown: read back by ID or list first, then decide whether to retry with the original Idempotency-Key.
  • 503 A dependency is unavailable: retry later with the original Idempotency-Key.

↑ Back to list

PUT /v1/admin/system-cleanup-settings

Update platform cleanup and backup settings

operationId
updatePlatformSystemCleanupSettings
Auth
  • Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
Required permissions

All of：system_configuration.manage

Parameters

updatePlatformSystemCleanupSettings Parameters
NameInTypeRequiredDescription
If-MatchheaderstringYes—
Idempotency-KeyheaderstringYes—
X-Request-IDheaderstringYes—

Request body

application/json · Required：Yes

updatePlatformSystemCleanupSettings Request body
NameTypeRequiredDescription
valueSettingsYes—

Responses

updatePlatformSystemCleanupSettings Responses
StatusDescription
200Saved policy

Fields：schema: const cdnca.platform-system-cleanup-settings/v1 revision: integer updated_at?: string(date-time) value: Settings

400Validation error
401Unauthenticated
403Permission denied
409Revision or idempotency conflict
500Unexpected internal failure
503Settings storage or policy is unavailable

What to do on failure

  • 400 Fix the parameters or body per the field list; do not retry unchanged.
  • 401 Check the credential format and whether it expired or was rotated.
  • 403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.
  • 409 Read the current state first; a retry of the same operation keeps the original Idempotency-Key and body.
  • 500 Outcome unknown: read back by ID or list first, then decide whether to retry with the original Idempotency-Key.
  • 503 A dependency is unavailable: retry later with the original Idempotency-Key.

↑ Back to list