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. במקום הפרמטר הזה, כדי לגלות נקודות קצה, השתמשו ב-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)

זה שינוי אופציונלי. נקודות קצה (endpoints) של המכונה.

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) בניהול הלקוח של המכונה. רלוונטי רק אם מצב ה-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. המערכת תתעלם מהשדה הזה אם המצב הוא לא 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 ‫24 שעות.

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
  ],
  "activeZones": [
    string
  ],
  "mode": enum (ZoneDistributionMode)
}
שדות
zone

string

זה שינוי אופציונלי. מגדיר את האזור שבו כל המשאבים יוקצו במצב SINGLE_ZONE. המערכת מתעלמת מהשדה הזה במצב MULTI_ZONE.

zones[]

string

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

activeZones[]

string

פלט בלבד. רשימת האזורים שבהם יש למכונה מכונות וירטואליות פעילות.

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

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

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)

זה שינוי אופציונלי. היום בשבוע של חלון הזמן לתחזוקה. חובה למלא את השדה הזה. אין לך אפשרות להשתמש ב-DAY_OF_WEEK_UNSPECIFIED.

startTime

object (TimeOfDay)

זה שינוי אופציונלי. שעת ההתחלה של חלון הזמן לתחזוקה, לפי שעון UTC. כשמציינים חלון זמן לתחזוקה, צריך לציין גם את startTime.

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 לכל מכונה יש רשות אישורים משלה שמנוהלת על ידי Google.
GOOGLE_MANAGED_SHARED_CA המכונה משתמשת ב-CA משותף בניהול Google לאזור של המכונה.
CUSTOMER_MANAGED_CAS_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 המופע לא עובר כרגע. היה ניסיון להעביר את המכונה שנכשל, והחזרה למצב הקודם הצליחה. עכשיו אפשר לנסות להעביר את המכונה שוב.
ROLLING_BACK מציין שניסיון קודם להעביר את הנתונים נכשל. מצב המכונה ברמה הגבוהה יהיה MIGRATING. המופע לא מוכן לניסיון העברה חדש. מתבצעת החזרה למצב הקודם כדי לשחזר את המכונה למצב המקורי שלה. המכונה תישאר במצב הזה עד שהחזרה לגרסה הקודמת תסתיים בהצלחה.
REPLICATION_ESTABLISHED המופע נמצא בתהליך העברה. המכונה יצרה שכפול מוצלח ומוכנה למעבר חד למערכת אחרת (cutover).
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.