Esta API sua os recursos disponibilizados pelo Oracle Object Storage conforme custos e políticas do fornecedor ( https://www.oracle.com/br/cloud/storage/object-storage/ ).

Ela trabalha no modo de compatibilidade / interoperabilidade com o AWS S3, respeitando as exigências e restrições impostas pela Oracle, conforme documentação do fornecedor ( https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/s3compatibleapi.htm ).

Pré-requisitos

• Conta no Oracle Object Storage;
• Credencias de acesso no modo de compatibilidade ( https://docs.oracle.com/pt-br/iaas/Content/Object/Tasks/s3compatibleapi.htm, https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/s3compatibleapi.htm ).

Configurando um projeto na conta do Oracle Object Storage

Obtenha os dados de acesso seguindo as instruções do tópico: “Configurando o Acesso ao Oracle Cloud Infrastructure” ( https://docs.oracle.com/pt-br/iaas/Content/Object/Tasks/s3compatibleapi.htm ) no manual da Oracle. Você vai precisar das seguintes informações:

• “Access ID” (“Chave de acesso“): Identificador único do acesso (usuário) da conta, normalmente um texto grande (40 caracteres ou mais). EX: “1234567890123456789012345678901234567890” (fictício);
• “Secret Key” (“Chave secreta“): É a senha de acesso, normalmente um texto grande (> 30 caracteres) em base64. EX: “AAAAAAAAbbbbb/ccccc/00/XXXXXXX9999999999999=” (fictício);
• “Region” (“Identificador da região“): Região indica onde o servidor está hospedado (EX: “sa-saopaulo-1“);
• “EndPoint” (“ponto final“): É o endereço completo do seu bucket, contendo namespace, region, e o servidor Oracle. EX: “https://l2apimaker.compat.objectstorage.sa-saopaulo-1.oraclecloud.com” (fictício);
• “Namespace” (“Nome do namespace“): É o endereço que precede o “.compat.objectstorage.” no endepoint do servidor, no exemplo anterior seria: “l2apimaker“;
• “Bucket” (Termo não traduzido): É o container onde os arquivos são armazenados.

De posse dessas informações, você poderá inicializar a conexão.

Configurando a conexão / Inicializando

A criação da conexão usando a função “Nuvem – Inicializar” é o passo inicial antes de utilizar as demais funções, neste ponto deve ser passado os parâmetros a seguir:

1. Tipo (Letras): Informar o texto fixo “ORACLE-OBJECT-STORAGE“;
2. Configurações (Variante): Deve ser um mapeamento com os seguintes dados:

• accesskey_id (Letras) – Access ID do usuário;
• accesskey_secret (Letras) – Secret Key (Senha) de acesso;
• region (Letras) – Sigla da região onde o serviço está sendo executado. EX: “sa-saopaulo-1“;
• bucket (Letras) – Nome do bucket que será utilizado nessa conexão. EX: “arquivos-l2-minha-empresa“;
• endpoint (Letras): caminho completo para acesso ao serviço. EX: “https://l2apimaker.compat.objectstorage.sa-saopaulo-1.oraclecloud.com”.

3. Fluxo de atualização (Fluxo): Não informar o terceiro parâmetro, deixar em branco.