API de armazenamento de objetos

Gerencie os buckets e objetos da equipe. Os nomes de buckets são globalmente únicos. As importações de objetos usam o corpo bruto do arquivo. Credenciais S3 recém-criadas aparecem nas respostas; mantenha essas respostas privadas.

Usar Autenticação da API para pedidos protegidos. Exemplos usam seus próprios IDs de recursos e um token temporário; exemplos de resposta salvos são sintéticos.

Método	Caminho	Operação
GET	/v1/object_bucket	Listar buckets
POST	/v1/object_bucket	Criar bucket
GET	/v1/object_bucket/{id}	Obter bucket
PUT	/v1/object_bucket/{id}	Atualizar bucket
DELETE	/v1/object_bucket/{id}	Excluir bucket
GET	/v1/object_bucket/{id}/objects	Listar objetos do bucket
GET	/v1/object_bucket/{id}/object	Baixar objeto do bucket
PUT	/v1/object_bucket/{id}/object	Enviar objeto para o bucket
DELETE	/v1/object_bucket/{id}/object	Excluir objeto do bucket
POST	/v1/object_bucket/{id}/folders	Criar pasta no bucket
DELETE	/v1/object_bucket/{id}/folders	Excluir pasta do bucket
GET	/v1/object_bucket/{id}/access-keys	Listar chaves de acesso ao bucket
POST	/v1/object_bucket/{id}/access-keys	Criar chave de acesso ao bucket
DELETE	/v1/object_bucket/{id}/access-keys/{access_key_id}	Excluir chave de acesso ao bucket

Listar buckets

GET /v1/object_bucket

Retorna uma lista paginada de ObjectBucket

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
page	consulta	não	Número da página
per_page	consulta	não	Itens por página

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

Lista de ObjectBucket

Campos de resposta

Campo	Tipo	Descrição
data	array
data[].acl_policy	objeto	Política ACL de objetos do Adios. O padrão é privado, com regras opcionais de prefixos públicos.
data[].backend_bucket	string	Nome do bucket no provedor. Usa o nome normalizado do bucket de objetos por padrão.
data[].bucket_id	string
data[].cache_policy	objeto	Política de cache do gateway para leitura pública de objetos.
data[].canonical_hostname	string	Nome de host de bucket gerado pelo Adios, como bucket.s3.adios.dev.
data[].cdn_policy	objeto	Política do CDN Adios para leitura pública de objetos. Substitui cache_policy quando definida.
data[].config	objeto	Opções adicionais de provedor e referências secretas.
data[].cors_policy	objeto	Política CORS S3 aplicada pelo Adios antes de encaminhar ao backend de objetos.
data[].created_at	inteiro	(Timestamp Unix)
data[].deleted_at	inteiro	(Timestamp Unix)
data[].endpoint	string	Endpoint compatível com S3 opcional que substitui o padrão para buckets importados.
data[].managed	booleano
data[].name	string	Espaço de nomes globalmente único do bucket, usado no roteamento de bucket.s3.adios.dev e s3.adios.dev/bucket.
data[].provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
data[].public_hostname	string	Nome de host personalizado opcional pertencente ao usuário, servido pelo gateway anycast para acesso ao bucket; os espaços de nomes adios.dev e adios.run são reservados.
data[].public_read	booleano
data[].region	string
data[].route_id	string	Rota de gateway sincronizada para os domínios personalizados de public_hostname.
data[].s3_path_endpoint	string	Endpoint S3 de estilo caminho compartilhado, como https://s3.adios.dev.
data[].status	string	Valores permitidos: pending, available, failed, deleted.
data[].team_id	string
data[].updated_at	inteiro	(Timestamp Unix)
data[].versioning	booleano
pagination	objeto
pagination.page	inteiro	Número da página atual
pagination.per_page	inteiro	Número de itens por página
pagination.total	inteiro	Número total de itens

Exemplo ilustrativo; não é uma resposta real:

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

Criar bucket

POST /v1/object_bucket

Cria um novo objeto ObjectBucket

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Campos da requisição (o corpo contém um exemplo editável):

Campo	Tipo	Obrigatório	Descrição
acl_policy	objeto	não	Política ACL de objetos do Adios. O padrão é privado, com regras opcionais de prefixos públicos.
backend_bucket	string	não	Nome do bucket no provedor. Usa o nome normalizado do bucket de objetos por padrão.
cache_policy	objeto	não	Política de cache do gateway para leitura pública de objetos.
canonical_hostname	string	não	Nome de host de bucket gerado pelo Adios, como bucket.s3.adios.dev.
cdn_policy	objeto	não	Política do CDN Adios para leitura pública de objetos. Substitui cache_policy quando definida.
config	objeto	não	Opções adicionais de provedor e referências secretas.
cors_policy	objeto	não	Política CORS S3 aplicada pelo Adios antes de encaminhar ao backend de objetos.
endpoint	string	não	Endpoint compatível com S3 opcional que substitui o padrão para buckets importados.
managed	booleano	sim	Padrão: true.
name	string	sim	Espaço de nomes globalmente único do bucket, usado no roteamento de bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	sim	Valores permitidos: adios, minio, ceph_rgw, external_s3. Padrão: "adios".
public_hostname	string	não	Nome de host personalizado opcional pertencente ao usuário, servido pelo gateway anycast para acesso ao bucket; os espaços de nomes adios.dev e adios.run são reservados.
public_read	booleano	sim	Padrão: false.
region	string	não	Padrão: "default".
route_id	string	não	Rota de gateway sincronizada para os domínios personalizados de public_hostname.
s3_path_endpoint	string	não	Endpoint S3 de estilo caminho compartilhado, como https://s3.adios.dev.
status	string	sim	Valores permitidos: pending, available, failed, deleted. Padrão: "pending".
team_id	string	sim
versioning	booleano	sim	Padrão: false.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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

Substitua YOUR_* no corpo antes de enviar. O heredoc com delimitador entre aspas mantém o JSON literal.

Resposta: HTTP 201

ObjectBucket criado

Campos de resposta

Campo	Tipo	Descrição
acl_policy	objeto	Política ACL de objetos do Adios. O padrão é privado, com regras opcionais de prefixos públicos.
backend_bucket	string	Nome do bucket no provedor. Usa o nome normalizado do bucket de objetos por padrão.
bucket_id	string
cache_policy	objeto	Política de cache do gateway para leitura pública de objetos.
canonical_hostname	string	Nome de host de bucket gerado pelo Adios, como bucket.s3.adios.dev.
cdn_policy	objeto	Política do CDN Adios para leitura pública de objetos. Substitui cache_policy quando definida.
config	objeto	Opções adicionais de provedor e referências secretas.
cors_policy	objeto	Política CORS S3 aplicada pelo Adios antes de encaminhar ao backend de objetos.
created_at	inteiro	(Timestamp Unix)
deleted_at	inteiro	(Timestamp Unix)
endpoint	string	Endpoint compatível com S3 opcional que substitui o padrão para buckets importados.
managed	booleano
name	string	Espaço de nomes globalmente único do bucket, usado no roteamento de bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nome de host personalizado opcional pertencente ao usuário, servido pelo gateway anycast para acesso ao bucket; os espaços de nomes adios.dev e adios.run são reservados.
public_read	booleano
region	string
route_id	string	Rota de gateway sincronizada para os domínios personalizados de public_hostname.
s3_path_endpoint	string	Endpoint S3 de estilo caminho compartilhado, como https://s3.adios.dev.
status	string	Valores permitidos: pending, available, failed, deleted.
team_id	string
updated_at	inteiro	(Timestamp Unix)
versioning	booleano

Exemplo ilustrativo; não é uma resposta real:

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

Obter bucket

GET /v1/object_bucket/{id}

Retorna um objeto ObjectBucket

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

ObjectBucket

Campos de resposta

Campo	Tipo	Descrição
acl_policy	objeto	Política ACL de objetos do Adios. O padrão é privado, com regras opcionais de prefixos públicos.
backend_bucket	string	Nome do bucket no provedor. Usa o nome normalizado do bucket de objetos por padrão.
bucket_id	string
cache_policy	objeto	Política de cache do gateway para leitura pública de objetos.
canonical_hostname	string	Nome de host de bucket gerado pelo Adios, como bucket.s3.adios.dev.
cdn_policy	objeto	Política do CDN Adios para leitura pública de objetos. Substitui cache_policy quando definida.
config	objeto	Opções adicionais de provedor e referências secretas.
cors_policy	objeto	Política CORS S3 aplicada pelo Adios antes de encaminhar ao backend de objetos.
created_at	inteiro	(Timestamp Unix)
deleted_at	inteiro	(Timestamp Unix)
endpoint	string	Endpoint compatível com S3 opcional que substitui o padrão para buckets importados.
managed	booleano
name	string	Espaço de nomes globalmente único do bucket, usado no roteamento de bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nome de host personalizado opcional pertencente ao usuário, servido pelo gateway anycast para acesso ao bucket; os espaços de nomes adios.dev e adios.run são reservados.
public_read	booleano
region	string
route_id	string	Rota de gateway sincronizada para os domínios personalizados de public_hostname.
s3_path_endpoint	string	Endpoint S3 de estilo caminho compartilhado, como https://s3.adios.dev.
status	string	Valores permitidos: pending, available, failed, deleted.
team_id	string
updated_at	inteiro	(Timestamp Unix)
versioning	booleano

Exemplo ilustrativo; não é uma resposta real:

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

Atualizar bucket

PUT /v1/object_bucket/{id}

Atualiza um objeto ObjectBucket existente

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Campos da requisição (o corpo contém um exemplo editável):

Campo	Tipo	Obrigatório	Descrição
acl_policy	objeto	não	Política ACL de objetos do Adios. O padrão é privado, com regras opcionais de prefixos públicos.
backend_bucket	string	não	Nome do bucket no provedor. Usa o nome normalizado do bucket de objetos por padrão.
cache_policy	objeto	não	Política de cache do gateway para leitura pública de objetos.
canonical_hostname	string	não	Nome de host de bucket gerado pelo Adios, como bucket.s3.adios.dev.
cdn_policy	objeto	não	Política do CDN Adios para leitura pública de objetos. Substitui cache_policy quando definida.
config	objeto	não	Opções adicionais de provedor e referências secretas.
cors_policy	objeto	não	Política CORS S3 aplicada pelo Adios antes de encaminhar ao backend de objetos.
endpoint	string	não	Endpoint compatível com S3 opcional que substitui o padrão para buckets importados.
managed	booleano	sim	Padrão: true.
name	string	sim	Espaço de nomes globalmente único do bucket, usado no roteamento de bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	sim	Valores permitidos: adios, minio, ceph_rgw, external_s3. Padrão: "adios".
public_hostname	string	não	Nome de host personalizado opcional pertencente ao usuário, servido pelo gateway anycast para acesso ao bucket; os espaços de nomes adios.dev e adios.run são reservados.
public_read	booleano	sim	Padrão: false.
region	string	não	Padrão: "default".
route_id	string	não	Rota de gateway sincronizada para os domínios personalizados de public_hostname.
s3_path_endpoint	string	não	Endpoint S3 de estilo caminho compartilhado, como https://s3.adios.dev.
status	string	sim	Valores permitidos: pending, available, failed, deleted. Padrão: "pending".
team_id	string	sim
versioning	booleano	sim	Padrão: false.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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

Substitua YOUR_* no corpo antes de enviar. O heredoc com delimitador entre aspas mantém o JSON literal.

Resposta: HTTP 200

ObjectBucket atualizado

Campos de resposta

Campo	Tipo	Descrição
acl_policy	objeto	Política ACL de objetos do Adios. O padrão é privado, com regras opcionais de prefixos públicos.
backend_bucket	string	Nome do bucket no provedor. Usa o nome normalizado do bucket de objetos por padrão.
bucket_id	string
cache_policy	objeto	Política de cache do gateway para leitura pública de objetos.
canonical_hostname	string	Nome de host de bucket gerado pelo Adios, como bucket.s3.adios.dev.
cdn_policy	objeto	Política do CDN Adios para leitura pública de objetos. Substitui cache_policy quando definida.
config	objeto	Opções adicionais de provedor e referências secretas.
cors_policy	objeto	Política CORS S3 aplicada pelo Adios antes de encaminhar ao backend de objetos.
created_at	inteiro	(Timestamp Unix)
deleted_at	inteiro	(Timestamp Unix)
endpoint	string	Endpoint compatível com S3 opcional que substitui o padrão para buckets importados.
managed	booleano
name	string	Espaço de nomes globalmente único do bucket, usado no roteamento de bucket.s3.adios.dev e s3.adios.dev/bucket.
provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nome de host personalizado opcional pertencente ao usuário, servido pelo gateway anycast para acesso ao bucket; os espaços de nomes adios.dev e adios.run são reservados.
public_read	booleano
region	string
route_id	string	Rota de gateway sincronizada para os domínios personalizados de public_hostname.
s3_path_endpoint	string	Endpoint S3 de estilo caminho compartilhado, como https://s3.adios.dev.
status	string	Valores permitidos: pending, available, failed, deleted.
team_id	string
updated_at	inteiro	(Timestamp Unix)
versioning	booleano

Exemplo ilustrativo; não é uma resposta real:

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

Excluir bucket

DELETE /v1/object_bucket/{id}

Exclui um objeto ObjectBucket

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

O recurso foi apagado.

Campos de resposta

Campo	Tipo	Descrição
message	string

Exemplo ilustrativo; não é uma resposta real:

{
  "message": "Deleted successfully"
}

Listar objetos do bucket

GET /v1/object_bucket/{id}/objects

Navegue por objetos sob um prefixo opcional.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
prefix	consulta	não	Prefixo da chave do objeto.
limit	consulta	não	Número de entradas entre 1 e 5000.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Baixar objeto do bucket

GET /v1/object_bucket/{id}/object

Leia o corpo bruto do objeto. Use a opção de download do Postman para salvá-lo.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
key	consulta	sim	Chave obrigatória do objeto.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Enviar objeto para o bucket

PUT /v1/object_bucket/{id}/object

Selecione um arquivo em Body → binary antes de enviar. O endpoint aceita bytes brutos, não dados de formulário multipart; o limite de envio é de 5 GiB.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
key	consulta	sim	Chave obrigatória do objeto.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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

Resposta: HTTP 201

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Excluir objeto do bucket

DELETE /v1/object_bucket/{id}/object

Exclua o objeto selecionado.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
key	consulta	sim	Chave obrigatória do objeto.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 204

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Criar pasta no bucket

POST /v1/object_bucket/{id}/folders

Crie um marcador de pasta de objetos.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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

Substitua YOUR_* no corpo antes de enviar. O heredoc com delimitador entre aspas mantém o JSON literal.

Resposta: HTTP 201

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Excluir pasta do bucket

DELETE /v1/object_bucket/{id}/folders

Apagar uma pasta e o seu conteúdo.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
prefix	consulta	sim	Prefixo obrigatório da pasta.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Listar chaves de acesso ao bucket

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

Liste os metadados das chaves S3 do bucket.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Criar chave de acesso ao bucket

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

Crie credenciais S3 para este bucket. Salve o segredo retornado em local privado; não publique a resposta.

Defina object_bucket_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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

Substitua YOUR_* no corpo antes de enviar. O heredoc com delimitador entre aspas mantém o JSON literal.

Resposta: HTTP 201

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.

Excluir chave de acesso ao bucket

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

Revogue a chave de acesso S3 selecionada.

Defina object_bucket_id, access_key_id usando IDs das suas próprias respostas da API.

Esta requisição altera dados ou inicia uma ação. Confira o destino e o corpo antes de enviá-la.

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
access_key_id	caminho	sim	Identificador de recurso dos resultados da API da sua equipe.
X-Tenant-ID	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de recursos.

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"

Resposta: HTTP 200

Resposta bem sucedida. Inspecione o estado retornado para operações que iniciam trabalho assíncrono.

Um esquema completo de corpo-resposta não é publicado para esta operação personalizada. Inspecione o conteúdo e o status retornados; nenhuma carga útil é assumida aqui.