---
title: "put-bucket-website"
slug: "put-bucket-website"
updated: 2026-10-14T00:05:21Z
published: 2026-10-14T09:00:27Z
canonical: "cli.ncloud-docs.com/put-bucket-website"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# put-bucket-website

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

Ncloud Storage 버킷에 정적 웹 사이트 호스팅 설정을 등록하거나 기존 설정을 덮어씁니다.

참고

Sub Account 사용자가 이 명령어를 실행하려면 Change/PutBucketWebsite 액션 권한이 있어야 합니다.

참고

설정을 등록한 버킷은 `http://{bucket}.kr.website.ncloudstorage.com` URL로 접근할 수 있습니다. 이 URL은 HTTP와 `GET`·`HEAD`·`OPTIONS` 메서드만 지원하며, 버킷 정책으로 공개한 범위만 응답합니다.

## 구문

`put-bucket-website` 구문은 다음과 같습니다.

```
aws s3api put-bucket-website \
    --bucket <bucket> \
    --website-configuration <website-configuration> \
    [--content-md5 <content-md5>] \
    [--checksum-algorithm <checksum-algorithm>] \
    --endpoint-url <endpoint-url>
```

## 옵션

`put-bucket-website` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`put-bucket-website`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--bucket` | String | Required | 버킷 이름 |
| `--website-configuration` | String | Required | 정적 웹 사이트 호스팅 설정 - [구문](/docs/put-bucket-website#websiteconfiguration%EA%B5%AC%EB%AC%B8) 참조 - 최대 크기: 128KB |

#### `--website-configuration` 구문

JSON 형식으로 입력하며, 입력할 수 있는 항목은 다음과 같습니다.

| 항목 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `IndexDocument.Suffix` | String | Conditional | 인덱스 문서의 객체 이름 - <예시> `index.html` - 빈 문자열 및 `/` 포함 불가 - `RedirectAllRequestsTo`를 입력하지 않은 경우, 필수 입력 |
| `ErrorDocument.Key` | String | Optional | 오류 문서의 객체 키 - <예시> `error.html` - 빈 문자열 불가 |
| `RedirectAllRequestsTo.HostName` | String | Conditional | 모든 요청을 리다이렉트할 호스트 이름 - `IndexDocument`를 입력하지 않은 경우, 필수 입력 - `IndexDocument`, `ErrorDocument`, `RoutingRules`와 동시 입력 불가 |
| `RedirectAllRequestsTo.Protocol` | String | Optional | 모든 요청을 리다이렉트할 프로토콜 - `http` \| `https` - 미입력 시 요청 프로토콜을 따름 |
| `RoutingRules[].Condition.KeyPrefixEquals` | String | Optional | 규칙을 적용할 객체 키의 접두사 - 최대 1,024자 가능 |
| `RoutingRules[].Condition.HttpErrorCodeReturnedEquals` | String | Optional | 규칙을 적용할 응답 상태 코드 - `400`~`417` \| `500`~`505` |
| `RoutingRules[].Redirect.HostName` | String | Optional | 리다이렉트할 호스트 이름 - `/` 및 공백 포함 불가 |
| `RoutingRules[].Redirect.Protocol` | String | Optional | 리다이렉트할 프로토콜 - `http` \| `https` |
| `RoutingRules[].Redirect.HttpRedirectCode` | String | Optional | 리다이렉트 응답 상태 코드 - `301`~`308` (`306` 제외) - 미입력 시 `301` |
| `RoutingRules[].Redirect.ReplaceKeyWith` | String | Optional | 객체 키 전체를 대체할 값 - 최대 1,024자 가능 - `ReplaceKeyPrefixWith`와 동시 입력 불가 |
| `RoutingRules[].Redirect.ReplaceKeyPrefixWith` | String | Optional | `Condition.KeyPrefixEquals`에 해당하는 접두사를 대체할 값 - 최대 1,024자 가능 - `ReplaceKeyWith`와 동시 입력 불가 |

- 예시 1: 인덱스 문서와 오류 문서를 설정할 때
  - `docs/` 접두사를 가지는 요청을 `documents/`로 리다이렉트합니다.
  - 404 오류가 발생하면 `https://www.example.com/notfound.html`로 리다이렉트합니다.

```
{
  "IndexDocument": {
    "Suffix": "index.html"
  },
  "ErrorDocument": {
    "Key": "error.html"
  },
  "RoutingRules": [
    {
      "Condition": {
        "KeyPrefixEquals": "docs/"
      },
      "Redirect": {
        "ReplaceKeyPrefixWith": "documents/"
      }
    },
    {
      "Condition": {
        "HttpErrorCodeReturnedEquals": "404"
      },
      "Redirect": {
        "HostName": "www.example.com",
        "Protocol": "https",
        "ReplaceKeyWith": "notfound.html"
      }
    }
  ]
}
```

- 예시 2: 모든 요청을 리다이렉트할 때
  - `RedirectAllRequestsTo`는 다른 항목과 함께 입력할 수 없습니다.

```
{
  "RedirectAllRequestsTo": {
    "HostName": "www.example.com",
    "Protocol": "https"
  }
}
```

### 선택 옵션

`put-bucket-website`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--content-md5` | String | Optional | 요청 데이터의 Base64 인코딩된 128비트 MD5 해시값 - 요청 데이터의 무결성 검증에 사용 - 미입력 시 자동 계산 |
| `--checksum-algorithm` | String | Optional | 요청 데이터 검증에 사용할 체크섬 알고리즘 - `CRC32` \| `CRC32C` \| `SHA1` \| `SHA256` \| `CRC64NVME` |

### 공통 옵션

`aws` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Ncloud Storage 옵션](/docs/storage-ncloudstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

정적 웹 사이트 호스팅 설정 요청이 성공하면 설정이 적용되며 결과는 출력되지 않습니다.

### 명령

명령 예시는 다음과 같습니다.

```
aws s3api put-bucket-website --bucket my-test-bucket \
    --website-configuration file://website.json \
    --endpoint-url=https://kr.ncloudstorage.com
```

## 연관 명령어

연관 명령어는 다음과 같습니다.

- [get-bucket-website](/docs/get-bucket-website)
- [delete-bucket-website](/docs/delete-bucket-website)
- [put-bucket-policy](/docs/put-bucket-policy)