API di archiviazione a oggetti

Gestisci bucket e oggetti del team. I nomi dei bucket sono globalmente univoci. I caricamenti degli oggetti usano il corpo originale del file. Le credenziali S3 appena create compaiono nelle risposte; mantieni private queste risposte.

Usa Autenticazione API per le richieste protette. Gli esempi usano i tuoi ID di risorse e un token temporaneo; gli esempi di risposte salvate sono sintetici.

Metodo	Percorso	Operazione
GET	/v1/object_bucket	Elenca i bucket
POST	/v1/object_bucket	Crea bucket
GET	/v1/object_bucket/{id}	Ottieni bucket
PUT	/v1/object_bucket/{id}	Aggiorna bucket
DELETE	/v1/object_bucket/{id}	Elimina bucket
GET	/v1/object_bucket/{id}/objects	Elenca gli oggetti del bucket
GET	/v1/object_bucket/{id}/object	Scarica un oggetto del bucket
PUT	/v1/object_bucket/{id}/object	Carica un oggetto nel bucket
DELETE	/v1/object_bucket/{id}/object	Elimina un oggetto del bucket
POST	/v1/object_bucket/{id}/folders	Crea una cartella nel bucket
DELETE	/v1/object_bucket/{id}/folders	Elimina una cartella del bucket
GET	/v1/object_bucket/{id}/access-keys	Elenca le chiavi di accesso del bucket
POST	/v1/object_bucket/{id}/access-keys	Crea una chiave di accesso del bucket
DELETE	/v1/object_bucket/{id}/access-keys/{access_key_id}	Elimina una chiave di accesso del bucket

Elenca i bucket

GET /v1/object_bucket

Restituisce un elenco paginato di ObjectBucket

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
page	query	No	Numero di pagina
per_page	query	No	Elementi per pagina

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Elenco di ObjectBucket

Campi di risposta

Campo	Tipo	Descrizione
data	array
data[].acl_policy	object	Politica ACL degli oggetti Adios. L’impostazione predefinita è privata, con regole facoltative per i prefissi pubblici.
data[].backend_bucket	string	Nome del bucket presso il fornitore. Il valore predefinito è il nome normalizzato del bucket di oggetti.
data[].bucket_id	string
data[].cache_policy	object	Politica di cache del gateway per le letture pubbliche degli oggetti.
data[].canonical_hostname	string	Nome host del bucket generato da Adios, come bucket.s3.adios.dev.
data[].cdn_policy	object	Politica della CDN Adios per le letture pubbliche degli oggetti. Quando impostata, sostituisce cache_policy.
data[].config	object	Opzioni aggiuntive del fornitore e riferimenti ai segreti.
data[].cors_policy	object	Politica CORS S3 applicata da Adios prima dell’inoltro al backend degli oggetti.
data[].created_at	integer	(timestamp Unix)
data[].deleted_at	integer	(timestamp Unix)
data[].endpoint	string	Override facoltativo dell’endpoint compatibile con S3 per i bucket importati.
data[].managed	boolean
data[].name	string	Namespace del bucket globalmente univoco, usato per l’instradamento bucket.s3.adios.dev e s3.adios.dev/bucket.
data[].provider	string	Valori consentiti: adios, minio, ceph_rgw, external_s3.
data[].public_hostname	string	Nome host personalizzato facoltativo di proprietà dell’utente, servito tramite il gateway anycast per accedere al bucket; i namespace adios.dev e adios.run sono riservati.
data[].public_read	boolean
data[].region	string
data[].route_id	string	Route del gateway sincronizzata per i domini personalizzati public_hostname.
data[].s3_path_endpoint	string	Endpoint S3 condiviso in stile path, come https://s3.adios.dev.
data[].status	string	Valori consentiti: pending, available, failed, deleted.
data[].team_id	string
data[].updated_at	integer	(timestamp Unix)
data[].versioning	boolean
pagination	object
pagination.page	integer	Numero di pagina attuale
pagination.per_page	integer	Numero di elementi per pagina
pagination.total	integer	Numero totale di elementi

Esempio illustrativo; non è una risposta dal vivo:

{
  "data": [
    {
      "acl_policy": {},
      "backend_bucket": "example",
      "bucket_id": "000000000000000000000000001",
      "cache_policy": {},
      "canonical_hostname": "example",
      "cdn_policy": {},
      "config": {},
      "cors_policy": {},
      "created_at": 1791072000,
      "deleted_at": 0,
      "endpoint": "example",
      "managed": true,
      "name": "postman-example",
      "provider": "adios",
      "public_hostname": "example",
      "public_read": false,
      "region": "default",
      "route_id": "000000000000000000000000001",
      "s3_path_endpoint": "example",
      "status": "pending",
      "team_id": "000000000000000000000000001",
      "updated_at": 1791072000,
      "versioning": false
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Crea bucket

POST /v1/object_bucket

Crea un nuovo oggetto ObjectBucket

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Campi di richiesta (il corpo contiene un esempio modificabile):

Campo	Tipo	Obbligatorio	Descrizione
acl_policy	object	No	Politica ACL degli oggetti Adios. L’impostazione predefinita è privata, con regole facoltative per i prefissi pubblici.
backend_bucket	string	No	Nome del bucket presso il fornitore. Il valore predefinito è il nome normalizzato del bucket di oggetti.
cache_policy	object	No	Politica di cache del gateway per le letture pubbliche degli oggetti.
canonical_hostname	string	No	Nome host del bucket generato da Adios, come bucket.s3.adios.dev.
cdn_policy	object	No	Politica della CDN Adios per le letture pubbliche degli oggetti. Quando impostata, sostituisce cache_policy.
config	object	No	Opzioni aggiuntive del fornitore e riferimenti ai segreti.
cors_policy	object	No	Politica CORS S3 applicata da Adios prima dell’inoltro al backend degli oggetti.
endpoint	string	No	Override facoltativo dell’endpoint compatibile con S3 per i bucket importati.
managed	boolean	Sì	Valore predefinito: true.
name	string	Sì	Namespace del bucket globalmente univoco, usato per l’instradamento bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Sì	Valori consentiti: adios, minio, ceph_rgw, external_s3. Valore predefinito: "adios".
public_hostname	string	No	Nome host personalizzato facoltativo di proprietà dell’utente, servito tramite il gateway anycast per accedere al bucket; i namespace adios.dev e adios.run sono riservati.
public_read	boolean	Sì	Valore predefinito: false.
region	string	No	Valore predefinito: "default".
route_id	string	No	Route del gateway sincronizzata per i domini personalizzati public_hostname.
s3_path_endpoint	string	No	Endpoint S3 condiviso in stile path, come https://s3.adios.dev.
status	string	Sì	Valori consentiti: pending, available, failed, deleted. Valore predefinito: "pending".
team_id	string	Sì
versioning	boolean	Sì	Valore predefinito: false.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/object_bucket" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "name": "YOUR_BUCKET_NAME",
  "provider": "adios",
  "managed": true,
  "public_read": false,
  "versioning": false,
  "status": "pending",
  "region": "YOUR_REGION"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 201

ObjectBucket creato

Campi di risposta

Campo	Tipo	Descrizione
acl_policy	object	Politica ACL degli oggetti Adios. L’impostazione predefinita è privata, con regole facoltative per i prefissi pubblici.
backend_bucket	string	Nome del bucket presso il fornitore. Il valore predefinito è il nome normalizzato del bucket di oggetti.
bucket_id	string
cache_policy	object	Politica di cache del gateway per le letture pubbliche degli oggetti.
canonical_hostname	string	Nome host del bucket generato da Adios, come bucket.s3.adios.dev.
cdn_policy	object	Politica della CDN Adios per le letture pubbliche degli oggetti. Quando impostata, sostituisce cache_policy.
config	object	Opzioni aggiuntive del fornitore e riferimenti ai segreti.
cors_policy	object	Politica CORS S3 applicata da Adios prima dell’inoltro al backend degli oggetti.
created_at	integer	(timestamp Unix)
deleted_at	integer	(timestamp Unix)
endpoint	string	Override facoltativo dell’endpoint compatibile con S3 per i bucket importati.
managed	boolean
name	string	Namespace del bucket globalmente univoco, usato per l’instradamento bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Valori consentiti: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nome host personalizzato facoltativo di proprietà dell’utente, servito tramite il gateway anycast per accedere al bucket; i namespace adios.dev e adios.run sono riservati.
public_read	boolean
region	string
route_id	string	Route del gateway sincronizzata per i domini personalizzati public_hostname.
s3_path_endpoint	string	Endpoint S3 condiviso in stile path, come https://s3.adios.dev.
status	string	Valori consentiti: pending, available, failed, deleted.
team_id	string
updated_at	integer	(timestamp Unix)
versioning	boolean

Esempio illustrativo; non è una risposta dal vivo:

{
  "acl_policy": {},
  "backend_bucket": "example",
  "bucket_id": "000000000000000000000000001",
  "cache_policy": {},
  "canonical_hostname": "example",
  "cdn_policy": {},
  "config": {},
  "cors_policy": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "endpoint": "example",
  "managed": true,
  "name": "postman-example",
  "provider": "adios",
  "public_hostname": "example",
  "public_read": false,
  "region": "default",
  "route_id": "000000000000000000000000001",
  "s3_path_endpoint": "example",
  "status": "pending",
  "team_id": "000000000000000000000000001",
  "updated_at": 1791072000,
  "versioning": false
}

Ottieni bucket

GET /v1/object_bucket/{id}

Restituisce un oggetto ObjectBucket

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

ObjectBucket

Campi di risposta

Campo	Tipo	Descrizione
acl_policy	object	Politica ACL degli oggetti Adios. L’impostazione predefinita è privata, con regole facoltative per i prefissi pubblici.
backend_bucket	string	Nome del bucket presso il fornitore. Il valore predefinito è il nome normalizzato del bucket di oggetti.
bucket_id	string
cache_policy	object	Politica di cache del gateway per le letture pubbliche degli oggetti.
canonical_hostname	string	Nome host del bucket generato da Adios, come bucket.s3.adios.dev.
cdn_policy	object	Politica della CDN Adios per le letture pubbliche degli oggetti. Quando impostata, sostituisce cache_policy.
config	object	Opzioni aggiuntive del fornitore e riferimenti ai segreti.
cors_policy	object	Politica CORS S3 applicata da Adios prima dell’inoltro al backend degli oggetti.
created_at	integer	(timestamp Unix)
deleted_at	integer	(timestamp Unix)
endpoint	string	Override facoltativo dell’endpoint compatibile con S3 per i bucket importati.
managed	boolean
name	string	Namespace del bucket globalmente univoco, usato per l’instradamento bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Valori consentiti: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nome host personalizzato facoltativo di proprietà dell’utente, servito tramite il gateway anycast per accedere al bucket; i namespace adios.dev e adios.run sono riservati.
public_read	boolean
region	string
route_id	string	Route del gateway sincronizzata per i domini personalizzati public_hostname.
s3_path_endpoint	string	Endpoint S3 condiviso in stile path, come https://s3.adios.dev.
status	string	Valori consentiti: pending, available, failed, deleted.
team_id	string
updated_at	integer	(timestamp Unix)
versioning	boolean

Esempio illustrativo; non è una risposta dal vivo:

{
  "acl_policy": {},
  "backend_bucket": "example",
  "bucket_id": "000000000000000000000000001",
  "cache_policy": {},
  "canonical_hostname": "example",
  "cdn_policy": {},
  "config": {},
  "cors_policy": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "endpoint": "example",
  "managed": true,
  "name": "postman-example",
  "provider": "adios",
  "public_hostname": "example",
  "public_read": false,
  "region": "default",
  "route_id": "000000000000000000000000001",
  "s3_path_endpoint": "example",
  "status": "pending",
  "team_id": "000000000000000000000000001",
  "updated_at": 1791072000,
  "versioning": false
}

Aggiorna bucket

PUT /v1/object_bucket/{id}

Aggiorna un oggetto ObjectBucket esistente

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Campi di richiesta (il corpo contiene un esempio modificabile):

Campo	Tipo	Obbligatorio	Descrizione
acl_policy	object	No	Politica ACL degli oggetti Adios. L’impostazione predefinita è privata, con regole facoltative per i prefissi pubblici.
backend_bucket	string	No	Nome del bucket presso il fornitore. Il valore predefinito è il nome normalizzato del bucket di oggetti.
cache_policy	object	No	Politica di cache del gateway per le letture pubbliche degli oggetti.
canonical_hostname	string	No	Nome host del bucket generato da Adios, come bucket.s3.adios.dev.
cdn_policy	object	No	Politica della CDN Adios per le letture pubbliche degli oggetti. Quando impostata, sostituisce cache_policy.
config	object	No	Opzioni aggiuntive del fornitore e riferimenti ai segreti.
cors_policy	object	No	Politica CORS S3 applicata da Adios prima dell’inoltro al backend degli oggetti.
endpoint	string	No	Override facoltativo dell’endpoint compatibile con S3 per i bucket importati.
managed	boolean	Sì	Valore predefinito: true.
name	string	Sì	Namespace del bucket globalmente univoco, usato per l’instradamento bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Sì	Valori consentiti: adios, minio, ceph_rgw, external_s3. Valore predefinito: "adios".
public_hostname	string	No	Nome host personalizzato facoltativo di proprietà dell’utente, servito tramite il gateway anycast per accedere al bucket; i namespace adios.dev e adios.run sono riservati.
public_read	boolean	Sì	Valore predefinito: false.
region	string	No	Valore predefinito: "default".
route_id	string	No	Route del gateway sincronizzata per i domini personalizzati public_hostname.
s3_path_endpoint	string	No	Endpoint S3 condiviso in stile path, come https://s3.adios.dev.
status	string	Sì	Valori consentiti: pending, available, failed, deleted. Valore predefinito: "pending".
team_id	string	Sì
versioning	boolean	Sì	Valore predefinito: false.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request PUT "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "name": "YOUR_BUCKET_NAME",
  "provider": "adios",
  "managed": true,
  "public_read": false,
  "versioning": false,
  "status": "pending",
  "region": "YOUR_REGION"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 200

ObjectBucket aggiornato

Campi di risposta

Campo	Tipo	Descrizione
acl_policy	object	Politica ACL degli oggetti Adios. L’impostazione predefinita è privata, con regole facoltative per i prefissi pubblici.
backend_bucket	string	Nome del bucket presso il fornitore. Il valore predefinito è il nome normalizzato del bucket di oggetti.
bucket_id	string
cache_policy	object	Politica di cache del gateway per le letture pubbliche degli oggetti.
canonical_hostname	string	Nome host del bucket generato da Adios, come bucket.s3.adios.dev.
cdn_policy	object	Politica della CDN Adios per le letture pubbliche degli oggetti. Quando impostata, sostituisce cache_policy.
config	object	Opzioni aggiuntive del fornitore e riferimenti ai segreti.
cors_policy	object	Politica CORS S3 applicata da Adios prima dell’inoltro al backend degli oggetti.
created_at	integer	(timestamp Unix)
deleted_at	integer	(timestamp Unix)
endpoint	string	Override facoltativo dell’endpoint compatibile con S3 per i bucket importati.
managed	boolean
name	string	Namespace del bucket globalmente univoco, usato per l’instradamento bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Valori consentiti: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nome host personalizzato facoltativo di proprietà dell’utente, servito tramite il gateway anycast per accedere al bucket; i namespace adios.dev e adios.run sono riservati.
public_read	boolean
region	string
route_id	string	Route del gateway sincronizzata per i domini personalizzati public_hostname.
s3_path_endpoint	string	Endpoint S3 condiviso in stile path, come https://s3.adios.dev.
status	string	Valori consentiti: pending, available, failed, deleted.
team_id	string
updated_at	integer	(timestamp Unix)
versioning	boolean

Esempio illustrativo; non è una risposta dal vivo:

{
  "acl_policy": {},
  "backend_bucket": "example",
  "bucket_id": "000000000000000000000000001",
  "cache_policy": {},
  "canonical_hostname": "example",
  "cdn_policy": {},
  "config": {},
  "cors_policy": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "endpoint": "example",
  "managed": true,
  "name": "postman-example",
  "provider": "adios",
  "public_hostname": "example",
  "public_read": false,
  "region": "default",
  "route_id": "000000000000000000000000001",
  "s3_path_endpoint": "example",
  "status": "pending",
  "team_id": "000000000000000000000000001",
  "updated_at": 1791072000,
  "versioning": false
}

Elimina bucket

DELETE /v1/object_bucket/{id}

Elimina un oggetto ObjectBucket

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risorsa eliminata.

Campi di risposta

Campo	Tipo	Descrizione
message	string

Esempio illustrativo; non è una risposta dal vivo:

{
  "message": "Deleted successfully"
}

Elenca gli oggetti del bucket

GET /v1/object_bucket/{id}/objects

Sfoglia gli oggetti sotto un prefisso opzionale.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
prefix	query	No	Prefisso della chiave dell’oggetto.
limit	query	No	Numero di voci tra 1 e 5000.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/objects" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Scarica un oggetto del bucket

GET /v1/object_bucket/{id}/object

Leggi il corpo originale dell’oggetto. Usa l’opzione di download di Postman per salvarlo.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
key	query	Sì	Chiave obbligatoria dell’oggetto.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/object?key=${ADIOS_OBJECT_KEY}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Carica un oggetto nel bucket

PUT /v1/object_bucket/{id}/object

Seleziona un file in Body → binary prima dell’invio. L’endpoint accetta byte grezzi, non dati di moduli multipart; il limite di caricamento è 5 GiB.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
key	query	Sì	Chiave obbligatoria dell’oggetto.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request PUT "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/object?key=${ADIOS_OBJECT_KEY}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @./upload.bin

Risposta: HTTP 201

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Elimina un oggetto del bucket

DELETE /v1/object_bucket/{id}/object

Elimina l’oggetto selezionato.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
key	query	Sì	Chiave obbligatoria dell’oggetto.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/object?key=${ADIOS_OBJECT_KEY}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 204

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Crea una cartella nel bucket

POST /v1/object_bucket/{id}/folders

Crea un marcatore di cartella per gli oggetti.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/folders" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "prefix": "YOUR_OBJECT_PREFIX"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 201

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Elimina una cartella del bucket

DELETE /v1/object_bucket/{id}/folders

Elimina una cartella e il suo contenuto.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
prefix	query	Sì	Prefisso obbligatorio della cartella.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/folders?prefix=${ADIOS_OBJECT_PREFIX}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Elenca le chiavi di accesso del bucket

GET /v1/object_bucket/{id}/access-keys

Elenca i metadati delle chiavi S3 del bucket.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/access-keys" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Crea una chiave di accesso del bucket

POST /v1/object_bucket/{id}/access-keys

Crea credenziali S3 per questo bucket. Conserva il segreto restituito in modo privato; non pubblicare la risposta.

Imposta object_bucket_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/access-keys" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "name": "postman-example"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 201

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Elimina una chiave di accesso del bucket

DELETE /v1/object_bucket/{id}/access-keys/{access_key_id}

Revoca la chiave di accesso S3 selezionata.

Imposta object_bucket_id, access_key_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
access_key_id	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
X-Tenant-ID	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/access-keys/${ADIOS_ACCESS_KEY_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.