BackupPlan カスタム リソース定義

仕様スキーマ

BackupPlanSpec は、BackupPlan の選択された状態を定義します。

BackupPlan:
  metadata:
    name: string
  spec:
    backupLocation:
      gcsOptions:
        bucket: string
        key: string
        secretRef:
          name: string
      s3Options:
        bucket: string
        caBundle: []string
        endpoint: string
        key: string
        region: string
        secretRef:
          name: string
      type: string
    backupRetainDays: integer
    backupSchedules:
      differential: string
      full: string
      incremental: string
    dbclusterRef: string
    paused: boolean

フィールド タイプ 必須または省略可	説明
name
string 必須	BackupPlan リソースの名前。
backupLocation
object 必須	バックアップを保存するリモート オブジェクト ストレージ リポジトリのロケーションを指定します。
backupLocation.gcsOptions
object 省略可	Cloud Storage リポジトリの構成オプション。
backupLocation.gcsOptions.bucket
string 必須	Cloud Storage バケット名（例: dbs-dump-bucket）。ユーザーは、ストレージ バケットへの書き込みアクセス権を確保する必要があります。
backupLocation.gcsOptions.key
string 必須	バックアップ ダンプファイルのオブジェクト キーの接頭辞（例: ods-dump/scottschema.dmp）。
backupLocation.gcsOptions.secretRef
object 省略可	Cloud Storage アクセス情報を保存する Secret リソースへの参照。
backupLocation.gcsOptions.secretRef.name
string 必須	Secret リソースの名前。
backupLocation.s3Options
object 省略可	Amazon S3 または S3 互換オブジェクト ストレージ リポジトリの構成オプション。
backupLocation.s3Options.bucket
string 必須	S3 バケット名（例: dbs-dump-bucket）。ユーザーは、ストレージ バケットへの書き込みアクセス権を確保する必要があります。
backupLocation.s3Options.caBundle
list (string) 省略可	S3 ストレージ サーバー証明書の検証に使用される PEM でエンコードされた CA 証明書のプール。
backupLocation.s3Options.endpoint
string 省略可	S3 エンドポイント URL（例: https://s3.amazonaws.com）。
backupLocation.s3Options.key
string 必須	バックアップ ダンプファイルのオブジェクト キーの接頭辞（例: ods-dump/scottschema.dmp）。
backupLocation.s3Options.region
string 必須	バケットが存在する AWS S3 リージョン（例: us-west-2）。
backupLocation.s3Options.secretRef
object 省略可	S3 ストレージ アクセス認証情報を含む Secret への参照。
backupLocation.s3Options.secretRef.name
string 必須	Secret リソースの名前。
backupLocation.type
string 必須	有効な値: GCS、S3。 リポジトリのタイプ（Amazon S3 の場合は S3、Cloud Storage の場合は GCS）。エージェントにどのストレージ システムまたは API を使用するかを指示します。
backupRetainDays
integer 省略可	デフォルト: 14、最小: 1、最大: 90。 サービスが Backup を自動的に削除するまでの日数。指定した場合、この BackupPlan で作成された Backup は、存続期間（createTime + backupRetainDays）に達すると自動的に削除されます。
backupSchedules
object 省略可	さまざまなタイプの自動バックアップのスケジュールを定義します。完全バックアップ、差分バックアップ、増分バックアップのタイプがサポートされています。指定しない場合、毎日午前 0 時（0 0 * * *）に 1 回フル バックアップが取得されます。
backupSchedules.differential
string 省略可	自動差分バックアップのスケジュールを定義する標準の cron 式。
backupSchedules.full
string 省略可	自動完全バックアップのスケジュールを定義する標準の cron 式（例: 0 0 * * *）。
backupSchedules.incremental
string 省略可	自動増分バックアップのスケジュールを定義する標準の cron 式。
dbclusterRef
string 必須	このバックアップ プランが構成する DBCluster カスタム リソースの名前。このフィールドは必須で、変更できません。
paused
boolean 省略可	デフォルト: false。 このバックアップ プランでバックアップの作成が一時停止されているかどうかを示すフラグ。true に設定すると、新しい自動バックアップのスケジュールがサービスによって一時停止されます。

ステータス スキーマ

BackupPlanStatus は、BackupPlan の観測状態を定義します。

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
lastBackupTime: string
nextBackupTime: string
observedGeneration: integer
phase: string
reconciled: boolean
recoveryWindow:
  begin: string
  end: string

フィールド タイプ 必須または省略可	説明
conditions
list (object) 省略可	conditions は、エンティティの現在の状態について利用可能な最新の観測値を表します。
conditions[].lastTransitionTime
string 必須	この条件があるステータスから別のステータスに遷移した最後の日時。これは、基本的な条件が変更されたときです。不明な場合は、API フィールドが変更された時刻を使用します。
conditions[].message
string 必須	移行の詳細を示す人が読めるメッセージ。空の文字列にすることもできます。
conditions[].observedGeneration
integer 省略可	この条件が設定されたときの .metadata.generation を表します。たとえば、.metadata.generation が 12 であるにもかかわらず、.status.conditions[x].observedGeneration が 9 である場合、その状態はインスタンスの現在の状態に関して古くなっています。
conditions[].reason
string 必須	最大長: 1, 024、最小長: 1 条件の最後の以降の理由を示すプログラマティック ID が含まれます。特定の条件タイプのプロデューサーは、このフィールドの想定される値と意味を定義できます。値は CamelCase 文字列にする必要があります。このフィールドを空にすることはできません。
conditions[].status
string 必須	条件のステータス（True、False、Unknown のいずれか）。
conditions[].type
string 必須	最大長: 316 条件のタイプ（CamelCase または foo.example.com/CamelCase）。
criticalIncidents
list (object) 必須	すべてのアクティブな重大インシデントのフラットなリスト。進行中の重大なインシデントに関するすべての情報が含まれます。
criticalIncidents[].code
string 必須	この特定のエラーのエラーコード。エラーコードは DBSE の後に数字が続く形式（DBSE1012 など）で表されます。
criticalIncidents[].createTime
string 必須	このインシデントが発生元で作成されたときのタイムスタンプ。
criticalIncidents[].message
string 省略可	発生したインシデント / エラー。
criticalIncidents[].messageTemplateParams
object 省略可	ユーザー インターフェースでユーザー フレンドリーなデータドリブン バージョンのメッセージを生成するために必要な Key-Value ペアが含まれます。
criticalIncidents[].resource
object 必須	インシデントを報告した Database Service コンポーネントに関する情報と、クラスタ マネージャー リソースに関する情報が含まれます。
criticalIncidents[].resource.component
string 必須	このインシデントを報告した Database Service サブシステムの内部識別子。
criticalIncidents[].resource.location
object 省略可	リソースが配置されているロケーション。
criticalIncidents[].resource.location.cluster
string 省略可	影響を受けたクラスタ マネージャー リソースのクラスタの名前。
criticalIncidents[].resource.location.group
string 省略可	クラスタ マネージャー リソースのグループ名。
criticalIncidents[].resource.location.kind
string 省略可	クラスタ マネージャー リソースの種類。
criticalIncidents[].resource.location.name
string 省略可	影響を受けたクラスタ マネージャー リソースの名前。
criticalIncidents[].resource.location.namespace
string 省略可	影響を受けたクラスタ マネージャー リソースの Namespace。
criticalIncidents[].resource.location.version
string 省略可	クラスタ マネージャー リソースのバージョン。
criticalIncidents[].stackTrace
list (object) 省略可	スタック トレースに含まれるメッセージの非構造化リスト。
criticalIncidents[].stackTrace.component
string 省略可	このメッセージをログに記録した Database Service コンポーネントの名前。
criticalIncidents[].stackTrace.message
string 省略可	ログに記録されたメッセージ。
criticalIncidents[].transientUntil
string 省略可	TransientUntil が指定されている場合、問題は指定された時刻までの一時的なものと見なす必要があります。
lastBackupTime
string 省略可	最後に実行されたバックアップのタイムスタンプ。
nextBackupTime
string 省略可	次回スケジュールされているバックアップのタイムスタンプ。
observedGeneration
integer 省略可	コントローラによって観測された世代。
phase
string 省略可	BackupPlan のフェーズ。
reconciled
boolean 省略可	リソースがコントローラによって調整されたかどうか。
recoveryWindow
object 省略可	利用可能な復元期間。
recoveryWindow.begin
string 省略可	開始時刻。
recoveryWindow.end
string 省略可	終了時間。