KRM API object.gdc.goog/v1

object.gdc.goog/v1

Object Storage v1 API グループの API スキーマ定義が含まれています。

バケット

Buckets API のスキーマを定義します。

表示場所: - BucketList

フィールド 説明
apiVersion 文字列 object.gdc.goog/v1
kind 文字列 Bucket
metadata ObjectMeta metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
spec BucketSpec
status BucketStatus

BucketInfo

BucketInfo API のスキーマを定義します。

表示場所: - BucketInfoList

フィールド 説明
apiVersion 文字列 object.gdc.goog/v1
kind 文字列 BucketInfo
metadata ObjectMeta metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

BucketInfo のリストが含まれます。

フィールド 説明
apiVersion 文字列 object.gdc.goog/v1
kind 文字列 BucketInfoList
metadata ListMeta metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
items BucketInfo の配列

BucketInfoSpec

BucketInfoSpec は、BucketInfo リソースの目的の状態を定義します。

表示場所: - BucketInfo

フィールド 説明
description 文字列 バケットの内容の説明。
storageClass ObjectStorageClass データにアクセスする必要がある頻度を定義します。使用できるオプションには、Standard と Nearline があります。Standard は、ウェブサイト、ストリーミング動画、モバイルアプリなど、頻繁にアクセスされるホットデータに適しています。少なくとも 30 日間保存する可能性があるデータに使用されます。Nearline は、データのバックアップやロングテールのマルチメディア コンテンツなど、少なくとも 60 日間保存できるデータに適しています。
bucketPolicy GlobalBucketPolicy バケット リソースのポリシーを定義します。指定しない場合、デフォルトのポリシーが適用されます。
location 文字列 バケット内のオブジェクト データが存在する物理的な場所を定義します。指定しない場合、デフォルトでバケットが作成されるロケーションになります。
bucketName 文字列 プロビジョニングされたバケットの非名前空間名。これは、ローカル ツールとライブラリを使用するときにバケットを参照するために使用されます。
zonalEndpoints 文字列配列 バケットにアクセスできるゾーン DNS エンドポイント。カスタマイズされたフェイルオーバーが必要な場合は、これらのエンドポイントを使用します。
globalEndpoint 文字列 このバケットのデータを含む任意のゾーンにトラフィックを動的にルーティングするグローバル エンドポイント。自動フェイルオーバーが必要な場合は、このエンドポイントを使用します。
region 文字列 バケットが保存されているリージョン。
encryption EncryptionStatus バケットの暗号化ステータス。
allowDegradedWrites ブール値 同期バケットでのみ使用されます。レプリケーション ゾーンのいずれかが使用できないため、S3 オペレーションを非同期レプリケーションに戻す必要があるかどうかを判断します。これにより、レプリケーション ゾーンのいずれかがダウンした場合に、同期バケットが読み取り専用になるのを防ぐことができます。空の場合、デフォルトで false になります。

BucketInfoStatus

BucketInfo の観測状態を定義します。

表示場所: - BucketInfo

フィールド 説明
conditions 条件の配列

BucketList

バケットのリストが含まれます。

フィールド 説明
apiVersion 文字列 object.gdc.goog/v1
kind 文字列 BucketList
metadata ListMeta metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
items バケットの配列

BucketPolicy

バケットのポリシーを定義します。

表示場所: - BucketSpec

フィールド 説明
lockingPolicy LockingPolicy オブジェクト ロックのポリシー。設定すると、オブジェクトのバージョニングが有効になり、バケットに保存されているすべてのオブジェクトにこのポリシーが適用されます。ロックされたオブジェクトは、ロックの有効期限が切れるまで削除できません。バケットの作成時にのみ有効にでき、後で無効にすることはできません。有効になっていない場合、オブジェクト ロックとバージョニングは無効になり、有効にすることはできません。
corsPolicy CorsPolicy バケットに設定されたカスタム CORS ポリシー ユーザーのポリシー。バケットに追加の CORS ポリシーが必要な場合は、CorsPolicy を有効にする必要があります。それ以外の場合、バケットにはデフォルトの UI コンソール CORS ポリシーのみが適用されます。CorsPolicy は、バケットの作成後にいつでも追加または変更できます。
lifecyclePolicy LifecyclePolicy バケットに設定されたカスタム ライフサイクル ポリシー ユーザーのポリシー。LifecyclePolicy は、バケットの作成後にいつでも追加、変更、削除できます。

BucketSpec

BucketSpec は、バケット リソースの望ましい状態を定義します。

表示場所: - バケット

フィールド 説明
description 文字列 バケットの内容の説明。
storageClass ObjectStorageClass データにアクセスする必要がある頻度を定義します。使用できるオプションには、Standard と Nearline があります。Standard は、ウェブサイト、ストリーミング動画、モバイルアプリなど、頻繁にアクセスされるホットデータに適しています。少なくとも 30 日間保存する可能性があるデータに使用されます。Nearline は、データのバックアップやロングテールのマルチメディア コンテンツなど、少なくとも 60 日間保存できるデータに適しています。
bucketPolicy BucketPolicy バケット リソースのポリシーを定義します。指定しない場合、デフォルトのポリシーが適用されます。
location 文字列 バケット内のオブジェクト データが存在する物理的な場所を定義します。指定しない場合、デフォルトでバケットが作成されるロケーションになります。

BucketStatus

バケットの観測状態を定義します。

表示場所: - バケット

フィールド 説明
fullyQualifiedName 文字列 プロビジョニングされたバケットの名前。この名前は、外部ツールやライブラリを使用するときにバケットを参照するために使用されます。
conditions 条件の配列 バケットのステータスを指定します。サポートされている条件には BucketReady が含まれます。BucketReady が True の場合、バケットがプロビジョニングされ、使用できる状態であることを示します。
endpoint 文字列 バケットにアクセスできる DNS エンドポイント。
region 文字列 バケットが保存されているリージョン。
encryption EncryptionStatus バケットの暗号化ステータス。
errorStatus ErrorStatus ErrorStatus には、観測時刻を含む最新のエラーが保持されます。

CorsPolicy

バケットにカスタム CORS ポリシーを設定する戦略を定義します。

表示される場所: - BucketPolicy - GlobalBucketPolicy

フィールド 説明
enableCorsPolicy ブール値 ユーザーがカスタム ポリシーをバケットに適用するかどうかを定義します。true の場合、CorsDetail で定義されたカスタム ポリシーが読み取られます。そうしないと、カスタム ポリシーが設定されていても CorsDetail は使用されません。
corsDetail CorsRule の配列 設定されているカスタム CORS ポリシーの詳細。

CorsRule

CORS ルールに関連する情報を定義します。

表示場所: - CorsPolicy

フィールド 説明
allowedHeaders 文字列配列 Access-Control-Request-Headers ヘッダーで指定されたヘッダー。
allowedMethods 文字列配列 許可されたオリジンによる実行が許可されている HTTP メソッド。
allowedOrigins 文字列配列 バケットにアクセスできるオリジン。
exposeHeaders 文字列配列 アクセス可能なレスポンスのヘッダー。
id 文字列 ルールの一意の識別子。値は 255 文字以下にする必要があります。

EncryptionStatus

EncryptionStatus は、バケットの暗号化のステータスを定義します。

表示される場所: - BucketInfoSpec - BucketStatus

フィールド 説明
type EncryptionType バケットに使用する暗号化のタイプを定義します。使用可能なオプションは次のとおりです。- CMEK - 顧客管理の暗号鍵。顧客に課金される HSM にルート化された KMS バックアップ鍵を作成します。お客様は、これらの鍵にアクセスして KMS を介して管理できます。
keyRef ObjectReference KeyRef は、バケット内のオブジェクトの暗号化にデフォルトの鍵として使用される鍵を参照します。

GlobalBucketPolicy

バケットのポリシーを定義します。

表示場所: - BucketInfoSpec

フィールド 説明
corsPolicy CorsPolicy バケットに設定されたカスタム CORS ポリシー ユーザーのポリシー。バケットに追加の CORS ポリシーが必要な場合は、CorsPolicy を有効にする必要があります。それ以外の場合、バケットにはデフォルトの UI コンソール CORS ポリシーのみが適用されます。CorsPolicy は、バケットの作成後にいつでも追加または変更できます。
lifecyclePolicy LifecyclePolicy バケットに設定されたカスタム ライフサイクル ポリシー ユーザーのポリシー。LifecyclePolicy は、バケットの作成後にいつでも追加、変更、削除できます。

LifecycleExpiration

表示場所: - LifecycleRule

フィールド 説明
date 時間 オブジェクトを削除する特定の日付。
days 整数 このオブジェクトがルールに従う日数。

LifecycleNoncurrentExpiration

表示場所: - LifecycleRule

フィールド 説明
noncurrentDays 整数 ライフサイクル ルールがアクションを実行するまでのオブジェクトの非現行期間の日数。

LifecyclePolicy

表示される場所: - BucketPolicy - GlobalBucketPolicy

フィールド 説明
enable ブール値 ユーザーがバケットでカスタム ライフサイクル ポリシーを有効にするかどうかを定義します。
lifecycleRules LifecycleRule の配列 バケット内のオブジェクトに対して有効期限切れアクションを実行できる 1 つ以上のライフサイクル構成ルールで構成されます。

LifecycleRule

表示場所: - LifecyclePolicy

フィールド 説明
id 文字列 ルールの一意の識別子。値は 255 文字以下にしてください。
status LifecycleRuleStatus ライフサイクル ルールのステータス。このルールがアクションを実行するかどうかを示します。ステータスはいつでも変更できます。有効なルールのみが有効になります。
expiration LifecycleExpiration 現在のバージョンのオブジェクトの有効期限の動作。Expiration と NoncurrentExpiration のいずれか、または両方を指定する必要があります。有効期限の動作がないルールは無視されます。
noncurrentExpiration LifecycleNoncurrentExpiration 非現行オブジェクトの有効期限の動作。
filter LifecycleRuleFilter ルールのフィルタ。フィルタが空の場合、ルールはバケット内のすべてのオブジェクトに適用されます。

LifecycleRuleFilter

ライフサイクル ルールに設定できるフィルタを定義します。

表示場所: - LifecycleRule

フィールド 説明
prefixFilter 文字列 指定された接頭辞を持つオブジェクトを照合します。接頭辞の空文字列は、バケット内のすべてのオブジェクトに適用することを意味します。
tagFilters タグ配列 指定されたタグとオブジェクトを照合します。オブジェクトのタグは、キーと値の両方と完全に一致している必要があります。

LifecycleRuleStatus

基になる型: string

表示場所: - LifecycleRule

LockingPolicy

バケットのオブジェクトをロックする戦略を定義します。

表示場所: - BucketPolicy

フィールド 説明
defaultObjectRetentionDays 整数 各オブジェクトの各バージョンが保持される最小日数を指定します。保持期間中はオブジェクトを削除できません。バケットにオブジェクトが含まれている場合も、バケットを削除できません。指定しない場合、デフォルトのオブジェクト保持期間は設定されません。作成後に変更できますが、変更は新しいオブジェクトとバージョンにのみ適用されます。既存のオブジェクトとバージョンでは、以前の値が引き続き使用されます。

タグ

ライフサイクル フィルタで使用できるオブジェクトのタグを定義します。

表示場所: - LifecycleRuleFilter

フィールド 説明
key 文字列
value 文字列