이 페이지는 Cloud Translation API를 통해 번역되었습니다.

XML API의 HTTP 헤더 및 쿼리 문자열 매개변수

Cloud Storage XML API는 여러 표준 HTTP 헤더뿐만 아니라 여러 확장 프로그램 (커스텀) HTTP 헤더를 사용합니다. 일부 HTTP 메서드는 쿼리 문자열 매개변수도 지원합니다. 헤더 및 매개변수는 아래에 설명되어 있습니다.

HTTP 헤더 및 쿼리 문자열 매개변수 요약

XML API는 다음 표준 HTTP 헤더를 사용합니다.

요청	응답	모두
승인 콘텐츠-MD5 호스트 일치하는 경우 If-Modified-Since If-None-Match If-Unmodified-Since	ETag Last-Modified 위치	Cache-Control 콘텐츠 처리 콘텐츠 인코딩 콘텐츠 언어 콘텐츠 길이 콘텐츠 범위 콘텐츠 유형 날짜 주행 가능 거리 전송 인코딩

XML API는 다음 확장 프로그램 (사용자설정) HTTP 헤더를 사용합니다.

요청	응답	모두
X-goog-acl x-goog-api-version x-goog-bucket-retention-period x-goog-content-length-range x-goog-content-sha256 x-goog-copy-source x-goog-copy-source-generation x-goog-copy-source-if-generation-match x-goog-copy-source-if-match x-goog-copy-source-if-metageneration-match x-goog-copy-source-if-modified-since x-goog-copy-source-if-none-match x-goog-copy-source-if-unmodified-since X-goog-date x-goog-encryption-key x-goog-encryption-kms-key-name x-goog-if-generation-match x-goog-if-metageneration-match x-goog-metadata-directive x-goog-project-id x-goog-재개 가능 x-goog-user-project	x-goog-component-count x-goog-expiration x-goog-generation x-goog-metageneration x-goog-stored-content-encoding x-goog-stored-content-length	x-goog-custom-time x-goog-encryption-algorithm x-goog-encryption-key-sha256 x-goog-해시 x-goog-meta- x-goog-storage-class

XML API는 다음과 같은 쿼리 문자열 매개변수를 사용합니다.

액세스 키 ID
ACL
필요한 조치
결제
메시지 쓰기
코르스
기본 객체 Acl
구분 기호
인코딩 유형
암호화
암호화 구성
생성
세대-마커

수명 주기 위치
로깅
마커
아이콘
최대 키
최대 항목 수
접두사
응답-콘텐츠 분류
응답-콘텐츠-유형
상태
스토리지 클래스
태그하기

upload_id[업로드_ID]
사용자 이름
사용자 프로젝트
버전 관리
버전
웹사이트 구성
X-Goog-Algorithm
X-Goog-Credential
X-Goog-Date
X-Goog-Expires
X-Goog-SignedHeaders
X-Goog-Signature

표준 HTTP 헤더

승인

요청을 인증하는 데 사용되는 문자열이 포함된 요청 헤더입니다.

유효한 값	인증 식별자 ( `Bearer` \| `GOOG1` \| `AWS`)와 다음 중 하나가 표시됩니다. 올바른 OAuth 2.0 토큰 액세스 키 서명
예	`Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s- ...`
세부정보	이 헤더를 사용하는 방법에 대한 자세한 내용은 인증을 참조하세요. 참고: 요청이 프록시를 통해 라우팅되는 경우 네트워크 관리자에게 사용자 인증 정보를 포함하는 `Authorization` 헤더가 있는지 확인해야 할 수 있습니다. 프록시에서 제거되지 않습니다. `Authorization` 헤더가 없으면 `MissingSecurityHeader` 오류가 발생하고 요청이 거부됩니다. 프록시 서버를 통해 Cloud Storage에 액세스하는 방법에 대한 자세한 내용은 문제해결 주제를 참조하세요.

Cache-Control

cache-control 설정을 지정하는 요청 및 응답 헤더입니다.

유효한 값	모든 유효한 캐시 제어 값 (사양 참조)
예	`Cache-Control: public, max-age=6000`
세부정보	모든 익명 사용자가 액세스할 수 있는 객체에만 캐시 제어를 지정해야 합니다. 익명으로 액세스하려면 객체의 ACL에 `AllUsers`에 대한 `READ` 또는 `FULL_CONTROL` 권한을 부여해야 합니다. 모든 익명 사용자가 객체에 액세스할 수 있으며 캐시 제어 설정을 지정하지 않으면 Cloud Storage는 3, 600초의 캐시 제어 설정을 적용합니다. XML을 통해 제공할 때 Cloud Storage는 객체의 메타데이터 제어를 고려합니다.

Content-Disposition

전송될 데이터에 대한 프레젠테이션 정보를 지정하는 요청 및 응답 헤더

유효한 값	모든 유효한 콘텐츠 처리 값 (사양 참조)
예	`Content-Disposition: attachment; filename=FILENAME`
세부정보	객체를 업로드할 때 Content-Disposition 헤더를 설정하면 다운로드 시점에 제공되며 이후 웹브라우저와 기타 HTTP 클라이언트에서 해석됩니다. Content-Disposition은 일반적으로 `attachment;filename=FILENAMEt`을 설정하여 웹 브라우저가 '다른 이름으로 저장...' 대화상자를 엽니다.

Content-Encoding

객체의 압축 알고리즘을 지정하는 요청 및 응답 헤더입니다.

유효한 값	모든 유효한 압축 알고리즘 (사양 참조)
예	`Content-Encoding: gzip`
세부정보	Cloud Storage는 객체를 압축하거나 압축 해제하지 않습니다. 이 헤더를 사용하여 압축 유형 알고리즘 (예: `deflate`)을 지정하면 Cloud Storage는 헤더를 유지하지만 객체를 압축하거나 압축 해제하지 않습니다.

Content-Language

콘텐츠의 ISO 639-1 언어 코드입니다.

유효한 값	언어 코드 목록은 언어 이름의 표시 코드의 ISO 639-1 열을 참조하세요.
예	`Content-Language: en`

콘텐츠 길이

요청 또는 응답 본문의 길이 (단위: 바이트)입니다.

유효한 값	0 이상의 모든 값
예	`Content-Length: 1234`
세부정보	이는 분할 전송 인코딩을 사용하는 요청을 제외한 모든 요청에 필요합니다 (사양 참조). 청크화된 전송 인코딩을 사용하지 않고 요청에 `Content-Length` 헤더를 포함하지 않으면 요청이 실패하고 Cloud Storage는 411 길이 필요 상태 코드로 응답합니다.

콘텐츠-MD5

요청 본문의 MD5 다이제스트입니다.

유효한 값	유효한 MD5 다이제스트
예	`Content-MD5: iB94gawbwUSiZy5FuruIOQ==`
세부정보	사양을 참조하세요. Cloud Storage는 이를 사용하여 `PUT` 작업의 무결성을 확인할 수 있습니다.

콘텐츠 범위

바이트 범위를 지정하는 요청 또는 응답 헤더입니다.

유효한 값 모든 유효한 바이트 범위

예 Content-Range: bytes 456-987/1234

세부정보

Content-Range 헤더는 응답에 표시될 때 Range 헤더가 포함된 요청의 결과로 반환되는 바이트 범위를 나타냅니다.

재개 가능한 업로드 요청의 일부로 포함되어 있으면 Content-Range는 업로드의 현재 위치를 쿼리하거나 시작점을 나타내는 지표로 쿼리하는 데 사용됩니다. 현재 요청에 업로드 중인 데이터 블록

바이트 범위는 범위에 포함됩니다. 즉, bytes 0-999은 파일 또는 객체의 처음 1,000바이트를 나타냅니다.

특히 다운로드 응답과 관련된 자세한 내용은 사양을 참조하세요.

Content-Type

요청 또는 응답의 MIME 유형입니다.

유효한 값	모든 유효한 MIME 유형 (사양 참조)
예	`Content-Type: text/html`
세부정보	객체 업로드 시 콘텐츠 유형을 지정하지 않은 경우 Cloud Storage 시스템은 객체를 제공할 때 `application/octet-stream`을 기본값으로 설정합니다.

날짜

요청 또는 응답의 날짜 및 시간입니다.

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다 (사양 참조).
예	`Date: Wed, 16 Jun 2010 11:11:11 GMT`
세부정보	광고 서명된 URL V2 서명 프로세스를 사용할 경우 형식은 기존 HTTP 형식이어야 합니다. 다음을 참조하세요. 사양 7.1.1.2의 을 엽니다. V4 서명 프로세스를 사용할 때 형식은 ISO 8601 기본 형식 `YYYYMMDD'T'HHMMSS'Z'`이어야 합니다.

ETag

액세스 중인 객체의 항목 태그가 포함된 응답 헤더입니다.

유효한 값	따옴표로 묶인 문자열입니다. 자세한 내용은 해시 및 ETag: 권장사항을 참조하세요.
예시	`ETag: "39a59594290b0f9a30662a56d695b71d"` `ETag: "-CKicn4fknbUCEAE="`
세부정보	사양을 참조하세요.

호스트

Cloud Storage의 URI를 지정하는 요청 헤더입니다.

유효한 값	URI의 올바른 형식입니다.
예	`Host: storage.googleapis.com`
세부정보	유효한 URI에 대한 자세한 내용은 요청 엔드포인트 및 호스트 사양을 참조하세요.

If-Match

항목 태그 (ETag)를 지정하는 요청 헤더입니다.

유효한 값	유효한 항목 태그입니다.
예	`If-Match: "881f7881ac1bc144a2672e45babb8839"`
세부정보	쉼표로 구분된 항목 태그 목록이 아닌 단일 항목 태그만 지정할 수 있습니다.이 헤더는 HEAD 객체 및 GET 객체 메서드와 함께 사용할 수 있습니다. 이 헤더를 사용하여 지정한 ETag가 객체의 ETag와 같은 경우 메타데이터 또는 객체가 반환됩니다. 이 헤더를 사용하여 지정한 ETag가 객체의 ETag와 다르면 메타데이터 또는 객체가 반환되지 않고 Cloud Storage는412 사전 조건 실패 오류 코드가 반환됩니다. 자세한 내용은 사양을 참조하세요.

If-Modified-Since

날짜와 시간을 지정하는 요청 헤더입니다.

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다.
예	`If-Modified-Since: Fri, 19 Feb 2010 22:04:23 GMT`
세부정보	이 헤더는 HEAD 개체 및 GET 객체 메서드와 함께 사용할 수 있습니다. 이 헤더를 사용하여 지정한 날짜 및 시간보다 이후 객체가 수정된 경우 메타데이터 또는 객체가 반환됩니다. 이 헤더를 사용하여 지정한 날짜 및 시간보다 이전에 객체가 수정된 경우 메타데이터 또는 객체가 반환되지 않고 Cloud Storage는 304 Not Modified를 반환합니다. 상태 코드를 반환합니다. If-Modified-Since 헤더에 대한 자세한 내용은 사양을 참조하세요. HTTP 날짜 형식에 대한 자세한 내용은 사양, 7.1.1항을 참조하세요.

If-None-Match

항목 태그 (ETag)를 지정하는 요청 헤더입니다.

유효한 값	유효한 항목 태그입니다.
예	`If-None-Match: "881f7881ac1bc144a2672e45babb8839"`
세부정보	이 헤더는 HEAD 개체 및 GET 객체 메서드와 함께 사용할 수 있습니다. 이 헤더로 지정한 ETag가 객체의 ETag와 다르면 메타데이터 또는 객체가 반환됩니다. 이 헤더를 사용하여 지정한 ETag가 객체의 ETag와 같은 경우 메타데이터 또는 객체가 반환되지 않고 Cloud Storage는304 수정되지 않음 상태 코드를 반환합니다. 자세한 내용은 사양을 참조하세요.

If-Unmodified-Since

날짜와 시간을 지정하는 요청 헤더입니다.

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다.
예	`If-Unmodified-Since: Fri, 19 Feb 2010 22:04:23 GMT`
세부정보	이 헤더는 HEAD 개체 및 GET 객체 메서드와 함께 사용할 수 있습니다. 이 헤더를 사용하여 지정한 날짜보다 객체가 수정되지 않았으면 메타데이터 또는 객체가 반환됩니다. 이 헤더를 사용하여 지정한 날짜보다 이전에 수정된 경우에는 메타데이터 또는 객체가 반환되지 않고 Cloud Storage는 412 Precondition Failed 오류 코드를 확인합니다. If-Unmodified-Since 헤더에 대한 자세한 내용은 사양을 참조하세요. HTTP 날짜 형식에 대한 자세한 내용은 사양, 7.1.1항을 참조하세요.

최종 수정일

객체가 마지막으로 수정된 날짜 및 시간이 포함된 응답 헤더

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다.
예	`Last-Modified: Fri, 19 Feb 2010 22:04:23 GMT`
세부정보	Last-Modified 헤더에 대한 자세한 내용은 사양을 참조하세요. HTTP 날짜 형식에 대한 자세한 내용은 사양, 7.1.1항을 참조하세요.

위치

여러 용도로 사용되는 응답 헤더:

재개 가능한 업로드를 시작하는 것과 관련하여 재개 가능한 업로드 작업을 위한 세션 URI를 제공합니다.
쿠키 기반 인증 요청에 대한 응답으로 이 요청에 대한 고유한 웹 출처 응답 URL을 제공합니다.
www.googleapis.com/download 이외의 URL에서 수행된 JSON API 다운로드 요청에 대한 응답으로 파일을 다운로드할 수 있는 JSON API URL로의 리디렉션을 제공합니다.

유효한 값	모든 유효한 URI입니다.
예	`Location: https://example.storage.googleapis.com/?upload_id=tvA0...rot`
세부정보	재개 가능한 업로드를 시작하면 `Location` 응답 헤더가 반환됩니다.

범위

반환하려는 바이트 범위를 나타내는 요청 헤더와 Cloud Storage 시스템에 업로드된 바이트 범위를 나타내는 응답 헤더

유효한 값 연속된 모든 바이트 범위

예시 Range: bytes=0-1999 (처음 2,000바이트)
Range: bytes=-2000 (마지막 2000바이트)
Range: bytes=2000- (바이트 2000~파일 끝)

세부정보

객체 데이터 요청에 헤더로 포함된 경우, 객체에 지정된 바이트 범위만 반환되므로 중단된 업로드를 재개할 때 유용합니다. 유효하고 요청이 성공하면 206 Partial Content 응답 코드가 생성됩니다. 특정 상황에서 range 요청 헤더는 무시된다는 점에 유의하세요.

재개 가능한 업로드와 연결된 응답의 일부로 반환될 경우 Range는 현재 업로드된 바이트 수를 나타냅니다. 이후에 이 정보를 사용하여 업로드를 계속할 수 있습니다.

바이트 범위는 제외됩니다. 예를 들어 bytes=0-999은 파일 또는 객체의 처음 1, 000바이트를 나타냅니다. 이 헤더에 대한 자세한 내용은 사양을 참조하세요.

전송 인코딩

전송 인코딩이 메시지 본문에 적용되었는지 여부를 지정하는 요청 및 응답 헤더

유효한 값	`chunked`
예	`Transfer-Encoding: chunked`
세부정보	이 헤더는 요청 또는 응답의 메시지 본문이 분할되었는지 여부를 지정합니다. 그렇다면 서버가 일련의 청크로 콘텐츠를 제공하며 길이가 0인 최종 청크를 제공합니다. `Transfer-Encoding: Chunked`를 지정하면 `Content-Length`를 지정할 필요가 없습니다. 스트리밍 업로드를 진행할 때와 같이 메시지 본문의 길이를 미리 알지 못한 경우에 유용합니다. 전송 인코딩에 대한 자세한 내용은 사양을 참조하세요. 청크 분할 전송 인코딩에 대한 자세한 내용은 사양을 참조하세요.

확장 프로그램 (커스텀) HTTP 헤더

X-goog-acl

사전 정의된 (미리 준비된) ACL을 버킷이나 객체를 업로드하거나 만들 때 적용하는 요청 헤더입니다.

유효한 값	버킷: `project-private`, `private`, `public-read`, `public-read-write`, `authenticated-read` 객체: `project-private`, `private`, `bucket-owner-read`, `bucket-owner-full-control`, `public-read`, `authenticated-read`
예	`x-goog-acl: private`
세부정보	사용자가 ACL을 지정하지 않고 객체를 업로드하거나 버킷을 만들면 `private` ACL이 적용됩니다. 사전 정의된 ACL에 대한 자세한 내용은 액세스 제어를 참조하세요.

x-goog-api-version

이 헤더는 지원 중단되었으며 사용되지 않습니다.

x-goog-bucket-retention-period

새 버킷에 보관 정책을 추가하는 요청 헤더

유효한 값	1에서 3,155,760,000 사이의 정수입니다.
예	`x-goog-bucket-retention-period: 32000`
세부정보	이 요청 헤더는 새 버킷을 만들 때만 사용할 수 있습니다. 헤더가 포함된 경우 새 버킷에는 이 헤더의 값에 따라 결정되는 지속 시간 보관 정책이 초 단위로 표시됩니다.

x-goog-component-count

복합 객체를 구성하는 구성요소의 수를 나타내는 응답 헤더입니다.

유효한 값	1 이상의 정수
예	`x-goog-component-count: 32`
세부정보	이 응답 헤더는 액세스된 객체가 복합 객체일 때만 반환됩니다. 헤더는 객체를 구성하는 구성요소의 수를 반환합니다.

x-goog-content-length-range

PUT 요청 헤더 이 필드를 사용할 경우 Cloud Storage는 요청 콘텐츠의 크기가 헤더에 지정된 범위 내에 있는 경우에만 요청을 수락합니다.

유효한 값	`MIN,MAX` 쌍
예	`x-goog-content-length-range: 0,256`
세부정보	콘텐츠 크기 값은 포함되고 바이트 단위로 제공됩니다. 요청 콘텐츠의 크기가 지정된 범위에 속하는 경우, 요청한 대로 전달됩니다. 요청 콘텐츠 크기가 지정된 범위를 벗어나면 요청이 실패하고 응답에 `400 Bad Request` 코드가 반환됩니다. `PUT`이 아닌 요청에서 `x-goog-content-length-range`를 사용하면 헤더는 자동으로 무시됩니다.

x-goog-content-sha256

요청 본문의 해시를 포함하는 요청 헤더입니다.

유효한 값	소문자 16진수, SHA-256 해시 또는 `UNSIGNED-PAYLOAD`
예	`x-goog-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855`
세부정보	이 헤더는 Authorization 헤더에서 signature를 사용하는 요청에 필요합니다. `x-goog-content-sha256`는 정규 요청의 페이로드 부분에 사용한 값과 일치해야 합니다.

x-goog-copy-source

복사 작업에 대한 소스 버킷 및 객체를 지정하는 요청 헤더입니다.

유효한 값 /BUCKET_NAME/OBJECT_NAME 경로

예 x-goog-copy-source: travel-maps/paris.jpg

세부정보

이 요청 헤더는 소스 객체의 경로를 지정합니다. 유효한 경로에는 버킷과 객체가 슬래시 (/)로 구분되어 있어야 합니다. 소스 객체 경로는 유효한 URL이어야 하므로 일반적으로 퍼센트로 인코딩되어야 합니다.

이 헤더를 사용하려면 소스 객체에 대한 READ 권한과 대상 버킷에 대한 WRITE 권한이 있어야 합니다.

소스 객체와 대상 객체가 동일한 경우 (세대 포함) 복사본은 메타데이터 업데이트로 처리됩니다. 업데이트/교체 동작 제어에 대한 자세한 내용은 x-goog-metadata-directive를 참조하세요.

x-goog-copy-source-generation

복사할 객체의 세대를 지정하는 요청 헤더입니다.

유효한 값	양수 (64비트 값)
예	`x-goog-copy-source-generation: 1360044097839000`
세부정보	이 요청 헤더를 x-goog-copy-source와 함께 사용하여 복사할 객체의 생성을 지정할 수 있습니다. x-goog-copy-source 헤더 없이는 유효하지 않습니다. 소스 객체의 세대가 없으면 Cloud Storage는 404 Not Found 상태 코드를 반환합니다. 소스 객체와 대상 객체가 동일한 경우 (세대 포함) 복사본은 메타데이터 업데이트로 처리됩니다. 업데이트/교체 동작 제어에 대한 자세한 내용은 x-goog-metadata-directive를 참조하세요.

x-goog-copy-source-if-generation-match

해당 복사 요청을 지정하는 요청 헤더는 소스 객체 x-goog-generation가 지정된 값과 일치하는 경우에만 실행됩니다. 이 헤더는 x-goog-copy-source와 함께 사용할 때만 유효합니다.

유효한 값	양수 (64비트 값)
예	`x-goog-copy-source-if-generation-match: 1360044097835000`
세부정보	이 요청 헤더는 지정된 세대가 있는 경우에만 소스 객체를 조건부로 복사하는 데 사용할 수 있습니다. 세대가 일치하지 않으면 Cloud Storage는 412 Precondition Failed 오류 코드를 반환합니다. 자세한 내용은 객체 버전 사용을 참조하세요.

x-goog-copy-source-if-match

복사 작업의 조건을 지정하는 요청 헤더입니다.

유효한 값	항목 태그 (ETag)
예	`x-goog-copy-source-if-match: 53fc311c15eda0a031809982ccf92aac`
세부정보	단일 항목 태그 (쉼표로 구분된 항목 태그 목록이 아님)만 지정할 수 있습니다. 이 요청 헤더는 `x-goog-copy-source` 요청 헤더로 복사 작업을 수행하는 경우에만 사용할 수 있습니다. 이 요청 헤더를 사용하여 지정한 ETag가 소스 객체의 ETag와 일치하면 복사 작업이 진행됩니다. ETag가 일치하지 않으면 Cloud Storage는 412 Precondition Failed 오류 코드를 반환합니다.

x-goog-copy-source-if-metageneration-match

해당 요청을 지정하는 요청 헤더는 소스 객체의 metageneration이 이 헤더 값과 일치하는 경우에만 허용됩니다.

유효한 값 양수 (64비트 값)

예 x-goog-copy-source-if-metageneration-match: 4

세부정보

소스 객체 메타 세대가 x-goog-copy-source-if-metageneration-match 헤더와 일치하면 요청이 성공적으로 완료되고 Google Cloud Storage가 HTTP 200 OK 상태를 반환합니다. 메타 세대가 일치하지 않으면 Cloud Storage는 412 Precondition Failed 오류 코드를 반환합니다.

이 값은 x-goog-copy-source-if-generation-match 또는 x-goog-copy-source-generation에만 사용할 수 있습니다. 가 없는데 이 중 하나를 사용하지 않으면 HTTP 400 BadRequest 잘못된 인수 오류 코드가 발생합니다.

자세한 내용은 객체 버전 사용을 참조하세요.

x-goog-copy-source-if-modified-since

복사 작업의 조건을 지정하는 요청 헤더입니다.

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다.
예	`x-goog-copy-source-if-modified-since: Fri, 19 Feb 2010 14:05:04 GMT`
세부정보	이 요청 헤더는 `x-goog-copy-source` 요청 헤더로 복사 작업을 수행하는 경우에만 사용할 수 있습니다. 지정한 날짜 및 시간이 소스 객체의 `Last-Modified` 날짜보다 이전이면 객체가 복사됩니다. 날짜 및 시간이 이후이면 Cloud Storage는 412 Precondition Failed 오류 코드를 반환합니다. If-Modified-Since HTTP 헤더에 대한 자세한 내용은 (이 복사 소스가 아닌 복사 사용 사례) 사양을 참조하세요. HTTP 날짜 형식에 대한 자세한 내용은 사양 섹션 7.1.1.2를 참조하세요.

x-goog-copy-source-if-none-match

복사 작업의 조건을 지정하는 요청 헤더입니다.

유효한 값	항목 태그 (ETag)
예	`x-goog-copy-source-if-none-match: 53fc311c15eda0a031809982ccf92aac`
세부정보	이 요청 헤더는 `x-goog-copy-source` 요청 헤더로 복사 작업을 수행하는 경우에만 사용할 수 있습니다. 이 요청 헤더를 사용하여 지정한 ETag가 소스 객체의 ETag와 일치하지 않으면 복사 작업이 진행됩니다. ETag가 일치하면 Cloud Storage는 412 Precondition Failed 오류 코드를 반환합니다. If-None-Match HTTP 헤더 (복사 소스 이외의 경우 이 사용 사례에 적용됨)에 대한 자세한 내용은 사양을 참조하세요.

x-goog-copy-source-if-unmodified-since

복사 작업의 조건을 지정하는 요청 헤더입니다.

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다.
예	`x-goog-copy-source-if-unmodified-since: Fri, 19 Feb 2010 14:05:04 GMT`
세부정보	이 요청 헤더는 `x-goog-copy-source` 요청 헤더로 복사 작업을 수행하는 경우에만 사용할 수 있습니다. 지정한 날짜 및 시간이 소스 객체의 `Last-Modified` 날짜보다 이후이면 객체가 복사됩니다. 날짜 및 시간이 너무 이전이면 Cloud Storage는 412 Precondition Failed 오류 코드를 반환합니다. If-Unmodified-Since HTTP 헤더 (복사 소스 이외의 경우 이 사용 사례에 적용됨)에 대한 자세한 내용은 사양을 참조하세요. HTTP 날짜 형식에 대한 자세한 내용은 사양, 7.1.1항을 참조하세요.

x-goog-custom-time

커스텀 타임스탬프 객체 메타데이터에 대한 요청 및 응답 헤더

유효한 값	RFC 3339 형식의 날짜 및 시간.
예	`x-goog-custom-time: 2020-04-12T23:20:50.52Z`
세부정보	이 헤더는 객체 PUT 또는 POST 요청 중에 포함될 수 있습니다. 헤더에 지정하는 값은 객체와 함께 저장되며 객체에 GET 또는 HEAD 요청을 실행할 때 응답 헤더로 반환됩니다. 객체의 커스텀 시간은 일반적으로 객체 수명 주기 관리와 함께 사용됩니다.

X-goog-date

인증된 요청의 타임스탬프를 지정하는 요청 헤더입니다.

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다.
예	`x-goog-date: Fri, 19 Feb 2010 14:05:04 GMT`
세부정보	광고 서명된 URL V2 서명 프로세스를 사용할 경우 형식은 기존 HTTP 형식이어야 합니다. 다음을 참조하세요. 사양 7.1.2.2의 을 엽니다. V4 서명 프로세스를 사용할 때 형식은 ISO 8601 기본 형식 `YYYYMMDD'T'HHMMSS'Z'`로 되어 있어야 합니다.

x-goog-encryption-algorithm

사용할 암호화 알고리즘을 지정하는 요청 및 응답 헤더입니다.

유효한 값	`AES256`
예	`x-goog-encryption-algorithm: AES256`
세부정보	이 요청 및 응답 헤더는 고객 제공 암호화 키를 제공할 때 사용됩니다.

x-goog-encryption-key

AES-256 암호화 키를 지정하는 요청 헤더입니다.

유효한 값	유효한 AES-256 암호화 키의 RFC 4648 Base64 인코딩 문자열
예	`x-goog-encryption-key: NwbyGGmcKAX4FxGpOERG2Ap33m5NVOgmXznSGTEvG0I=`
세부정보	이 요청 헤더는 고객 제공 암호화 키를 제공할 때 사용됩니다.

x-goog-encryption-key-sha256

암호화 키의 SHA256 해시를 지정하는 요청 및 응답 헤더입니다.

유효한 값	암호화 키에 사용할 유효한 SHA256 해시의 RFC 4648 Base64 인코딩 문자열입니다.
예	`x-goog-encryption-key-sha256: +eBzkZBt1Mj2CZx69L3c8yXoZB6DtRLlSvXMJB9JGIQ=`
세부정보	이 요청 헤더는 고객 제공 암호화 키를 제공할 때 사용됩니다.

x-goog-encryption-kms-key-name

Cloud KMS 암호화 키를 지정하는 요청 헤더입니다.

유효한 값	Cloud KMS 암호화 키 리소스.
예	`x-goog-encryption-kms-key-name: projects/my-project/locations/us-east1/keyRings/my-keyring/cryptoKeys/my-key`
세부정보	이 요청 헤더는 고객 관리 암호화 키로 특정 객체를 암호화하려는 경우에 사용됩니다.

x-goog-expiration

액세스된 객체가 수명 주기 구성에 따라 삭제될 시기를 지정하는 응답 헤더입니다.

유효한 값	일반적인 HTTP 형식으로 표시되는 날짜 및 시간입니다.
예	`x-goog-expiration: Tue, 25 June 2013 00:00:00 GMT`
세부정보	이 응답 헤더는 특정 조건이 충족되는 경우 수명 주기 관리가 사용 설정된 버킷의 객체에 대해서만 반환됩니다. 자세한 내용은 객체 수명 주기 동작을 참조하세요.

x-goog-generation

액세스할 객체 데이터의 버전을 나타내는 응답 헤더입니다.

유효한 값	양수 (64비트 값)
예	`x-goog-generation: 1360044097835000`
세부정보	객체를 만들거나 바꿀 때마다 Cloud Storage는 자동으로 세대를 할당합니다. 객체 데이터가 교체될 때마다 세대가 변경됩니다. 하지만 여러 객체의 세대 사이에는 정의된 관계가 없습니다. 자세한 내용은 객체 버전 사용을 참조하세요.

x-goog-if-generation-match

객체의 요청을 지정하는 요청 헤더는 객체의 x-goog-generation이 이 헤더 값과 일치하는 경우에만 허용됩니다.

유효한 값 0 또는 임의의 정수 (64비트 값)

예 x-goog-if-generation-match: 1360044097835000

세부정보

객체 세대가 x-goog-if-generation-match 헤더와 일치하면 요청이 성공적으로 완료되고 Google Cloud Storage가 HTTP 200 OK 상태를 반환합니다. 세대가 일치하지 않으면 Google Cloud Storage는 HTTP 412 Precondition Failed 오류 코드를 반환합니다.

x-goog-if-generation-match 헤더를 0으로 설정하면 Google Cloud Storage는 현재 객체가 없는 경우에만 지정된 요청을 수행합니다. 예를 들어 PUT 요청을 수행하여 x-goog-if-generation-match를 사용하여 새 객체를 만들 수 있으며, 이 객체는 실시간으로 라이브 버전이 없는 경우에만 생성됩니다. 객체가 있으면 요청이 취소됩니다.

자세한 내용은 객체 버전 사용을 참조하세요.

x-goog-if-metageneration-match

객체의 요청을 지정하는 요청 헤더는 객체의 x-goog-metageneration이 이 헤더 값과 일치하는 경우에만 허용됩니다.

유효한 값 양수 (64비트 값)

예 x-goog-if-metageneration-match: 4

세부정보

객체 메타 세대가 x-goog-if-metageneration-match 헤더와 일치하면 요청이 성공적으로 완료되고 Google Cloud Storage가 HTTP 200 OK 상태를 반환합니다. 메타 세대가 일치하지 않으면 Cloud Storage는 HTTP 412 Precondition Failed 오류 코드를 반환합니다.

메타데이터 업데이트가 실제로 생성되는 객체 생성과 관련하여 실제로 수행되도록 하려면 이 요청 헤더를 x-goog-if-generation-match 헤더와 함께 사용해야 합니다. 읽기-쓰기-쓰기 작업을 안전하게 수행할 수 있습니다.

자세한 내용은 객체 버전 사용을 참조하세요.

x-goog-metadata-directive

복사 작업 중에 메타데이터 처리를 지정하는 요청 헤더입니다.

객체 ACL이 있는 경우 절대 복사되지 않습니다. 해당되는 경우 새 객체는 x-goog-acl 요청 헤더에 지정된 ACL 또는 새 객체가 포함된 버킷에 설정된 기본 객체 ACL을 수신합니다.

유효한 값 COPY | REPLACE

예 x-goog-metadata-directive: REPLACE

세부정보

x-goog-copy-source 요청 헤더에서만 사용됩니다. 기본값은 COPY입니다.

COPY을 지정하면 소스 객체의 메타데이터가 새로 생성된 객체에 적용됩니다.

REPLACE을 지정하면 요청에서 제공된 메타데이터가 새로 생성된 객체에 적용됩니다.

객체를 복사할 때 소스 객체를 다시 작성한다면 x-goog-metadata-directive: REPLACE을 포함해야 합니다. 다른 모든 경우에 헤더는 선택사항입니다.

x-goog-metageneration

액세스할 객체 메타데이터의 버전을 나타내는 응답 헤더입니다.

유효한 값	양수 (64비트 값)
예	`x-goog-metageneration: 1`
세부정보	객체를 만들거나 교체할 때마다 Cloud Storage는 1세대의 메타 세대를 자동으로 할당합니다. metageneration은 객체 메타데이터가 업데이트될 때마다 (ACL 업데이트 또는 기타 메타데이터 업데이트) 증가합니다. 즉, 더 큰 메타 세대는 항상 새로운 버전의 객체 메타데이터를 의미합니다. 하지만 여러 객체의 서로 다른 세대와 동일한 객체의 세대 사이에도 정의된 관계가 없습니다. 객체의 각 세대에는 세대에만 해당하는 고유 메타 세대 버전이 있습니다. 자세한 내용은 객체 버전 사용을 참조하세요.

x-goog-해시

객체의 MD5 또는 CRC32C base64 인코딩 체크섬을 표현하기 위한 요청 및 응답 헤더입니다. 업로드 요청에 대한 요청 헤더로서 제공된 해시는 Cloud Storage에서 계산된 값을 기준으로 검증됩니다.

유효한 값	`md5=BASE64_ENCODED_MD5` 또는 `crc32c=BASE64_ENCODED_CRC32C`입니다. big-endian 바이트 순서로 CRC32c 값을 지정합니다. 또한 HTTP는 쉼표로 구분된 헤더 값을 동일 키가 있는 개별 헤더와 동일합니다.
예시	`x-goog-hash: crc32c=n03x6A==` `x-goog-hash: md5=Ojk9c3dhfxgoKVVHYwFbHQ==` `x-goog-hash: crc32c=n03x6A==,md5=Ojk9c3dhfxgoKVVHYwFbHQ==`
세부정보	Cloud Storage는 비복합 객체에 대해 MD5 해시를 저장합니다. CRC32C를 모든 객체에 사용할 수 있습니다.

x-goog-meta-

객체의 커스텀 메타데이터를 정의할 수 있는 요청 및 응답 헤더입니다.

유효한 값 모든 유효한 헤더 이름입니다.

예 x-goog-meta-reviewer: jane

세부정보

이 헤더를 사용하려면 커스텀 헤더 이름을 x-goog-meta- 프리픽스에 추가한 다음 PUT 또는 POST 요청에 헤더와 관련 값을 추가합니다. 예를 들어 객체가 다양한 프로젝트와 연결된 경우 x-goog-meta-project-name와 같이 여러 요청 헤더를 만들어 객체 메타데이터에 프로젝트 정보를 추가할 수 있습니다. x-goog-meta-project-number 및 x-goog-meta-project-manager. 그런 다음 아래 예시와 같이 PUT 또는 POST 요청 중에 이러한 요청 헤더의 값을 설정할 수 있습니다.


PUT /kitten.jpg HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Wed, 17 Jun 2020 11:11:11 GMT
Content-Type: image/jpg
Content-Length: 554
Authorization: Bearer 1/zVNpoQNsOSxZKqOZgckhpQ
x-goog-meta-project-name: Sales Projections
x-goog-meta-project-number: 878973
x-goog-meta-project-manager: W. Loman

x-goog-meta- 헤더는 객체와 함께 저장되며 객체에 GET 또는 HEAD 요청을 수행하면 항상 응답 헤더에 반환됩니다. 헤더를 커스텀 메타데이터로 사용하면 가격 및 지원의 설명대로 요금이 청구됩니다.

참고: 모든 커스텀 헤더와 연관된 값은 인쇄 가능한 US-ASCII 문자만 포함해야 합니다.

참고: 커스텀 헤더의 총 크기를 몇 KB로 제한하는 것이 좋습니다.

x-goog-project-id

작업 중인 프로젝트를 지정하는 요청 헤더.

유효한 값	유효한 프로젝트 번호 또는 이름입니다.
예시	`x-goog-project-id: 000111222333` `x-goog-project-id: my-project-name` `x-goog-project-id: example.com:my-google-apps-for-work-project-name`
세부정보	이 요청 헤더는 버킷을 만들 프로젝트 또는 버킷을 나열할 프로젝트를 Cloud Storage에 알려줍니다. 상호 운용 가능한 액세스를 위해 기본 프로젝트를 설정한 경우 이러한 태스크는 선택사항입니다.

x-goog-재개 가능

재개 가능한 업로드 작업을 시작하는 요청 헤더

유효한 값	시작
예	`x-goog-resumable: start`
세부정보	이 요청 헤더는 재개 가능한 업로드를 시작하려 함을 Cloud Storage 시스템에 알립니다. 헤더는 POST 객체 요청에서만 사용할 수 있으며 재개 가능한 업로드에만 사용할 수 있습니다.

x-goog-storage-class

객체의 스토리지 클래스를 나타내는 요청 및 응답 헤더

유효한 값	`STANDARD`, `NEARLINE`, `COLDLINE`, `ARCHIVE`, `MULTI_REGIONAL`, `REGIONAL`
예	`x-goog-storage-class: NEARLINE`
세부정보	객체를 관련 버킷의 기본 스토리지 클래스 이외의 스토리지 클래스로 설정하기 위해 이 헤더를 `PUT Object` 및 `POST Object` 요청에 포함할 수 있습니다. 헤더는 모든 `GET Object` 응답에 포함됩니다.

x-goog-stored-content-encoding

객체의 개별 요청에 발생할 수 있는 서버 기반 협상과 관계없이 Cloud Storage에 저장된 객체의 콘텐츠 인코딩을 나타내는 응답 헤더입니다.

유효한 값	객체 업로드 또는 `identity`에 지정된 콘텐츠 코딩입니다.
예	`x-goog-stored-content-encoding: gzip`
세부정보	콘텐츠 코딩 없이 객체를 업로드한 경우 이 헤더의 값은 `identity`입니다.

x-goog-stored-content-length

객체의 개별 요청에 대해 발생할 수 있는 서버 기반 협상과 관계없이 Cloud Storage에 저장된 객체의 콘텐츠 길이 (바이트)를 나타내는 응답 헤더입니다.

유효한 값	0 이상의 모든 바이트 값입니다.
예	`x-goog-stored-content-length: 350`
세부정보	없음

x-goog-user-project

요청과 관련된 액세스 요금을 청구할 사용자 프로젝트를 지정하는 요청 헤더입니다.

유효한 값	기존 Google Cloud 프로젝트의 프로젝트 ID
예	`x-goog-user-project: my-project`
세부정보	헤더에 지정된 프로젝트에는 요청과 관련된 요금이 청구됩니다. 예를 들어 이 헤더는 요청자 지불이 사용 설정된 버킷에 요청을 수행할 때 사용됩니다.

쿼리 문자열 매개변수

이 섹션에 설명된 쿼리 문자열 매개변수의 예시에서는 URI가 표시되지 않지만 storage.googleapis.com을 기준으로 한 상대라고 가정합니다. 요청 엔드포인트에 설명된 것처럼 호스트 이름의 일부로 버킷 이름을 지정할 수도 있습니다(예: BUCKET-NAME.storage.googleapis.com). 버킷을 호스트 이름의 일부로 지정하는 경우, 버킷 경로에 버킷 이름을 포함하지 마세요. 예를 들어 다음은 객체의 ACL을 가져오는 것과 같습니다.

https://storage.googleapis.com/BUCKET-NAME/object-name?acl
https://BUCKET-NAME.storage.googleapis.com/object-name?acl

액세스 키 ID

업데이트하거나 삭제할 HMAC 키를 식별할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	HMAC 키와 연결된 액세스 ID입니다.
예	`/?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive` `/?Action=DeleteAccessKey&AccessKeyId=GOOG1EXAMPLE`
세부정보	`AccessKeyId` 쿼리 문자열 매개변수를 사용하여 업데이트하거나 삭제할 HMAC 키를 지정할 수 있습니다. `AccessKeyId`를 `Action` 쿼리 매개변수와 함께 사용해야 합니다. HMAC 키의 액세스 ID를 검색하는 방법에 대한 자세한 내용은 HMAC 키 정보 가져오기를 참조하세요.

acl

쿼리 문자열 매개변수를 사용하면 버킷 또는 객체의 액세스 제어 목록을 검색하거나 변경할 수 있습니다.

유효한 값	없음
예	`/BUCKET_NAME?acl` `/BUCKET_NAME/OBJECT_NAME?acl`
세부정보	PUT Bucket, PUT Object, GET Bucket, GET Object의 경우 선택사항입니다. PUT 요청을 전송할 때는 적용하려는 ACL을 지정하는 XML 문서를 요청 본문에 포함해야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

작업

수행할 HMAC 키 작업을 식별할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	`ListAccessKeys`, `CreateAccessKey`, `UpdateAccessKey`, `DeleteAccessKey`
예	`/?Action=ListAccessKeys`
세부정보	그만큼`Action` 쿼리 문자열 매개변수를 사용하여 수행할 HMAC 키 작업을 지정할 수 있습니다. `list` , `create` , `update` 또는`delete` 을 엽니다.

billing

버킷의 요청자 지불 기능 상태를 사용 설정, 사용 중지 또는 확인할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	요청 본문 내: `Enabled`, `Disabled`
예	`/BUCKET_NAME?billing`
세부정보	`GET Bucket` 요청에 대한 선택사항 `PUT Bucket`입니다. `GET Bucket` 요청에 사용하면 요청자 지불 기능의 현재 상태가 응답 본문에 반환됩니다. `PUT Bucket` 요청에 사용할 때 요청 본문에는 기능을 사용 설정할지 아니면 사용 중지할지 지정하는 `<BillingConfiguration>` 요소가 포함되어야 합니다. XML API를 사용하여 요청자 지불 기능을 설정하는 방법에 대한 자세한 내용은 버킷 요청자 지불 설정을 참조하세요.

compose

기존 객체의 시퀀스를 XML 복합 API에서만 사용하는 새 복합 객체로 작성하도록 하는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME/OBJECT_NAME?compose`
세부정보	PUT Object 요청의 경우 선택사항입니다. ComposeRequest XML 문서는 요청 본문에 제공되어야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

cors

버킷의 교차 출처 리소스 공유 (CORS)를 검색하거나 변경할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME?cors`
세부정보	PUT 버킷, GET 버킷 요청의 경우 선택사항입니다. PUT 요청을 전송할 때는 적용하려는 CORS를 지정하는 XML 문서를 요청 본문에 포함해야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

기본 객체 Acl

버킷의 기본 객체 액세스 제어 목록을 검색하거나 변경할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME?defaultObjectAcl`
세부정보	PUT Bucket 및 GET Bucket 요청에서 선택사항입니다. PUT 요청을 전송할 때는 버킷에 추가된 새 객체에 기본적으로 적용되는 ACL을 지정하는 XML 문서를 요청 본문에 포함해야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다. 자세한 내용은 기본 객체 ACL 설정을 참조하세요.

구분 기호

GET 버킷 요청 중에 객체 목록을 제한하는 데 사용되는 문자 또는 문자 그룹입니다.

유효한 값 모든 유니코드 문자 또는 문자입니다.

예 /?delimiter=/

세부정보

delimiter는 디렉터리와 유사한 이름 지정 스키마를 사용하는 객체 목록을 단순화합니다. 이 옵션을 사용하면 이름에 구분 기호를 포함하지 않는 객체가 일반적으로 응답의 Contents 요소에 있는 것처럼 반환됩니다. 객체 이름에 구분 기호가 포함된 경우, 구분 기호의 첫 번째 인스턴스를 포함하여 객체 이름의 일부분이 응답의 CommonPrefixes 요소에 표시됩니다.

delimiter를 prefix 매개변수와 함께 사용할 수 있습니다. 이 경우 prefix은 이름이 prefix과 일치하는 객체로만 결과를 제한합니다.

delimiter는 일반적으로 /로 설정되지만 모든 문자의 시퀀스일 수 있습니다. delimiter 사용 방법의 예시는 구분자 예시를 참조하세요.

인코딩 유형

객체 나열 요청에 대한 응답으로 객체 이름을 URL 인코딩하기 위한 쿼리 문자열 매개변수입니다.

유효한 값	`url`
예	`/bucket?encoding-type=url`
세부정보	버킷의 객체 나열 시 선택사항입니다. 요청에 포함된 경우 반환되는 객체 이름은 URL로 인코딩됩니다. 이는 XML 1.0에서 파싱할 수 없는 유니코드 문자가 객체 이름에 포함된 경우에 유용합니다.

암호화

객체의 암호화 정보를 검색할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/object?encryption`
세부정보	GET Object 요청(선택사항) 쿼리된 객체가 고객 제공 암호화 키로 암호화되면 암호화 알고리즘과 키의 SHA-256이 `Encryption` 요소에 반환됩니다. 쿼리된 객체가 고객 관리 암호화 키로 암호화되면 Cloud Key Management Service 키 리소스가 `Encryption` 요소에 반환됩니다. 다른 모든 경우에는 빈 `Encryption` 요소가 반환됩니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

암호화 구성

버킷에서 사용하는 기본 고객 관리 암호화 키를 설정하거나 검색할 수 있게 해주는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/bucket?encryptionConfig`
세부정보	GET Bucket 요청의 경우 선택사항입니다. 쿼리된 버킷에 기본 고객 관리 암호화 키가 설정되어 있으면 키 요소 이름이 `EncryptionConfiguration` 요소 내에 반환됩니다. PUT 버킷 요청의 경우에는 선택사항입니다. 요청에 요청 본문의 고객 관리 암호화 키 리소스가 포함되면 이 키는 버킷의 기본 암호화 키가 됩니다. 요청에 빈 `EncryptionConfiguration` 요소가 포함되어 있으면 기존 기본 키가 버킷에서 삭제됩니다.

생성

가져올 객체의 세대를 나타내는 값입니다.

유효한 값	양수 (64비트 값)
예	`?generation=1360887759327000`
세부정보	`generation` 쿼리 문자열 매개변수를 사용하면 작업할 객체 버전을 지정할 수 있습니다.

세대-마커

객체 목록을 시작할 세대 번호를 나타내는 값입니다.

유효한 값	양수 (64비트 값)
예	`?generation-marker=1360887759327000`
세부정보	`generation-marker` 쿼리 문자열 매개변수는 버전이 지정된 버킷에서 페이지로 구분된 목록의 시작점입니다. `marker` 및 함께 사용하여 객체를 시작한 후 이후에 목록을 시작할 위치를 올바르게 지정해야 합니다. 지정된 `generation-marker`보다 큰 객체 버전 (세대가 더 높은 경우 라이브 버전 포함)은 객체 목록에 사전보다 더 광범위한 객체처럼 객체 목록에 반환됩니다. `marker`

수명 주기

버킷의 수명 주기 관리 정책을 검색하거나 변경할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME?lifecycle`
세부정보	PUT 버킷, GET 버킷 요청의 경우 선택사항입니다. PUT 요청을 전송할 때는 수명 주기 구성을 지정하는 요청 본문에 XML 문서를 포함해야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

위치

버킷의 location 제약조건을 검색할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME?location`
세부정보	다음 요청의 경우 선택사항입니다. GET Bucket.

로깅

버킷의 로깅 구성을 검색하거나 변경할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME?logging`
세부정보	PUT 버킷, GET 버킷 요청의 경우 선택사항입니다. PUT 요청을 전송할 때는 로깅 구성을 지정하는 요청 본문에 XML 문서를 포함해야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

마커

객체 목록을 시작할 위치를 나타내는 문자열입니다.

유효한 값	모든 문자열.
예	`?marker=test`
세부정보	`marker` 쿼리 문자열 매개변수는 객체 목록을 이후에 시작할 객체를 지정하는 유니코드 문자 문자열입니다. 반환되는 객체의 목록은 `marker`보다 사전 음성화된 객체 목록입니다.

마커

HMAC 키의 후속 페이지를 나열할 수 있는 페이지 토큰입니다.

유효한 값	`IsTruncated`가 `true`인 경우 이전 `list` 응답에서 제공된 문자열입니다.
예	`?Action=ListAccessKeys&Marker=AERPALERN/NEXT/TOKEN`
세부정보	`Marker` 쿼리 문자열 매개변수는 지정된 프로젝트의 HMAC 키를 나열할 때 큰 결과 집합을 페이지로 나누는 데 사용되는 연속 토큰입니다. 조건`IsTruncated` 다음과 같음`true` 이전 `list` 제공된`Marker` 이후 토큰의 토큰`list` 요청까지`IsTruncated` `false` 을 엽니다. `Marker`를 `Action` 쿼리 매개변수와 함께 사용해야 합니다. 자세한 내용은 HMAC 키 가져오기를 참조하세요.

최대 키

단일 결과 '페이지'에 반환되는 객체의 수를 제한하는 정수입니다.

유효한 값	0보다 큰 숫자입니다.
예	`?max-keys=100`
세부정보	`max-keys` 쿼리 문자열 매개변수는 객체 목록에서 반환하려는 최대 객체 수를 지정하는 정수입니다. 요청이 `max-keys`가 허용하는 것보다 많은 객체를 반환할 수 있는 경우 `IsTruncated` 응답 요소에는 `True` 값이 포함됩니다.

최대 항목 수

단일 결과 페이지에서 반환되는 HMAC 키 수를 제한하는 정수입니다.

유효한 값	0보다 큰 숫자입니다.
예	`?Action=ListAccessKeys&MaxItems=100`
세부정보	`MaxItems` 쿼리 문자열 매개변수는 단일 결과 페이지에서 반환되는 최대 HMAC 키 수를 지정하는 정수입니다. 요청이 `MaxItems`에서 허용하는 것보다 더 많은 키를 반환할 수 있다면 `IsTruncated` 응답 요소에 `true` 값이 포함됩니다. `MaxItems`를 `Action` 쿼리 매개변수와 함께 사용해야 합니다. 이 서비스는 지정된 최댓값보다 적은 결과를 반환할 수 있습니다.

접두사

객체 목록을 특정 프리픽스가 있는 객체로 제한하는 문자열입니다.

유효한 값	모든 유효한 프리픽스.
예	?prefix=/europe/france
세부정보	`prefix` 쿼리 문자열 매개변수는 목록이 지정된 `prefix` 값으로 시작되는 객체로 목록을 제한하는 유니코드 문자 문자열입니다. `prefix` 쿼리 문자열 매개변수를 `delimiter` 쿼리 문자열 매개변수와 함께 사용하여 더 작은 객체의 하위 집합을 만들 수 있습니다.

응답-콘텐츠 분류

인증된 GET 요청에서 콘텐츠 처리를 재정의할 수 있도록 허용하는 쿼리 문자열 매개변수입니다.

유효한 값	기본 객체의 콘텐츠 분류 대신 반환할 URL 인코딩 헤더입니다.
예	`?response-content-disposition=attachment%3B%20filename%3D%22foo%22`
세부정보	인증된 GET 요청이 헤더에서 반환된 콘텐츠 처리를 재정의하도록 허용합니다. 자세한 내용은 사양을 참조하세요.

응답-콘텐츠-유형

인증된 GET 요청에 대한 콘텐츠 유형 재정의를 허용하는 쿼리 문자열 매개변수입니다.

유효한 값	기본 객체의 콘텐츠 유형 대신 반환할 URL 인코딩 헤더입니다.
예	`?response-content-type=text%2Fhtml`
세부정보	인증된 GET 요청이 헤더에서 반환된 콘텐츠 처리를 재정의하도록 허용합니다. 자세한 내용은 사양을 참조하세요.

상태

HMAC 키를 사용 설정하거나 사용 중지할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	`Active`, `Inactive`
예	`?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive`
세부정보	`Status` 쿼리 문자열 매개변수를 사용하여 `Active` 및 `Inactive` 사이의 HMAC 키 상태를 변경할 수 있습니다. `Status`를 `Action` 및 `AccessKeyId` 쿼리 매개변수와 함께 사용해야 합니다.

스토리지 클래스

버킷의 스토리지 클래스를 설정하거나 검색할 수 있게 해주는 쿼리 문자열 매개변수입니다.

유효한 값	요청 본문 내: `STANDARD`, `NEARLINE`, `ARCHIVE`, `COLDLINE`, `MULTI_REGIONAL`, `REGIONAL`,`DURABLE_REDUCED_AVAILABILITY`
예	`/BUCKET_NAME?storageClass`
세부정보	`GET Bucket` 요청에 대한 선택사항 `PUT Bucket`입니다. `GET Bucket` 요청에 사용되면 지정된 버킷의 스토리지 클래스가 응답 본문에 반환됩니다. `PUT Bucket` 요청에 사용되는 경우 요청 본문에 버킷에 할당할 스토리지 클래스를 지정하는 `<StorageClass>` 요소가 포함되어야 합니다. XML API를 사용하여 버킷의 스토리지 클래스를 설정하는 방법에 대한 자세한 내용은 버킷 스토리지 클래스 설정을 참조하세요.

태그하기

버킷에 적용된 라벨을 설정하거나 가져올 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	요청 본문 내: `key:value` 쌍으로 지정되는 라벨.
예	`/BUCKET_NAME?tagging`
세부정보	`GET Bucket` 요청에 대한 선택사항 `PUT Bucket`입니다. `GET Bucket` 요청에 사용하면 지정된 버킷에 적용된 라벨이 응답 본문에 반환됩니다. `PUT Bucket` 요청에 사용하는 경우 요청 본문에 버킷에 적용할 라벨을 지정하는 `<Tagging>` 요소가 포함되어야 합니다. XML API를 사용하여 라벨을 적용하는 방법에 대한 자세한 내용은 버킷 라벨 설정을 참조하세요.

upload_id[업로드_ID]

재개 가능한 업로드 작업의 업로드 ID를 지정하는 쿼리 문자열 매개변수입니다. upload_id는 세션 URI의 일부이지만 이후 재개 가능한 업로드 작업의 요청 URI를 고유하게 정의하므로 전체 세션 URI를 저장해야 합니다. 세션 URI는 Location 응답 헤더에서 가져옵니다.

유효한 값 모든 유효한 업로드 ID.

예 /?upload_id=tvA0ExBntDaOKdxL46u1NkHxNb...B2Uowrot HTTP/1.1

세부정보

업로드 ID는 일주일 후 만료됩니다. 업로드 ID를 가져오자마자 재개 가능한 업로드를 시작하고 중단된 직후 중단된 업로드를 재개하는 것이 좋습니다.

요청에 만료된 업로드 ID를 사용하면 404 찾을 수 없음 상태 코드가 수신됩니다. 이 경우 재개 가능한 업로드를 다시 시작하고 새 업로드 ID를 가져온 후 새 업로드 ID를 사용하여 업로드를 시작해야 합니다.

업로드 ID는 생성된 위치에 결합되므로 한 위치에서 생성하고 다른 위치에서 사용하면 성능이 저하될 수 있습니다.

업로드 ID는 Bearer 토큰입니다. 즉, 이 토큰을 소유하는 것이 인증자 역할을 합니다. 따라서 업로드 ID를 유출하지 않도록 주의해야 합니다.

사용자 이름

HMAC 키를 만들거나 업데이트하거나 나열할 서비스 계정을 식별할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	올바른 서비스 계정 이메일 주소입니다.
예	`/?Action=CreateAccessKey&UserName=serviceAccount@proj.iam.gserviceaccount.com`
세부정보	`UserName`HMAC 키를 만들고 프로젝트와 관련된 키를 나열하기 위한 선택사항은 선택사항입니다. `UserName`를 `Action` 쿼리 매개변수와 함께 사용해야 합니다.

사용자 프로젝트

요청과 관련된 액세스 요금이 청구될 프로젝트 ID를 지정하는 쿼리 문자열 매개변수입니다.

유효한 값	유효한 프로젝트 ID
예	`?userProject=example-project`
세부정보	이 매개변수에 지정된 프로젝트에는 요청과 관련된 요금이 청구됩니다. 예를 들어 `userProject`는 요청자 지불이 사용 설정된 버킷에 대한 요청을 할 때 사용됩니다. 일반적으로 프로젝트 ID가 필요한 XML 요청은 `userProject` 매개변수 대신 `x-goog-user-project` 헤더에 ID를 제공해야 합니다.

버전 관리

버킷의 버전 관리 구성을 검색하거나 변경할 수 있는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/OBJECT_NAME?versioning`
세부정보	PUT 버킷, GET 버킷 요청의 경우 선택사항입니다. PUT 요청을 전송할 때는 적용하려는 버전 관리 구성을 지정하는 XML 문서를 요청 본문에 포함해야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

versions

버전이 지정된 버킷에서 모든 세대의 객체를 검색할 수 있게 해주는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME?versions=True`
세부정보	다음 요청의 경우 선택사항입니다. GET Bucket.

웹사이트 구성

버킷의 웹사이트 구성을 검색하거나 변경할 수 있게 해주는 쿼리 문자열 매개변수입니다.

유효한 값	없음
예	`/BUCKET_NAME?websiteConfig`
세부정보	PUT 버킷, GET 버킷 요청의 경우 선택사항입니다. PUT 요청을 전송할 때는 적용하려는 웹사이트 구성을 지정하는 XML 문서를 요청 본문에 포함해야 합니다. 이 쿼리 매개변수에는 추가 하위 리소스를 사용할 수 없습니다.

X-Goog-Algorithm

V4 서명된 URL 알고리즘을 결정하는 쿼리 문자열 매개변수입니다.

유효한 값	`GOOG4-RSA-SHA256` `GOOG4-HMAC-SHA256` `AWS4-HMAC-SHA256`
세부정보	서명된 URL과 같은 V4 서명된 요청에 특별히 사용됩니다.

X-Goog-Credential

사용된 사용자 인증 정보 유형을 결정하는 쿼리 문자열 매개변수입니다.

유효한 값	`Service_Account_Email/Date/Region/goog4_request` `Google_HMAC_Access_Key_ID/Date/Region/goog4_request` `AWS_HMAC_Access_Key_ID/Date/Region/aws4_request`
예	Google 서비스 계정 사용: `example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request` HMAC 사용: `GOOGTS7C7FUP3AIRVJTE2BCD%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request`
세부정보	서명된 URL과 같은 V4 서명된 요청에 특별히 사용됩니다.

X-Goog-Date (쿼리 매개변수)

서명된 URL을 사용할 수 있게 된 날짜 및 시간

유효한 값	다음 날짜 이후의 날짜: YYYYMMDD'T'HHMMSS'Z'
예	`?X-Goog-Date=20181026T181309Z`
세부정보	사용되는 형식은 ISO 8601 기본 형식 YYYYMMDD'T'HHMMSS'Z'입니다.

X-Goog-Expires

V4 서명된 URL이 활성 상태로 유지되는 시간을 결정하기 위한 쿼리 문자열 매개변수입니다.

유효한 값	604,800초 이하
예	`?X-Goog-Expires=900`
세부정보	서명된 URL의 유효 기간으로, X-Goog-Date(값 매개변수)의 값(초)으로 측정됩니다. 최댓값은 7일 또는 604800초입니다.

X-Goog-SignedHeaders

V4 서명된 URL에 서명된 헤더를 결정하는 쿼리 문자열 매개변수입니다.

유효한 값	유일한 필수 헤더는 host입니다. V4 서명 URL 서명으로 서명된 모든 헤더는 이 목록에 있어야 합니다.
예시	`?X-Goog-SignedHeaders=host` `?X-Goog-SignedHeaders=host,x-goog-acl`
세부정보	서명된 URL을 사용하는 모든 요청의 일부로 포함되어야 하는 헤더입니다.

X-Goog-Signature

V4 서명 URL 서명 값이 있는 쿼리 문자열 매개변수

유효한 값	서명된 URL의 서명.
예	?X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7
세부정보	이 서명된 URL을 사용하여 지정된 리소스에 대한 요청을 허용하는 인증 문자열입니다.