Skip to main content
이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

StorageGRID에서 지원되는 S3 API 요청

PDF

이 페이지에서는 StorageGRID가 Amazon Simple Storage Service(S3) API를 지원하는 방법을 요약합니다.

이 페이지에는 StorageGRID에서 지원하는 S3 작업만 포함되어 있습니다.

참고 각 작업에 대한 AWS 설명서를 보려면 제목의 링크를 선택하십시오.

일반적인 URI 쿼리 매개변수 및 요청 헤더

별도로 명시되지 않은 경우, 다음과 같은 일반적인 URI 쿼리 매개변수가 지원됩니다.

  • versionId (객체 연산에 필요한 사항)

별도로 명시되지 않은 경우, 다음과 같은 일반 요청 헤더가 지원됩니다.

  • Authorization

  • Connection

  • Content-Length

  • Content-MD5

  • Content-Type

  • Date

  • Expect

  • Host

  • x-amz-date

관련 정보

"AbortMultipartUpload"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 추가적으로 다음 URI 쿼리 매개변수도 지원합니다.

  • uploadId

요청 본문

None

StorageGRID 문서

"멀티파트 업로드 작업"

"CompleteMultipartUpload"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 추가적으로 다음 URI 쿼리 매개변수도 지원합니다.

  • uploadId

  • x-amz-checksum-sha256

요청 본문 XML 태그

StorageGRID는 다음과 같은 요청 본문 XML 태그를 지원합니다.

  • ChecksumSHA256

  • CompleteMultipartUpload

  • ETag

  • Part

  • PartNumber

StorageGRID 문서

"CompleteMultipartUpload"

"CopyObject"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 헤더도 지원합니다.

  • x-amz-copy-source

  • x-amz-copy-source-if-match

  • x-amz-copy-source-if-modified-since

  • x-amz-copy-source-if-none-match

  • x-amz-copy-source-if-unmodified-since

  • x-amz-copy-source-server-side-encryption-customer-algorithm

  • x-amz-copy-source-server-side-encryption-customer-key

  • x-amz-copy-source-server-side-encryption-customer-key-MD5

  • x-amz-metadata-directive

  • x-amz-object-lock-legal-hold

  • x-amz-object-lock-mode

  • x-amz-object-lock-retain-until-date

  • x-amz-server-side-encryption

  • x-amz-server-side-encryption-customer-algorithm

  • x-amz-server-side-encryption-customer-key

  • x-amz-server-side-encryption-customer-key-MD5

  • x-amz-storage-class

  • x-amz-tagging

  • x-amz-tagging-directive

  • x-amz-meta-<metadata-name>

요청 본문

None

StorageGRID 문서

"CopyObject"

"CreateBucket"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 헤더도 지원합니다.

  • x-amz-bucket-object-lock-enabled

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"버킷에 대한 작업"

"CreateMultipartUpload"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 헤더도 지원합니다.

  • Cache-Control

  • Content-Disposition

  • Content-Encoding

  • Content-Language

  • Expires

  • x-amz-checksum-algorithm

  • x-amz-server-side-encryption

  • x-amz-storage-class

  • x-amz-server-side-encryption-customer-algorithm

  • x-amz-server-side-encryption-customer-key

  • x-amz-server-side-encryption-customer-key-MD5

  • x-amz-tagging

  • x-amz-object-lock-mode

  • x-amz-object-lock-retain-until-date

  • x-amz-object-lock-legal-hold

  • x-amz-meta-<metadata-name>

요청 본문

None

StorageGRID 문서

"CreateMultipartUpload"

"DeleteBucket"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

StorageGRID 문서

"버킷에 대한 작업"

"DeleteBucketCors"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"DeleteBucketEncryption"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"DeleteBucketLifecycle"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"DeleteBucketPolicy"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"DeleteBucketReplication"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"DeleteBucketTagging"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"DeleteObject"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더을 지원하며, 추가로 다음 요청 헤더도 지원합니다.

  • x-amz-bypass-governance-retention

요청 본문

None

StorageGRID 문서

"객체에 대한 연산"

"DeleteObjects"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더을 지원하며, 추가로 다음 요청 헤더도 지원합니다.

  • x-amz-bypass-governance-retention

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"객체에 대한 연산"

"DeleteObjectTagging"

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"객체에 대한 연산"

"GetBucketAcl"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketCors"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketEncryption"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketLifecycleConfiguration"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"GetBucketLocation"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketNotificationConfiguration"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketPolicy"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketReplication"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketTagging"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetBucketVersioning"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"GetObject"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 URI 쿼리 매개변수를 지원하며, 추가로 다음과 같은 URI 쿼리 매개변수도 지원합니다.

  • x-amz-checksum-mode

  • partNumber

  • response-cache-control

  • response-content-disposition

  • response-content-encoding

  • response-content-language

  • response-content-type

  • response-expires

그리고 다음과 같은 추가 요청 헤더가 있습니다.

  • Range

  • x-amz-server-side-encryption-customer-algorithm

  • x-amz-server-side-encryption-customer-key

  • x-amz-server-side-encryption-customer-key-MD5

  • If-Match

  • If-Modified-Since

  • If-None-Match

  • If-Unmodified-Since

요청 본문

None

StorageGRID 문서

"GetObject"

"GetObjectAcl"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"객체에 대한 연산"

"GetObjectLegalHold"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"S3 REST API를 사용하여 S3 Object Lock 구성"

"GetObjectLockConfiguration"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"S3 REST API를 사용하여 S3 Object Lock 구성"

"GetObjectRetention"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"S3 REST API를 사용하여 S3 Object Lock 구성"

"GetObjectTagging"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"객체에 대한 연산"

"HeadBucket"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"HeadObject"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 헤더도 지원합니다.

  • x-amz-checksum-mode

  • x-amz-server-side-encryption-customer-algorithm

  • x-amz-server-side-encryption-customer-key

  • x-amz-server-side-encryption-customer-key-MD5

  • If-Match

  • If-Modified-Since

  • If-None-Match

  • If-Unmodified-Since

  • Range

요청 본문

None

StorageGRID 문서

"HeadObject"

"ListBuckets"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

None

StorageGRID 문서

"서비스 > ListBuckets에 대한 작업"

"ListMultipartUploads"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 매개변수도 지원합니다.

  • encoding-type

  • key-marker

  • max-uploads

  • prefix

  • upload-id-marker

요청 본문

None

StorageGRID 문서

"ListMultipartUploads"

"ListObjects"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 매개변수도 지원합니다.

  • delimiter

  • encoding-type

  • marker

  • max-keys

  • prefix

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"ListObjectsV2"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 매개변수도 지원합니다.

  • continuation-token

  • delimiter

  • encoding-type

  • fetch-owner

  • max-keys

  • prefix

  • start-after

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"ListObjectVersions"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 매개변수도 지원합니다.

  • delimiter

  • encoding-type

  • key-marker

  • max-keys

  • prefix

  • version-id-marker

요청 본문

None

StorageGRID 문서

"버킷에 대한 작업"

"ListParts"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 매개변수도 지원합니다.

  • max-parts

  • part-number-marker

  • uploadId

요청 본문

None

StorageGRID 문서

"ListMultipartUploads"

"PutBucketCors"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"버킷에 대한 작업"

"PutBucketEncryption"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문 XML 태그

StorageGRID는 다음과 같은 요청 본문 XML 태그를 지원합니다.

  • ApplyServerSideEncryptionByDefault

  • Rule

  • ServerSideEncryptionConfiguration

  • SSEAlgorithm

StorageGRID 문서

"버킷에 대한 작업"

"PutBucketLifecycleConfiguration"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문 XML 태그

StorageGRID는 다음과 같은 요청 본문 XML 태그를 지원합니다.

  • And

  • Days

  • Expiration

  • ExpiredObjectDeleteMarker

  • Filter

  • ID

  • Key

  • LifecycleConfiguration

  • NewerNoncurrentVersions

  • NoncurrentDays

  • NoncurrentVersionExpiration

  • Prefix

  • Rule

  • Status

  • Tag

  • Value

StorageGRID 문서

"PutBucketNotificationConfiguration"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문 XML 태그

StorageGRID는 다음과 같은 요청 본문 XML 태그를 지원합니다.

  • Event

  • Filter

  • FilterRule

  • Id

  • Name

  • NotificationConfiguration

  • Prefix

  • S3Key

  • Suffix

  • Topic

  • TopicConfiguration

  • Value

StorageGRID 문서

"버킷에 대한 작업"

"PutBucketPolicy"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

지원되는 JSON 본문 필드에 대한 자세한 내용은 "버킷 및 그룹 액세스 정책 사용"을 참조하세요.

"PutBucketReplication"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문 XML 태그

  • Bucket

  • Destination

  • Prefix

  • ReplicationConfiguration

  • Rule

  • Status

  • StorageClass

StorageGRID 문서

"버킷에 대한 작업"

"PutBucketTagging"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"버킷에 대한 작업"

"PutBucketVersioning"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문 매개변수

StorageGRID는 다음과 같은 요청 본문 매개변수를 지원합니다.

  • VersioningConfiguration

  • Status

StorageGRID 문서

"버킷에 대한 작업"

"PutObject"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 을 지원하며, 다음과 같은 추가 헤더도 지원합니다.

  • Cache-Control

  • Content-Disposition

  • Content-Encoding

  • Content-Language

  • Expires

  • x-amz-checksum-sha256

  • x-amz-server-side-encryption

  • x-amz-storage-class

  • x-amz-server-side-encryption-customer-algorithm

  • x-amz-server-side-encryption-customer-key

  • x-amz-server-side-encryption-customer-key-MD5

  • x-amz-tagging

  • x-amz-object-lock-mode

  • x-amz-object-lock-retain-until-date

  • x-amz-object-lock-legal-hold

  • x-amz-meta-<metadata-name>

요청 본문

  • 객체의 이진 데이터

StorageGRID 문서

"PutObject"

"PutObjectLegalHold"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"S3 REST API를 사용하여 S3 Object Lock 구성"

"PutObjectLockConfiguration"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"S3 REST API를 사용하여 S3 Object Lock 구성"

"PutObjectRetention"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 헤더를 지원하며, 추가적으로 다음 헤더도 지원합니다.

  • x-amz-bypass-governance-retention

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"S3 REST API를 사용하여 S3 Object Lock 구성"

"PutObjectTagging"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

StorageGRID 구현 당시 Amazon S3 REST API에서 정의한 모든 요청 본문 매개변수를 지원합니다.

StorageGRID 문서

"객체에 대한 연산"

"RestoreObject"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

지원되는 본문 필드에 대한 자세한 내용은 "RestoreObject"을 참조하십시오.

"SelectObjectContent"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대해 모든 공통 매개변수 및 헤더을 지원합니다.

요청 본문

지원되는 본문 필드에 대한 자세한 내용은 다음을 참조하십시오.

"UploadPart"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 URI 쿼리 매개변수를 지원하며, 추가로 다음과 같은 URI 쿼리 매개변수도 지원합니다.

  • partNumber

  • uploadId

그리고 다음과 같은 추가 요청 헤더가 있습니다.

  • x-amz-checksum-sha256

  • x-amz-server-side-encryption-customer-algorithm

  • x-amz-server-side-encryption-customer-key

  • x-amz-server-side-encryption-customer-key-MD5

요청 본문

  • 해당 부분의 이진 데이터

StorageGRID 문서

"UploadPart"

"UploadPartCopy"

URI 쿼리 매개변수 및 요청 헤더

StorageGRID는 이 요청에 대한 모든 공통 매개변수 및 헤더 URI 쿼리 매개변수를 지원하며, 추가로 다음과 같은 URI 쿼리 매개변수도 지원합니다.

  • partNumber

  • uploadId

그리고 다음과 같은 추가 요청 헤더가 있습니다.

  • x-amz-copy-source

  • x-amz-copy-source-if-match

  • x-amz-copy-source-if-modified-since

  • x-amz-copy-source-if-none-match

  • x-amz-copy-source-if-unmodified-since

  • x-amz-copy-source-range

  • x-amz-server-side-encryption-customer-algorithm

  • x-amz-server-side-encryption-customer-key

  • x-amz-server-side-encryption-customer-key-MD5

  • x-amz-copy-source-server-side-encryption-customer-algorithm

  • x-amz-copy-source-server-side-encryption-customer-key

  • x-amz-copy-source-server-side-encryption-customer-key-MD5

요청 본문

None

StorageGRID 문서

"UploadPartCopy"