s3_destination

El dominio s3_destination tiene 10 acciones. En la superficie meta se alcanzan todas a través de arcane_s3_destination; en la individual, cada una es una herramienta propia; en la dinámica se ejecutan con arcane_execute_action y el ID canónico.

Resumen

Acción	Título	Tipo
s3_destination.create	Create S3 destination	escritura
s3_destination.delete	Delete S3 destination	destructiva
s3_destination.get	Get S3 destination	lectura
s3_destination.list	List S3 destinations	lectura
s3_destination.options	List all S3 destination options	lectura
s3_destination.sync	Sync S3 destinations	destructiva
s3_destination.test	Test S3 destination	escritura
s3_destination.test_configuration	Test unsaved S3 destination configuration	lectura
s3_destination.update	Update S3 destination	escritura
s3_destination.usage	Check S3 destination references	lectura

Acciones

s3_destination.create

Create S3 destination

• Tipo: escritura
• Parámetros obligatorios: accessKeyId, bucket, forcePathStyle, name, region, secretAccessKey, useSsl
• Meta-herramienta: arcane_s3_destination con "action": "create"
• Herramienta individual: arcane_s3_destination_create
• Ruta de Arcane: POST /api/backups/s3
• ID de operación: create-s3-destination
• Uso: Arcane first runs the connection test (uploads, reads back and deletes a temporary object under the prefix) and refuses to save if it fails, so the bucket must already exist and be writable. Required: name (unique), bucket, accessKeyId, secretAccessKey, useSsl, forcePathStyle and region (may be empty only when endpoint is set. Omit endpoint for AWS S3, set it plus forcePathStyle=true for MinIO-style servers. useSsl picks http or https for the endpoint, overriding any scheme written in it). Returns the destination with its id (no secret), and the change is then pushed to remote environments in the background.
• Acciones relacionadas: s3_destination.test_configuration, s3_destination.list, backup.policies_update, volume_backup.policy_update

s3_destination.delete

Delete S3 destination

• Tipo: destructiva — exige confirm: true
• Parámetros obligatorios: id
• Meta-herramienta: arcane_s3_destination con "action": "delete"
• Herramienta individual: arcane_s3_destination_delete
• Ruta de Arcane: DELETE /api/backups/s3/{id}
• ID de operación: delete-s3-destination
• Uso: id from s3_destination.list. Fails with 409 while the destination is in use (see s3_destination.usage) on this instance or on any remote environment, or while a remote environment cannot be reached to check. Disable it in the backup policies and remove the backups stored there first. Deletes only Arcane’s record, not the objects in the bucket. Remote environments then get the change in the background. It does not check system-managed volume backup policies (backup.volume_config_get), so review those first.
• Acciones relacionadas: s3_destination.usage, s3_destination.list, backup.policies_update, volume_backup.policy_update

s3_destination.get

Get S3 destination

• Tipo: lectura
• Parámetros obligatorios: id
• Meta-herramienta: arcane_s3_destination con "action": "get"
• Herramienta individual: arcane_s3_destination_get
• Ruta de Arcane: GET /api/backups/s3/{id}
• ID de operación: get-s3-destination
• Uso: id from s3_destination.list or s3_destination.options. Returns the destination’s connection settings (endpoint, bucket, region, accessKeyId, prefix, useSsl, forcePathStyle) and secretConfigured. The secret access key is never returned. Read it before s3_destination.update, which replaces every field.
• Acciones relacionadas: s3_destination.list, s3_destination.update, s3_destination.usage

s3_destination.list

List S3 destinations

List saved S3-compatible backup destinations with search, sorting, and pagination

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_s3_destination con "action": "list"
• Herramienta individual: arcane_s3_destination_list
• Ruta de Arcane: GET /api/backups/s3
• ID de operación: list-s3-destinations
• Uso: Paged list of the saved S3 destinations (global, not per environment). search matches name, endpoint, bucket, region and prefix, start/limit page it (limit defaults to 20). Each item’s id is the s3DestinationId that backup.create, volume_backup.create, backup.policies_update and volume_backup.policy_update take. Secrets are never returned, only secretConfigured. For the whole list without paging use s3_destination.options.
• Acciones relacionadas: s3_destination.get, s3_destination.options, s3_destination.create

s3_destination.options

List all S3 destination options

List saved S3-compatible destinations for backup configuration selectors

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_s3_destination con "action": "options"
• Herramienta individual: arcane_s3_destination_options
• Ruta de Arcane: GET /api/backups/s3/options
• ID de operación: list-all-s3-destinations
• Uso: Returns every saved S3 destination as a plain array sorted by name, with no search or paging: use it to pick an s3DestinationId for a backup or a backup policy. Use s3_destination.list to search or page.
• Acciones relacionadas: s3_destination.list, backup.policies_update, volume_backup.policy_update

s3_destination.sync

Sync S3 destinations

Synchronize manager-owned S3 destinations to an agent

• Tipo: destructiva — exige confirm: true
• Parámetros obligatorios: destinations
• Meta-herramienta: arcane_s3_destination con "action": "sync"
• Herramienta individual: arcane_s3_destination_sync
• Ruta de Arcane: POST /api/backups/s3/sync
• ID de operación: sync-s3-destinations
• Uso: Agent-side endpoint a manager uses to push its S3 destinations: the given list REPLACES this instance’s destinations, and every destination not in it is deleted (one still in use locally is kept and the call reports an error after the rest is applied). To push destinations to an environment use environment.sync instead.
• Acciones relacionadas: environment.sync

s3_destination.test

Test S3 destination

Verify upload, download, and delete access using the saved or supplied S3 destination configuration

• Tipo: escritura
• Parámetros obligatorios: id
• Meta-herramienta: arcane_s3_destination con "action": "test"
• Herramienta individual: arcane_s3_destination_test
• Ruta de Arcane: POST /api/backups/s3/{id}/test
• ID de operación: test-s3-destination
• Uso: With only id, tests the saved configuration. To test changes before saving them, pass the complete configuration (name, bucket, region, accessKeyId, secretAccessKey, useSsl, forcePathStyle, with endpoint and prefix optional): omitted fields count as empty. secretAccessKey may be empty to reuse the stored secret only while endpoint, bucket, region, accessKeyId, useSsl and forcePathStyle are unchanged. The endpoint must be reachable both from Arcane and from the backup helper containers Arcane starts on the Docker host.
• Acciones relacionadas: s3_destination.test_configuration, s3_destination.get

s3_destination.test_configuration

Test unsaved S3 destination configuration

Verify upload, download, and delete access before saving an S3 destination

• Tipo: lectura
• Parámetros obligatorios: accessKeyId, bucket, forcePathStyle, name, region, secretAccessKey, useSsl
• Meta-herramienta: arcane_s3_destination con "action": "test_configuration"
• Herramienta individual: arcane_s3_destination_test_configuration
• Ruta de Arcane: POST /api/backups/s3/test
• ID de operación: test-s3-destination-configuration
• Uso: Tests settings that are not saved yet, with the same body as s3_destination.create (secretAccessKey required). Nothing is stored. It writes, reads back and deletes a temporary .arcane-connection-test-* object under the prefix, and fails with the S3 error when access is missing. To test a saved destination use s3_destination.test.
• Acciones relacionadas: s3_destination.create, s3_destination.test

s3_destination.update

Update S3 destination

• Tipo: escritura
• Parámetros obligatorios: id, accessKeyId, bucket, forcePathStyle, name, region, secretAccessKey, useSsl
• Meta-herramienta: arcane_s3_destination con "action": "update"
• Herramienta individual: arcane_s3_destination_update
• Ruta de Arcane: PUT /api/backups/s3/{id}
• ID de operación: update-s3-destination
• Uso: id from s3_destination.list. Replaces the whole configuration: send every field (start from s3_destination.get), an omitted prefix or endpoint is cleared. secretAccessKey may be empty to keep the stored secret only if endpoint, bucket, region, accessKeyId, useSsl and forcePathStyle are unchanged, otherwise Arcane demands it again. The new settings are connection-tested before saving and then pushed to remote environments.
• Acciones relacionadas: s3_destination.get, s3_destination.test, s3_destination.list

s3_destination.usage

Check S3 destination references

Report whether backup records, policies, or settings on this environment still reference the destination

• Tipo: lectura
• Parámetros obligatorios: id
• Meta-herramienta: arcane_s3_destination con "action": "usage"
• Herramienta individual: arcane_s3_destination_usage
• Ruta de Arcane: GET /api/backups/s3/{id}/in-use
• ID de operación: get-s3-destination-usage
• Uso: id from s3_destination.list. Returns inUse=true when a system or volume backup policy on this Arcane instance has S3 enabled with this destination, or a system or volume backup has a copy stored in it. System-managed volume backup policies (backup.volume_config_update) are not checked. It checks only this instance, while s3_destination.delete also asks every remote environment, so delete can still fail with inUse=false.
• Acciones relacionadas: s3_destination.delete, backup.policies_get, volume_backup.policy_get, backup.volume_config_get