Suporte à API de Compatibilidade com Amazon S3 do Object Storage

Existe suporte para as seguintes APIs de bucket:

• DeleteBucket
• GetLocation
• HeadBucket
• GetService (listar todos os meus buckets)
• ListObjects
• PutBucket

Existe suporte para as seguintes APIs de objeto:

• BulkDelete
• DeleteObject
• GetObject
• HeadObject
• PutObject
• RestoreObjects

Existe suporte para as seguintes APIs de upload multiparte:

• AbortMultipartUpload
• CompleteMultipartUpload
• InitiateMultipartUpload
• ListParts
• ListUploads
• UploadPart

Existe suporte para as seguintes APIs de aplicação de tag:

• DeleteBucketTagging
• GetBucketTagging
• PutBucketTagging

Usando cabeçalhos opcionais de API, você pode fornecer sua própria chave de criptografia AES de 256 bits que é usada para criptografar e descriptografar objetos de upload e download feitos no Object Storage.

Para usar suas próprias chaves para criptografia do servidor, especifique os três seguintes três cabeçalhos de solicitação com as informações da chave de criptografia:

O Object Storage tem APIs distintas para copiar objetos e copiar partes. O Amazon S3 usa a presença dos seguintes cabeçalhos em PutObject e UploadPart para localizar as operações da cópia. Para copiar um objeto de origem criptografado com uma chave SSE-C, você deve especificar esses três cabeçalhos para que a decodificação do objeto pelo Object Storage seja possível.

Observe o seguinte em relação aos recursos de API que não são suportados ao usar os SDKs e ferramentas anteriores:

• O AWS Signature Versão 2 (SigV2) não é suportado. Em vez disso, use o mecanismo de assinatura AWS Signature Versão 4.

Usando cabeçalhos opcionais de API, você pode fornecer sua própria chave de criptografia no serviço Vault para criptografar objetos transferidos por upload para o serviço Object Storage.

Para usar suas próprias chaves no serviço Vault para criptografia do servidor, especifique o seguinte cabeçalho de solicitação com o OCID da chave no serviço Vault:

Os clientes compatíveis com S3 podem fazer upload de objetos usando aws-chunked no cabeçalho Content-Encoding. Há suporte para uploads de parte única e solicitações UploadPart multiparte. Há suporte para payloads de streaming do AWS SigV4, incluindo:

• STREAMING-AWS4-HMAC-SHA256-PAYLOAD
• STREAMING-AWS4-HMAC-SHA256-PAYLOAD-TRAILER
• STREAMING-UNSIGNED-PAYLOAD-TRAILER

Os clientes podem enviar uploads do aws-chunked com cabeçalhos HTTP Content-Length ou Transfer-Encoding: chunked. Os clientes devem fornecer x-amz-decoded-content-length, que a API de Compatibilidade com Amazon S3 trata como o objeto ou tamanho de peça real. As assinaturas de bloco são validadas, portanto, os uploads com dados de bloco adulterados ou assinaturas de bloco inválidas são rejeitados. As assinaturas de trailer são validadas para uploads assinados no modo de trailer, portanto, blocos de trailer adulterados também são rejeitados. A validação da soma de verificação do rodapé é suportada para:

• CRC32
• CRC32C
• SHA256
• CRC64NVME

Incompatibilidade de soma de verificação faz com que o upload falhe durante o processamento da solicitação. As somas de verificação do trailer SHA256 se integram ao comportamento additional-checksum existente, para que possam ser persistidas de forma consistente com a semântica de soma de verificação da API de Compatibilidade com Amazon S3 existente. As somas de verificação do trailer CRC32, CRC32C e CRC64NVME são somente para verificação; portanto, elas são validadas, mas não persistidas, como metadados de objeto. O comportamento de upload da API de Compatibilidade com Amazon S3 existente para uploads não descompactados permanece inalterado.

As versões mais recentes do AWS SDK não adicionam automaticamente o cabeçalho Content-MD5 e, em vez disso, mudaram para novos cabeçalhos (como x-amz-checksum-crc32) como a soma de verificação padrão. O fluxo DeleteObjects / BulkDelete na API de Compatibilidade com Amazon S3 suporta x-amz-checksum-sha256 e x-amz-checksum-crc32c como alternativas ao Content-MD5 para validar o corpo da solicitação.

S3Client s3Client = S3Client.builder()
    .addPlugin(LegacyMd5Plugin.create())
    .endpointOverride(URI.create(endpoint))
    .credentialsProvider(StaticCredentialsProvider.create(
        AwsBasicCredentials.create(accessKey, secretKey)))
    .forcePathStyle(true)
    .build();

Você pode configurar vários aplicativos clientes para se comunicar com os pontos finais compatíveis com Amazon S3 do Object Storage. Este tópico fornece alguns exemplos de configuração para Clientes do Amazon S3 compatíveis.