GetBucketWebsite

Classic/VPC 환경에서 이용 가능합니다.

Ncloud Storage 버킷에 설정된 정적 웹 사이트 호스팅 설정을 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	-

요청 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`website`	String	Required	정적 웹 사이트 호스팅 설정 조회 요청 값 없이 키만 입력

요청 예시

요청 예시는 다음과 같습니다.

GET /?website HTTP/1.1
Host: bucket.kr.ncloudstorage.com

응답

응답 형식을 설명합니다.

응답 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`WebsiteConfiguration`	-	-	정적 웹 사이트 호스팅 설정의 루트 요소
`WebsiteConfiguration.IndexDocument`	Object	-	인덱스 문서 설정 `RedirectAllRequestsTo`를 설정하지 않은 경우 표시
`WebsiteConfiguration.IndexDocument.Suffix`	String	-	인덱스 문서의 객체 이름
`WebsiteConfiguration.ErrorDocument`	Object	-	오류 문서 설정 설정한 경우 표시
`WebsiteConfiguration.ErrorDocument.Key`	String	-	오류 문서의 객체 키
`WebsiteConfiguration.RedirectAllRequestsTo`	Object	-	모든 요청을 지정한 호스트로 리다이렉트하는 설정 설정한 경우 표시 표시되는 경우 `IndexDocument`, `ErrorDocument`, `RoutingRules`는 표시되지 않음
`WebsiteConfiguration.RedirectAllRequestsTo.HostName`	String	-	리다이렉트할 호스트 이름
`WebsiteConfiguration.RedirectAllRequestsTo.Protocol`	String	-	리다이렉트할 프로토콜 `http` \| `https` 설정한 경우 표시
`WebsiteConfiguration.RoutingRules`	List	-	리다이렉트 규칙 목록 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Condition`	Object	-	규칙을 적용할 조건 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Condition.KeyPrefixEquals`	String	-	규칙을 적용할 객체 키의 접두사 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Condition.HttpErrorCodeReturnedEquals`	Integer	-	규칙을 적용할 응답 상태 코드 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Redirect`	Object	-	리다이렉트 대상
`WebsiteConfiguration.RoutingRules.RoutingRule.Redirect.HostName`	String	-	리다이렉트할 호스트 이름 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Redirect.Protocol`	String	-	리다이렉트할 프로토콜 `http` \| `https` 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Redirect.HttpRedirectCode`	Integer	-	리다이렉트 응답 상태 코드 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Redirect.ReplaceKeyWith`	String	-	객체 키 전체를 대체할 값 설정한 경우 표시
`WebsiteConfiguration.RoutingRules.RoutingRule.Redirect.ReplaceKeyPrefixWith`	String	-	`Condition.KeyPrefixEquals`에 해당하는 접두사를 대체할 값 설정한 경우 표시

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.

에러 코드	HTTP 상태 코드	설명
`NoSuchWebsiteConfiguration`	404	버킷에 정적 웹 사이트 호스팅 설정이 존재하지 않음

응답 예시

응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <IndexDocument>
        <Suffix>index.html</Suffix>
    </IndexDocument>
    <ErrorDocument>
        <Key>error.html</Key>
    </ErrorDocument>
    <RoutingRules>
        <RoutingRule>
            <Condition>
                <KeyPrefixEquals>docs/</KeyPrefixEquals>
            </Condition>
            <Redirect>
                <ReplaceKeyPrefixWith>documents/</ReplaceKeyPrefixWith>
            </Redirect>
        </RoutingRule>
    </RoutingRules>
</WebsiteConfiguration>