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

Object Storage Service:Table Bucket のメンテナンス構成の設定

最終更新日:May 09, 2026

put-table-bucket-maintenance-configuration コマンドは、Table Bucket のメンテナンス構成(未参照ファイルクリーンアップポリシーなど)を設定します。

注意事項

  • メンテナンス構成は、Table Bucket のバックグラウンドメンテナンス動作をコントロールします。現在、--type パラメーターでサポートされているのは iceberg タイプのみであり、これにより未参照ファイルクリーンアップの有効化または無効化が可能です。

  • --value パラメーターには、JSON 形式の構成が必要です。コマンドライン上でインラインで構成を渡すか、file:// プレフィックスを使用してローカル JSON ファイルを指定できます。

構文

ossutil tables-api put-table-bucket-maintenance-configuration --table-bucket-arn value --type value --value value [flags]

パラメーター

タイプ

説明

--table-bucket-arn

文字列

Table Bucket の ARN。形式は acs:osstables:{region}:{uid}:bucket/{bucket-name} です。

--type

文字列

メンテナンスタイプ。現在、iceberg のみがサポートされています。

--value

文字列

メンテナンス構成の値。JSON 形式で指定します。

説明
  • put-table-bucket-maintenance-configuration コマンドは、PutTableBucketMaintenanceConfiguration API オペレーションに対応しています。パラメーターの詳細については、「PutTableBucketMaintenanceConfiguration」をご参照ください。

  • サポートされているグローバルコマンドラインオプションの詳細については、「ossutil グローバルオプション」をご参照ください。

--value パラメーターの JSON 構文は次のとおりです。

{
  "settings": {
    "unreferenced_file_cleanup": {
      "enabled": true
    }
  }
}

  • メンテナンスタイプを iceberg に設定して、Table Bucket の未参照ファイルクリーンアップを有効にします。

    ossutil tables-api put-table-bucket-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --type iceberg --value '{"settings":{"unreferenced_file_cleanup":{"enabled":true}}}'
  • maintenance.json という名前のローカルファイルからメンテナンス構成を設定します。file:// プレフィックスを使用してファイルパスを指定します。

    ossutil tables-api put-table-bucket-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --type iceberg --value file://maintenance.json