API de stockage objet

Gérez les buckets et objets de l’équipe. Les noms des buckets sont uniques mondialement. Les envois d’objets utilisent le corps brut du fichier. Les identifiants S3 nouvellement créés figurent dans les réponses ; gardez ces réponses privées.

Utiliser Authentification API pour les requêtes protégées. Les exemples utilisent vos propres ID de ressources et un jeton temporaire ; les exemples de réponses enregistrés sont synthétiques.

Méthode	Chemin	Opération
GET	/v1/object_bucket	Lister les buckets
POST	/v1/object_bucket	Créer un bucket
GET	/v1/object_bucket/{id}	Obtenir le bucket
PUT	/v1/object_bucket/{id}	Mettre à jour le bucket
DELETE	/v1/object_bucket/{id}	Supprimer le bucket
GET	/v1/object_bucket/{id}/objects	Lister les objets du bucket
GET	/v1/object_bucket/{id}/object	Télécharger l’objet du bucket
PUT	/v1/object_bucket/{id}/object	Envoyer un objet dans le bucket
DELETE	/v1/object_bucket/{id}/object	Supprimer l’objet du bucket
POST	/v1/object_bucket/{id}/folders	Créer un dossier de bucket
DELETE	/v1/object_bucket/{id}/folders	Supprimer le dossier du bucket
GET	/v1/object_bucket/{id}/access-keys	Lister les clés d’accès du bucket
POST	/v1/object_bucket/{id}/access-keys	Créer une clé d’accès au bucket
DELETE	/v1/object_bucket/{id}/access-keys/{access_key_id}	Supprimer la clé d’accès du bucket

Lister les buckets

GET /v1/object_bucket

Renvoie une liste paginée d’ObjectBucket

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
page	requête	non	Numéro de page
per_page	requête	non	Éléments par page

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Liste d’ObjectBucket

Champs de réponse

Champ	Type	Description
data	tableau
data[].acl_policy	objet	Politique ACL Adios des objets. Privée par défaut, avec des règles facultatives de préfixes publics.
data[].backend_bucket	chaîne	Nom du bucket chez le fournisseur. Utilise par défaut le nom normalisé du bucket d’objets.
data[].bucket_id	chaîne
data[].cache_policy	objet	Politique de cache de la passerelle pour la lecture d’objets publics.
data[].canonical_hostname	chaîne	Nom d’hôte Adios généré pour le bucket, par exemple bucket.s3.adios.dev.
data[].cdn_policy	objet	Politique CDN Adios pour la lecture d’objets publics. Remplace cache_policy lorsqu’elle est définie.
data[].config	objet	Options supplémentaires du fournisseur et références aux secrets.
data[].cors_policy	objet	Politique CORS S3 appliquée par Adios avant la transmission au backend de stockage objet.
data[].created_at	entier	(horodatage Unix)
data[].deleted_at	entier	(horodatage Unix)
data[].endpoint	chaîne	Point de terminaison compatible S3 facultatif remplaçant celui par défaut pour les buckets importés.
data[].managed	booléen
data[].name	chaîne	Espace de noms du bucket, unique mondialement, utilisé pour le routage bucket.s3.adios.dev et s3.adios.dev/bucket.
data[].provider	chaîne	Valeurs autorisées : adios, minio, ceph_rgw, external_s3.
data[].public_hostname	chaîne	Nom d’hôte personnalisé facultatif appartenant à l’utilisateur, desservi par la passerelle anycast pour l’accès au bucket ; les espaces de noms adios.dev et adios.run sont réservés.
data[].public_read	booléen
data[].region	chaîne
data[].route_id	chaîne	Route de passerelle synchronisée pour les domaines personnalisés public_hostname.
data[].s3_path_endpoint	chaîne	Point de terminaison S3 partagé utilisant le style d’adressage par chemin, tel que https://s3.adios.dev.
data[].status	chaîne	Valeurs autorisées : pending, available, failed, deleted.
data[].team_id	chaîne
data[].updated_at	entier	(horodatage Unix)
data[].versioning	booléen
pagination	objet
pagination.page	entier	Numéro de page actuel
pagination.per_page	entier	Nombre d’éléments par page
pagination.total	entier	Nombre total d’éléments

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "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
  }
}

Créer un bucket

POST /v1/object_bucket

Crée un nouvel objet ObjectBucket

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Champs de la requête (le corps contient un exemple modifiable) :

Champ	Type	Requis	Description
acl_policy	objet	non	Politique ACL Adios des objets. Privée par défaut, avec des règles facultatives de préfixes publics.
backend_bucket	chaîne	non	Nom du bucket chez le fournisseur. Utilise par défaut le nom normalisé du bucket d’objets.
cache_policy	objet	non	Politique de cache de la passerelle pour la lecture d’objets publics.
canonical_hostname	chaîne	non	Nom d’hôte Adios généré pour le bucket, par exemple bucket.s3.adios.dev.
cdn_policy	objet	non	Politique CDN Adios pour la lecture d’objets publics. Remplace cache_policy lorsqu’elle est définie.
config	objet	non	Options supplémentaires du fournisseur et références aux secrets.
cors_policy	objet	non	Politique CORS S3 appliquée par Adios avant la transmission au backend de stockage objet.
endpoint	chaîne	non	Point de terminaison compatible S3 facultatif remplaçant celui par défaut pour les buckets importés.
managed	booléen	oui	Valeur par défaut : true.
name	chaîne	oui	Espace de noms du bucket, unique mondialement, utilisé pour le routage bucket.s3.adios.dev et s3.adios.dev/bucket.
provider	chaîne	oui	Valeurs autorisées : adios, minio, ceph_rgw, external_s3. Valeur par défaut : "adios".
public_hostname	chaîne	non	Nom d’hôte personnalisé facultatif appartenant à l’utilisateur, desservi par la passerelle anycast pour l’accès au bucket ; les espaces de noms adios.dev et adios.run sont réservés.
public_read	booléen	oui	Valeur par défaut : false.
region	chaîne	non	Valeur par défaut : "default".
route_id	chaîne	non	Route de passerelle synchronisée pour les domaines personnalisés public_hostname.
s3_path_endpoint	chaîne	non	Point de terminaison S3 partagé utilisant le style d’adressage par chemin, tel que https://s3.adios.dev.
status	chaîne	oui	Valeurs autorisées : pending, available, failed, deleted. Valeur par défaut : "pending".
team_id	chaîne	oui
versioning	booléen	oui	Valeur par défaut : false.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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

Remplacez YOUR_* du corps avant l’envoi. Le heredoc entre guillemets préserve le JSON littéral.

Réponse : HTTP 201

ObjectBucket créé

Champs de réponse

Champ	Type	Description
acl_policy	objet	Politique ACL Adios des objets. Privée par défaut, avec des règles facultatives de préfixes publics.
backend_bucket	chaîne	Nom du bucket chez le fournisseur. Utilise par défaut le nom normalisé du bucket d’objets.
bucket_id	chaîne
cache_policy	objet	Politique de cache de la passerelle pour la lecture d’objets publics.
canonical_hostname	chaîne	Nom d’hôte Adios généré pour le bucket, par exemple bucket.s3.adios.dev.
cdn_policy	objet	Politique CDN Adios pour la lecture d’objets publics. Remplace cache_policy lorsqu’elle est définie.
config	objet	Options supplémentaires du fournisseur et références aux secrets.
cors_policy	objet	Politique CORS S3 appliquée par Adios avant la transmission au backend de stockage objet.
created_at	entier	(horodatage Unix)
deleted_at	entier	(horodatage Unix)
endpoint	chaîne	Point de terminaison compatible S3 facultatif remplaçant celui par défaut pour les buckets importés.
managed	booléen
name	chaîne	Espace de noms du bucket, unique mondialement, utilisé pour le routage bucket.s3.adios.dev et s3.adios.dev/bucket.
provider	chaîne	Valeurs autorisées : adios, minio, ceph_rgw, external_s3.
public_hostname	chaîne	Nom d’hôte personnalisé facultatif appartenant à l’utilisateur, desservi par la passerelle anycast pour l’accès au bucket ; les espaces de noms adios.dev et adios.run sont réservés.
public_read	booléen
region	chaîne
route_id	chaîne	Route de passerelle synchronisée pour les domaines personnalisés public_hostname.
s3_path_endpoint	chaîne	Point de terminaison S3 partagé utilisant le style d’adressage par chemin, tel que https://s3.adios.dev.
status	chaîne	Valeurs autorisées : pending, available, failed, deleted.
team_id	chaîne
updated_at	entier	(horodatage Unix)
versioning	booléen

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "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
}

Obtenir le bucket

GET /v1/object_bucket/{id}

Renvoie un seul ObjectBucket

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

ObjectBucket

Champs de réponse

Champ	Type	Description
acl_policy	objet	Politique ACL Adios des objets. Privée par défaut, avec des règles facultatives de préfixes publics.
backend_bucket	chaîne	Nom du bucket chez le fournisseur. Utilise par défaut le nom normalisé du bucket d’objets.
bucket_id	chaîne
cache_policy	objet	Politique de cache de la passerelle pour la lecture d’objets publics.
canonical_hostname	chaîne	Nom d’hôte Adios généré pour le bucket, par exemple bucket.s3.adios.dev.
cdn_policy	objet	Politique CDN Adios pour la lecture d’objets publics. Remplace cache_policy lorsqu’elle est définie.
config	objet	Options supplémentaires du fournisseur et références aux secrets.
cors_policy	objet	Politique CORS S3 appliquée par Adios avant la transmission au backend de stockage objet.
created_at	entier	(horodatage Unix)
deleted_at	entier	(horodatage Unix)
endpoint	chaîne	Point de terminaison compatible S3 facultatif remplaçant celui par défaut pour les buckets importés.
managed	booléen
name	chaîne	Espace de noms du bucket, unique mondialement, utilisé pour le routage bucket.s3.adios.dev et s3.adios.dev/bucket.
provider	chaîne	Valeurs autorisées : adios, minio, ceph_rgw, external_s3.
public_hostname	chaîne	Nom d’hôte personnalisé facultatif appartenant à l’utilisateur, desservi par la passerelle anycast pour l’accès au bucket ; les espaces de noms adios.dev et adios.run sont réservés.
public_read	booléen
region	chaîne
route_id	chaîne	Route de passerelle synchronisée pour les domaines personnalisés public_hostname.
s3_path_endpoint	chaîne	Point de terminaison S3 partagé utilisant le style d’adressage par chemin, tel que https://s3.adios.dev.
status	chaîne	Valeurs autorisées : pending, available, failed, deleted.
team_id	chaîne
updated_at	entier	(horodatage Unix)
versioning	booléen

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "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
}

Mettre à jour le bucket

PUT /v1/object_bucket/{id}

Met à jour un objet ObjectBucket existant

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Champs de la requête (le corps contient un exemple modifiable) :

Champ	Type	Requis	Description
acl_policy	objet	non	Politique ACL Adios des objets. Privée par défaut, avec des règles facultatives de préfixes publics.
backend_bucket	chaîne	non	Nom du bucket chez le fournisseur. Utilise par défaut le nom normalisé du bucket d’objets.
cache_policy	objet	non	Politique de cache de la passerelle pour la lecture d’objets publics.
canonical_hostname	chaîne	non	Nom d’hôte Adios généré pour le bucket, par exemple bucket.s3.adios.dev.
cdn_policy	objet	non	Politique CDN Adios pour la lecture d’objets publics. Remplace cache_policy lorsqu’elle est définie.
config	objet	non	Options supplémentaires du fournisseur et références aux secrets.
cors_policy	objet	non	Politique CORS S3 appliquée par Adios avant la transmission au backend de stockage objet.
endpoint	chaîne	non	Point de terminaison compatible S3 facultatif remplaçant celui par défaut pour les buckets importés.
managed	booléen	oui	Valeur par défaut : true.
name	chaîne	oui	Espace de noms du bucket, unique mondialement, utilisé pour le routage bucket.s3.adios.dev et s3.adios.dev/bucket.
provider	chaîne	oui	Valeurs autorisées : adios, minio, ceph_rgw, external_s3. Valeur par défaut : "adios".
public_hostname	chaîne	non	Nom d’hôte personnalisé facultatif appartenant à l’utilisateur, desservi par la passerelle anycast pour l’accès au bucket ; les espaces de noms adios.dev et adios.run sont réservés.
public_read	booléen	oui	Valeur par défaut : false.
region	chaîne	non	Valeur par défaut : "default".
route_id	chaîne	non	Route de passerelle synchronisée pour les domaines personnalisés public_hostname.
s3_path_endpoint	chaîne	non	Point de terminaison S3 partagé utilisant le style d’adressage par chemin, tel que https://s3.adios.dev.
status	chaîne	oui	Valeurs autorisées : pending, available, failed, deleted. Valeur par défaut : "pending".
team_id	chaîne	oui
versioning	booléen	oui	Valeur par défaut : false.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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

Remplacez YOUR_* du corps avant l’envoi. Le heredoc entre guillemets préserve le JSON littéral.

Réponse : HTTP 200

ObjectBucket mis à jour

Champs de réponse

Champ	Type	Description
acl_policy	objet	Politique ACL Adios des objets. Privée par défaut, avec des règles facultatives de préfixes publics.
backend_bucket	chaîne	Nom du bucket chez le fournisseur. Utilise par défaut le nom normalisé du bucket d’objets.
bucket_id	chaîne
cache_policy	objet	Politique de cache de la passerelle pour la lecture d’objets publics.
canonical_hostname	chaîne	Nom d’hôte Adios généré pour le bucket, par exemple bucket.s3.adios.dev.
cdn_policy	objet	Politique CDN Adios pour la lecture d’objets publics. Remplace cache_policy lorsqu’elle est définie.
config	objet	Options supplémentaires du fournisseur et références aux secrets.
cors_policy	objet	Politique CORS S3 appliquée par Adios avant la transmission au backend de stockage objet.
created_at	entier	(horodatage Unix)
deleted_at	entier	(horodatage Unix)
endpoint	chaîne	Point de terminaison compatible S3 facultatif remplaçant celui par défaut pour les buckets importés.
managed	booléen
name	chaîne	Espace de noms du bucket, unique mondialement, utilisé pour le routage bucket.s3.adios.dev et s3.adios.dev/bucket.
provider	chaîne	Valeurs autorisées : adios, minio, ceph_rgw, external_s3.
public_hostname	chaîne	Nom d’hôte personnalisé facultatif appartenant à l’utilisateur, desservi par la passerelle anycast pour l’accès au bucket ; les espaces de noms adios.dev et adios.run sont réservés.
public_read	booléen
region	chaîne
route_id	chaîne	Route de passerelle synchronisée pour les domaines personnalisés public_hostname.
s3_path_endpoint	chaîne	Point de terminaison S3 partagé utilisant le style d’adressage par chemin, tel que https://s3.adios.dev.
status	chaîne	Valeurs autorisées : pending, available, failed, deleted.
team_id	chaîne
updated_at	entier	(horodatage Unix)
versioning	booléen

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "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
}

Supprimer le bucket

DELETE /v1/object_bucket/{id}

Supprime un objet ObjectBucket

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Ressource supprimée.

Champs de réponse

Champ	Type	Description
message	chaîne

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "message": "Deleted successfully"
}

Lister les objets du bucket

GET /v1/object_bucket/{id}/objects

Parcourir les objets sous un préfixe facultatif.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
prefix	requête	non	Préfixe de la clé objet.
limit	requête	non	Nombre d'entrées entre 1 et 5000.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Télécharger l’objet du bucket

GET /v1/object_bucket/{id}/object

Lisez le corps de l'objet brut. Utilisez l'option de téléchargement de Postman pour l'enregistrer.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
key	requête	oui	Clé d'objet obligatoire.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Envoyer un objet dans le bucket

PUT /v1/object_bucket/{id}/object

Sélectionnez un fichier dans Body → binary avant l’envoi. Le point de terminaison accepte des octets bruts, pas des données de formulaire multipart ; la limite d’envoi est de 5 Gio.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
key	requête	oui	Clé d'objet obligatoire.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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

Réponse : HTTP 201

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Supprimer l’objet du bucket

DELETE /v1/object_bucket/{id}/object

Supprimer l'objet sélectionné.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
key	requête	oui	Clé d'objet obligatoire.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 204

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Créer un dossier de bucket

POST /v1/object_bucket/{id}/folders

Créer un marqueur de dossier d’objets.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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

Remplacez YOUR_* du corps avant l’envoi. Le heredoc entre guillemets préserve le JSON littéral.

Réponse : HTTP 201

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Supprimer le dossier du bucket

DELETE /v1/object_bucket/{id}/folders

Supprimer un dossier et son contenu.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
prefix	requête	oui	Préfixe du dossier requis.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Lister les clés d’accès du bucket

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

Lister les métadonnées des clés S3 du bucket.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Créer une clé d’accès au bucket

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

Créez des identifiants S3 pour ce bucket. Conservez le secret renvoyé dans un emplacement privé ; ne publiez pas la réponse.

Définissez object_bucket_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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

Remplacez YOUR_* du corps avant l’envoi. Le heredoc entre guillemets préserve le JSON littéral.

Réponse : HTTP 201

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Supprimer la clé d’accès du bucket

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

Révoquer la clé d’accès S3 sélectionnée.

Définissez object_bucket_id, access_key_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
access_key_id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.