버킷이 있는지, 요청자가 버킷에 대한 읽기 액세스 권한이 있는지 여부를 나타냅니다.
존재하지 않는 버킷으로 범위가 지정된 HEAD 요청을 실행하면404 찾을 수 없음 오류 응답 본문에는NoSuchBucket
이Code 요소
쿼리 문자열 매개변수
이 요청에는 일반적으로 쿼리 문자열 매개변수가 포함되지 않습니다.
서명된 URL을 만들고 사용할 때 포함되는 매개변수에 대한 정보는 서명된 URL 쿼리 문자열 매개변수를 참조하세요.
요청 헤더
| 헤더 | 설명 | 필수 |
|---|---|---|
Authorization |
요청의 인증 문자열입니다. | 예 |
Content-Length |
헤더가 없는 요청 본문의 길이 (바이트 단위) |
없음 |
Date |
요청 날짜 및 시간입니다. | 없음 |
Host |
Cloud Storage의 URI입니다. 자세한 내용은 요청 엔드포인트를 참조하세요. | 예 |
x-goog-user-project |
요청과 관련된 요금이 청구될 프로젝트입니다. | 없음 |
요청 본문 요소
이 요청은 요청 본문에 XML 문서를 포함하지 않습니다.
요청 구문
HEAD / HTTP/1.1 Host: BUCKET_NAME.storage.googleapis.com Date: DATE Content-Length: 0 Authorization: AUTHENTICATION_STRING
응답 헤더
요청이 표준 응답 헤더를 반환합니다.
응답 본문 요소
응답의 응답 본문에 XML 문서가 없습니다. HEAD 요청에 대한 오류 응답에는 응답 본문이 포함되지 않습니다.
예
다음 샘플은 이름이 travel-maps인 버킷에 대한 HEAD 요청을 보여줍니다.
요청
HEAD / HTTP/1.1 Host: travel-maps.storage.googleapis.com Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
응답
HTTP/1.1 200 OK ...