REST Resource: projects.locations.instances

リソース: インスタンス

Memorystore インスタンス。

JSON 表現
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "stateInfo": {
    object (StateInfo)
  },
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "shardCount": integer,
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (PersistenceConfig)
  },
  "engineVersion": string,
  "engineConfigs": {
    string: string,
    ...
  },
  "nodeConfig": {
    object (NodeConfig)
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "pscAutoConnections": [
    {
      object (PscAutoConnection)
    }
  ],
  "pscAttachmentDetails": [
    {
      object (PscAttachmentDetail)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "crossInstanceReplicationConfig": {
    object (CrossInstanceReplicationConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "migrationConfig": {
    object (MigrationConfig)
  },
  "aclPolicyInfo": {
    object (AclPolicyInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of mutually exclusive fields.
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean,
  "simulateMaintenanceEvent": boolean,
  "ondemandMaintenance": boolean,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "kmsKey": string,
  "backupCollection": string,
  "maintenanceVersion": string,
  "effectiveMaintenanceVersion": string,
  "serverCaMode": enum (ServerCaMode),
  "serverCaPool": string,
  "rotateServerCertificate": boolean,
  "aclPolicy": string,
  "aclPolicyInSync": boolean
}
フィールド
name

string

ID。インスタンスの一意の名前。形式: projects/{project}/locations/{location}/instances/{instance}

createTime

string (Timestamp format)

出力専用。インスタンスの作成タイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

出力専用。インスタンスの最新の更新タイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

labels

map (key: string, value: string)

省略可。ユーザー指定のメタデータを表すラベル。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

state

enum (State)

出力専用。インスタンスの現在の状態。

stateInfo

object (StateInfo)

出力専用。インスタンスの状態に関する追加情報。

uid

string

出力専用。システムによって割り当てられたインスタンスの固有識別子。

authorizationMode

enum (AuthorizationMode)

省略可。インスタンスの認可モード。

transitEncryptionMode

enum (TransitEncryptionMode)

省略可。変更不可。インスタンスの転送中の暗号化モード。

shardCount

integer

省略可。インスタンスのシャード数。

discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

出力専用。非推奨: discoveryEndpoints パラメータは非推奨になりました。そのため、エンドポイント パラメータを使用して接続が作成された場合、このフィールドは入力されません。このパラメータの代わりに、検出には connectionType CONNECTION_TYPE_DISCOVERY を使用して endpoints.connections.pscConnection と endpoints.connections.pscAutoConnection を使用します。

nodeType

enum (NodeType)

省略可。インスタンスの個々のノードのマシンタイプ。

persistenceConfig

object (PersistenceConfig)

省略可。インスタンスの永続性構成。

engineVersion

string

省略可。インスタンスのエンジン バージョン。

engineConfigs

map (key: string, value: string)

省略可。ユーザー指定のインスタンスのエンジン構成。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

nodeConfig

object (NodeConfig)

出力専用。インスタンスの個々のノードの構成。

zoneDistributionConfig

object (ZoneDistributionConfig)

省略可。変更不可。ノード割り当て用のインスタンスのゾーン分布構成。

pscAutoConnections[]
(deprecated)

object (PscAutoConnection)

省略可。変更不可。非推奨: 代わりに endpoints.connections.psc_auto_connection 値を使用してください。

pscAttachmentDetails[]

object (PscAttachmentDetail)

出力専用。PSC 接続を構成するためのサービス アタッチメントの詳細。

endpoints[]

object (InstanceEndpoint)

省略可。インスタンスのエンドポイント。

mode

enum (Mode)

省略可。変更不可。インスタンスのモード構成。

maintenancePolicy

object (MaintenancePolicy)

省略可。インスタンスのメンテナンス ポリシー。指定しない場合、メンテナンス イベントは Memorystore の内部ロールアウト スケジュールに基づいて実行されます。

maintenanceSchedule

object (MaintenanceSchedule)

出力専用。公開されたメンテナンス スケジュール。

crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

省略可。クロス インスタンス レプリケーションの構成。

encryptionInfo

object (EncryptionInfo)

出力専用。クラスタの保存データの暗号化情報。

automatedBackupConfig

object (AutomatedBackupConfig)

省略可。インスタンスの自動バックアップ構成。

availableMaintenanceVersions[]

string

出力専用。このフィールドは、セルフサービス アップデートで利用可能なメンテナンス バージョンを特定するために使用されます。

allowFewerZonesDeployment
(deprecated)

boolean

省略可。変更不可。非推奨。使用しないでください。

migrationConfig

object (MigrationConfig)

出力専用。インスタンスの移行構成。

aclPolicyInfo

object (AclPolicyInfo)

出力専用。適用された ACL ポリシーの詳細。

インポート元のソース。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
gcsSource

object (GcsBackupSource)

省略可。変更不可。Cloud Storage バケットに保存されているバックアップ。Cloud Storage バケットは、インスタンスと同じリージョンに存在する必要があります。指定された Cloud Storage オブジェクトからインポートするには、読み取り権限が必要です。

managedBackupSource

object (ManagedBackupSource)

省略可。変更不可。Memorystore サービスによって生成および管理されるバックアップ。

相互に排他的なフィールドの終わり。
replicaCount

integer

省略可。シャードあたりのレプリカノードの数。省略した場合、デフォルトは 0 レプリカです。

deletionProtectionEnabled

boolean

省略可。true に設定すると、インスタンスの削除は失敗します。

simulateMaintenanceEvent

boolean

省略可。入力専用。メンテナンス イベントをシミュレートします。

ondemandMaintenance
(deprecated)

boolean

省略可。入力専用。インスタンスのオンデマンド メンテナンス。

satisfiesPzs

boolean

省略可。出力専用。将来の使用のために予約。

satisfiesPzi

boolean

省略可。出力専用。将来の使用のために予約。

asyncInstanceEndpointsDeletionEnabled

boolean

省略可。true の場合、お客様が作成して登録したインスタンス エンドポイントを非同期で削除できます。つまり、このようなインスタンス エンドポイントは、インスタンス エンドポイントの転送ルールが削除される前に登録解除できます。

kmsKey

string

省略可。クラスタの保存データの暗号化に使用される KMS 鍵。

backupCollection

string

出力専用。バックアップ コレクションの完全なリソース名。例: projects/{project}/locations/{location}/backupCollections/{collection}

maintenanceVersion

string

省略可。このフィールドは、セルフサービス更新をトリガーして、必要なメンテナンス バージョンを示すために使用できます。このフィールドへの入力は、availableMaintenanceVersions フィールドで確認できます。

effectiveMaintenanceVersion

string

出力専用。このフィールドは、インスタンスの実際のメンテナンス バージョンを表します。

serverCaMode

enum (ServerCaMode)

省略可。変更不可。インスタンスのサーバー CA モード。

serverCaPool

string

省略可。変更不可。インスタンスの顧客管理の CA プール。サーバー CA モードが CUSTOMER_MANAGED_CAS_CA の場合にのみ適用されます。形式: 「projects/{project}/locations/{region}/caPools/{ca_pool}」。

rotateServerCertificate

boolean

省略可。入力専用。サーバー証明書をローテーションします。

aclPolicy

string

省略可。インスタンスの ACL ポリシー。形式: projects/{project}/locations/{location}/aclPolicies/{aclPolicy}

aclPolicyInSync
(deprecated)

boolean

出力専用。非推奨: インスタンスに適用された ACL ルールが同期されているかどうか。

GcsBackupSource

Cloud Storage バケットに保存されているバックアップ。Cloud Storage バケットは、インスタンスと同じリージョンに存在する必要があります。

JSON 表現
{
  "uris": [
    string
  ]
}
フィールド
uris[]

string

省略可。例: gs://bucket1/object1、gs://bucket2/folder2/object2

ManagedBackupSource

Memorystore によって生成および管理されるバックアップ。

JSON 表現
{
  "backup": string
}
フィールド
backup

string

省略可。例: //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} バックアップ名の短縮版(接頭辞なし)もサポートされています(projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId} など)。この場合、バックアップは memorystore.googleapis.com にあると想定されます。

状態

インスタンスが取り得る状態。

列挙型
STATE_UNSPECIFIED 未設定。
CREATING インスタンスを作成しています。
ACTIVE インスタンスが作成され、使用可能な状態です。
UPDATING インスタンスを更新しています。
DELETING インスタンスを削除しています。
MIGRATING インスタンスを移行しています。

StateInfo

インスタンスの状態に関する追加情報。

JSON 表現
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of mutually exclusive fields.
}
フィールド
以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
updateInfo

object (UpdateInfo)

出力専用。インスタンスの状態が UPDATING の場合に、進行中の更新について説明します。

相互に排他的なフィールドの終わり。

UpdateInfo

UPDATING 状態のインスタンスに関する情報を表します。

JSON 表現
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetEngineVersion": string,
  "targetNodeType": enum (NodeType)
}
フィールド
targetShardCount

integer

出力専用。インスタンスのシャードの目標数。

targetReplicaCount

integer

出力専用。インスタンスのシャードあたりのレプリカノードの目標数。

targetEngineVersion

string

出力専用。インスタンスのターゲット エンジン バージョン。

targetNodeType

enum (NodeType)

出力専用。インスタンスのターゲット ノードタイプ。

AuthorizationMode

インスタンスで使用できる認可モード。

列挙型
AUTHORIZATION_MODE_UNSPECIFIED 未設定。
AUTH_DISABLED 認可が無効になっています。
IAM_AUTH IAM 基本認証。
TOKEN_AUTH トークンベースの認可。

TransitEncryptionMode

インスタンスで使用できる転送中の暗号化モード。

列挙型
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED 未設定。
TRANSIT_ENCRYPTION_DISABLED 転送中の暗号化が無効になっています。
SERVER_AUTHENTICATION 転送中の暗号化にはサーバー管理の暗号化が使用されます。

DiscoveryEndpoint

クライアントがインスタンスに接続するためのエンドポイントを表します。

JSON 表現
{
  "address": string,
  "port": integer,
  "network": string
}
フィールド
address

string

出力専用。クライアントが接続する、公開されたエンドポイントの IP アドレス。

port

integer

出力専用。公開されているエンドポイントのポート番号。

network

string

出力専用。検出エンドポイントの IP アドレスが予約されるネットワーク(形式は projects/{networkProject}/global/networks/{network_name})。

PersistenceConfig

インスタンスの永続性構成を表します。

JSON 表現
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
フィールド
mode

enum (PersistenceMode)

省略可。現在の永続性モード。

rdbConfig

object (RDBConfig)

省略可。RDB 構成。モードが RDB でない場合、このフィールドは無視されます。

aofConfig

object (AOFConfig)

省略可。AOF 構成。モードが AOF でない場合、このフィールドは無視されます。

PersistenceMode

使用可能な永続性モード。

列挙型
PERSISTENCE_MODE_UNSPECIFIED 未設定。
DISABLED 永続性が無効になり、スナップショット データが削除されます。
RDB RDB ベースの永続性が有効になっています。
AOF AOF ベースの永続性が有効になっています。

RDBConfig

RDB ベースの永続性の構成。

JSON 表現
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
フィールド
rdbSnapshotPeriod

enum (SnapshotPeriod)

省略可。RDB スナップショット間の期間。

rdbSnapshotStartTime

string (Timestamp format)

省略可。最初にスナップショットが試行された時刻(または試行される予定の時刻)、および将来スナップショットが調整される時刻。指定しない場合は、現在の時刻が使用されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

SnapshotPeriod

使用可能なスナップショット期間。

列挙型
SNAPSHOT_PERIOD_UNSPECIFIED 未設定。
ONE_HOUR 1 時間。
SIX_HOURS 6 時間。
TWELVE_HOURS 12 時間。
TWENTY_FOUR_HOURS 24 時間。

AOFConfig

AOF ベースの永続性の構成。

JSON 表現
{
  "appendFsync": enum (AppendFsync)
}
フィールド
appendFsync

enum (AppendFsync)

省略可。fsync モード。

AppendFsync

使用可能な fsync モード。

列挙型
APPEND_FSYNC_UNSPECIFIED 未設定。 デフォルト: EVERY_SEC
NEVER fsync を実行しません。通常、Linux はこの構成で 30 秒ごとにデータをフラッシュしますが、カーネルの正確なチューニングによって異なります。
EVERY_SEC 1 秒ごとに fsync が実行されます。障害が発生すると、1 秒分のデータが失われる可能性があります。
ALWAYS 新しいコマンドが AOF に追加されるたびに fsync を実行します。パフォーマンスを犠牲にすることなく、最適なデータ損失保護を実現します。

NodeConfig

インスタンスのノードの構成を表します。

JSON 表現
{
  "sizeGb": number
}
フィールド
sizeGb

number

出力専用。ノードのメモリサイズ(GB)。

ZoneDistributionConfig

インスタンス リソースの割り当てのゾーン分布構成。

JSON 表現
{
  "zone": string,
  "zones": [
    string
  ],
  "mode": enum (ZoneDistributionMode)
}
フィールド
zone

string

省略可。すべてのリソースが SINGLE_ZONE モードで割り当てられるゾーンを定義します。MULTI_ZONE モードでは無視されます。

zones[]

string

省略可。Memorystore インスタンスがリソースを割り当てるマルチゾーン インスタンスのゾーンを指定します。このフラグは、単一ゾーン インスタンスには適用されません。

mode

enum (ZoneDistributionMode)

省略可。現在のゾーン分布モード。デフォルトは MULTI_ZONE です。

ZoneDistributionMode

使用可能なゾーン分布モード。

列挙型
ZONE_DISTRIBUTION_MODE_UNSPECIFIED 未設定。デフォルト: MULTI_ZONE
MULTI_ZONE リージョン内でランダムに選択された 3 つのゾーンにリソースを分散します。
SINGLE_ZONE 単一のゾーンにリソースをプロビジョニングします。ゾーン フィールドを指定する必要があります。

PscAutoConnection

PSC 接続のコンシューマー リソースの詳細。

JSON 表現
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
フィールド
pscConnectionId

string

出力専用。サービス アタッチメントに接続されている転送ルールの PSC 接続 ID。

ipAddress

string

出力専用。PSC 転送ルール用にコンシューマー ネットワークに割り当てられている IP。

forwardingRule

string

出力専用。コンシューマー側の転送ルールの URI。形式: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}

projectId

string

必須。PSC 接続が確立されるコンシューマーの projectId。これは、インスタンスが作成される projectId と同じにする必要があります。

network

string

必須。PSC エンドポイントが作成されるネットワーク(形式は projects/{projectId}/global/networks/{network_name})。

serviceAttachment

string

出力専用。PSC 接続のターゲットとなるサービス アタッチメント。形式は projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id} です。

pscConnectionStatus

enum (PscConnectionStatus)

出力専用。PSC 接続のステータス。接続が存在して ACTIVE であるか、存在しないか。この値は定期的に更新されます。最新のステータスについては、Private Service Connect API を使用してください。

connectionType

enum (ConnectionType)

出力専用。PSC 接続のタイプ。

公開されているエンドポイントのポート。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
port

integer

省略可。ポートは、プライマリ/リーダー エンドポイントまたは検出エンドポイントに対してのみ設定されます。

相互に排他的なフィールドの終わり。

PscConnectionStatus

PSC 接続のステータス。

列挙型
PSC_CONNECTION_STATUS_UNSPECIFIED PSC 接続ステータスが指定されていません。
ACTIVE 接続がアクティブである
NOT_FOUND 接続が見つかりません

ConnectionType

PSC 接続のタイプ

列挙型
CONNECTION_TYPE_UNSPECIFIED 接続タイプが設定されていない
CONNECTION_TYPE_DISCOVERY トポロジ検出に使用される接続。
CONNECTION_TYPE_PRIMARY プライマリにアクセスするためのプライマリ エンドポイントとして使用される接続。
CONNECTION_TYPE_READER レプリカへのアクセスに読み取りエンドポイントとして使用される接続。

PscAttachmentDetail

PSC 接続を作成するためのクラスタのサービス アタッチメントの構成。

JSON 表現
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
フィールド
serviceAttachment

string

出力専用。自分で作成した PscConnection がターゲットとして使用するサービス アタッチメント URI。

connectionType

enum (ConnectionType)

出力専用。Psc エンドポイントのタイプ。

InstanceEndpoint

InstanceEndpoint は、インスタンスにアクセスするために各 VPC ネットワークでグループとして作成される PSC 接続で構成されます。各グループには、クラスタ内のサービス アタッチメントごとに 1 つの接続が必要です。

JSON 表現
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
フィールド
connections[]

object (ConnectionDetail)

省略可。PSC 接続のグループ。これらは同じ VPC ネットワークに作成され、クラスタ内のサービス アタッチメントごとに 1 つ作成されます。

ConnectionDetail

各 PSC 接続の情報。

JSON 表現
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of mutually exclusive fields.
}
フィールド
インスタンスへの PSC 接続は、クラスタの作成時にサービス接続の自動化(自動接続)によって作成することも、ユーザー自身が作成することもできます(ユーザー作成接続)。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
pscAutoConnection

object (PscAutoConnection)

変更不可。サービス接続の自動化によって作成された PSC 接続の詳細情報。

pscConnection

object (PscConnection)

ユーザーが作成した PSC 接続の詳細情報。

相互に排他的なフィールドの終わり。

PscConnection

ユーザーが PSC 接続構成を作成しました。

JSON 表現
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
フィールド
pscConnectionId

string

必須。サービス アタッチメントに接続されている転送ルールの PSC 接続 ID。

ipAddress

string

必須。PSC 転送ルール用にコンシューマー ネットワークに割り当てられている IP。

forwardingRule

string

必須。コンシューマー側の転送ルールの URI。形式: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}

projectId

string

出力専用。転送ルールが作成されるコンシューマーの projectId。

network

string

必須。IP アドレスが存在するコンシューマー ネットワーク。形式: projects/{projectId}/global/networks/{network_name}

serviceAttachment

string

必須。PSC 接続のターゲットとなるサービス アタッチメント。形式は projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id} です。

pscConnectionStatus

enum (PscConnectionStatus)

出力専用。PSC 接続のステータス。接続が存在して ACTIVE であるか、存在しないか。この値は定期的に更新されます。最新のステータスについては、Private Service Connect API を使用してください。

connectionType

enum (ConnectionType)

出力専用。PSC 接続のタイプ。

公開されているエンドポイントのポート。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
port

integer

省略可。ポートは、プライマリ/リーダー エンドポイントまたは検出エンドポイントに対してのみ設定されます。

相互に排他的なフィールドの終わり。

モード

クラスタモードの有効化/無効化に使用されるモード構成。

列挙型
MODE_UNSPECIFIED モードが指定されていません。
STANDALONE

非推奨: 代わりに CLUSTER_DISABLED を使用してください。

CLUSTER インスタンスはクラスタ モードです。
CLUSTER_DISABLED インスタンスのクラスタモードが無効になっている。

MaintenancePolicy

インスタンスごとのメンテナンス ポリシー。

JSON 表現
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
フィールド
createTime

string (Timestamp format)

出力専用。ポリシーの作成時間。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

出力専用。ポリシーが更新された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

省略可。このポリシーの対象となるリソースに適用されるメンテナンス時間枠。最小数 1。現在のバージョンでは、weekly_window の最大数は 1 になることが想定されています。

WeeklyMaintenanceWindow

1 週間のオペレーションに指定された時間枠。

JSON 表現
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
フィールド
day

enum (DayOfWeek)

省略可。指定した曜日に実行されるスケジュールを定義できます。

startTime

object (TimeOfDay)

省略可。時間枠の開始時刻(UTC)。

MaintenanceSchedule

今後のメンテナンス スケジュール。

JSON 表現
{
  "startTime": string,
  "endTime": string
}
フィールド
startTime

string (Timestamp format)

出力専用。このインスタンスに対する次回の定期メンテナンスの開始時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

endTime

string (Timestamp format)

出力専用。このインスタンスに対する次回の定期メンテナンスの開始時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

CrossInstanceReplicationConfig

クロス インスタンス レプリケーション構成。

JSON 表現
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
フィールド
instanceRole

enum (InstanceRole)

必須。クロス インスタンス レプリケーションにおけるインスタンスのロール。

primaryInstance

object (RemoteInstance)

省略可。このセカンダリ インスタンスのレプリケーション ソースとして使用されるプライマリ インスタンスの詳細。

このフィールドは、セカンダリ インスタンスに対してのみ設定されます。

secondaryInstances[]

object (RemoteInstance)

省略可。このプライマリ インスタンスから複製しているセカンダリ インスタンスのリスト。

このフィールドは、プライマリ インスタンスに対してのみ設定されます。

updateTime

string (Timestamp format)

出力専用。クロス インスタンス レプリケーション構成が最後に更新された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

membership

object (Membership)

出力専用。クロス インスタンス レプリケーションに参加しているすべてのメンバー インスタンスの出力専用ビュー。このビューは、インスタンスのロール(プライマリまたはセカンダリ)に関係なく、すべてのメンバー インスタンスによって提供されます。

プライマリ インスタンスは、そこからレプリケートしているすべてのセカンダリ インスタンスに関する情報を提供できます。ただし、セカンダリ インスタンスは、レプリケート元のプライマリ インスタンスについてのみ認識します。ただし、プライマリ インスタンスが使用できないシナリオ(リージョン停止など)では、Getinstance リクエストを他のメンバー インスタンスに送信できます。このフィールドには、インスタンス間のレプリケーションに参加しているすべてのメンバー インスタンスが一覧表示されます。

InstanceRole

クロス インスタンス レプリケーションにおけるインスタンスのロール。

列挙型
INSTANCE_ROLE_UNSPECIFIED インスタンス ロールが設定されていません。動作は NONE と同等です。
NONE このインスタンスは、インスタンス間のレプリケーションに参加していません。これは独立したインスタンスであり、他のインスタンスとの間で複製は行われません。
PRIMARY 読み取りと書き込みの両方が可能なインスタンス。このインスタンスに書き込まれたデータは、アタッチされたセカンダリ インスタンスにも複製されます。
SECONDARY 読み取りのみを許可し、プライマリ インスタンスからデータを複製するインスタンス。

RemoteInstance

クロス インスタンス レプリケーション設定でこのインスタンスに関連付けられているリモート インスタンスの詳細。

JSON 表現
{
  "instance": string,
  "uid": string
}
フィールド
instance

string

省略可。リモート インスタンスの完全なリソースパス(projects//locations//instances/形式)。

uid

string

出力専用。リモート インスタンスの固有識別子。

メンバーシップ

クロス インスタンス レプリケーションに参加しているすべてのメンバー インスタンスの出力専用ビュー。

JSON 表現
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
フィールド
primaryInstance

object (RemoteInstance)

出力専用。セカンダリ インスタンスのレプリケーション ソースとして機能するプライマリ インスタンス。

secondaryInstances[]

object (RemoteInstance)

出力専用。プライマリ インスタンスからレプリケートしているセカンダリ インスタンスのリスト。

AutomatedBackupConfig

インスタンスの自動バックアップ構成。

JSON 表現
{
  "automatedBackupMode": enum (AutomatedBackupMode),
  "retention": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of mutually exclusive fields.
}
フィールド
automatedBackupMode

enum (AutomatedBackupMode)

省略可。自動バックアップ モード。モードが無効になっている場合、他のフィールドは無視されます。

retention

string (Duration format)

省略可。バックアップが削除されるまでの自動バックアップの保持期間。値は 1 ~ 365 日の範囲で指定してください。指定しない場合、デフォルト値は 35 日です。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

自動バックアップのスケジュール。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
fixedFrequencySchedule

object (FixedFrequencySchedule)

省略可。固定頻度で自動バックアップをトリガーします。

相互に排他的なフィールドの終わり。

FixedFrequencySchedule

このスケジュールでは、バックアップを一定の頻度でトリガーできます(現在は毎日のみサポートされています)。

JSON 表現
{
  "startTime": {
    object (TimeOfDay)
  }
}
フィールド
startTime

object (TimeOfDay)

必須。すべての自動バックアップの開始時刻(UTC)。開始時刻は正時に設定する必要があります。このフィールドは必須です。

AutomatedBackupMode

自動バックアップ モード。

列挙型
AUTOMATED_BACKUP_MODE_UNSPECIFIED デフォルト値。自動バックアップ構成が指定されていません。
DISABLED 自動バックアップ構成が無効です。
ENABLED 自動バックアップ構成が有効になっています。

ServerCaMode

インスタンスのサーバー CA モード。

列挙型
SERVER_CA_MODE_UNSPECIFIED サーバー CA モードが指定されていません。
GOOGLE_MANAGED_PER_INSTANCE_CA 各インスタンスには独自の Google 管理の CA があります。
GOOGLE_MANAGED_SHARED_CA インスタンスは、インスタンスのリージョンに Google 管理の共有 CA を使用します。
CUSTOMER_MANAGED_CAS_CA インスタンスが CAS の顧客管理の CA を使用している。
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA

非推奨: 代わりに GOOGLE_MANAGED_PER_INSTANCE_CA を使用してください。

SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA

非推奨: 代わりに GOOGLE_MANAGED_SHARED_CA を使用してください。

SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA

非推奨: 代わりに CUSTOMER_MANAGED_CAS_CA を使用してください。

MigrationConfig

インスタンスの移行の構成。

JSON 表現
{
  "state": enum (State),
  "forceFinishMigration": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "selfManagedSource": {
    object (SelfManagedSource)
  }
  // End of mutually exclusive fields.
}
フィールド
state

enum (State)

出力専用。インスタンスの移行状態。

forceFinishMigration

boolean

出力専用。レプリケーションを停止する前に、ソースとターゲット間のオフセット キャッチアップ検証を行わずに移行の最終処理を強制するブール値フラグを表します。

移行元に関する詳細。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
selfManagedSource

object (SelfManagedSource)

出力専用。セルフマネージド Valkey/Redis インスタンスからの移行の構成

相互に排他的なフィールドの終わり。

SelfManagedSource

セルフマネージド ソース インスタンスの詳細。

JSON 表現
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
フィールド
ipAddress

string

必須。移行元インスタンスの IP アドレス。この IP アドレスは、移行プロセス全体で Memorystore インスタンスからアクセスできる安定した IP アドレスである必要があります。

port

integer

必須。ソース インスタンスのポート。このポートは、移行プロセス全体で Memorystore インスタンスからアクセスできる安定したポートである必要があります。

networkAttachment

string

必須。ソース インスタンスへの接続の確立に使用される Private Service Connect ネットワーク アタッチメントのリソース名。このネットワーク アタッチメントには次の要件があります。1. Memorystore インスタンスと同じプロジェクトに存在する必要があります。2. Memorystore インスタンスと同じリージョンに存在する必要があります。3. ネットワーク アタッチメントに接続されているサブネットは、送信元インスタンス ノードと同じ VPC ネットワーク内にある必要があります。

形式: projects/{project}/regions/{region}/networkAttachments/{networkAttachment}

状態

インスタンスの移行状態。今後、新しい値が追加される可能性があります。

列挙型
STATE_UNSPECIFIED インスタンスに移行関連のアクティビティはありません。これが初期状態です。
ROLLED_BACK インスタンスは現在移行されていません。インスタンスで移行が試行されましたが失敗し、その後のロールバックは成功しました。これで、必要に応じて新しい移行を試行する準備が整いました。
ROLLING_BACK 以前の移行試行が失敗したことを示します。インスタンスの概要ステータスは MIGRATING になります。インスタンスは新しい移行の試行の準備ができていません。インスタンスを元の状態に戻すためのロールバックが進行中です。インスタンスは、ロールバックが成功するまでこの状態のままになります。
REPLICATION_ESTABLISHED インスタンスは移行中です。インスタンスでレプリケーションが正常に確立され、カットオーバーの準備が整いました。
MIGRATED インスタンスが正常に移行されます。

AclPolicyInfo

適用された ACL ポリシーの詳細。

JSON 表現
{
  "appliedAclPolicy": string,
  "appliedAclPolicyRevision": string,
  "appliedAclPolicyRevisionNumber": string,
  "aclPolicyRevisionStatuses": [
    {
      object (AclPolicyRevisionStatus)
    }
  ]
}
フィールド
appliedAclPolicy

string

出力専用。適用された ACL ポリシーのリソース名。形式: "projects/{project}/locations/{location}/aclPolicies/{aclPolicy}"

appliedAclPolicyRevision

string

出力専用。適用された ACL ポリシー リビジョンのリソース名。形式: 「projects/{project}/locations/{location}/aclPolicies/{aclPolicy}/revisions/{revision}」

appliedAclPolicyRevisionNumber

string (int64 format)

出力専用。適用された ACL ポリシー リビジョンのリビジョン番号。

aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

出力専用。インスタンス上のこの ACL ポリシーのさまざまなリビジョンのステータスのリスト。

メソッド

addTokenAuthUser

トークンベースの認証が有効になっているインスタンスにトークン認証ユーザーを追加します。

backup

バックアップ インスタンス。

create

指定されたプロジェクトとロケーションで新しいインスタンスを作成します。

delete

1 つのインスタンスを削除します。

finishMigration

移行プロセスを完了します。

get

1 つのインスタンスの詳細を取得します。

getCertificateAuthority

インスタンスの認証局の詳細を取得します。

list

指定されたプロジェクトとロケーションでのインスタンスを一覧で表示します。

patch

単一インスタンスのパラメータを更新します。

rescheduleMaintenance

今後のメンテナンス イベントのスケジュールを変更します。

startMigration

ソース インスタンスからターゲット Memorystore インスタンスへの移行を開始します。