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

僅供輸出。系統指派的執行個體專屬 ID。
authorizationMode

enum (AuthorizationMode)

選用。執行個體的授權模式。
transitEncryptionMode

enum (TransitEncryptionMode)

選用。不可變動。執行個體的傳輸加密模式。
shardCount

integer

選用。執行個體的 shard 數量。
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

僅供輸出。已淘汰：discoveryEndpoints 參數已淘汰。因此，如果使用端點參數建立連線，系統就不會填入這個值。請改用 endpoints.connections.pscConnection 和 endpoints.connections.pscAutoConnection，並將 connectionType 設為 CONNECTION_TYPE_DISCOVERY，以進行探索。
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 政策詳細資料。
要匯入的來源。以下列出互斥欄位。回應中最多會設定一個欄位：
gcsSource

object (GcsBackupSource)

選用。不可變動。儲存在 Cloud Storage bucket 中的備份。Cloud Storage bucket 必須與執行個體位於相同區域。如要從提供的 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

選用。這個欄位可用來觸發自助式更新，指出所需的維護版本。這個欄位的輸入內容取決於可用的 MaintenanceVersions 欄位。
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 bucket 中的備份。Cloud Storage bucket 必須與執行個體位於相同區域。

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.
}
欄位
以下列出互斥欄位。回應中最多會設定一個欄位：
updateInfo

object (UpdateInfo)

僅供輸出。當執行個體狀態為 UPDATING 時，說明正在進行的更新。
互斥欄位的結尾。

UpdateInfo

代表狀態為 UPDATING 的執行個體相關資訊。

JSON 表示法 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetEngineVersion": string,
  "targetNodeType": enum (NodeType)
}
欄位
targetShardCount

integer

僅供輸出。執行個體的目標 shard 數量。
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 六小時。
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 每秒執行一次 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 連線的消費者專案 ID。這應與建立執行個體的專案 ID 相同。
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 連線的狀態：連線是否存在且為「有效」，或連線已不存在。請注意，這個值會定期更新。如要查看最新狀態，請使用 Private Service Connect API。
connectionType

enum (ConnectionType)

僅供輸出。PSC 連線類型。
公開端點的連接埠。以下列出互斥欄位。回應中最多會設定一個欄位：
port

integer

選用。連接埠只會為主要/讀取器或探索端點設定。
互斥欄位的結尾。

PscConnectionStatus

PSC 連線狀態。

列舉
PSC_CONNECTION_STATUS_UNSPECIFIED 未指定 PSC 連線狀態。
ACTIVE 連線有效
NOT_FOUND 找不到連線

ConnectionType

Private Service Connect 連線類型

列舉
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 包含在每個虛擬私有雲網路中以群組形式建立的 PSC 連線，用於存取執行個體。在每個群組中，叢集中的每個服務附件都應有一個連線。

JSON 表示法 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
欄位
connections[]

object (ConnectionDetail)

選用。一組 PSC 連線。這些介面會在同一個虛擬私有雲網路中建立，叢集中的每個服務附件各有一個介面。

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 連線時，可透過叢集建立期間的服務連線自動化 (自動連線) 建立，也可由客戶自行建立 (使用者建立的連線)。以下列出互斥欄位。回應中最多會設定一個欄位：
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

僅供輸出。建立轉送規則的消費者專案 ID。
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 連線的狀態：連線是否存在且為「有效」，或連線已不存在。請注意，這個值會定期更新。如要查看最新狀態，請使用 Private Service Connect API。
connectionType

enum (ConnectionType)

僅供輸出。PSC 連線類型。
公開端點的連接埠。以下列出互斥欄位。回應中最多會設定一個欄位：
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 的數量上限應為一。

WeeklyMaintenanceWindow

每週作業的指定時間範圍。

JSON 表示法 
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
欄位
day

enum (DayOfWeek)

選用。可定義在指定星期幾執行的排程。
startTime

object (TimeOfDay)

選用。時段開始時間 (世界標準時間)。

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

僅供輸出。遠端執行個體的專屬 ID。

成員資格

所有參與跨執行個體複寫的成員執行個體，都只會輸出檢視畫面。

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 天。

以秒為單位的時間長度，最多 9 個小數位數，結尾為「s」。示例："3.5s"。
自動備份的排程。以下列出互斥欄位。回應中最多會設定一個欄位：
fixedFrequencySchedule

object (FixedFrequencySchedule)

選用。以固定頻率觸發自動備份。
互斥欄位的結尾。

FixedFrequencySchedule

這個排程會以固定頻率觸發備份作業 (目前僅支援每日備份)。

JSON 表示法 
{
  "startTime": {
    object (TimeOfDay)
  }
}
欄位
startTime

object (TimeOfDay)

這是必要旗標，每次自動備份的開始時間 (世界標準時間)。必須設為整點。這是必填欄位。

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

僅供輸出。代表布林值旗標，可強制完成遷移作業，而不需在停止複製作業前，驗證來源與目標之間的偏移量追趕情況。
遷移來源的詳細資料。以下列出互斥欄位。回應中最多會設定一個欄位：
selfManagedSource

object (SelfManagedSource)

僅供輸出。從自行管理的 Valkey/Redis 執行個體遷移的設定
互斥欄位的結尾。

SelfManagedSource

自行管理的來源執行個體詳細資料。

JSON 表示法 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
欄位
ipAddress

string

這是必要旗標，來源執行個體的 IP 位址。這個 IP 位址應為穩定 IP 位址，在遷移程序中，Memorystore 執行個體可存取該位址。
port

integer

這是必要旗標，來源執行個體的通訊埠。這個通訊埠應為穩定通訊埠，在遷移過程中，Memorystore 執行個體可存取該通訊埠。
networkAttachment

string

這是必要旗標，用於建立來源執行個體連線的 Private Service Connect 網路連結資源名稱。這項網路連結必須符合下列規定：1. 必須與 Memorystore 執行個體位於相同專案。2. 必須與 Memorystore 執行個體位於相同區域。3. 附加至網路連結的子網路必須與來源執行個體節點位於相同的虛擬私有雲網路。

格式：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)

僅供輸出。執行個體上這項存取控管清單政策的各項修訂版本狀態清單。

方法

addTokenAuthUser

 為啟用權杖驗證的執行個體新增權杖驗證使用者。

backup

 備份執行個體。

create

 在指定專案和位置建立新執行個體。

delete

 刪除單一執行個體。

finishMigration

 完成遷移程序。

get

 取得單一執行個體的詳細資料。

getCertificateAuthority

 取得執行個體憑證授權單位的詳細資料。

list

 列出指定專案和位置中的執行個體。

patch

 更新單一執行個體的參數。

rescheduleMaintenance

 重新安排近期維護事件。

startMigration

 將來源執行個體遷移至目標 Memorystore 執行個體。