27.10. VolumeSnapshot [snapshot.storage.k8s.io/v1]


Description
VolumeSnapshot は、永続ボリュームのポイントインタイムスナップショットを作成するか、既存のスナップショットにバインドするためのユーザーの要求です。
タイプ
object
必須
  • spec

27.10.1. 仕様

Expand
プロパティータイプ説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta_v2

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

spec は、ユーザーが要求するスナップショットの望ましい特性を定義します。詳細: https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots 必須。

status

object

status は、スナップショットの現在の情報を表します。コンシューマーは、このオブジェクトを使用する前に、VolumeSnapshot オブジェクトと VolumeSnapshotContent オブジェクトの間のバインドが成功したことを (VolumeSnapshot オブジェクトと VolumeSnapshotContent オブジェクトの両方が相互にポイントしていることを検証して) 確認する必要があります。

27.10.1.1. .spec

Description
spec は、ユーザーが要求するスナップショットの望ましい特性を定義します。詳細: https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots 必須。
タイプ
object
必須
  • source
Expand
プロパティータイプDescription

source

object

source は、スナップショットの作成元を指定します。このフィールドは、作成後は不変です。必須。

volumeSnapshotClassName

string

VolumeSnapshotClassName は、VolumeSnapshot によって要求された VolumeSnapshotClass の名前です。VolumeSnapshotClassName は、デフォルトの SnapshotClass を使用する必要があることを示すために nil のままにすることができます。特定のクラスターには、複数のデフォルトの Volume SnapshotClasses がある場合があります。CSI ドライバーごとに 1 つのデフォルトです。VolumeSnapshot が SnapshotClass を指定しない場合、VolumeSnapshotSource がチェックされ、関連付けられた CSI ドライバーが何であるかが把握され、その CSI ドライバーに関連付けられたデフォルトの VolumeSnapshotClass が使用されます。特定の CSI ドライバーに複数の VolumeSnapshotClass が存在し、複数がデフォルトとしてマークされている場合、CreateSnapshot は失敗し、イベントを生成します。このフィールドには空の文字列は使用できません。

27.10.1.2. .spec.source

Description
source は、スナップショットの作成元を指定します。このフィールドは、作成後は不変です。必須。
タイプ
object
Expand
プロパティータイプDescription

persistentVolumeClaimName

string

persistVolumeClaimName は、スナップショットの作成元となるボリュームを表す PersistentVolumeClaim オブジェクトの名前を指定します。この PVC は、VolumeSnapshot オブジェクトと同じ名前空間にあると見なされます。スナップショットが存在せず、作成する必要がある場合は、このフィールドを設定する必要があります。このフィールドは不変です。

volumeSnapshotContentName

string

volumeSnapshotContentName は、既存のボリュームスナップショットを表す既存の VolumeSnapshotContent オブジェクトの名前を指定します。スナップショットがすでに存在し、Kubernetes での表現のみが必要な場合は、このフィールドを設定する必要があります。このフィールドは不変です。

27.10.1.3. .status

Description
status は、スナップショットの現在の情報を表します。コンシューマーは、このオブジェクトを使用する前に、VolumeSnapshot オブジェクトと VolumeSnapshotContent オブジェクトの間のバインドが成功したことを (VolumeSnapshot オブジェクトと VolumeSnapshotContent オブジェクトの両方が相互にポイントしていることを検証して) 確認する必要があります。
タイプ
object
Expand
プロパティータイプDescription

boundVolumeSnapshotContentName

string

boundVolumeSnapshotContentName は、この VolumeSnapshot オブジェクトがバインドしようとしている VolumeSnapshotContent オブジェクトの名前です。指定しない場合は、VolumeSnapshot オブジェクトが VolumeSnapshotContent オブジェクトに正常にバインドされていないことを示します。注: セキュリティーの問題を回避するために、コンシューマーは、このオブジェクトを使用する前に、VolumeSnapshot オブジェクトと VolumeSnapshotContent オブジェクトの間のバインドが成功したことを (VolumeSnapshot オブジェクトと VolumeSnapshotContent オブジェクトの両方が相互にポイントしていることを検証して) 確認する必要があります。

creationTime

string

creationTime は、基盤となるストレージシステムによってポイントインタイムスナップショットが取得されたときのタイムスタンプです。動的スナップショットを作成する場合、このフィールドには、CSI "CreateSnapshot" gRPC 呼び出しから返された "creation_time" 値がスナップショットコントローラーによって入力されます。既存のスナップショットで、ドライバーがサポートしている場合、このフィールドには CSI "ListSnapshots" gRPC 呼び出しから返される "creation_time" 値が入力されます。指定しない場合は、スナップショットの作成時刻が不明であることを示している可能性があります。

error

object

error は、スナップショットの作成中に最後に観察されたエラーです (存在する場合)。このフィールドは、報告されたエラーのタイプに基づいて、スナップショットが作成されるのを待機し続けるかどうかを決定するために、上位レベルのコントローラー (つまり、アプリケーションコントローラー) に役立つ場合があります。スナップショットの作成中にエラーが発生した場合、スナップショットコントローラーは再試行を続けます。成功すると、このエラーフィールドはクリアされます。

readyToUse

boolean

readyToUse は、スナップショットを使用してボリュームを復元する準備ができているかどうかを示します。動的スナップショット作成の場合、このフィールドには、CSI "CreateSnapshot" gRPC 呼び出しから返された "ready_to_use" 値がスナップショットコントローラーによって入力されます。既存のスナップショットの場合、ドライバーがサポートしている場合、このフィールドには CSI "ListSnapshots" gRPC 呼び出しから返される "ready_to_use" 値が入力されます。サポートされていない場合、このフィールドは True に設定されます。指定しない場合は、スナップショットの準備状態が不明であることを意味します。

restoreSize

integer-or-string

restoreSize は、このスナップショットからボリュームを作成するのに必要なボリュームの最小サイズを表します。動的スナップショット作成の場合、このフィールドには、CSI "CreateSnapshot" gRPC 呼び出しから返された "size_bytes" 値がスナップショットコントローラーによって入力されます。既存のスナップショットで、ドライバーがサポートしている場合、このフィールドには CSI "ListSnapshots" gRPC 呼び出しから返される "size_bytes" 値が入力されます。このスナップショットからボリュームを復元する場合、ボリュームのサイズは、指定されている場合は restoreSize より小さくしてはなりません。小さくしないと、復元が失敗します。指定しない場合は、サイズが不明であることを示します。

27.10.1.4. .status.error

Description
error は、スナップショットの作成中に最後に観察されたエラーです (存在する場合)。このフィールドは、報告されたエラーのタイプに基づいて、スナップショットが作成されるのを待機し続けるかどうかを決定するために、上位レベルのコントローラー (つまり、アプリケーションコントローラー) に役立つ場合があります。スナップショットの作成中にエラーが発生した場合、スナップショットコントローラーは再試行を続けます。成功すると、このエラーフィールドはクリアされます。
タイプ
object
Expand
プロパティータイプDescription

message

string

message は、指定されている場合、スナップショットの作成中に発生したエラーの詳細を示す文字列です。注: メッセージはログに記録される可能性があり、機密情報を含めることはできません。

time

string

time は、エラーが発生したときのタイムスタンプです。

27.10.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/snapshot.storage.k8s.io/v1/volumesnapshots

    • GET: VolumeSnapshot 種類のオブジェクトを一覧表示する
  • /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots

    • DELETE: VolumeSnapshot のコレクションを削除する
    • GET: VolumeSnapshot 種類のオブジェクトを一覧表示する
    • POST:VolumeSnapshot を作成する
  • /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots/{name}

    • DELETE: VolumeSnapshot を削除する
    • GET: 指定された VolumeSnapshot を読み取ります。
    • PATCH: 指定された VolumeSnapshot を部分更新します。
    • PUT: 指定された VolumeSnapshot を置き換えます。
  • /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots/{name}/status

    • GET: 指定された VolumeSnapshot の状態を読み取ります。
    • PATCH: 指定された VolumeSnapshot の部分更新状況です。
    • PUT: 指定された VolumeSnapshot の状態の置き換えます。

27.10.2.1. /apis/snapshot.storage.k8s.io/v1/volumesnapshots

Expand
表27.249 グローバルクエリーパラメーター
パラメータータイプ説明

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

pretty

string

'true' の場合、出力はきれいに印刷されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

HTTP メソッド
GET
Description
VolumeSnapshot 種類のオブジェクトを一覧表示する
Expand
表27.250 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshotList schema

401 - Unauthorized

空白

27.10.2.2. /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots

Expand
表27.251 グローバルパスパラメーター
パラメータータイプ説明

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表27.252 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
DELETE
Description
VolumeSnapshot のコレクションを削除する
Expand
表27.253 クエリーパラメーター
パラメータータイプ説明

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

Expand
表27.254 HTTP 応答
HTTP コードレスポンス本文

200 - OK

Status_v2 schema

401 - Unauthorized

空白

HTTP メソッド
GET
Description
VolumeSnapshot 種類のオブジェクトを一覧表示する
Expand
表27.255 クエリーパラメーター
パラメータータイプ説明

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

Expand
表27.256 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshotList schema

401 - Unauthorized

空白

HTTP メソッド
POST
Description
VolumeSnapshot の作成
Expand
表27.257 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表27.258 ボディパラメーター
パラメータータイプ説明

body

VolumeSnapshot スキーマ

 
Expand
表27.259 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshot スキーマ

201 - Created

VolumeSnapshot スキーマ

202 - Accepted

VolumeSnapshot スキーマ

401 - Unauthorized

空白

27.10.2.3. /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots/{name}

Expand
表27.260 グローバルパスパラメーター
パラメータータイプ説明

name

string

VolumeSnapshot の名前

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表27.261 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
DELETE
Description
VolumeSnapshot の削除
Expand
表27.262 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

gracePeriodSeconds

integer

オブジェクトが削除されるまでの時間 (秒)。値は負の値ではない整数にする必要があります。値をゼロに指定すると、ただちに削除されます。この値が nil の場合、指定されたタイプのデフォルトの猶予期間が使用されます。指定しない場合、デフォルトでオブジェクトごとの値になります。ゼロはすぐに削除することを意味します。

orphanDependents

boolean

非推奨: PropagationPolicy を使用してください。このフィールドは 1.7 で非推奨となります。依存オブジェクトが孤立している必要があります。true/false の場合、孤立したファイナライザーがオブジェクトのファイナライザー一覧で追加/削除されます。このフィールドまたは PropagationPolicy のいずれかを設定できますが、両方を設定することはできません。

propagationPolicy

string

ガベージコレクションが実行されるかどうか、およびその方法。このフィールドまたは OrphanDependents のどちらかを設定できますが、両方を設定することはできません。デフォルトポリシーは、metadata.finalizers に設定されている既存のファイナライザーとリソース固有のデフォルトポリシーによって決定されます。許容値は次のとおりです。'Orphan' - 依存を削除して孤立させます。'Background' - ガベージコレクターがバックグラウンドで依存関係を削除できるようにします。'Foreground' - フォアグラウンド内のすべての依存関係を削除するカスケードポリシー。

Expand
表27.263 ボディパラメーター
パラメータータイプ説明

body

DeleteOptions_v2 schema

 
Expand
表27.264 HTTP 応答
HTTP コードレスポンス本文

200 - OK

Status_v2 schema

202 - Accepted

Status_v2 schema

401 - Unauthorized

空白

HTTP メソッド
GET
Description
指定された VolumeSnapshot の読み取り
Expand
表27.265 クエリーパラメーター
パラメータータイプ説明

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

Expand
表27.266 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshot スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
Description
指定された VolumeSnapshot の部分更新
Expand
表27.267 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表27.268 ボディパラメーター
パラメータータイプ説明

body

Patch schema

 
Expand
表27.269 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshot スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
Description
指定された VolumeSnapshot を置き換えます。
Expand
表27.270 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表27.271 ボディパラメーター
パラメータータイプ説明

body

VolumeSnapshot スキーマ

 
Expand
表27.272 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshot スキーマ

201 - Created

VolumeSnapshot スキーマ

401 - Unauthorized

空白

27.10.2.4. /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots/{name}/status

Expand
表27.273 グローバルパスパラメーター
パラメータータイプ説明

name

string

VolumeSnapshot の名前

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表27.274 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
GET
Description
指定された VolumeSnapshot の状態を読み取る
Expand
表27.275 クエリーパラメーター
パラメータータイプ説明

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

Expand
表27.276 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshot スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
Description
指定された VolumeSnapshot の部分更新状況
Expand
表27.277 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表27.278 ボディパラメーター
パラメータータイプ説明

body

Patch schema

 
Expand
表27.279 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshot スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
Description
指定された VolumeSnapshot の状態の置き換え
Expand
表27.280 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表27.281 ボディパラメーター
パラメータータイプ説明

body

VolumeSnapshot スキーマ

 
Expand
表27.282 HTTP 応答
HTTP コードレスポンス本文

200 - OK

VolumeSnapshot スキーマ

201 - Created

VolumeSnapshot スキーマ

401 - Unauthorized

空白

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat