Sobre as APIs do IBM Storage Ceph as a Service

IBM Storage Ceph as a Service fornece duas APIs para configurar e gerenciar seus recursos de armazenamento.

Essas APIs IBM Storage Ceph as a Service usam IBM Cloud® Identity and Access Management para autorizar e autenticar solicitações.

Como os tokens do Cloud Identity and Access Management são relativamente fáceis de utilizar, o curl é uma boa opção para testes básicos e interação com seu armazenamento. Mais informações podem ser localizadas na referência de curl.

As seções a seguir descrevem o conjunto completo de operações da API do IBM Storage Ceph as a Service.

API de gerenciamento de armazenamento em bloco

Use a API de gerenciamento de armazenamento em bloco para provisionar e gerenciar programaticamente os recursos de armazenamento em bloco na implantação do IBM Storage Ceph as a Service, incluindo volumes, hosts e mapeamentos de volume para host.

Bloquear operações

Essas operações criam, excluem, obtêm informações e controlam o comportamento do armazenamento em bloco.

Operação de armazenamento em bloco
Bloqueio de operação	Ação
`GET /volumes`	Usado para recuperar uma lista de todos os volumes de blocos.
`DELETE /volumes/{id}`	Exclui um volume.
`POST /volumes`	Criar volume em uma implantação.
`GET /volumes/{id}`	Recupera um único volume.
`PATCH /volumes/{id}`	Atualiza o nome ou a capacidade de um volume.
`GET /hosts`	Recupera uma lista de todos os hosts na implantação
`POST /hosts`	Cria um novo host.
`DELETE /host/{id}`	Exclui um host específico.
`GET /hosts/{id}`	Recupera um host específico.
`PATCH /hosts/{id}`	Atualiza as informações do host.
`POST /hosts/{id}/volume_mappings`	Criar um mapeamento de volume para um host.
`GET /hosts/{id}/volume_mappings/{volume_mapping_id}`	Recupera um mapeamento de volume único.
`GET /hosts/{id}/volume_mappings`	Recupera as listas de mapeamentos de volume de um host.
`DELETE /hosts/{id}/volume_mappings/{volume_mapping_id}`	Exclui o mapeamento de volume específico.
`DELETE /hosts/{id}/volume_mappings`	Exclui todos os mapeamentos de volume de um host.

API de administração de armazenamento de objetos

Operações de administração

Essas operações criam, excluem, obtêm informações sobre e controlam o comportamento dos objetos de administração.

Operação de administração de objetos
Operação administrativa	Nota
`POST /certificates/{cert_type}`	Crie um certificado “ S3 ”.
`PUT /certificates/{cert_type}`	Substitua ou atualize o certificado S3
`GET /certificates/{cert_type}`	Recupera o status do certificado.
`DELETE /certificates/{cert_type}`	Exclui o certificado S3.
`GET /certificates`	Recupera a lista de certificados configurados
`POST /s3_credentials/{access_key}`	Cria a credencial S3 para o objeto.
`GET /s3_credentials`	Recupera uma ou mais credenciais do site S3.
`DELETE /s3_credentials/{access_key}`	Exclui a credencial S3.

API de armazenamento de objetos S3

A API IBM® Storage Ceph® as a Service Object Storage S3 é uma API baseada em REST para leitura e gravação de objetos.

Esta API IBM Storage Ceph as a Service utiliza IBM Cloud® Identity and Access Management para autenticação e autorização e oferece suporte a um subconjunto da API S3, facilitando a migração de aplicativos para IBM Cloud.

Operações de objeto

Essas operações criam, excluem, obtêm informações e controlam o comportamento de objetos d S3.

Operação de objeto
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.
`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 peças associadas a um ID de upload.

Operações de depósito

Essas operações criam, excluem, obtêm informações sobre e controlam o comportamento dos buckets.

Operação de depósito
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.
`GET` Depósito	Lista objetos em um depósito. Limitado à listagem de 1.000 objetos por vez.
`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.

Mais informações sobre os recursos e casos de uso do site IBM Storage Ceph as a Service podem ser encontradas em ibm.com.