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
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.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 este cabeçalho de solicitação adicional:
|
ONTAP 9,8 |
GetObjectAcl |
ONTAP 9,8 |
ObterAtributosDeObjeto O ONTAP S3 suporta este cabeçalho adicional:
|
ONTAP 9.17.1 |
GetObjectRetention |
ONTAP 9.14,1 |
GetObjectTagging |
ONTAP 9.9,1 |
HeadObject |
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 |
UploadPart |
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
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