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

מזהה. השם הייחודי של המופע. פורמט: 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 הוצא משימוש. לכן, הוא לא יאוכלס אם החיבורים נוצרו באמצעות פרמטר של נקודות קצה. במקום הפרמטר הזה, כדי לגלות את נקודות הקצה, צריך להשתמש בפרמטרים 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. הקטגוריות של 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 של השרת הוא 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.

מדינה

המצבים האפשריים של המופע.

טיפוסים בני מנייה (enum)
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

פלט בלבד. מספר השארדים שהוגדר כמטרה למופע.
targetReplicaCount

integer

פלט בלבד. מספר הצמתים המשוכפלים לכל רסיס שמוגדר כמטרה עבור המופע.
targetEngineVersion

string

פלט בלבד. גרסת המנוע של היעד עבור המופע.
targetNodeType

enum (NodeType)

פלט בלבד. סוג צומת היעד של המופע.

AuthorizationMode

מצבי ההרשאה האפשריים של המופע.

טיפוסים בני מנייה (enum)
AUTHORIZATION_MODE_UNSPECIFIED לא מוגדר.
AUTH_DISABLED ההרשאה מושבתת.
IAM_AUTH הרשאה בסיסית ב-IAM.
TOKEN_AUTH הרשאה מבוססת-טוקן.

TransitEncryptionMode

מצבי הצפנה אפשריים בזמן ההעברה של המופע.

טיפוסים בני מנייה (enum)
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED לא מוגדר.
TRANSIT_ENCRYPTION_DISABLED ההצפנה במעבר מושבתת.
SERVER_AUTHENTICATION הצפנה בניהול השרת משמשת להצפנה במעבר.

DiscoveryEndpoint

מייצג נקודת קצה (endpoint) לחיבור לקוחות למופע.

ייצוג ב-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. המערכת תתעלם מהשדה הזה אם הערך של mode (מצב) הוא לא AOF.

PersistenceMode

מצבי שמירה אפשריים.

טיפוסים בני מנייה (enum)
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

תקופות אפשריות של תמונות מצב.

טיפוסים בני מנייה (enum)
SNAPSHOT_PERIOD_UNSPECIFIED לא מוגדר.
ONE_HOUR שעה אחת.
SIX_HOURS שש שעות.
TWELVE_HOURS 12 שעות.
TWENTY_FOUR_HOURS עשרים וארבע שעות.

AOFConfig

הגדרה של שמירת נתונים על סמך AOF.

ייצוג ב-JSON 
{
  "appendFsync": enum (AppendFsync)
}
שדות
appendFsync

enum (AppendFsync)

זה שינוי אופציונלי. מצב fsync.

AppendFsync

מצבי fsync אפשריים.

טיפוסים בני מנייה (enum)
APPEND_FSYNC_UNSPECIFIED לא מוגדר. ברירת מחדל: EVERY_SEC
NEVER לעולם לא לבצע fsync. בדרך כלל, מערכת Linux תנקה את הנתונים כל 30 שניות עם ההגדרה הזו, אבל זה תלוי בהתאמה המדויקת של ליבת המערכת.
EVERY_SEC ‫Fsync כל שנייה. במקרה של אסון, יכול להיות שנתונים של שנייה אחת יאבדו.
ALWAYS ‫Fsync בכל פעם שפקודות כתיבה חדשות מצורפות ל-AOF. ההגנה הכי טובה מפני אובדן נתונים, אבל על חשבון הביצועים.

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

מצבי הפצה אפשריים של אזורים.

טיפוסים בני מנייה (enum)
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 של כלל ההעברה שמחובר לקובץ המצורף של השירות.
ipAddress

string

פלט בלבד. כתובת ה-IP שהוקצתה ברשת הצרכן לכלל ההעברה של PSC.
forwardingRule

string

פלט בלבד. ה-URI של כלל ההעברה בצד הצרכן. פורמט: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

חובה. מזהה הפרויקט של הצרכן שבו נוצרים חיבורי PSC. זה צריך להיות אותו מזהה פרויקט שבו נוצר המופע.
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 APIs.
connectionType

enum (ConnectionType)

פלט בלבד. סוג החיבור של PSC.
יציאות של נקודת הקצה שנחשפת. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
port

integer

אופציונלי. היציאה תוגדר רק לנקודת קצה ראשית/קוראת או לנקודת קצה של Discovery.
סוף השדות הבלעדיים.

PscConnectionStatus

הסטטוס של חיבור ה-PSC.

טיפוסים בני מנייה (enum)
PSC_CONNECTION_STATUS_UNSPECIFIED לא צוין סטטוס החיבור ל-PSC.
ACTIVE החיבור פעיל
NOT_FOUND החיבור לא נמצא

ConnectionType

סוג החיבור של PSC

טיפוסים בני מנייה (enum)
CONNECTION_TYPE_UNSPECIFIED לא הוגדר סוג החיבור
CONNECTION_TYPE_DISCOVERY החיבור שישמש לזיהוי הטופולוגיה.
CONNECTION_TYPE_PRIMARY החיבור שישמש כנקודת קצה ראשית לגישה לשרת הראשי.
CONNECTION_TYPE_READER החיבור שישמש כנקודת קצה לקוראים כדי לגשת לרפליקות.

PscAttachmentDetail

הגדרת צירוף שירות של האשכול, ליצירת חיבורי PSC.

ייצוג ב-JSON 
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
שדות
serviceAttachment

string

פלט בלבד. כתובת ה-URI של קובץ השירות שאותו צריך להגדיר כיעד ב-PscConnection שנוצר באופן עצמאי.
connectionType

enum (ConnectionType)

פלט בלבד. סוג נקודת הקצה של PSC.

InstanceEndpoint

‫InstanceEndpoint מורכב מחיבורי PSC שנוצרים כקבוצה בכל רשת VPC לצורך גישה למופע. בכל קבוצה, תהיה נקודת חיבור אחת לכל שירות מצורף באשכול.

ייצוג ב-JSON 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
שדות
connections[]

object (ConnectionDetail)

זה שינוי אופציונלי. קבוצה של חיבורי PSC. הם נוצרים באותה רשת VPC, אחד לכל קובץ מצורף של שירות באשכול.

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 של כלל ההעברה שמחובר לקובץ המצורף של השירות.
ipAddress

string

חובה. כתובת ה-IP שהוקצתה ברשת הצרכן לכלל ההעברה של PSC.
forwardingRule

string

חובה. ה-URI של כלל ההעברה בצד הצרכן. פורמט: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

פלט בלבד. מזהה פרויקט הצרכן שממנו נוצר כלל ההעברה.
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 APIs.
connectionType

enum (ConnectionType)

פלט בלבד. סוג החיבור של PSC.
יציאות של נקודת הקצה שנחשפת. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
port

integer

אופציונלי. היציאה תוגדר רק לנקודת קצה ראשית/קוראת או לנקודת קצה של Discovery.
סוף השדות הבלעדיים.

מצב

הגדרת המצב, שמשמשת להפעלה או להשבתה של מצב האשכול.

טיפוסים בני מנייה (enum)
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)

זה שינוי אופציונלי. שעת ההתחלה של חלון הזמן לפי שעון 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

תפקיד המכונה בשכפול בין מכונות.

טיפוסים בני מנייה (enum)
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)

זה שינוי אופציונלי. כמה זמן לשמור גיבויים אוטומטיים לפני שהם יימחקו. הערך צריך להיות בין יום אחד ל-365 ימים. אם לא מציינים ערך, ערך ברירת המחדל הוא 35 ימים.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
לוח הזמנים של הגיבויים האוטומטיים. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
fixedFrequencySchedule

object (FixedFrequencySchedule)

זה שינוי אופציונלי. הפעלת גיבויים אוטומטיים בתדירות קבועה.
סוף השדות הבלעדיים.

FixedFrequencySchedule

התזמון הזה מאפשר להפעיל את הגיבוי בתדירות קבועה (נכון לעכשיו, רק גיבוי יומי נתמך).

ייצוג ב-JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
שדות
startTime

object (TimeOfDay)

חובה. שעת ההתחלה של כל גיבוי אוטומטי לפי שעון UTC. השעה חייבת להיות בתחילת השעה. חובה למלא את השדה הזה.

AutomatedBackupMode

מצב הגיבוי האוטומטי.

טיפוסים בני מנייה (enum)
AUTOMATED_BACKUP_MODE_UNSPECIFIED ערך ברירת המחדל. לא צוינה הגדרה של גיבוי אוטומטי.
DISABLED ההגדרה של גיבוי אוטומטי מושבתת.
ENABLED ההגדרה של גיבוי אוטומטי מופעלת.

ServerCaMode

מצב אישור ה-CA של השרת עבור המופע.

טיפוסים בני מנייה (enum)
SERVER_CA_MODE_UNSPECIFIED לא צוין מצב CA של השרת.
GOOGLE_MANAGED_PER_INSTANCE_CA לכל מופע יש רשות אישורים (CA) משלו שמנוהלת על ידי Google.
GOOGLE_MANAGED_SHARED_CA המופע משתמש ב-CA משותף בניהול Google עבור האזור של המופע.
CUSTOMER_MANAGED_CAS_CA המכונה משתמשת ב-CA בניהול הלקוח מ-CAS.
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. רשת המשנה שמצורפת לקובץ המצורף לרשת צריכה להיות באותה רשת VPC כמו הצמתים של מופע המקור.

פורמט: projects/{project}/regions/{region}/networkAttachments/{networkAttachment}

מדינה

מצב ההעברה של המופע. יכול להיות שבעתיד נוסיף ערכים חדשים.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED אין מקרים שקשורים לפעילות העברה. זה המצב ההתחלתי.
ROLLED_BACK המופע לא נמצא כרגע בתהליך העברה. היה ניסיון להעביר את המופע, אבל הוא נכשל. לאחר מכן בוצעה חזרה למצב הקודם (rollback) והיא הצליחה. אם רוצים, אפשר לנסות להעביר את המופע שוב.
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 הזו במופע.

Methods

addTokenAuthUser

 הוספת משתמש עם אימות באמצעות טוקן למופע שמופעל בו אימות באמצעות טוקן.

backup

 גיבוי של מכונה.

create

 יוצרת מופע חדש בפרויקט ובמיקום נתונים.

delete

 מחיקה של מופע יחיד.

finishMigration

 השלמת תהליך ההעברה.

get

 קבלת פרטים של מופע יחיד.

getCertificateAuthority

 קבלת פרטים על רשות האישורים של מופע.

list

 הצגת רשימה של מופעים בפרויקט ובמיקום נתונים.

patch

 מעדכן את הפרמטרים של מופע יחיד.

rescheduleMaintenance

 קביעת מועד חדש לאירוע תחזוקה קרוב.

startMigration

 מפעילה את ההעברה של מכונת מקור למכונת היעד של Memorystore.