すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ファイルの上書き禁止

最終更新日:Sep 09, 2026

Object Storage Service (OSS) バケット内のファイルを偶発的または悪意のある変更から保護するために、上書き禁止ルールを設定できます。この機能により、ファイルのパス、種類、またはユーザーのアイデンティティに基づいて、上書きできないファイルを正確に制御できます。

  • 同時実行書き込みと上書き禁止ルール:複数のクライアントが、存在しないパスに書き込む場合や、削除中に書き込みが発生する場合など、同時実行性の高いシナリオでは、システムが上書き対象の既存ファイルを見つけられないことがあります。このような場合、書き込み操作は許可されます。ただし、ファイルが正常に作成されると、その後の上書き試行はルールによってブロックされます。

  • ストレージクラス移行の制限:「ファイルの上書き禁止」機能が有効になっている場合、OSS コンソール、SDK、ossutil などのクライアント側メソッドを使用して CopyObject API を呼び出し、オブジェクトのストレージクラスを (たとえば Standard から Archive へ) 変更することはできません。保護されたオブジェクトのストレージクラスを変更するには、ライフサイクルルールを使用して自動的に移行させてください。

  • 機能の互換性:「ファイルの上書き禁止」機能は、クライアント側のファイル上書き操作のみをブロックします。クロスリージョンレプリケーション (CRR) やライフサイクルルールなどのバックグラウンドシステム機能には影響しません。

  • バージョニングとの競合:「ファイルの上書き禁止」機能はバージョニングと相互に排他的です。バケットでバージョニングが有効化または停止されている場合、すべての上書き禁止ルールは無視されます。

仕組み

OSS がファイルの上書きリクエストを受信すると、システムは設定された上書き禁止ルールに対して、ルールが作成された順序でリクエストを評価します:

  1. ルールのマッチング:システムは、ファイルパスがルールに設定されたプレフィックスおよびサフィックス条件に一致し、かつユーザーのアイデンティティが「制限対象ユーザー」の設定に一致するかどうかをチェックします。

  2. 判定:OSS は、ルール内のすべての条件 (プレフィックス、サフィックス、およびユーザーアイデンティティ) が満たされた場合にのみ、上書きをブロックし、FileAlreadyExists エラーを返します。

  3. デフォルトの動作:リクエストがどの上書き禁止ルールにも一致しない場合、上書きは許可されます。

特定のファイル種類の保護

本番環境の設定ファイルやログファイルが、特定のユーザーによって誤って上書きされるのを防ぎます。

  1. [Buckets] ページで、対象のバケット名をクリックします。

  2. ナビゲーションペインで、データ管理 > ファイル上書き禁止 を選択します。

  3. 上書き禁止ルールの作成 をクリックし、次のパラメーターを設定します:

    • [ルール ID]:カスタム ID を入力できます。空のままにすると、ID が自動的に生成されます。

    • [ファイル名プレフィックス]:保護するディレクトリパスを入力します。例: production/configs/。

    • [ファイル名サフィックス]:保護するファイル拡張子を入力します。例: .json。

    • [ユーザー]:上書きを制限する RAM ユーザー、RAM ロール、またはその他のアカウントを指定します。

  4. OK をクリックしてルールを作成します。

  5. ルールを検証します:

    • 制限されたアカウントを使用して、production/configs/app.json に同じ名前のファイルをアップロードしてみます。

    • FileAlreadyExists エラーが返されることを確認します。

    • 他のユーザーは正常にファイルをアップロードできること、およびプレフィックスとサフィックスの条件を満たさないパスへのアップロードは成功することを確認します。

グローバル保護ポリシーの設定

重要なビジネスデータに対して包括的な保護を確立し、どのユーザーによる偶発的な変更も防ぎます。

  1. [Buckets] ページで、対象のバケット名をクリックします。

  2. ナビゲーションペインで、データ管理 > ファイル上書き禁止 を選択します。

  3. 上書き禁止ルールの作成 をクリックし、次のパラメーターを設定します:

    • [ルール ID]:カスタム ID を入力できます。空のままにすると、ID が自動的に生成されます。

    • [ファイル名プレフィックス]: critical-data/

    • [ファイル名サフィックス]:この項目を空のままにすると、指定したパス内のすべてのファイルが保護されます。

    • [ユーザー]: * (すべてのアカウント)

  4. OK をクリックしてルールを作成します。

  5. グローバル保護を検証します:

    • いずれかのアカウントを使用して、critical-data/database.sql を上書きしてみます。

    • グローバル保護が有効であることを示す FileAlreadyExists エラーが返されることを確認します。

    • public-data/ などの他のパスにあるファイルは、引き続き上書きできることを確認します。

マッチングルール

  • ルールの数:1 つのバケットには最大 100 個のルールを設定できます。

  • 文字長:プレフィックスまたはサフィックスの最大長は 1,023 文字です。

  • プレフィックスとサフィックスのマッチング:完全な文字列照合のみがサポートされています。正規表現とワイルドカードはサポートされていません。OSS は logs/ などの入力をリテラル文字として扱います。

  • プレフィックスマッチング:プレフィックス logs/ は logs/app.log には一致しますが、dev-logs/app.log には一致しません。

  • サフィックスマッチング:サフィックス .txt は readme.txt には一致しますが、readme.TXT (大文字と小文字を区別) や readme.txt.bak には一致しません。

  • 制限対象ユーザーのマッチング:アスタリスク (*) ワイルドカードがサポートされています。設定の詳細については、「バケットポリシーの一般的な例」のプリンシパル要素をご参照ください。

  • 条件ロジック:OSS は、ルール内のすべての条件 (プレフィックス、サフィックス、および制限対象ユーザー) が満たされた場合にのみ、上書きをブロックします。

  • ルール ID:このパラメーターはオプションです。このフィールドを空のままにすると、OSS は自動的に汎用一意識別子 (UUID) を生成します。ID を指定する場合、その ID はバケット内で一意である必要があります。

ファイル上書き操作

この機能は、次のクライアント側のファイル上書き操作をブロックします:

  • PutObject

  • PostObject

  • CopyObject

  • PutObjectSymlink

  • InitiateMultipartUpload

  • CompleteMultipartUpload

よくある質問

バケット所有者がファイルを上書きできないのはなぜですか?

これは想定される動作です。「制限対象ユーザー」フィールドが空の場合、ルールはバケット所有者やルートアカウントを含むすべてのユーザーに適用されます。上書き権限を復元するには、次のいずれかの操作を実行します:

  • コンソールでルールを削除します。

  • ルールのプレフィックスまたはサフィックスを変更して、その適用範囲を狭めます。

  • 「制限対象ユーザー」に特定のアカウントを設定して、それらのユーザーのみを制限します。

プレフィックス logs/*.txt が機能しないのはなぜですか?

OSS は、プレフィックスとサフィックスのマッチングにワイルドカードをサポートしていません。* 文字はリテラル文字として扱われ、システムは logs/*.txt という名前のファイルに対して完全一致検索を実行します。正しい方法は次のとおりです:

  • プレフィックスを logs/ に設定します

  • サフィックスを .txt に設定します

これにより、logs/ ディレクトリ内の .txt で終わるすべてのファイルが一致します。

プレフィックスとサフィックスのフィールドが空の場合はどうなりますか?

プレフィックスとサフィックスの両方が空のままの場合、ルールはバケット全体に適用されます。これは、次のことを意味します:

  • 「制限対象ユーザー」フィールドも空の場合、すべてのユーザーがバケット内のどのファイルも上書きできなくなります。

  • 「制限対象ユーザー」フィールドに特定のアカウントが指定されている場合、それらのユーザーのみがバケット内のファイルの上書きを制限されます。

一部の書き込み操作がブロックされないのはなぜですか?

上書き禁止ルールは、既存のファイルに対する書き込み操作のみをブロックします。複数のクライアントが、存在しないパスに書き込む場合や、削除中に書き込みが開始された場合などの同時書き込み中に、システムは上書き対象の既存ファイルを見つけられないことがあります。このような競合状態では、書き込み操作は続行されます。これは、ルールが失敗したことを意味するものではありません。ファイルが作成された後、ルールはその後の上書き試行をブロックします。さらに、このルールは「ファイル上書き操作」のリストにない操作をブロックすることはできません。