PutBucketCors

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

Ncloud Storage 버킷에 CORS(Cross-Origin Resource Sharing) 설정을 등록하거나 기존 설정을 덮어씁니다.

요청

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

메서드	URL
PUT	-

요청 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오. 단, 요청 시 Content-MD5 또는 x-amz-checksum-sha256 헤더 중 하나를 반드시 포함해야 합니다.

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`CORSConfiguration`	-	Required	CORS 설정의 루트 요소
`CORSConfiguration.CORSRule`	List	Required	CORS 규칙 목록 최대 100개 가능
`CORSConfiguration.CORSRule.ID`	String	Optional	규칙 이름 최대 255자 가능 규칙 내에서 고유한 값 생략 시 자동 생성
`CORSConfiguration.CORSRule.AllowedMethod`	List	Required	허용할 HTTP 메서드 `GET`, `PUT`, `POST`, `DELETE`, `HEAD` 중 하나 이상 지정
`CORSConfiguration.CORSRule.AllowedOrigin`	List	Required	허용할 Origin 와일드카드(`*`) 사용 가능하며 Origin당 1개만 허용
`CORSConfiguration.CORSRule.AllowedHeader`	List	Optional	허용할 요청 헤더 와일드카드(`*`) 사용 가능하며 헤더당 1개만 허용
`CORSConfiguration.CORSRule.ExposeHeader`	List	Optional	브라우저에 노출할 응답 헤더 와일드카드(`*`) 사용 불가
`CORSConfiguration.CORSRule.MaxAgeSeconds`	Integer	Optional	브라우저가 preflight 응답을 캐시하는 시간(초)

참고

CORSRule이 없거나, AllowedMethod 또는 AllowedOrigin이 누락된 경우, 오류를 반환합니다.
AllowedOrigin 및 AllowedHeader에는 와일드카드(*)를 각 항목당 1개만 사용할 수 있습니다.
ExposeHeader에는 와일드카드(*)를 사용할 수 없습니다.
CORSRule.ID가 중복되면 오류를 반환합니다.

요청 예시

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

PUT /?cors HTTP/1.1
Host: bucket.kr.ncloudstorage.com
Content-MD5: Q2hlY2sgSW50ZWdyaXR5IQ==

<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <CORSRule>
        <ID>rule1</ID>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedOrigin>https://example.com</AllowedOrigin>
        <AllowedHeader>*</AllowedHeader>
        <ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
        <MaxAgeSeconds>3600</MaxAgeSeconds>
    </CORSRule>
</CORSConfiguration>

응답

응답 형식을 설명합니다.

응답 헤더

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

응답 상태 코드

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

응답 예시

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

HTTP/1.1 200 OK