Ações compatíveis com o ONTAP S3
As ações do ONTAP S3 são compatíveis com APIs REST S3 padrão, exceto conforme indicado abaixo. Para obter detalhes, consulte "Referência de API do Amazon S3".
|
|
Essas S3 ações são suportadas especificamente ao usar buckets S3 nativos no ONTAP. Algumas dessas ações, como as associadas ao controle de versão, bloqueios de objetos e outros recursos, não são suportadas ao usar "S3 buckets nas (S3 em volumes nas multiprotocolo)"o . |
A menos que seja indicado para uma operação específica, os seguintes cabeçalhos de solicitação comuns são suportados a partir do ONTAP 9.8:
-
Authorization -
Connection -
Content-Length -
Content-MD5 -
Content-Type -
Date -
Expect -
Host -
x-amz-date
A partir do ONTAP 9.20.1, os seguintes cabeçalhos de checksum são compatíveis com buckets S3 NAS:
-
x-amz-checksum-algorithm -
x-amz-checksum-crc64nvme -
x-amz-checksum-type
Operações do balde
As operações a seguir são suportadas no ONTAP usando APIs AWS S3:
| Funcionamento do balde | Suporte ONTAP começando com |
|---|---|
CreateBucket O ONTAP S3 suporta este cabeçalho adicional:
|
ONTAP 9.11,1 |
DeleteBucket |
ONTAP 9.11,1 |
DeleteBucketCors |
ONTAP 9,8 |
DeleteBucketLifecycle |
ONTAP 9,8 |
DeleteBucketPolicy |
ONTAP 9.12,1 |
GetBucketAcl |
ONTAP 9,8 |
GetBucketCors |
ONTAP 9,8 |
GetBucketLifecycleConfiguration |
ONTAP 9.13,1 *Somente ações de expiração são suportadas |
GetBucketlocalização |
ONTAP 9.10,1 |
Política de GetBucketPolicy |
ONTAP 9.12,1 |
GetBucketControle de versão |
ONTAP 9.11,1 |
Balde para a cabeça |
ONTAP 9,8 |
ListAllMyBuckets |
ONTAP 9,8 |
ListBuckets |
ONTAP 9,8 |
ListBucketVersions |
ONTAP 9.11,1 |
PutBucket |
|
PutBucketCors |
ONTAP 9,8 |
PutBucketLifecycleConfiguration |
ONTAP 9.13.1 * somente ações de expiração são suportadas |
Política de PutBucketPolicy |
ONTAP 9.12,1 |
PutBucketControle de versão |
ONTAP 9.11,1 |
Operações de objetos
A partir do ONTAP 9.19.1, ONTAP S3 oferece suporte à aplicação de gravações condicionais para uploads de objetos e exclusões condicionais para exclusões de objetos. As gravações e exclusões condicionais permitem evitar sobrescritas ou exclusões acidentais de objetos. As operações condicionais funcionam somente se a solicitação for feita usando o método de assinatura AWS_V4 em uma conexão TLS. Os seguintes cabeçalhos condicionais e operações de objeto são suportados:
| Operação do objeto | Cabeçalho condicional |
|---|---|
PutObject CopyObject CompleteMultipartUpload |
If-None-Match If-Match |
DeleteObject DeleteObjects |
If-Match |
A partir do ONTAP 9.20.1, o ONTAP S3 oferece suporte a checksums flexíveis para buckets S3 NAS.
-
O ONTAP valida, armazena e retorna checksums quando os clientes incluem cabeçalhos de checksum nas solicitações.
-
Somente o algoritmo CRC-64NVME e o
FULL_OBJECTtipo de checksum são suportados. -
O suporte flexível a checksum se aplica apenas a buckets S3 NAS.
A partir do ONTAP 9.9,1, o ONTAP S3 oferece suporte a metadados e marcação de objetos.
-
PutObject e CreateMultipartUpload incluem pares de chave-valor usando
x-amz-meta-<key>.Por exemplo
x-amz-meta-project: ontap_s3: . -
GetObject e HeadObject retornam metadados definidos pelo usuário.
-
Ao contrário dos metadados, as tags podem ser lidas independentemente dos objetos usando:
-
Marcação de objetos
-
GetObjectTagging
-
DeleteObjectTagging
-
A partir do ONTAP 9.11,1, o ONTAP S3 oferece suporte ao controle de versão de objetos e às ações associadas a essas APIs do ONTAP:
-
GetBucketControle de versão
-
ListBucketVersions
-
PutBucketControle de versão
A menos que seja indicado para uma operação específica, os seguintes parâmetros de consulta de URI são suportados:
-
versionId(conforme exigido para operações de objetos começando com ONTAP 9.12.1)
| Operação do objeto | Suporte ONTAP começando com |
|---|---|
AbortMultipartUpload O ONTAP S3 suporta este parâmetro de consulta URI adicional:
|
ONTAP 9,8 |
CompleteMultipartUpload O ONTAP S3 suporta este parâmetro de consulta URI adicional:
|
ONTAP 9,8 |
CopyObject O ONTAP S3 suporta estes cabeçalhos adicionais:
|
ONTAP 9.12,1 |
CreateMultipartUpload O ONTAP S3 suporta estes cabeçalhos adicionais:
|
ONTAP 9,8 |
DeleteObject O ONTAP S3 suporta este cabeçalho adicional:
|
ONTAP 9,8 |
DeleteObjects o ONTAP S3 suporta este cabeçalho adicional: * |
ONTAP 9.11,1 |
DeleteObjectTagging |
ONTAP 9.9,1 |
GetObject O ONTAP S3 suporta estes parâmetros de consulta URI adicionais:
E estes cabeçalhos de solicitação adicionais:
|
ONTAP 9,8 |
GetObjectAcl |
ONTAP 9,8 |
ObterAtributosDeObjeto O ONTAP S3 suporta todos os parâmetros e cabeçalhos comuns para esta solicitação, o ONTAP S3 também suporta este cabeçalho adicional:
|
ONTAP 9.17.1 |
GetObjectRetention |
ONTAP 9.14,1 |
GetObjectTagging |
ONTAP 9.9,1 |
HeadObject o ONTAP S3 suporta todos os parâmetros e cabeçalhos comuns para esta solicitação. |
ONTAP 9,8 |
ListMultipartUploads O ONTAP S3 suporta estes parâmetros URI adicionais:
|
ONTAP 9,8 |
ListObjects O ONTAP S3 suporta estes parâmetros URI adicionais:
|
ONTAP 9,8 |
ListObjectsV2 O ONTAP S3 suporta estes parâmetros URI adicionais:
|
ONTAP 9,8 |
ListObjectVersions O ONTAP S3 suporta estes parâmetros URI adicionais:
|
ONTAP 9.11,1 |
ListParts O ONTAP S3 suporta estes parâmetros URI adicionais:
|
ONTAP 9,8 |
PutObject O ONTAP S3 suporta estes cabeçalhos adicionais:
|
ONTAP 9,8 |
PutObjectLockConfiguration |
ONTAP 9.14,1 |
Retenção PutObjectRetention O ONTAP S3 suporta este cabeçalho adicional:
|
ONTAP 9.14,1 |
Marcação de objetos |
ONTAP 9.9,1 |
Para UploadPart, o ONTAP S3 suporta todos os parâmetros e cabeçalhos comuns para esta solicitação. |
ONTAP 9,8 |
UploadPartCopy O ONTAP S3 suporta estes parâmetros URI adicionais:
E estes cabeçalhos de solicitação adicionais:
|
ONTAP 9.12,1 |
Políticas de grupo
Essas operações não são específicas do S3 e geralmente estão associadas a processos de identidade e gerenciamento (IAM). O ONTAP é compatível com esses comandos, mas não usa as APIs REST do IAM.
-
Criar política
-
Política do AttachGroup
Gerenciamento de usuários
Essas operações não são específicas do S3 e geralmente estão associadas aos processos do IAM.
-
CreateUser
-
DeleteUser
-
CreateGroup
-
DeleteGroup
S3 ações por liberação
A partir do ONTAP 9.20.1, os buckets NAS S3 em volumes FlexCache oferecem suporte a operações de cópia de objetos no lado do servidor usando as APIs S3 CopyObject e UploadPartCopy. Você pode copiar objetos no mesmo bucket NAS FlexCache ou de um bucket NAS S3 com suporte de um volume FlexGroup para um bucket NAS FlexCache. Não há suporte para cópia de um bucket NAS S3 com suporte de um volume FlexVol para um bucket NAS FlexCache, entre dois buckets NAS FlexCache ou de um bucket NAS FlexCache para um bucket NAS não FlexCache.
O ONTAP 9.20.1 adiciona suporte a checksums flexíveis usando o algoritmo CRC-64NVME para buckets S3 NAS. O ONTAP valida, armazena e retorna checksums quando os clientes incluem cabeçalhos de checksum em suas solicitações. As seguintes operações suportam cabeçalhos de checksum flexíveis:
-
PutObject
-
CreateMultipartUpload
-
UploadPart
-
CompleteMultipartUpload
-
CopyObject
-
UploadPartCopy
-
GetObject
-
HeadObject
-
ListObjectsV2
-
ListParts
Somente o algoritmo CRC-64NVME e o tipo de checksum FULL_OBJECT são suportados. O suporte flexível a checksum está disponível apenas para buckets S3 NAS.
ONTAP 9.14,1 adiciona suporte para bloqueio de objetos S3.
|
|
Operações de retenção legal (bloqueios sem tempos de retenção definidos) não são suportadas. |
-
GetObjectLockConfiguration
-
GetObjectRetention
-
PutObjectLockConfiguration
-
Retenção PutObjectRetention
O ONTAP 9.13,1 adiciona suporte ao gerenciamento do ciclo de vida do bucket.
-
DeleteBucketLifecycleConfiguration
-
GetBucketLifecycleConfiguration
-
PutBucketLifecycleConfiguration
O ONTAP 9.12,1 adiciona suporte a políticas de bucket e a capacidade de copiar objetos.
-
DeleteBucketPolicy
-
Política de GetBucketPolicy
-
Política de PutBucketPolicy
-
CopyObject
-
UploadPartCopy
O ONTAP 9.11,1 adiciona suporte para versionamento, URLs pré-assinados, uploads em grupo e suporte para ações S3 comuns, como criar e excluir buckets usando APIs do S3.
-
O ONTAP S3 adiciona suporte para uploads em partes, assinando solicitações usando
x-amz-content-sha256: STREAMING-AWS4-HMAC-SHA256-PAYLOAD -
O ONTAP S3 agora oferece suporte a aplicativos clientes usando URLs pré-assinados para compartilhar objetos ou permitir que outros usuários façam upload de objetos sem exigir credenciais de usuário.
-
CreateBucket
-
DeleteBucket
-
GetBucketControle de versão
-
ListBucketVersions
-
PutBucket
-
PutBucketControle de versão
-
DeleteObjects
-
ListObjectVersions
|
|
Como o FlexGroup subjacente não é criado até que o primeiro bucket seja, um bucket deve ser criado no ONTAP antes que um cliente externo possa criar um bucket usando o CreateBucket. |
ONTAP 9.10,1 adiciona suporte para SnapMirror S3 e GetBucketLocation.
-
GetBucketlocalização
O ONTAP 9.9,1 adiciona suporte para metadados de objetos e suporte a marcação ao ONTAP S3.
-
PutObject e CreateMultipartUpload agora incluem pares de chave-valor usando
x-amz-meta-<key>. Por exemplox-amz-meta-project: ontap_s3: . -
GetObject e HeadObject agora retornam metadados definidos pelo usuário.
Tags também podem ser usadas com baldes. Ao contrário dos metadados, as tags podem ser lidas independentemente dos objetos usando:
-
Marcação de objetos
-
GetObjectTagging
-
DeleteObjectTagging