Sobre a API S3 do IBM Cloud Object Storage
A API do IBM Cloud® Object Storage é uma API baseada em REST para objetos de leitura e composição.
Ela usa o IBM Cloud® Identity and Access Management para autenticação e autorização e suporta um subconjunto da API S3 para fácil migração de aplicativos para o IBM Cloud.
Esta documentação de referência está sendo continuamente melhorada. Se você tiver perguntas técnicas sobre como usar a API em seu aplicativo, poste-as no Stack Overflow. Inclua as tags ibm-cloud-platform e object-storage e ajude a melhorar esta documentação com seu feedback.
Como é relativamente fácil trabalhar com os tokens do Cloud Identity and Access Management, o curl é uma boa opção para teste básico e interação com seu armazenamento. Mais informações podem ser localizadas na referência de curl.
As tabelas a seguir descrevem o conjunto completo de operações da API do IBM Cloud Object Storage. Para obter mais informações, consulte a página de referência da API para depósitos ou objetos.
Operações de depósito
Essas operações criam, excluem, obtêm informações e controlam o comportamento de depósitos.
| Operação de depósito | Nota |
|---|---|
GET Depósitos |
Usado para recuperar uma lista de todos os depósitos que pertencem a uma conta. |
DELETE Depósito |
Exclui um depósito vazio. |
DELETE CORS de depósito |
Exclui qualquer configuração de CORS (compartilhamento de recurso de origem cruzada) definida em um depósito. |
GET Depósito |
Lista objetos em um depósito. Limitado à listagem de 1.000 objetos por vez. |
GET CORS de depósito |
Recupera qualquer configuração de CORS definida em um depósito. |
HEAD Depósito |
Recupera os cabeçalhos de um depósito. |
GET uploads de múltiplas partes |
Lista uploads de múltiplas partes que não estão concluídos ou cancelados. |
PUT Depósito |
Os depósitos têm restrições de nomenclatura. As contas são limitadas a 100 depósitos. |
PUT CORS de depósito |
Cria uma configuração de CORS para um depósito. |
Operações de objeto
Essas operações criam, excluem, obtêm informações e controlam o comportamento de objetos.
| Operação de objeto | Nota |
|---|---|
DELETE Objeto |
Exclui um objeto de um depósito. |
DELETE Em lote |
Exclui muitos objetos de um depósito com uma operação. |
GET Objeto |
Recupera um objeto de um depósito. |
HEAD Objeto |
Recupera os cabeçalhos de um objeto. |
OPTIONS Objeto |
Verifica a configuração de CORS para ver se uma solicitação específica pode ser enviada. |
PUT Objeto |
Inclui um objeto em um depósito. |
PUT Objeto (copiar) |
Cria uma cópia de um objeto. |
| Iniciar upload de múltiplas partes | Cria um ID de upload para um conjunto de partes a serem transferidas por upload. |
| Fazer upload de parte | Faz upload de uma parte de um objeto que está associado a um ID de upload. |
| Fazer upload de parte (copiar) | Faz upload de uma parte de um objeto existente que está associado a um ID de upload. |
| Concluir upload de múltiplas partes | Monta um objeto de partes que estão associadas a um ID de upload. |
| Cancelar upload de múltiplas partes | Cancela o upload e exclui as partes pendentes que estão associadas a um ID de upload. |
| Listar partes | Retorna uma lista de partes que estão associadas a um ID de upload |
Mais informações sobre recursos e casos de uso do IBM Cloud Object Storage podem ser localizadas em ibm.com.