--- title: "PutBucketCors" slug: "ncloudstorage-putbucketcors" updated: 2026-09-17T09:58:30Z published: 2026-09-17T09:58:30Z canonical: "api.ncloud-docs.com/ncloudstorage-putbucketcors" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # PutBucketCors Classic/VPC環境で利用できます。 Ncloud Storageのバケットに Cross-Origin Resource Sharing(CORS)設定を登録したり、既存の設定を上書きします。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | PUT | - | ### リクエストヘッダ リクエストヘッダの説明は次の通りです。 参考 Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのリクエストヘッダ](/docs/ja/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `Content-MD5` | Conditional | リクエストボディの Base64エンコードした128ビット MD5ハッシュ値 - リクエストボディの完全性検証に使用 - `x-amz-checksum-*`を入力しなかった場合、必ず入力 | | `x-amz-checksum-*` | Conditional | チェックサムのハッシュ値 - キーの`*`に使用したアルゴリズムを入力 - サポートアルゴリズム: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme` - `Content-MD5`を入力しなかった場合、必ず入力 | ### リクエストボディ リクエストボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `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`のうち、1つ以上を指定 | | `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== rule1 GET PUT https://example.com * x-amz-server-side-encryption 3600 ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 ### レスポンスステータスコード Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Storageのレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK ```