POST 요청을 통해 재개 가능한 업로드를 시작합니다. 이 초기 요청은 데이터를 업로드하는 후속 PUT 요청에 사용할 세션 URI를 생성합니다. 또한 최초 요청에서 객체의 메타데이터를 지정할 수 있습니다. 재개 가능한 업로드가 완료되면 업로드된 객체는 이름이 같은 기존 객체를 대체합니다. Cloud Storage에 업로드하는 방법에 관한 팁은 권장사항을 참조하세요.
XML API를 사용한 간단한 업로드의 경우 POST 객체를 사용하는 대신 PUT 객체 요청을 수행합니다.
쿼리 문자열 매개변수
이 요청에는 일반적으로 쿼리 문자열 매개변수가 포함되지 않습니다.
서명된 URL을 만들고 사용할 때 포함되는 매개변수에 대한 정보는 서명된 URL 쿼리 문자열 매개변수를 참조하세요.
요청 헤더
다음 요청 헤더를 사용할 수 있습니다.
| 헤더 | 설명 | 필수 |
|---|---|---|
Authorization |
요청의 인증 문자열입니다. | 예 |
Cache-Control |
공개적으로 액세스 가능한 객체를 캐시해야 하는 조건입니다. Cache-Control은 객체의 변환 가능 여부도 판단하는 데 사용됩니다. |
없음 |
Content-Disposition |
객체 데이터가 전송되는 방식에 관한 프레젠테이션 정보를 지정하는 헤더입니다. | 없음 |
Content-Encoding |
업로드할 객체를 압축하는 데 사용된 압축 알고리즘입니다. | 없음 |
Content-Language |
콘텐츠의 ISO 639-1 언어 코드입니다. | 없음 |
Content-Length |
헤더가 없는 요청 본문의 길이 (바이트 단위) 재개 가능한 업로드를 시작하는 경우 이 값은 0입니다. |
예 |
Content-Type |
업로드할 객체의 MIME 유형입니다. 콘텐츠 유형을 지정하지 않으면 Cloud Storage는 객체를 제공할 때 기본적으로 application/octet-stream로 설정됩니다. |
아니요 (권장) |
Date |
요청 날짜 및 시간입니다. | 예 |
Host |
Cloud Storage의 URI입니다. 자세한 내용은 요청 엔드포인트를 참조하세요. | 예 |
x-goog-acl |
객체에 적용할 사전 정의된 ACL입니다. | 없음 |
x-goog-custom-time |
사용자가 지정한 날짜 및 시간. | 없음 |
x-goog-encryption-kms-key-name |
객체를 암호화하는 데 사용할 고객 관리 암호화 키입니다. | 없음 |
x-goog-if-generation-match |
지정한 세대가 교체할 객체와 동일하면 객체가 대체됩니다. 또한 0을 특수 값으로 지정하여 기존 객체가 없는 경우에만 새 객체를 만들 수 있습니다. | 없음 |
x-goog-if-metageneration-match |
지정한 metageneration이 업데이트하려는 객체와 동일하면 객체 메타데이터가 업데이트됩니다. x-goog-if-generation가 지정된 경우에만 허용됩니다. 이 2세대 속성을 결합하면 안전하게 읽기-수정-쓰기 업데이트를 구현할 수 있습니다. |
없음 |
x-goog-meta- |
커스텀 메타데이터를 저장하는 데 사용할 수 있는 확장 헤더입니다. | 없음 |
x-goog-resumable |
이 요청이 재개 가능한 업로드를 시작함을 나타냅니다. 이 헤더는 start 값을 사용해야 합니다. |
예 |
x-goog-storage-class |
객체에 연결된 버킷의 기본 스토리지 클래스 외의 스토리지 클래스를 제공합니다. | 없음 |
x-goog-user-project |
요청과 관련된 요금이 청구될 프로젝트입니다. | 없음 |
객체 업로드와 함께 고객 제공 암호화 키를 제공하려면 요청에 고객 제공 암호화 키 페이지에 나열된 헤더를 사용합니다.
요청 본문 요소
이 요청은 요청 본문에 XML 문서를 포함하지 않습니다.
응답 헤더
응답에는 객체 데이터를 업로드할 때 사용할 세션 URI를 나타내는 Location 헤더가 포함됩니다.
응답 본문 요소
응답의 응답 본문에 XML 문서가 없습니다.
예
다음 샘플에서는 paris.jpg라는 객체를 travel-maps라는 버킷에 업로드합니다.
요청
POST /paris.jpg HTTP/2 Host: travel-maps.storage.googleapis.com Date: Thu, 10 Dec 2020 18:11:50 GMT Content-Type: image/jpg Content-Length: 0 X-Goog-Resumable: start Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
응답
HTTP/2 201 Content-Type: text/plain; charset=utf-8 X-Guploader-Uploadid: ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Location: https://storage.googleapis.com/nstocktest/xmltestinit.jpg?upload_id=ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Content-Length: 0 Date: Thu, 10 Dec 2020 18:11:53 GMT Server: UploadServer