REST Resource: projects.locations.clusters

משאב: אשכול

מופע של אשכול.

ייצוג ב-JSON 
{
  "name": string,
  "createTime": string,
  "state": enum (State),
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "pscConfigs": [
    {
      object (PscConfig)
    }
  ],
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "pscConnections": [
    {
      object (PscConnection)
    }
  ],
  "stateInfo": {
    object (StateInfo)
  },
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (ClusterPersistenceConfig)
  },
  "redisConfigs": {
    string: string,
    ...
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "crossClusterReplicationConfig": {
    object (CrossClusterReplicationConfig)
  },
  "pscServiceAttachments": [
    {
      object (PscServiceAttachment)
    }
  ],
  "clusterEndpoints": [
    {
      object (ClusterEndpoint)
    }
  ],
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "labels": {
    string: string,
    ...
  },
  "aclPolicy": string,
  "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,
  "sizeGb": integer,
  "shardCount": integer,
  "preciseSizeGb": number,
  "deletionProtectionEnabled": boolean,
  "maintenancePolicy": {
    object (ClusterMaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (ClusterMaintenanceSchedule)
  },
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "simulateMaintenanceEvent": boolean,
  "backupCollection": string,
  "kmsKey": string,
  "ondemandMaintenance": boolean,
  "asyncClusterEndpointsDeletionEnabled": boolean,
  "maintenanceVersion": string,
  "effectiveMaintenanceVersion": string,
  "serverCaMode": enum (ServerCaMode),
  "serverCaPool": string,
  "rotateServerCertificate": boolean,
  "aclPolicyInSync": boolean
}
שדות
name

string

חובה. מזהה. שם ייחודי של המשאב בהיקף הזה, כולל הפרויקט והמיקום, בפורמט: projects/{projectId}/locations/{locationId}/clusters/{clusterId}
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".
state

enum (State)

פלט בלבד. המצב הנוכחי של האשכול הזה. יכול להיות במצבים הבאים: CREATING, ‏ READY, ‏ UPDATING, ‏ DELETING ו-SUSPENDED
uid

string

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

enum (AuthorizationMode)

זה שינוי אופציונלי. מצב ההרשאה של אשכול Redis. אם לא מציינים את המדיניות, תכונת האימות מושבתת באשכול.
transitEncryptionMode

enum (TransitEncryptionMode)

זה שינוי אופציונלי. הצפנה במעבר של אשכול Redis. אם לא מציינים הצפנה, היא מושבתת באשכול.
pscConfigs[]

object (PscConfig)

זה שינוי אופציונלי. כל PscConfig מגדיר את רשת הצרכן שבה כתובות ה-IP יוקצו לאשכול לגישת לקוח באמצעות אוטומציה של Private Service Connect. בשלב הזה יש תמיכה רק ב-PscConfig אחד.
discoveryEndpoints[]

object (DiscoveryEndpoint)

פלט בלבד. נקודות קצה שנוצרות בכל רשת נתונה, כדי שלקוחות Redis יוכלו להתחבר לאשכול. בשלב הזה יש תמיכה רק בנקודת קצה אחת לגילוי.
pscConnections[]

object (PscConnection)

פלט בלבד. רשימת חיבורי ה-PSC שנוצרו אוטומטית באמצעות אוטומציה של קישוריות לשירותים.
stateInfo

object (StateInfo)

פלט בלבד. מידע נוסף על המצב הנוכחי של האשכול.
nodeType

enum (NodeType)

זה שינוי אופציונלי. הסוג של צומת redis באשכול. המאפיין NodeType קובע את סוג המכונה הבסיסי של צומת Redis.
persistenceConfig

object (ClusterPersistenceConfig)

זה שינוי אופציונלי. הגדרת התמדה (RDB, ‏ AOF) לאשכול.
redisConfigs

map (key: string, value: string)

זה שינוי אופציונלי. צמדים של מפתח/ערך של שינויים בהגדרות של לקוחות להגדרות Redis שניתנות לשינוי

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
zoneDistributionConfig

object (ZoneDistributionConfig)

זה שינוי אופציונלי. ההגדרה הזו תשמש כדי לקבוע איך הלקוח רוצה שנפיץ את משאבי האשכול באזור.
crossClusterReplicationConfig

object (CrossClusterReplicationConfig)

זה שינוי אופציונלי. הגדרת רפליקציה בין אשכולות.
pscServiceAttachments[]

object (PscServiceAttachment)

פלט בלבד. פרטים של קובץ מצורף לשירות להגדרת חיבורי PSC
clusterEndpoints[]

object (ClusterEndpoint)

זה שינוי אופציונלי. רשימה של נקודות קצה של אשכולות.
automatedBackupConfig

object (AutomatedBackupConfig)

זה שינוי אופציונלי. הגדרת הגיבוי האוטומטי של האשכול.
encryptionInfo

object (EncryptionInfo)

פלט בלבד. פרטי ההצפנה של הנתונים במצב מנוחה של האשכול.
availableMaintenanceVersions[]

string

פלט בלבד. השדה הזה משמש לקביעת גרסאות התחזוקה שזמינות לעדכון בשירות עצמי.
allowFewerZonesDeployment
(deprecated)

boolean

זה שינוי אופציונלי. אי אפשר לשנות. הוצא משימוש, אין להשתמש בו.
labels

map (key: string, value: string)

זה שינוי אופציונלי. תוויות שמייצגות מטא-נתונים שהמשתמשים סיפקו.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
aclPolicy

string

זה שינוי אופציונלי. מדיניות ה-ACL שתחול על האשכול.
aclPolicyInfo

object (AclPolicyInfo)

פלט בלבד. פרטים על מדיניות ה-ACL שהוחלה.
המקור שממנו מייבאים. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
gcsSource

object (GcsBackupSource)

זה שינוי אופציונלי. גיבויים שמאוחסנים בקטגוריות של Cloud Storage. הקטגוריות של Cloud Storage צריכות להיות באותו אזור כמו האשכולות. כדי לייבא מאובייקטים של Cloud Storage שסופקו, נדרשת הרשאת קריאה.
managedBackupSource

object (ManagedBackupSource)

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

integer

זה שינוי אופציונלי. מספר הצמתים המשוכפלים לכל רסיס.
sizeGb

integer

פלט בלבד. גודל הזיכרון של Redis ב-GB לכל האשכול, מעוגל כלפי מעלה למספר השלם הבא.
shardCount

integer

זה שינוי אופציונלי. מספר הרסיסים של אשכול Redis.
preciseSizeGb

number

פלט בלבד. ערך מדויק של גודל הזיכרון של Redis ב-GB לכל האשכול.
deletionProtectionEnabled

boolean

זה שינוי אופציונלי. פעולת המחיקה תיכשל אם הערך מוגדר כ-true.
maintenancePolicy

object (ClusterMaintenancePolicy)

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

object (ClusterMaintenanceSchedule)

פלט בלבד. ClusterMaintenanceSchedule פלט בלבד לוח זמנים לפרסום תחזוקה.
satisfiesPzs

boolean

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

boolean

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

boolean

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

string

זה שינוי אופציונלי. פלט בלבד. השם המלא של משאב אוסף הגיבוי. דוגמה: projects/{project}/locations/{location}/backupCollections/{collection}
kmsKey

string

זה שינוי אופציונלי. מפתח KMS שמשמש להצפנת הנתונים במצב מנוחה של האשכול.
ondemandMaintenance
(deprecated)

boolean

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

boolean

זה שינוי אופציונלי. אם הערך הוא true, אפשר למחוק באופן אסינכרוני נקודות קצה של אשכולות שנוצרו ונרשמו על ידי לקוחות. כלומר, אפשר לבטל את הרישום של נקודת קצה כזו של אשכול לפני שמוחקים את כללי ההעברה בנקודת הקצה של האשכול.
maintenanceVersion

string

זה שינוי אופציונלי. אפשר להשתמש בשדה הזה כדי להפעיל עדכון בשירות עצמי ולציין את גרסת התחזוקה הרצויה. אפשר לקבוע את הקלט בשדה הזה לפי השדה availableMaintenanceVersions.
effectiveMaintenanceVersion

string

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

enum (ServerCaMode)

זה שינוי אופציונלי. מצב CA של השרת עבור האשכול.
serverCaPool

string

זה שינוי אופציונלי. מאגר CA בניהול הלקוח עבור האשכול. רלוונטי רק ל-BYOCA, כלומר אם serverCaMode הוא SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA. פורמט: projects/{project}/locations/{region}/caPools/{ca_pool}
rotateServerCertificate

boolean

זה שינוי אופציונלי. קלט בלבד. מחליפים את אישורי השרת.
aclPolicyInSync
(deprecated)

boolean

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

GcsBackupSource

גיבויים שמאוחסנים בקטגוריות של Cloud Storage. הקטגוריות של Cloud Storage צריכות להיות באותו אזור כמו האשכולות.

ייצוג ב-JSON 
{
  "uris": [
    string
  ]
}
שדות
uris[]

string

זה שינוי אופציונלי. כתובות ה-URI של האובייקטים ב-Cloud Storage שרוצים לייבא. דוגמה: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

גיבויים שנוצרו ונוהלו על ידי memorystore.

ייצוג ב-JSON 
{
  "backup": string
}
שדות
backup

string

זה שינוי אופציונלי. דוגמה: ‎//redis.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup}‎ אפשר גם להשתמש בגרסה קצרה יותר (בלי הקידומת) של שם הגיבוי, כמו ‎projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId}‎ במקרה הזה, המערכת מניחה שהגיבוי נמצא ב-redis.googleapis.com.

מדינה

מייצג את המצבים השונים של אשכול Redis.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED לא מוגדר.
CREATING אשכול Redis בתהליך יצירה.
ACTIVE אשכול Redis נוצר ומוכן לשימוש מלא.
UPDATING מתבצע עדכון של ההגדרות של אשכול Redis.
DELETING מחיקת מקבץ Redis.

AuthorizationMode

מצב ההרשאה הזמין של אשכול Redis.

טיפוסים בני מנייה (enum)
AUTH_MODE_UNSPECIFIED לא מוגדר.
AUTH_MODE_IAM_AUTH מצב הרשאה בסיסי ב-IAM
AUTH_MODE_DISABLED מצב השבתת הרשאות
AUTH_MODE_TOKEN_AUTH מצב הרשאה מבוסס-טוקן

TransitEncryptionMode

מצב ההצפנה בזמן ההעברה שזמין.

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

PscConfig

ייצוג ב-JSON 
{
  "network": string
}
שדות
network

string

חובה. הרשת שבה כתובת ה-IP של נקודת הקצה של הגילוי תישמר, בפורמט projects/{networkProject}/global/networks/{network_id}.

DiscoveryEndpoint

נקודות קצה בכל רשת, כדי שלקוחות Redis יוכלו להתחבר לאשכול.

ייצוג ב-JSON 
{
  "address": string,
  "port": integer,
  "pscConfig": {
    object (PscConfig)
  }
}
שדות
address

string

פלט בלבד. הכתובת של נקודת הקצה של Redis שנחשפת ומשמשת את הלקוחות להתחבר לשירות. הכתובת יכולה להיות כתובת IP או שם מארח.
port

integer

פלט בלבד. מספר היציאה של נקודת הקצה של Redis שנחשפת.
pscConfig

object (PscConfig)

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

PscConnection

פרטים על משאבים של צרכנים בחיבור PSC.

ייצוג ב-JSON 
{
  "pscConnectionId": string,
  "address": 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 של כלל ההעברה שמחובר לקובץ המצורף של השירות.
address

string

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

string

חובה. ה-URI של כלל ההעברה בצד הצרכן. דוגמה: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.
projectId

string

זה שינוי אופציונלי. מזהה הפרויקט של פרויקט הצרכן שבו נוצר כלל ההעברה.
network

string

חובה. הרשת של הצרכן שבה נמצאת כתובת ה-IP, בפורמט projects/{projectId}/global/networks/{network_id}.
serviceAttachment

string

חובה. החיבור של שירות, שהוא היעד של חיבור ה-PSC, בפורמט projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

פלט בלבד. הסטטוס של חיבור ה-PSC. חשוב לזכור שהערך הזה מתעדכן מעת לעת. כדי לקבל את הסטטוס העדכני של חיבור PSC, אפשר לעיין במאמר https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details.
connectionType

enum (ConnectionType)

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

integer

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

PscConnectionStatus

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

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

ConnectionType

סוג החיבור ל-PSC, למטרת גישה לאשכול.

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

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

מייצג מידע על אשכול שמתעדכן.

ייצוג ב-JSON 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetNodeType": enum (NodeType)
}
שדות
targetShardCount

integer

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

integer

מספר היעד של צמתי העתקה לכל רסיס.
targetNodeType

enum (NodeType)

סוג צומת היעד עבור אשכול Redis.

ClusterPersistenceConfig

הגדרה של פונקציונליות ההתמדה.

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

ZoneDistributionConfig

הגדרת חלוקת אזורים להקצאת משאבי אשכול.

ייצוג ב-JSON 
{
  "mode": enum (ZoneDistributionMode),
  "zone": string,
  "zones": [
    string
  ]
}
שדות
mode

enum (ZoneDistributionMode)

זה שינוי אופציונלי. מצב חלוקת האזורים. אם לא מציינים ערך, ברירת המחדל היא MULTI_ZONE.
zone

string

זה שינוי אופציונלי. כשבוחרים באפשרות SINGLE ZONE (תחום יחיד), המערכת משתמשת בשדה התחום כדי להקצות את כל המשאבים באותו תחום. ההגדרה הזו לא רלוונטית ל-MULTI_ZONE, והמערכת תתעלם ממנה באשכולות MULTI_ZONE.
zones[]

string

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

ZoneDistributionMode

הגדרה של מצבים שונים של חלוקת אזורים.

טיפוסים בני מנייה (enum)
ZONE_DISTRIBUTION_MODE_UNSPECIFIED לא מוגדר. ברירת מחדל: MULTI_ZONE
MULTI_ZONE מפיצים את כל המשאבים ב-3 אזורים שנבחרו באופן אקראי, בתוך האזור.
SINGLE_ZONE פיזור כל המשאבים בתחום מוגדר אחד. כשבוחרים במצב הזה, חובה לציין את השדה zone.

CrossClusterReplicationConfig

הגדרת רפליקציה בין אשכולות.

ייצוג ב-JSON 
{
  "clusterRole": enum (ClusterRole),
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
שדות
clusterRole

enum (ClusterRole)

פלט בלבד. התפקיד של האשכול בשכפול בין אשכולות.
primaryCluster

object (RemoteCluster)

פרטים של האשכול הראשי שמשמש כמקור השכפול של האשכול המשני הזה.

השדה הזה מוגדר רק עבור אשכול משני.
secondaryClusters[]

object (RemoteCluster)

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

השדה הזה מוגדר רק עבור אשכול ראשי.
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)

פלט בלבד. תצוגה של כל אשכולות החברים שמשתתפים בשכפול בין אשכולות. התצוגה הזו תסופק על ידי כל אשכול חברים, ללא קשר לתפקיד האשכול(ראשי או משני).

אשכול ראשי יכול לספק מידע על כל האשכולות המשניים שמשכפלים ממנו. עם זאת, אשכול משני יודע רק על האשכול הראשי שממנו הוא משכפל. עם זאת, בתרחישים שבהם האשכול הראשי לא זמין(למשל, הפסקת חשמל אזורית), אפשר לשלוח בקשת clusters.get לכל אשכול חבר אחר, ובשדה הזה יופיעו כל אשכולות החברים שמשתתפים בשכפול בין אשכולות.

ClusterRole

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

טיפוסים בני מנייה (enum)
CLUSTER_ROLE_UNSPECIFIED לא מוגדר תפקיד באשכול. ההתנהגות שוות ערך ל-NONE.
NONE האשכול הזה לא משתתף בשכפול בין אשכולות. זהו אשכול עצמאי, והוא לא משכפל נתונים לאף אשכול אחר ולא מקבל נתונים מאף אשכול אחר.
PRIMARY קלאסטר שמאפשר גם קריאה וגם כתיבה. כל הנתונים שנכתבים לאשכול הזה משוכפלים גם לאשכולות המשניים המצורפים.
SECONDARY קלאסטר שמאפשר רק קריאה ושכפול של נתונים מקלאסטר ראשי.

RemoteCluster

פרטים של האשכול המרוחק שמשויך לאשכול הזה בהגדרה של שכפול בין אשכולות.

ייצוג ב-JSON 
{
  "cluster": string,
  "uid": string
}
שדות
cluster

string

פלט בלבד. הנתיב המלא של משאב האשכול המרוחק בפורמט: projects//locations//clusters/
uid

string

פלט בלבד. המזהה הייחודי של האשכול המרוחק.

חברות

תצוגה של כל אשכולות החברים שמשתתפים בשכפול בין אשכולות.

ייצוג ב-JSON 
{
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ]
}
שדות
primaryCluster

object (RemoteCluster)

פלט בלבד. האשכול הראשי שמשמש כמקור השכפול לאשכולות המשניים.
secondaryClusters[]

object (RemoteCluster)

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

ClusterMaintenancePolicy

מדיניות תחזוקה לכל אשכול.

ייצוג ב-JSON 
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (ClusterWeeklyMaintenanceWindow)
    }
  ]
}
שדות
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 (ClusterWeeklyMaintenanceWindow)

זה שינוי אופציונלי. חלון זמן לתחזוקה שחל על משאבים שכלולים במדיניות הזו. מינימום 1. בגרסה הנוכחית, המספר המקסימלי של weeklyMaintenanceWindow צפוי להיות אחד.

ClusterWeeklyMaintenanceWindow

חלון הזמן שצוין לפעולות שבועיות.

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

enum (DayOfWeek)

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

object (TimeOfDay)

זה שינוי אופציונלי. שעת ההתחלה של חלון הזמן לפי שעון UTC.

ClusterMaintenanceSchedule

לוח הזמנים לתחזוקה הקרובה.

ייצוג ב-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".

PscServiceAttachment

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

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

string

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

enum (ConnectionType)

פלט בלבד. סוג החיבור של PSC שמכוון לצירוף השירות הזה.

ClusterEndpoint

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

PscAutoConnection

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

ייצוג ב-JSON 
{
  "pscConnectionId": string,
  "address": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType)
}
שדות
pscConnectionId

string

פלט בלבד. מזהה החיבור של PSC של כלל ההעברה שמחובר לקובץ המצורף של השירות.
address

string

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

string

פלט בלבד. ה-URI של כלל ההעברה בצד הצרכן. דוגמה: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.
projectId

string

חובה. מזהה פרויקט הצרכן שממנו נוצר כלל ההעברה.
network

string

חובה. הרשת של הצרכן שבה נמצאת כתובת ה-IP, בפורמט projects/{projectId}/global/networks/{network_id}.
serviceAttachment

string

פלט בלבד. החיבור של שירות, שהוא היעד של חיבור ה-PSC, בפורמט projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

פלט בלבד. הסטטוס של חיבור ה-PSC. חשוב לזכור שהערך הזה מתעדכן מעת לעת. כדי לקבל את הסטטוס העדכני, צריך להשתמש בממשקי Private Service Connect APIs.
connectionType

enum (ConnectionType)

פלט בלבד. סוג החיבור של PSC.

AutomatedBackupConfig

הגדרת הגיבוי האוטומטי של אשכול.

ייצוג ב-JSON 
{
  "automatedBackupMode": enum (AutomatedBackupMode),

  // 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.
  "retention": string
}
שדות
automatedBackupMode

enum (AutomatedBackupMode)

זה שינוי אופציונלי. מצב הגיבוי האוטומטי. אם המצב מושבת, המערכת תתעלם משאר השדות.
לוח הזמנים של הגיבויים האוטומטיים. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
fixedFrequencySchedule

object (FixedFrequencySchedule)

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

string (Duration format)

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

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

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 של השרת.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA לכל אשכול יש רשות אישורים (CA) משלו שמנוהלת על ידי Google.
SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA האשכול משתמש ב-CA משותף שמנוהל על ידי Google באזור.
SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA האשכול משתמש ב-CA בניהול הלקוח מ-CAS.

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

 גיבוי של Redis Cluster.

create

 יוצרת אשכול Redis על סמך המאפיינים שצוינו.

delete

 מחיקת אשכול Redis ספציפי.

get

 מקבל את הפרטים של אשכול Redis ספציפי.

getCertificateAuthority

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

list

 השיטה מחזירה רשימה של כל אשכולות Redis שבבעלות פרויקט במיקום (אזור) שצוין או בכל המיקומים.

patch

 עדכון המטא-נתונים וההגדרות של אשכול Redis ספציפי.

rescheduleClusterMaintenance

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