DBCluster v1.1.1 自訂資源定義

選取說明文件版本：

規格結構定義

DBClusterSpec 會定義 DBCluster 的所需狀態。

allowExternalIncomingTraffic: boolean
availability:
  autoFailoverTriggerThreshold: integer
  autoHealTriggerThreshold: integer
  enableAutoFailover: boolean
  enableAutoHeal: boolean
  enableStandbyAsReadReplica: boolean
  healthcheckPeriodSeconds: integer
  numberOfStandbys: integer
connectedModeSpec:
  apiKeySecret: string
  clusterId: string
  displayLocation: string
  gcpProjectId: string
  gcpZone: string
controlPlaneAgentsVersion: string
databaseImage: string
databaseVersion: string
isDeleted: boolean
mode: string
primarySpec:
  adminUser:
    passwordRef:
      name: string
  allowExternalIncomingTrafficToInstance: boolean
  auditLogTarget:
    syslog:
      certsSecretRef:
        name: string
        namespace: string
      host: string
  availabilityOptions:
    healthcheckPeriodSeconds: integer
    livenessProbe: string
  dbLoadBalancerOptions:
    annotations: object
    gcp:
      loadBalancerIP: string
      loadBalancerType: string
  features:
    googleMLExtension:
      config:
        vertexAIKeyRef: string
        vertexAIRegion: string
      enabled: boolean
    memoryAgent:
      enabled: boolean
  isStopped: boolean
  mode: string
  parameters: object
  resources:
    cpu: integer or string
    disks:
    - accessModes: string
      annotations: object
      name: string
      selector:
        matchExpressions:
        - key: string
          operator: string
          values: string
        matchLabels: object
      size: string
      storageClass: string
      volumeName:
    memory: string or integer
  schedulingconfig:
    nodeaffinity:
      preferredDuringSchedulingIgnoredDuringExecution:
        preference:
          matchExpressions:
          - key: string
            operator: string
            values: string
          matchFields:
          - key: string
            operator: string
            values: string
        weight: integer
      requiredDuringSchedulingIgnoredDuringExecution:
        nodeSelectorTerms:
          matchExpressions:
          - key: string
            operator: string
            values: string
          matchFields:
          - key: string
            operator: string
            values: string
    podAffinity:
      preferredDuringSchedulingIgnoredDuringExecution:
      - podAffinityTerm:
          labelSelector:
            matchExpressions:
            - key: string
              operator: string
              values: string
            matchLabels: object
          namespaceSelector:
            matchExpressions:
            - key: string
              operator: string
              values: string
            matchLabels: object
            namespaces: string
            topologyKey: string
        weight: integer
      requiredDuringSchedulingIgnoredDuringExecution:
        labelSelector:
          matchExpressions:
          - key: string
            operator: string
            values: string
          matchLabels: object
        namespaceSelector:
          matchExpressions:
          - key: string
            operator: string
            values: string
          matchLabels: object
        namespaces: string
        topologyKey: string
    podAntiAffinity:
      preferredDuringSchedulingIgnoredDuringExecution:
        podAffinityTerm:
          labelSelector:
            matchExpressions:
            - key: string
              operator: string
              type: string
            matchLabels: object
          namespaceSelector:
            matchExpressions:
            - key: string
              operator: string
              values: string
            matchLabels: object
          namespaces: string
          topologyKey: string
        weight: integer
      requiredDuringSchedulingIgnoredDuringExecution:
        labelSelector:
          matchExpressions:
          - key: string
            operator: string
            values: string
          matchLabels: object
        namespaceSelector:
          matchExpressions:
          - key: string
            operator: string
            type: string
          matchLabels: object
        namespaces: string
        topologyKey: string
    tolerations:
    - effect: string
      key: string
      operator: string
      tolerationSeconds: integer
      value: string
  services: object
  sidecarRef:
    name: string
  sourceCidrRanges:
  tls:
    certSecret:
      name: string
  walArchiveSetting:
    archiveMode: string
    location: string
tls:
  certSecret:
    name: string

欄位

類型
必要或選填

 

說明
allowExternalIncomingTraffic
boolean
選填 		不適用
availability
object
選填 		可用性包含 DBCluster 高可用性 (HA) 功能的可調整設定。
availability.autoFailoverTriggerThreshold
integer
選填 		AutoFailoverTriggerThreshold 是主要執行個體連續健康狀態檢查失敗的次數，達到這個次數就會觸發自動容錯移轉。如果設為 0，系統會使用預設值。使用 EnableAutoFailover 旗標停用自動容錯移轉功能。
availability.autoHealTriggerThreshold
integer
選填 		AutoHealTriggerThreshold 是待命執行個體連續健康狀態檢查失敗的次數，達到這個次數就會觸發自動修復。使用 EnableAutoHeal 旗標停用自動修復功能。
availability.enableAutoFailover
boolean
選填 		啟用 AutoFailover 表示如果 DBCluster 偵測到主要執行個體運作狀況不佳，而待命執行個體運作狀況良好，就會觸發容錯移轉。如果設為 true，系統會啟用自動容錯移轉。如果設為 false，即使系統偵測到主要執行個體處於非健康狀態，也不會觸發自動容錯移轉。預設值為 true。啟用這項功能後，如果系統偵測到主要執行個體在指定門檻內處於非健康狀態，就會觸發容錯移轉。這項功能僅適用於 HA DBCluster，且備援資料庫必須正常運作。
availability.enableAutoHeal
boolean
選填 		EnableAutoHeal 表示如果偵測到待命執行個體健康狀態不良，這個 DBCluster 會觸發自動修復。如果設為 true，則會啟用自動修復功能。如果設為 false，即使系統偵測到待命執行個體健康狀態不良，也不會觸發自動修復。預設值為 true。啟用這項功能後，如果系統偵測到待命執行個體健康狀態不良，且達到指定門檻，就會觸發自動修復程序。這項功能僅適用於 HA DBCluster。
availability.enableStandbyAsReadReplica
boolean
必填 		EnableStandbyAsReadReplica 可決定待機伺服器是否能接受使用者查詢。如果設為 true，系統會建立新端點，啟用備援的唯讀存取權。
availability.healthcheckPeriodSeconds
integer
選填 		HealthcheckPeriodSeconds 是健康狀態檢查探測器等待的秒數，之後會再次檢查主要和待命執行個體的健康狀態，並據此更新狀態。
availability.numberOfStandbys
integer
選填 		NumberOfStandbys 是指應為這個資料庫叢集建立的待命節點數量。如果設為大於 0 的值，叢集就會啟用高可用性，系統也會建立指定數量的待命執行個體。待命執行個體數量上限為 5 個。如要查看這個 DBCluster 的高可用性目前狀態，請查看 DBCluster 狀態下的 HAReady 條件。如果 HAReady 為 true，表示設定已完成並準備就緒。如果設為 0，叢集就會停用高可用性，並刪除所有現有的待命執行個體。支援 0 到 5 之間的任何數字 (含 0 和 5)。預設值為 0。詳情請參閱「在 Kubernetes 中管理高可用性」。
connectedModeSpec
object
選填 		不適用
connectedModeSpec.apiSecretKey
string
選填 		不適用
connectedModeSpec.clusterId
string
選填 		不適用
connectedModeSpec.displayLocation
string
選填 		不適用
connectedModeSpec.gcpProjectId
string
選填 		不適用
connectedModeSpec.gcpZone
string
選填 		不適用
controlPlaneAgentsVersion
string
必填 		ControlPlaneAgentsVersion 是叢集的所需控制層代理程式版本，例如「0.5.2」。controlPlaneAgentsVersion 必須與所選 databaseVersion 相容。如要瞭解相容的版本，請查看{link}中的可用版本清單。這個版本會套用至資料庫叢集的所有執行個體。如果是新的資料庫叢集，系統會使用指定版本建立執行個體。如果是現有的資料庫叢集，運算子會嘗試升級或降級至指定的 controlPlaneAgentsVersion。欄位 status.currentControlPlaneAgentsVersion 會指出控制層代理程式的目前版本。
databaseImage
string
選填 		DatabaseImage 是容器登錄中自訂資料庫映像檔的統一資源 ID。如果指定 databaseImage，運算子會使用這個容器映像檔做為資料庫，而不是指定 databaseVersion 的預設資料庫容器映像檔。建議 databaseImage 容器以所選 databaseVersion 使用的預設資料庫映像檔為基礎。
databaseVersion
string
選填 		DatabaseVersion 是叢集的所需資料庫版本，例如「15.4.5」。這是必填欄位。這個版本會套用至資料庫叢集的所有執行個體。如果是新的資料庫叢集，系統會使用指定版本建立執行個體。如果是現有資料庫叢集，運算子會嘗試升級或降級至指定的 databaseVersion。欄位 status.currentDatabaseVersion 會指出目前的資料庫版本。
isDeleted
boolean
選填 		IsDeleted 表示刪除 DBCluster 的要求。這個欄位預設為 false。這個欄位會套用至資料庫叢集的所有執行個體。如果設為 true，控制層會嘗試釋出相關資源，包括網路端點。查看狀態欄位，瞭解是否有任何成功或失敗的指標。
mode
string
選填 		指出這個 DBCluster 的模式。
primarySpec
object
必填 		PrimarySpec 包含資料庫叢集主要執行個體的規格。主要執行個體包含運算和儲存資源，可為資料庫叢集的讀寫端點提供服務。
primarySpec.adminUser
object
必填 		AdminUser 代表管理員使用者規格。這是控制層建立的初始資料庫使用者。其他資料庫使用者則由使用者直接管理。這個欄位也可以用來重設初始使用者的密碼。
primarySpec.adminUser.passwordRef
object
選填 		PasswordRef 是包含管理員使用者密碼的密鑰名稱。在初始佈建或密碼重設期間，系統會使用這個值將管理員使用者的密碼設為該密碼。密鑰必須與資料庫叢集位於同一專案。密鑰名稱必須符合以下模式：db-pw-。此外，密碼的鍵 (位於密鑰內) 必須與資料庫叢集名稱相同。
primarySpec.adminUser.passwordRef.name
string
選填 		參照對象的名稱。詳情請參閱「名稱」。
primarySpec.allowExternalIncomingTrafficToInstance
boolean
選填 		AllowExternalIncomingTrafficToInstance 用於設定外部 LB 建立作業。
primarySpec.AuditLogTarget
object
選填 		AuditLogTarget 會設定資料庫稽核記錄的接收器。
primarySpec.AuditLogTarget.syslog
object
選填 		不適用
primarySpec.AuditLogTarget.certsSecretRef
object
必填 		CertsSecretRef 包含用於與系統記錄伺服器建立 TLS 連線的憑證。
primarySpec.AuditLogTarget.certsSecretRef.name
string
選填 		名稱在命名空間中不得重複，用於參照密鑰資源。
primarySpec.AuditLogTarget.certsSecretRef.namespace
string
選填 		命名空間會定義密鑰名稱不得重複的空間。
primarySpec.AuditLogTarget.syslog.host
string
必填 		主機是系統記錄伺服器 FQDN 或 IP 位址。
primarySpec.availabilityOptions
object
選填 		AvailabilityOptions 包含 HA 功能的可調整設定。
primarySpec.availabilityOptions.healthcheckPeriodSeconds
integer
選填 		HealthcheckPeriodSeconds 是健康檢查探測器等待的秒數，之後會再次檢查主要和待命執行個體的健康狀態，並據此更新狀態。這個欄位會從 DBCluster 的規格向下傳播。
primarySpec.availabilityOptions.livenessProbe
string
選填 		LivenessProbe 可啟用或停用有效性探測，用於觸發容器重新啟動。設為「已啟用」時，有效性探測器會定期對資料庫執行健康狀態檢查。如果連續三次健康狀態檢查都失敗，系統就會重新啟動容器。系統會自動停用高可用性執行個體的 LivenessProbe。如果設為「已停用」，有效性探測器就不會對資料庫執行健康狀態檢查。預設值為「已啟用」。
primarySpec.availabilityOptions.livenessProbe
string
選填 		LivenessProbe 可啟用或停用有效性探測，用於觸發容器重新啟動。設為「已啟用」時，有效性探測器會定期對資料庫執行健康狀態檢查。如果連續三次健康狀態檢查都失敗，系統就會重新啟動容器。系統會自動停用高可用性執行個體的 LivenessProbe。如果設為「已停用」，有效性探測器就不會對資料庫執行健康狀態檢查。預設值為「已啟用」。
primarySpec.dbLoadBalancerOptions
object
選填 		DBNetworkServiceOptions 可覆寫 Kubernetes 服務的部分詳細資料，這些服務是為了公開資料庫連線而建立。
primarySpec.dbLoadBalancerOptions.annotations
object
選填 		系統會將客戶提供的註解新增至 loadbalancer 類型的服務物件。
primarySpec.dbLoadBalancerOptions.gcp
object
選填 		包含 Kubernetes LoadBalancer 的 Google Cloud專屬屬性。
primarySpec.dbLoadBalancerOptions.gcp.loadBalancerIP
string
選填 		LoadBalancerIP 是靜態 IP 位址。詳情請參閱「設定靜態外部 IP 位址」。
primarySpec.dbLoadBalancerOptions.gcp.loadBalancerType
string
選填 		LoadBalancer 可以是內部或外部。詳情請參閱內部負載平衡器。
primarySpec.features
object
選填 		功能規格。
primarySpec.features.googleMLExtension
object
選填 		Google 機器學習 (ML) 擴充功能規格。
primarySpec.features.googleMLExtension.config
object
選填 		Google ML 擴充功能設定。
primarySpec.features.googleMLExtension.config.vertexAIKeyRef
string
選填 		不適用
primarySpec.features.googleMLExtension.config.vertexAIRegion
string
選填 		不適用
primarySpec.features.googleMLExtension.enabled
boolean
必填 		不適用
primarySpec.features.memoryAgent
object
選填 		不適用
primarySpec.features.memoryAgent.enabled
boolean
必填 		指出是否要啟用或停用資料庫的記憶代理程式。預設值為 true。
primarySpec.features.memoryAgent.enabled
boolean
必填 		指出是否要啟用或停用資料庫的記憶代理程式。預設值為 true。
primarySpec.isStopped
boolean
選填 		如果設為 true，IsStopped 會停止執行個體。這個欄位預設為 false。停止執行個體時，系統會釋出執行個體的運算資源 (CPU、記憶體)。不過，執行個體會保留儲存空間資源和網路端點，因此重新啟動時，下游服務不會受到影響。查看狀態欄位，瞭解是否有任何成功或失敗的項目。
primarySpec.mode
string
選填 		模式會指定運算子管理這個執行個體的方式。
primarySpec.parameters
object
選填 		參數可讓您為資料庫叢集設定資料庫參數。參數會採用與資料庫引擎定義的參數名稱/值相應的鍵/值組合。
primarySpec.resources
object
必填 		資料庫容器的資源規格。當資源內的任何欄位發生變更時，運算子會使用新的資源規格重新啟動資料庫執行個體。
primarySpec.resources.cpu
integer or string
必填 		分配給資料庫容器的 CPU 數量。
primarySpec.resources.disks
object
必填 		分配給資料庫容器的磁碟規格。
primarySpec.resources.disks.accessModes
string
選填 		AccessModes 包含磁碟區的所需存取模式。詳情請參閱「存取模式」。
primarySpec.resources.disks.annotations
object
選填 		已在永久磁碟區要求中新增其他註解。這個欄位可讓您與其他工具整合。
primarySpec.resources.disks.name
string
必填 		磁碟名稱。允許的值為：DataDisk、LogDisk、BackupDisk 和 ObsDisk。
primarySpec.resources.disks.selector
object
選填 		要用於繫結的磁碟區標籤查詢。如果設定這個欄位，系統會使用標籤相符的磁碟區做為磁碟的備份磁碟區。詳情請參閱 PersistentVolumeClaimSpec。
primarySpec.resources.disks.selector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.resources.disks.selector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.resources.disks.selector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists 和 DoesNotExist。
primarySpec.resources.disks.selector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.resources.disks.selector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.resources.disks.size
string
必填 		磁碟大小 (以位元組為單位)，例如「10Gi」代表 10 Gibibytes。這是必填欄位。允許的大小單位前置字元為：以 2 為底的「Ki」、「Mi」、「Gi」、「Ti」、「Pi」和「Ei」。10 倍的單位也包括「K」、「M」、「G」、「T」、「P」和「E」。詳情請參閱「單位前置字元」。
primarySpec.resources.disks.storageClass
string
選填 		StorageClass 會指向特定 CSI 儲存空間類別。這是選填欄位。如果未設定這個欄位，系統會使用 Kubernetes 叢集的預設 CSI 儲存空間類別。如果 Kubernetes 叢集沒有預設值，則持續性磁碟區聲明會失敗，資料庫叢集也無法佈建。詳情請參閱「儲存空間級別」。
primarySpec.resources.disks.volumeName
string
選填 		VolumeName 是繫結至這個磁碟的永久磁碟區繫結參照。這是選填欄位。這樣就能重複使用現有磁碟區。請注意，如果指定這個欄位，「storageClass」值將不會生效。詳情請參閱「繫結」。
primarySpec.resources.memory
string or integer
必填 		分配給資料庫容器的記憶體量。
primarySpec.resources.memory
string or integer
必填 		分配給資料庫容器的記憶體量。
primarySpec.schedulingConfig
object
選填 		SchedulingConfig 會指定執行個體在 Kubernetes 節點上的排程方式。排程設定中的任何欄位變更時，Kubernetes Pod 可能會根據設定重新排程到不同節點。
primarySpec.schedulingConfig.nodeAffinity
object
選填 		NodeAffinity 會說明執行個體的節點相依性排程規則。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution
object
選填 		排程器會優先將 Pod 排程至符合這個欄位指定相依性運算式的節點，但排程器可能會選擇違反一或多個運算式的節點。權重總和最大的節點是首選節點，也就是說，對於符合所有排程需求 (資源要求、RequiredDuringScheduling 親和性運算式等) 的每個節點，請透過疊代這個欄位的元素並將「權重」加到總和中來計算總和(如果節點符合相應的 matchExpressions)；總和最大的節點就是首選節點。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference
object
必填 		與對應權重相關聯的節點選取器字詞。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchExpressions
object
選填 		依節點標籤列出的節點選取器需求。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchExpressions.key
string
必填 		選取器套用的標籤鍵。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchExpressions.operator
string
必填 		代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists、DoesNotExist。Gt 和 Lt。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchExpressions.values
string
選填 		字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。如果運算子為 Gt 或 Lt，值陣列必須只有一個元素，且會解讀為整數。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchFields
object
選填 		依節點欄位列出的節點選取器需求清單。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchFields.key
string
必填 		選取器套用的標籤鍵。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchFields.operator
string
必填 		代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists、DoesNotExist。Gt 和 Lt。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.preference.matchFields.values
string
選填 		字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。如果運算子為 Gt 或 Lt，值陣列必須只有一個元素，且會解譯為整數。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution.weight
integer
必填 		與對應 nodeSelectorTerm 相符的權重，範圍為 1 到 100。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution
object
選填 		如果在排程時未滿足這個欄位指定的親和性需求，系統就不會將 Pod 排程到節點上。如果在 Pod 執行期間，因更新等因素導致不符合這個欄位指定的親和性需求，系統可能會或可能不會嘗試最終從節點中移除 Pod。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms
object
必填 		節點選取器字詞清單。這些字詞會以 OR 運算子連結。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchExpressions
object
選填 		依節點標籤列出的節點選取器需求。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchExpressions.key
string
必填 		選取器套用的標籤鍵。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchExpressions.operator
string
必填 		代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists、DoesNotExist。Gt 和 Lt。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchExpressions.values
string
選填 		字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。如果運算子為 Gt 或 Lt，值陣列必須只有一個元素，且會解譯為整數。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchFields
object
選填 		依節點欄位列出的節點選取器需求清單。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchFields.key
string
必填 		選取器套用的標籤鍵。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchFields.operator
string
必填 		代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists、DoesNotExist。Gt 和 Lt。
primarySpec.schedulingConfig.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchFields.values
string
選填 		字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。如果運算子為 Gt 或 Lt，值陣列必須只有一個元素，且會解譯為整數。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAffinity
object
選填 		PodAffinity 說明執行個體的 Pod 相依性排程規則。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution
object
選填 		排程器會在排程 Pod 時，優先處理符合這個欄位中指定親和性運算式的節點。排程器仍可能會選擇不完全符合條件的節點。總權重最高的節點會優先使用。計算這個權重時，系統會加總滿足所有排程需求 (例如資源要求或 requiredDuringScheduling 親和性運算式) 的每個節點值。對於每個相符的 podAffinityTerm，節點的權重會增加，而總權重最高的節點會選為最偏好的節點。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm
object
必填 		與對應權重相關聯的 Pod 親和性字詞。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector
object
選填 		一組資源 (在本例中為 Pod) 的標籤查詢。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子為 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector
object
選填 		針對字詞適用的命名空間集進行標籤查詢。這個詞彙適用於此欄位選取的命名空間，以及命名空間欄位中列出的命名空間的聯集。空值選取器和空值或空白命名空間清單表示「這個 Pod 的命名空間」。空白選取器 ({}) 會比對所有命名空間。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子為 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaces
string
選填 		namespaces 會指定詞彙適用的命名空間名稱靜態清單。這個詞彙適用於此欄位中列出的命名空間，以及 namespaceSelector 選取的命名空間。如果命名空間清單為空或為空值，且 namespaceSelector 為空值，則表示「這個 Pod 的命名空間」。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.topologyKey
string
必填 		這個 Pod 必須與指定命名空間中符合 labelSelector 的 Pod 位於同一位置 (親和性) 或不同位置 (反親和性)。共置是指在節點上執行，而節點的標籤值 (含拓撲鍵) 與任何所選 Pod 執行的節點相符。拓撲鍵不得為空。
primarySpec.schedulingConfig.podAffinity.preferredDuringSchedulingIgnoredDuringExecution.weight
integer
必填 		與相符的對應 podAffinityTerm 相關聯的權重，範圍為 1 到 100。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution
object
選填 		如果在排程時未滿足這個欄位指定的親和性需求，系統就不會將 Pod 排程到節點上。如果在 Pod 執行期間，因 Pod 標籤更新等因素，導致不符合這個欄位指定的親和性需求，系統可能會或可能不會嘗試最終從節點中移除 Pod。如果有多個元素，系統會將對應於每個 podAffinityTerm 的節點清單交集，也就是說，必須滿足所有條件。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector
object
選填 		一組資源 (在本例中為 Pod) 的標籤查詢。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector
object
選填 		一組資源 (在本例中為 Pod) 的標籤查詢。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子為 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector
object
選填 		針對字詞適用的命名空間集進行標籤查詢。這個詞彙適用於此欄位選取的命名空間，以及命名空間欄位中列出的命名空間的聯集。空值選取器和空值或空白命名空間清單表示「這個 Pod 的命名空間」。空白選取器 ({}) 會比對所有命名空間。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaces
string
選填 		namespaces 會指定詞彙適用的命名空間名稱靜態清單。這個詞彙適用於此欄位中列出的命名空間，以及 namespaceSelector 選取的命名空間。如果命名空間清單為空或為空值，且 namespaceSelector 為空值，則表示「這個 Pod 的命名空間」。
primarySpec.schedulingConfig.podAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey
string
必填 		這個 Pod 必須與指定命名空間中符合 labelSelector 的 Pod 位於同一位置 (親和性) 或不同位置 (反親和性)。共置是指在節點上執行，而節點的標籤值 (含拓撲鍵) 與任何所選 Pod 執行的節點相符。拓撲鍵不得為空。
primarySpec.schedulingConfig.podAntiAffinity
object
選填 		PodAntiAffinity 會說明執行個體的 Pod 反相依性排程規則。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution
object
選填 		排程器會優先將 Pod 排程至符合這個欄位指定反親和性運算式的節點，但排程器可能會選擇違反一或多個運算式的節點。權重總和最大的節點是首選節點。換句話說，對於符合所有排程需求 (資源要求、requiredDuringScheduling 反親和性運算式等) 的每個節點，請逐一疊代這個欄位的元素，並將「權重」加到總和中 (如果節點有符合對應 podAffinityTerm 的 Pod)。總和最高的節點為首選。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm
object
必填 		與對應權重相關聯的 Pod 親和性字詞。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector
object
選填 		一組資源 (在本例中為 Pod) 的標籤查詢。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子為 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector
object
選填 		針對字詞適用的命名空間集進行標籤查詢。這個詞彙適用於此欄位選取的命名空間，以及命名空間欄位中列出的命名空間的聯集。空值選取器和空值或空白命名空間清單表示「這個 Pod 的命名空間」。空白選取器 ({}) 會比對所有命名空間。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子為 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaces
string
選填 		namespaces 會指定詞彙適用的命名空間名稱靜態清單。這個詞彙適用於此欄位中列出的命名空間，以及 namespaceSelector 選取的命名空間。如果命名空間清單為空或為空值，且 namespaceSelector 為空值，則表示「這個 Pod 的命名空間」。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.topologyKey
string
必填 		這個 Pod 必須與指定命名空間中符合 labelSelector 的 Pod 位於同一位置 (親和性) 或不同位置 (反親和性)。共置是指在節點上執行，而節點的標籤值 (含拓撲鍵) 與任何所選 Pod 執行的節點相符。拓撲鍵不得為空。
primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.weight
integer
必填 		與相符的對應 podAffinityTerm 相關聯的權重，範圍為 1 到 100。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution
object
選填 		如果在排程時未滿足這個欄位指定的反親和性需求，系統就不會將 Pod 排程到節點上。如果在 Pod 執行期間，這個欄位指定的反親和性規定不再符合 (例如由於 Pod 標籤更新)，系統可能會或可能不會嘗試最終將 Pod 從節點中移除。如果有多個元素，系統會將對應於每個 podAffinityTerm 的節點清單交集，也就是說，必須滿足所有條件。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector
object
選填 		一組資源 (在本例中為 Pod) 的標籤查詢。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.labelSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector
object
選填 		針對字詞適用的命名空間集進行標籤查詢。這個詞彙適用於此欄位選取的命名空間，以及命名空間欄位中列出的命名空間的聯集。空值選取器和空值或空白命名空間清單表示「這個 Pod 的命名空間」。空白選取器 ({}) 會比對所有命名空間。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions.key
string
必填 		鍵是選取器套用的標籤鍵。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists 和 DoesNotExist。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector.matchLabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.namespaces
string
選填 		namespaces 會指定詞彙適用的命名空間名稱靜態清單。這個詞彙適用於此欄位中列出的命名空間，以及 namespaceSelector 選取的命名空間。如果命名空間清單為空或為空值，且 namespaceSelector 為空值，則表示「這個 Pod 的命名空間」。
primarySpec.schedulingConfig.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey
string
必填 		這個 Pod 必須與指定命名空間中符合 labelSelector 的 Pod 位於同一位置 (親和性) 或不同位置 (反親和性)。共置是指在節點上執行，而節點的標籤值 (含拓撲鍵) 與任何所選 Pod 執行的節點相符。拓撲鍵不得為空。
primarySpec.schedulingConfig.tolerations
object
選填 		容許度可讓您管理是否允許在套用特定汙染的 Kubernetes 節點上排定執行個體。
primarySpec.schedulingConfig.tolerations.effect
string
選填 		效果表示要比對的汙染效果。如果為空白，則表示符合所有汙染效果。如有指定，允許的值為 NoSchedule、PreferNoSchedule 和 NoExecute。
primarySpec.schedulingConfig.tolerations.key
string
選填 		Key 是容許事項適用的污點鍵。如果為空白，則表示比對所有汙染鍵。如果金鑰為空白，運算子必須為 Exists。這個組合表示要比對所有值和所有鍵。
primarySpec.schedulingConfig.tolerations.operator
string
選填 		運算子代表鍵與值之間的關係。有效運算子為「存在」和「等於」。預設值為「Equal」。Exists 等於值的萬用字元，因此 Pod 可以容忍特定類別的所有汙染。
primarySpec.schedulingConfig.tolerations.tolerationSeconds
integer
選填 		TolerationSeconds 代表容許條件容許汙染的時間長度 (必須是 NoExecute 效果，否則系統會忽略這個欄位)。根據預設，這個欄位不會設定，這表示永遠容許 taint (不會移除)。系統會將零和負值視為 0 (立即移除)。
primarySpec.schedulingConfig.tolerations.value
string
選填 		值是容許值比對的汙染值。如果運算子為「存在」，值必須為空白；否則必須是一般字串。
primarySpec.services
object
選填 		服務清單列出可供選擇的選用半代管服務。
primarySpec.sidecarRef
object
選填 		SidecarRef 是指 Sidecar 自訂資源的參照。如果已設定，側車自訂資源中包含的側車容器會注入資料庫 Pod。
primarySpec.sidecarRef.name
string
選填 		參照對象的名稱。詳情請參閱「名稱」。
primarySpec.sourceCidrRanges
string
選填 		允許用戶端使用的來源 IP CIDR 範圍。
primarySpec.tls
object
選填 		TLS 是執行個體所需的伺服器憑證設定。這是選填欄位。變更這個欄位時，執行個體 Pod 會重新啟動，載入指定的憑證。
primarySpec.tls.certSecret
object
選填 		CertSecret 包含相同命名空間中的憑證密鑰名稱。密碼必須包含 ca.crt (CA 憑證)、tls.key (伺服器私密金鑰) 和 tls.crt (伺服器葉片憑證) 項目。這個密鑰用於設定資料庫執行個體的 TLS 設定。
primarySpec.tls.certSecret.name
string
選填 		參照對象的名稱。詳情請參閱「名稱」
primarySpec.walArchiveSetting
object
選填 		WalArchiveSetting 會指定 WAL 封存設定。如果設定了這個屬性，系統會啟用 archive_mode，將 WAL 記錄封存至指定位置。詳情請參閱「持續歸檔和時間點復原 (PITR)」。
primarySpec.walArchiveSetting.archiveMode
string
選填 		ArchiveMode 會指定 archive_mode。詳情請參閱 archive_mode。
primarySpec.walArchiveSetting.location
string
選填 		位置是儲存封存 WAL 記錄的位置。
tls
object
選填 		TLS 是叢集所需的伺服器憑證設定。根據預設，這個欄位是空白的，系統會為叢集產生新的自行簽署 CA 和分葉憑證。變更這個欄位時，資料庫叢集 Pod 會重新啟動，以載入指定的憑證。欄位 status.certificateReference 會指出目前的 CA 憑證密碼和金鑰。
tls.certSecret
object
選填 		CertSecret 會參照相同命名空間中的憑證密鑰。密碼必須包含 ca.crt (CA 憑證)、tls.key (伺服器私密金鑰) 和 tls.crt (伺服器葉片憑證) 項目。這個密碼可用於設定資料庫叢集內資料庫執行個體的 TLS 設定。
tls.certSecret.name
string
選填 		參照對象的名稱。詳情請參閱「名稱」

狀態結構定義

DBClusterStatus 定義 DBCluster 的觀察狀態。

healthCheck:
  isRegistered: boolean
  lastHealthCheckTime: string
certificateReference:
  certificateKey: string
  secretRef:
    name: string
    namespace: string
conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
latestFailoverStatus:
  failoverName: string
  status:
    conditions:
    - lastTransitionTime: string
      message: string
      observedGeneration: integer
      reason: string
      status: string
      type: string
    createTime: string
    criticalIncidents:
    - code: string
      createTime: string
      message: string
      messageTemplateParams: object
      resource:
        component: string
        location:
          cluster: string
          group: string
          kind: string
          name: string
          namespace: string
          version: string
      stackTrace:
      - component: string
        message: string
      transientUntil: string
  endTime: string
  internal:
    newPrimary: string
    oldPrimary: string
    phase: string
  observedGeneration: integer
  reconciled: boolean
  startTime: string
  state: string
observedGeneration: integer
phase: string
primary:
  allocatedResources:
    cpu: integer or string
    disks:
      accessModes: string
      annotations: string
      name: string
      selector:
        matchExpressions:
        - key: string
          operator: string
          values: string
          matchLabels: object
        size: string
        storageClass: string
        volumeName: string
    memory: integer or string
  conditions:
  - lastTransitionTime: string
    message: string
    observedGeneration: integer
    reason: string
    status: string
    type: string
  currentControlPlaneAgentsVersion: string
  currentDatabaseImage: string
  currentDatabaseVersion: string
  currentParameters: object
  endpoint: string
  endpoints:
  - name: string
    value: string
  latestExport:
    creationTimeStamp: string
    exportName: string
    spec:
      dbclusterRef: string
      exportLocation:
        gcsOptions:
          bucket: string
          key: string
          secretRef:
            name: string
            namespace: string
        type: string
    status:
      completeTime: string
      conditions:
      - lastTransitionTime: string
        message: string
        observedGeneration: integer
        reason: string
        status: string
        type: string
      criticalIncidents:
      - code: string
        createTime: string
        message: string
        messageTemplateParams: object
        resource:
          component: string
          location:
            cluster: string
            group: string
            kind: string
            name: string
            namespace: string
            version: string
        stackTrace:
        - component: string
          message: string
        transientUntil: string
      exportSubDirectory: string
      observedGeneration: integer
      phase: string
      reconciled: boolean
      startTime: string
  latestImport:
    creationTimeStamp: string
    importName: string
    spec:
      databaseName: string
      dbclusterRef: string
      downloadOnly: boolean
      dumpStorage:
        gcsOptions:
          bucket: string
          key: string
          secretRef:
            name: string
            namespace: string
        type: string
      logStorage:
        gcsOptions:
          bucket: string
          key: string
          secretRef:
            name: string
            namespace: string
        type: string
    status:
      completeTime: string
      conditions:
      - lastTransitionTime: string
        message: string
        observedGeneration: integer
        reason: string
        status: string
        type: string
      criticalIncidents:
      - code: string
        createTime: string
        message: string
        messageTemplateParams: object
        resource:
          component: string
          location:
            cluster: string
            group: string
            kind: string
            name: string
            namespace: string
            version: string
        stackTrace:
        - component: string
          message: string
        transientUntil: string
      dumpPath: string
      observedGeneration: integer
      phase: string
      reconciled: boolean
      startTime: string
  phase: string
  url: string
  walArchiveSetting:
    location: string
reconciled: boolean
registrationStatus:
  IsHA: boolean
  IsRegistered: boolean
  RegistrationTime: string
restoredFrom:
  restoredTime: string
  sourceDBCluster: object
serviceAccounts: string

欄位

類型
必要或選填

 

說明
healthCheck
object
選填 		HealthStatus 代表健康狀態檢查。
healthCheck.isRegistered
boolean
選填 		不適用
healthCheck.lastHealthCheckTime
string
選填 		不適用
certificateReference
object
選填 		CertificateReference 是指伺服器 CA 憑證的密鑰和金鑰，可用於連線至資料庫。如果提供 spec.TLS，在資料庫設定為使用提供的伺服器憑證後，這個值應參照相同的密碼。
certificateReference.certificateKey
string
選填 		CertificateKey 是用來搜尋憑證密鑰的金鑰。
certificateReference.secretRef
object
選填 		SecretRef 是指包含憑證的密鑰。
certificateReference.secretRef.name
string
選填 		名稱在命名空間中不得重複，用於參照密鑰資源。
certificateReference.secretRef.namespace
string
選填 		命名空間會定義密鑰名稱不得重複的空間。
conditions
list (object)
選填 		條件代表實體目前狀態的最新可用觀察結果。
conditions[]
object
選填 		條件包含這個 API 資源目前狀態的其中一個層面詳細資料。
conditions[].lastTransitionTime
string
必填 		lastTransitionTime 是指條件最近一次從一個狀態轉變為另一個狀態的時間，也就是底層條件變更時。如果不知道基礎條件的變更時間，請使用 API 欄位的變更時間。
conditions[].message
string
必填 		message 是使用者可理解的訊息，指出轉換的詳細資料。這個值可以是空字串。
conditions[].observedGeneration
integer
選填 		observedGeneration 代表條件設定依據的 .metadata.generation。舉例來說，如果 .metadata.generation 為 12，而 .status.conditions[x].observedGeneration 為 9，則該條件與執行個體的目前狀態不符。
conditions[].reason
string
必填 		reason 包含程式輔助 ID，指出條件上次轉換的原因。特定條件類型的產生者可以定義這個欄位的預期值和意義，以及這些值是否視為有保障的 API。值須為 CamelCase 字串，這個欄位可能不是空白。
conditions[].status
string
必填 		條件的狀態，可以是 True、False 或 Unknown。
conditions[].type
string
必填 		條件類型，格式為 CamelCase 或 foo.example.com/CamelCase。許多 .condition.type 值在 Available 等資源中保持一致，但任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。相符的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
criticalIncidents
object
選填 		CriticalIncidents 是所有有效重大事件的平面清單。
criticalIncidents[]
object
選填 		CriticalIncident 包含目前重大事件的所有資訊。
criticalIncidents[].code
string
必填 		「代碼」是這項特定錯誤的錯誤代碼。錯誤代碼為 DBSE+數字字串，例如「DBSE1012」。
criticalIncidents[].createTime
string
必填 		CreateTime 是指在來源建立這個事件的時間戳記。
criticalIncidents[].message
string
選填 		訊息會說明發生的事件或錯誤。
criticalIncidents[].messageTemplateParams
object
選填 		MessageTemplateParams 包含鍵/值組合，用於在使用者介面中產生易於使用的資料驅動型 Message 版本。
criticalIncidents[].resource
object
必填 		資源包含回報事件的資料庫服務元件相關資訊，以及 Kubernetes 資源的相關資訊。
criticalIncidents[].resource.component
string
必填 		Component 是回報事件的資料庫服務子系統內部 ID。
criticalIncidents[].resource.location
object
選填 		位置
criticalIncidents[].resource.location.cluster
string
選填 		叢集是受影響 Kubernetes 資源的叢集名稱。
criticalIncidents[].resource.location.group
string
選填 		Group 是 Kubernetes 資源的群組名稱。
criticalIncidents[].resource.location.kind
string
選填 		Kind 是 Kubernetes 資源的種類。
criticalIncidents[].resource.location.name
string
選填 		名稱是受影響的 Kubernetes 資源名稱。
criticalIncidents[].resource.location.namespace
string
選填 		命名空間是受影響 Kubernetes 資源的命名空間。
criticalIncidents[].resource.location.version
string
選填 		Group 是 Kubernetes 資源的版本。
criticalIncidents[].stackTrace
object
選填 		StackTrace 包含來自堆疊追蹤的非結構化訊息清單。
criticalIncidents[].stackTrace.component
string
選填 		Component 是記錄訊息的資料庫服務元件名稱。
criticalIncidents[].stackTrace.message
string
選填 		記錄的訊息。
criticalIncidents[].transientUntil
string
選填 		如果存在 TransientUntil，表示問題必須視為暫時性問題，直到指定時間為止。
criticalIncidents[].transientUntil
string
選填 		如果存在 TransientUntil，表示問題必須視為暫時性問題，直到指定時間為止。
latestFailoverStatus
object
選填 		LatestFailoverStatus 是資料庫叢集最近一次更新的容錯移轉狀態。這個狀態是資料庫叢集目前或最近一次更新的容錯移轉作業狀態副本。這項功能可用於輕鬆監控目前執行的容錯移轉作業狀態。
latestFailoverStatus.failoverName
string
選填 		FailoverName 是最新容錯移轉的名稱。
latestFailoverStatus.status
object
選填 		狀態代表資料庫叢集最近一次容錯移轉的狀態。
latestFailoverStatus.status.conditions
object
選填 		條件代表實體目前狀態的最新可用觀察結果。
latestFailoverStatus.status.conditions.lastTransitionTime
string
必填 		lastTransitionTime 是指條件最近一次從一個狀態轉變為另一個狀態的時間，也就是底層條件變更時。如果不知道，可以使用 API 欄位變更的時間。
latestFailoverStatus.status.conditions.message
string
必填 		message 是使用者可理解的訊息，指出轉換的詳細資料。這可能是空字串。
latestFailoverStatus.status.conditions.observedGeneration
integer
選填 		observedGeneration 代表條件設定依據的 .metadata.generation。舉例來說，如果 .metadata.generation 目前為 12，但 .status.conditions[x].observedGeneration 為 9，則條件相對於執行個體的目前狀態已過時。
latestFailoverStatus.status.conditions.reason
string
必填 		reason 包含程式輔助 ID，指出條件上次轉換的原因。特定條件類型的產生者可以定義這個欄位的預期值和意義，以及這些值是否視為有保障的 API。值應為 CamelCase 字串。這個欄位不得留空。
latestFailoverStatus.status.conditions.status
string
必填 		條件的狀態，可以是 True、False 或 Unknown。
latestFailoverStatus.status.conditions.type
string
必填 		條件類型，格式為 CamelCase 或 foo.example.com/CamelCase。許多 .condition.type 值在 Available 等資源中保持一致，但任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。相符的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
latestFailoverStatus.status.createTime
string
選填 		CreateTime 是指建立內部容錯移轉工作流程機制的時間。
latestFailoverStatus.status.criticalIncidents
object
選填 		CriticalIncidents 是所有有效重大事件的平面清單。
latestFailoverStatus.status.criticalIncidents.code
string
必填 		「代碼」是這項特定錯誤的錯誤代碼。錯誤代碼為 DBSE+數字字串，例如「DBSE1012」。
latestFailoverStatus.status.criticalIncidents.createTime
string
必填 		CreateTime 是指在來源建立這個事件的時間戳記。
latestFailoverStatus.status.criticalIncidents.message
string
選填 		訊息會說明發生的事件或錯誤。
latestFailoverStatus.status.criticalIncidents.messageTemplateParams
object
選填 		MessageTemplateParams 包含鍵/值組合，用於在使用者介面中產生易於使用的資料驅動型 Message 版本。
latestFailoverStatus.status.criticalIncidents.resource
object
必填 		資源包含回報事件的資料庫服務元件相關資訊，以及 Kubernetes 資源的相關資訊。
latestFailoverStatus.status.criticalIncidents.resource.component
string
必填 		Component 是回報事件的資料庫服務子系統內部 ID。
latestFailoverStatus.status.criticalIncidents.resource.location
object
選填 		位置
latestFailoverStatus.status.criticalIncidents.resource.location.cluster
string
選填 		叢集是受影響 Kubernetes 資源的叢集名稱。
latestFailoverStatus.status.criticalIncidents.resource.location.group
string
選填 		Group 是 Kubernetes 資源的群組名稱。
latestFailoverStatus.status.criticalIncidents.resource.location.kind
string
選填 		Kind 是 Kubernetes 資源的種類。
latestFailoverStatus.status.criticalIncidents.resource.location.name
string
選填 		名稱是受影響的 Kubernetes 資源名稱。
latestFailoverStatus.status.criticalIncidents.resource.location.namespace
string
選填 		命名空間是受影響 Kubernetes 資源的命名空間。
latestFailoverStatus.status.criticalIncidents.resource.location.version
string
選填 		Group 是 k8s 資源的版本。
latestFailoverStatus.status.criticalIncidents.stackTrace
object
選填 		StackTrace 包含來自堆疊追蹤的非結構化訊息清單。
latestFailoverStatus.status.criticalIncidents.stackTrace.component
string
選填 		Component 是記錄訊息的資料庫服務元件名稱。
latestFailoverStatus.status.criticalIncidents.stackTrace.message
string
選填 		記錄的訊息。
latestFailoverStatus.status.criticalIncidents.transientUntil
string
選填 		如果存在 TransientUntil，表示問題必須視為暫時性問題，直到指定時間為止。
latestFailoverStatus.status.endTime
string
選填 		EndTime 是指容錯移轉達到最終狀態的時間。
latestFailoverStatus.status.internal
object
選填 		系統控制器會使用 Internal。請勿依賴本節中的資訊。
latestFailoverStatus.status.internal.newPrimary
string
必填 		NewPrimary 是您嘗試容錯移轉的執行個體。
latestFailoverStatus.status.internal.oldPrimary
string
必填 		OldPrimary 是容錯移轉開始時的主要執行個體。
latestFailoverStatus.status.internal.phase
string
選填 		階段用於追蹤容錯移轉的目前狀態。
latestFailoverStatus.status.observedGeneration
integer
選填 		控制器觀察到的世代。
latestFailoverStatus.status.reconciled
boolean
選填 		資源是否已由控制器調解。
latestFailoverStatus.status.startTime
string
選填 		StartTime 是指容錯移轉作業的開始時間。
latestFailoverStatus.status.state
string
選填 		狀態是容錯移轉作業的目前狀態。值包括 InProgress、Success、Failed_RollbackInProgress、Failed_RollbackSuccess 和 Failed_RollbackFailed。
  • InProgress 表示容錯移轉作業仍在進行中。
  • 「成功」表示容錯移轉已完成。當新的主要執行個體升級成功，這項作業即完成。
  • Failed_RollbackInProgress 表示運算子無法升級新的主要執行個體，且正在嘗試重新啟動舊的主要執行個體。
  • Failed_RollbackSuccess 表示運算子無法升級新的主要執行個體，但已成功重新啟動舊的主要執行個體。
  • Failed_RollbackFailed 表示運算子無法升級新的主要執行個體，也無法重新啟動舊的主要執行個體。DBCluster 可能需要手動修復。
observedGeneration
integer
選填 		內部：控制器觀察到的世代。
phase
string
選填 		不適用
primary
object
選填 		Primary 包含主要執行個體的狀態。
primary.allocatedResources
object
選填 		AllocatedResources 代表記憶體、CPU 和磁碟的目前設定。
primary.allocatedResources.cpu
integer or string
必填 		分配給資料庫容器的 CPU 數量。
primary.allocatedResources.disks
object
必填 		分配給資料庫容器的磁碟規格。
primary.allocatedResources.disks.accessModes
string
選填 		AccessModes 包含磁碟區的所需存取模式。詳情請參閱「存取模式」。
primary.allocatedResources.disks.annotations
object
選填 		已在永久磁碟區要求中新增其他註解。因此可與其他工具整合。
primary.allocatedResources.disks.name
string
必填 		磁碟名稱。這是必填欄位。允許的值包括：「DataDisk」、「LogDisk」、「BackupDisk」和「ObsDisk」。
primary.allocatedResources.disks.selector
object
選填 		要用於繫結的磁碟區標籤查詢。如果設定這個欄位，系統會使用標籤相符的磁碟區做為磁碟的備份磁碟區。詳情請參閱 PersistentVolumeClaimSpec
primary.allocatedResources.disks.selector
object
選填 		要用於繫結的磁碟區標籤查詢。如果設定這個欄位，系統會使用標籤相符的磁碟區做為磁碟的備份磁碟區。詳情請參閱 PersistentVolumeClaimSpec。
primary.allocatedResources.disks.selector.matchExpressions
object
選填 		matchExpressions 是標籤選取器需求的清單。這些條件會以 AND 運算子連結。
primary.allocatedResources.disks.selector.matchExpressions.operator
string
必填 		運算子代表鍵與一組值的關係。有效運算子包括 In、NotIn、Exists 和 DoesNotExist。
primary.allocatedResources.disks.selector.matchExpressions.values
string
選填 		values 是字串值陣列。如果運算子為 In 或 NotIn，值陣列不得為空。如果運算子為 Exists 或 DoesNotExist，值陣列必須為空。這個陣列會在策略性合併修補程式期間遭到取代。
primary.allocatedResources.disks.selector.matchlabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primary.allocatedResources.disks.selector.matchlabels
object
選填 		matchLabels 是 {key,value} 組合的對應。matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的元素，其鍵欄位為「key」，運算子為「In」，且值陣列只包含「value」。這些條件會以 AND 運算子連結。
primary.allocatedResources.disks.size
string
必填 		磁碟大小 (以位元組為單位)，例如「10Gi」代表 10 Gibibytes。這是必填欄位。允許的大小單位前置字元為：以 2 為底的「Ki」、「Mi」、「Gi」、「Ti」、「Pi」和「Ei」。10 倍的單位也包括「K」、「M」、「G」、「T」、「P」和「E」。詳情請參閱「單位前置字元」。
primary.allocatedResources.disks.storageClass
string
選填 		StorageClass 會指向特定 CSI 儲存空間類別。這是選填欄位。如果未設定這個欄位，系統會使用 Kubernetes 叢集的預設 CSI 儲存空間類別。如果 Kubernetes 叢集沒有預設值，則持續性磁碟區聲明會失敗，資料庫叢集也無法佈建。詳情請參閱「儲存空間級別」。
primary.allocatedResources.disks.volumeName
string
選填 		VolumeName 是繫結至這個磁碟的永久磁碟區繫結參照。這是選填欄位。這樣就能重複使用現有磁碟區。請注意，如果指定這個欄位，「storageClass」值將不會生效。詳情請參閱「繫結」。
primary.allocatedResources.memory
string or integer
必填 		分配給資料庫容器的記憶體量。
primary.allocatedResources.memory
string or integer
必填 		分配給資料庫容器的記憶體量。
primary.conditions
object
必填 		條件代表執行個體目前狀態的最新可用觀察結果。
primary.conditions.lastTransitionTime
string
必填 		lastTransitionTime 是指條件最近一次從一個狀態轉變為另一個狀態的時間，也就是底層條件變更時。如果不知道基礎條件的變更時間，可以使用 API 欄位的變更時間。
primary.conditions.message
string
必填 		message 是使用者可理解的訊息，指出轉換的詳細資料。這個值可以是空字串。
primary.conditions.observedGeneration
integer
選填 		observedGeneration 代表條件設定依據的 .metadata.generation。舉例來說，如果 .metadata.generation 為 12，但 .status.conditions[x].observedGeneration 為 9，則該條件相對於執行個體的目前狀態已過時。
primary.conditions.reason
string
必填 		reason 包含程式輔助 ID，指出條件上次轉換的原因。特定條件類型的產生者可以定義這個欄位的預期值和意義，以及這些值是否視為有保障的 API。值應為 CamelCase 字串。這個欄位可能不是空白。
primary.conditions.status
string
必填 		條件的狀態，可以是 True、False 或 Unknown。
primary.conditions.type
string
必填 		條件類型，格式為 CamelCase 或 foo.example.com/CamelCase。許多 .condition.type 值在 Available 等資源中保持一致，但任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。相符的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
primary.currentControlPlaneAgentsVersion
string
選填 		CurrentControlPlaneAgentsVersion 是主要執行個體執行的控制層代理程式版本。主要執行個體佈建完成後，或升級/降級成功後，這個值必須與 spec.controlPlaneAgentsVersion 的值相符。
primary.currentDatabaseImage
string
選填 		CurrentDatabaseImage 是主要執行個體使用的自訂資料庫映像檔。主要執行個體佈建完成，或升級/降級成功後，這個值必須與 spec.databaseImage 的值相符。
primary.currentDatabaseVersion
string
選填 		CurrentDatabaseVersion 是主要執行個體目前執行的資料庫版本。主要執行個體佈建完成，或升級/降級成功後，這個值應與 spec.databaseVersion 的值相符。
primary.currentParameters
object
選填 		CurrentParameters 會指出參數的目前值。CurrentParameters 可用於確認 spec.primarySpec.parameters 欄位是否已套用至資料庫。只有 spec.primarySpec.parameters 中的參數名稱會納入這個欄位。
primary.endpoint
string
選填 		端點是可用於建立資料庫連線的位址。已淘汰：請改用「端點」欄位。
primary.endpoints
object
選填 		端點包含所有可存取這個執行個體的端點。
primary.endpoints.name
string
必填 		名稱包含端點名稱。
primary.endpoints.value
string
選填 		值包含端點資訊。
primary.endpoints.value
string
選填 		值包含端點資訊。
primary.latestExport
object
選填 		LatestExport 代表資料庫執行個體的最新匯出作業。
primary.latestExport.creationTimeStamp
string
選填 		CreationTimeStamp 代表資料庫執行個體匯出的建立時間。
primary.latestExport.exportName
string
選填 		ExportName 是最新匯出作業的名稱。
primary.latestExport.spec
object
選填 		Spec 代表資料庫執行個體的匯出規格。
primary.latestExport.spec.dbclusterRef
string
選填 		DBClusterRef 是要匯出的相同命名空間中的 dbcluster 名稱。
primary.latestExport.spec.exportLocation
object
必填 		ExportLocation 會指定匯出檔案的儲存位置。您必須確保從運算子內正確寫入儲存空間值區。
primary.latestExport.spec.exportLocation.gcsOptions
object
選填 		GCSOptions 是指 Cloud Storage 相關選項。
primary.latestExport.spec.exportLocation.gcsOptions.bucket
string
必填 		Bucket 為必填欄位，例如 dbs-dump-bucket。您必須確保從運算子內正確寫入儲存空間值區。
primary.latestExport.spec.exportLocation.gcsOptions.key
string
必填 		傾印檔案的物件鍵，例如 ods-dump/scottschema.dmp。
primary.latestExport.spec.exportLocation.gcsOptions.secretRef
object
選填 		SecretRef 是指儲存 Cloud Storage 存取資訊的密鑰。
primary.latestExport.spec.exportLocation.gcsOptions.secretRef.name
string
選填 		名稱在命名空間中不得重複，用於參照密鑰資源。
primary.latestExport.spec.exportLocation.gcsOptions.secretRef.namespace
string
選填 		命名空間會定義密鑰名稱不得重複的空間。
primary.latestExport.spec.exportLocation.type
string
必填 		存放區類型，例如 S3 或 GCS，可告知代理程式要使用哪個儲存系統或 API。
primary.latestExport.status
object
選填 		狀態代表資料庫執行個體的最新匯入作業。
primary.latestExport.status.completeTime
string
選填 		CompleteTime 是匯出作業完成的時間。
primary.latestExport.status.conditions
object
選填 		條件代表實體目前狀態的最新可用觀察結果。
primary.latestExport.status.conditions.lastTransitionTime
string
必填 		lastTransitionTime 是指條件最近一次從一個狀態轉變為另一個狀態的時間。這必須是基礎條件變更的時間。如果不知道基礎條件的變更時間，請使用 API 欄位的變更時間。
primary.latestExport.status.conditions.message
string
必填 		message 是使用者可理解的訊息，指出轉換的詳細資料。這可能是空字串。
primary.latestExport.status.conditions.observedGeneration
integer
選填 		observedGeneration 代表條件設定依據的 .metadata.generation。舉例來說，如果 .metadata.generation 目前為 12，而 .status.conditions[x].observedGeneration 為 9，則該條件相對於執行個體的目前狀態已過時。
primary.latestExport.status.conditions.reason
string
必填 		reason 包含程式輔助 ID，指出條件上次轉換的原因。特定條件類型的產生者可能會定義這個欄位的預期值和意義，以及這些值是否視為有保障的 API。值須為 CamelCase 字串，這個欄位可能不是空白。
primary.latestExport.status.conditions.status
string
必填 		條件的狀態，可以是 True、False 或 Unknown。
primary.latestExport.status.conditions.type
string
必填 		條件類型，格式為 CamelCase 或 foo.example.com/CamelCase。許多 .condition.type 值在 Available 等資源中保持一致，但任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。相符的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
primary.latestExport.status.criticalIncidents
object
選填 		CriticalIncidents 是所有有效重大事件的平面清單。
primary.latestExport.status.criticalIncidents.code
string
必填 		「代碼」是這項特定錯誤的錯誤代碼。錯誤代碼為 DBSE+數字字串，例如「DBSE1012」。
primary.latestExport.status.criticalIncidents.createTime
string
必填 		CreateTime 是指在來源建立這個事件的時間戳記。
primary.latestExport.status.criticalIncidents.message
string
選填 		訊息會說明發生的事件或錯誤。
primary.latestExport.status.criticalIncidents.messageTemplateParams
object
選填 		MessageTemplateParams 包含鍵/值組合，用於在使用者介面中產生易於使用的資料驅動型 Message 版本。
primary.latestExport.status.criticalIncidents.resource
object
必填 		資源包含回報事件的資料庫服務元件相關資訊，以及 Kubernetes 資源的相關資訊。
primary.latestExport.status.criticalIncidents.resource.component
string
必填 		Component 是回報事件的資料庫服務子系統內部 ID。
primary.latestExport.status.criticalIncidents.resource.location
object
選填 		位置
primary.latestExport.status.criticalIncidents.resource.location.cluster
string
選填 		叢集是受影響 Kubernetes 資源的叢集名稱。
primary.latestExport.status.criticalIncidents.resource.location.group
string
選填 		Group 是 Kubernetes 資源的群組名稱。
primary.latestExport.status.criticalIncidents.resource.location.kind
string
選填 		Kind 是 Kubernetes 資源的 Kind 名稱。
primary.latestExport.status.criticalIncidents.resource.location.name
string
選填 		名稱是受影響的 Kubernetes 資源名稱。
primary.latestExport.status.criticalIncidents.resource.location.namespace
string
選填 		命名空間是受影響 Kubernetes 資源的命名空間。
primary.latestExport.status.criticalIncidents.resource.location.version
string
選填 		Group 是 Kubernetes 資源的版本。
primary.latestExport.status.criticalIncidents.resource.location.version
string
選填 		Group 是 Kubernetes 資源的版本。
primary.latestExport.status.criticalIncidents.stackTrace
object
選填 		StackTrace 包含來自堆疊追蹤的非結構化訊息清單。
primary.latestExport.status.criticalIncidents.stackTrace.component
string
選填 		Component 是記錄訊息的資料庫服務元件名稱。
primary.latestExport.status.criticalIncidents.stackTrace.message
string
選填 		記錄的訊息。
primary.latestExport.status.criticalIncidents.transientUntil
string
選填 		如果存在 TransientUntil，表示問題必須視為暫時性問題，直到指定時間為止。
primary.latestExport.status.exportSubDirectory
string
選填 		ExportSubDirectory 是附加至 ExportLocation 的子目錄，用於儲存匯出的檔案。
primary.latestExport.status.observedGeneration
integer
選填 		ExportSubDirectory 是附加至 ExportLocation 的子目錄，用於儲存匯出的檔案。
primary.latestExport.status.phase
string
選填 		階段是匯出作業目前狀態的摘要。
primary.latestExport.status.reconciled
boolean
選填 		內部：資源是否已由控制器調解。
primary.latestExport.status.startTime
string
選填 		StartTime 是指匯出作業開始的時間。
primary.latestImport
object
選填 		LatestImport 代表資料庫執行個體的最新匯入作業。
primary.latestImport.creationTimeStamp
string
選填 		CreationTimeStamp 代表資料庫執行個體的匯入建立時間。
primary.latestImport.importName
string
選填 		ImportName 是最新匯入作業的名稱。
primary.latestImport.spec
object
選填 		Spec 代表資料庫執行個體匯入作業的規格。
primary.latestImport.spec.databaseName
string
選填 		DatabaseName 是要匯入的 Instance 內資料庫資源名稱。
primary.latestImport.spec.dbclusterRef
string
選填 		DBClusterRef 是要匯入的相同命名空間中的 dbcluster 名稱。
primary.latestImport.spec.downloadOnly
boolean
選填 		如果設為 true，表示系統只會下載傾印檔案，但不會匯入資料庫。預設值為 false。
primary.latestImport.spec.dumpStorage
object
必填 		DumpStorage 會指定匯入傾印檔案的儲存位置。請務必確保從運算子內適當讀取儲存空間值區。
primary.latestImport.spec.dumpStorage.gcsOptions
object
選填 		GCSOptions 是指 Cloud Storage 相關選項。
primary.latestImport.spec.dumpStorage.gcsOptions.bucket
string
必填 		Bucket 為必填欄位，例如 dbs-dump-bucket。您必須確保從運算子內正確寫入儲存空間值區。
primary.latestImport.spec.dumpStorage.gcsOptions.key
string
必填 		傾印檔案的物件鍵，例如 ods-dump/scottschema.dmp。
primary.latestImport.spec.dumpStorage.gcsOptions.secretRef
object
選填 		SecretRef 是指儲存 Cloud Storage 存取資訊的密鑰。
primary.latestImport.spec.dumpStorage.gcsOptions.secretRef.name
string
選填 		名稱在命名空間中不得重複，用於參照密鑰資源。
primary.latestImport.spec.dumpStorage.gcsOptions.secretRef.namespace
string
選填 		命名空間會定義密鑰名稱不得重複的空間。
primary.latestImport.spec.dumpStorage.type
string
必填 		存放區類型，例如 S3 或 GCS，可告知代理程式要使用哪個儲存系統或 API。
primary.latestImport.spec.logStorage
object
選填 		LogStorage 可選擇指定儲存位置，用來複製匯入記錄。您必須確保從運算子內正確寫入儲存空間值區。
primary.latestImport.spec.logStorage.gcsOptions
object
選填 		GCSOptions 是指 Cloud Storage 相關選項。
primary.latestImport.spec.logStorage.gcsOptions.bucket
string
必填 		Bucket 為必填欄位，例如 dbs-dump-bucket。您必須確保從運算子內正確寫入儲存空間值區。
primary.latestImport.spec.logStorage.gcsOptions.key
string
必填 		傾印檔案的物件金鑰。
primary.latestImport.spec.logStorage.gcsOptions.secretRef
object
選填 		SecretRef 是指儲存 Cloud Storage 存取資訊的密鑰。
primary.latestImport.spec.logStorage.gcsOptions.secretRef.name
string
選填 		名稱在命名空間中不得重複，用於參照密鑰資源。
primary.latestImport.spec.logStorage.gcsOptions.secretRef.namespace
string
選填 		命名空間會定義密鑰名稱不得重複的空間。
primary.latestImport.spec.logStorage.type
string
必填 		存放區類型，可告知代理程式要使用哪個儲存系統或 API。
primary.latestImport.status
object
選填 		狀態代表資料庫執行個體的最新匯入作業。
primary.latestImport.status.completeTime
string
選填 		CompleteTime 是匯入完成的時間。
primary.latestImport.status.conditions
object
選填 		條件代表實體目前狀態的最新可用觀察結果。
primary.latestImport.status.conditions.lastTransitionTime
string
必填 		lastTransitionTime 是指條件最近一次從一個狀態轉變為另一個狀態的時間。這必須是基礎條件變更的時間。如果不知道基礎條件的變更時間，請使用 API 欄位的變更時間。
primary.latestImport.status.conditions.message
string
必填 		message 是使用者可理解的訊息，指出轉換的詳細資料。這可能是空字串。
primary.latestImport.status.conditions.observedGeneration
integer
選填 		observedGeneration 代表條件設定依據的 .metadata.generation。舉例來說，如果 .metadata.generation 為 12，而 .status.conditions[x].observedGeneration 為 9，則該條件與執行個體的目前狀態不符。
primary.latestImport.status.conditions.reason
string
必填 		reason 包含程式輔助 ID，指出條件上次轉換的原因。特定條件類型的產生者可能會定義這個欄位的預期值和意義，以及這些值是否視為有保障的 API。值須為 CamelCase 字串，這個欄位可能不是空白。
primary.latestImport.status.conditions.status
string
必填 		條件的狀態，可以是 True、False 或 Unknown。
primary.latestImport.status.conditions.type
string
必填 		條件類型，格式為 CamelCase 或 foo.example.com/CamelCase。許多 .condition.type 值在 Available 等資源中保持一致，但任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。相符的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
primary.latestImport.status.criticalIncidents
object
選填 		CriticalIncidents 是所有有效重大事件的平面清單。
primary.latestImport.status.criticalIncidents.code
string
必填 		「代碼」是這項特定錯誤的錯誤代碼。錯誤代碼為 DBSE+數字字串，例如「DBSE1012」。
primary.latestImport.status.criticalIncidents.createTime
string
必填 		CreateTime 是指在來源建立這個事件的時間戳記。
primary.latestImport.status.criticalIncidents.message
string
選填 		訊息會說明發生的事件或錯誤。
primary.latestImport.status.criticalIncidents.messageTemplateParams
object
選填 		MessageTemplateParams 包含鍵/值組合，用於在使用者介面中產生易於使用的資料驅動型 Message 版本。
primary.latestImport.status.criticalIncidents.resource
object
必填 		資源包含回報事件的資料庫服務元件相關資訊，以及 Kubernetes 資源的相關資訊。
primary.latestImport.status.criticalIncidents.resource.component
string
必填 		Component 是回報事件的資料庫服務子系統內部 ID。
primary.latestImport.status.criticalIncidents.resource.location
object
選填 		位置
primary.latestImport.status.criticalIncidents.resource.location.cluster
string
選填 		叢集是受影響 Kubernetes 資源的叢集名稱。
primary.latestImport.status.criticalIncidents.resource.location.group
string
選填 		Group 是 Kubernetes 資源的群組名稱。
primary.latestImport.status.criticalIncidents.resource.location.kind
string
選填 		Kind 是 Kubernetes 資源的種類。
primary.latestImport.status.criticalIncidents.resource.location.name
string
選填 		名稱是受影響的 Kubernetes 資源名稱。
primary.latestImport.status.criticalIncidents.resource.location.namespace
string
選填 		命名空間是受影響 Kubernetes 資源的命名空間。
primary.latestImport.status.criticalIncidents.resource.location.version
string
選填 		Group 是 Kubernetes 資源的版本。
primary.latestImport.status.criticalIncidents.stackTrace
object
選填 		StackTrace 包含來自堆疊追蹤的非結構化訊息清單。
primary.latestImport.status.criticalIncidents.stackTrace.component
string
選填 		Component 是記錄訊息的資料庫服務元件名稱。
primary.latestImport.status.criticalIncidents.stackTrace.message
string
選填 		記錄的訊息。
primary.latestImport.status.criticalIncidents.transientUntil
string
選填 		如果存在 TransientUntil，表示問題必須視為暫時性問題，直到指定時間為止。
primary.latestImport.status.dumpPath
string
選填 		DumpPath 是下載的傾印檔案路徑，僅適用於下載匯入。
primary.latestImport.status.observedGeneration
integer
選填 		內部：控制器觀察到的世代。
primary.latestImport.status.phase
string
選填 		階段是匯入作業目前狀態的摘要。
primary.latestImport.status.reconciled
boolean
選填 		內部：資源是否已由控制器調解。
primary.latestImport.status.startTime
string
選填 		StartTime 是匯入作業的開始時間。
primary.phase
string
選填 		階段是執行個體目前狀態的摘要。
primary.walArchiveSetting
object
選填 		WalArchiveSetting 代表目前的預寫記錄 (WAL) 封存設定。
primary.walArchiveSetting.location
string
選填 		不適用
reconciled
boolean
選填 		內部：資源是否已由控制器調解。
registrationStatus
object
選填 		RegistrationStatus 代表資料庫叢集的遷移狀態。
registrationStatus.isHA
boolean
選填 		如果 DBClusterSpec HA Availability 設定至少有 1 個 numberOfStandbys 設定，IsHA 會設為 true。
registrationStatus.isRegistered
boolean
選填 		不適用
registrationStatus.isRegistered
string
選填 		RegistrationTime 代表內部部署資料庫叢集向 Google Cloud註冊的時間。
restoredFrom
object
選填 		RestoredFrom 是顯示目前 DBCluster 最近一次還原來源的狀態。
restoredFrom.restoredTime
string
選填 		這個 DBCluster 要從中還原的來源 DBCluster 時間點。
restoredFrom.sourceDBCluster
string
選填 		這個 DBCluster 從中還原的來源 DBCluster。
restoredFrom.sourceDBCluster
string
選填 		這個 DBCluster 從中還原的來源 DBCluster。
serviceAccounts
object
選填 		ServiceAccounts 包含控制層建立的服務帳戶，供不同作業使用。授予這些服務帳戶權限後，資料庫就能與 Kubernetes 生態系統中的其他服務互動。如要進一步瞭解各項作業，包括所需權限，請參閱相關說明文件。