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` 選填	EnableAutoFailover 表示如果 DBCluster 偵測到主要執行個體健康狀態不良，且待命執行個體健康狀態良好，就會觸發容錯移轉。如果設為 true，就會啟用自動容錯移轉功能。如果設為 false，即使系統偵測到主要執行個體狀況不佳，也不會觸發自動容錯移轉。預設值為 true。啟用後，如果系統偵測到主要執行個體在指定門檻內健康狀態不佳，就會觸發容錯移轉。這項功能僅適用於 HA DBCluster，且備援資料庫必須正常運作。
`availability.enableAutoHeal`
`boolean` 選填	EnableAutoHeal 表示如果偵測到待命執行個體健康狀態不良，這個 DBCluster 就會觸發自動修復。如果設為 true，則會啟用自動修復功能。如果設為 false，即使系統偵測到待命執行個體健康狀態不佳，也不會觸發自動修復功能。預設值為 true。啟用這項功能後，如果系統偵測到待命執行個體健康狀態不良，達到指定門檻，就會觸發自動修復。這項功能僅適用於高可用性 DBCluster。
`availability.enableStandbyAsReadReplica`
`boolean` 必填	EnableStandbyAsReadReplica 會決定待機伺服器是否可接受使用者查詢。如果設為 true，系統會建立新的端點，啟用待命執行個體的唯讀存取權。
`availability.healthcheckPeriodSeconds`
`integer` 選填	HealthcheckPeriodSeconds 是健康狀態檢查探測器等待的秒數，之後會再次檢查主要和待命執行個體的健康狀態，並據此更新狀態。
`availability.numberOfStandbys`
`integer` 選填	NumberOfStandbys 是指應為這個 DBCluster 建立的待機數量。如果設為大於 0 的值，叢集就會啟用高可用性，且系統會建立指定數量的待命執行個體。待命執行個體數量上限為 5 個。如要查看這個 DBCluster 的 HA 目前狀態，請查看 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 的預設資料庫容器映像檔。建議您根據所選 databaseVersion 使用的預設資料庫映像檔，建立 databaseImage 容器。
`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 包含要用於與 syslog 伺服器建立 TLS 連線的憑證。
`primarySpec.AuditLogTarget.certsSecretRef.name`
`string` 選填	命名空間中的名稱不得重複，用於參照密鑰資源。
`primarySpec.AuditLogTarget.certsSecretRef.namespace`
`string` 選填	命名空間會定義密鑰名稱不得重複的空間。
`primarySpec.AuditLogTarget.syslog.host`
`string` 必填	主機是 Syslog 伺服器 FQDN 或 IP 位址。
`primarySpec.availabilityOptions`
`object` 選填	AvailabilityOptions 包含高可用性功能的調整設定。
`primarySpec.availabilityOptions.healthcheckPeriodSeconds`
`integer` 選填	HealthcheckPeriodSeconds 是健康狀態檢查探測器等待的時間 (以秒為單位)，之後會再次檢查主要和待命執行個體的健康狀態，並據此更新狀態。這個欄位會從 DBCluster 的規格向下傳播。
`primarySpec.availabilityOptions.livenessProbe`
`string` 選填	LivenessProbe 可啟用或停用 liveness 探測，用於觸發容器重新啟動。設為「已啟用」後，存活探測會定期對資料庫執行健康狀態檢查。如果容器連續三次未通過健康狀態檢查，就會重新啟動。高可用性執行個體會自動停用 LivenessProbe。如果設為「停用」，liveness 探測就不會對資料庫執行健康狀態檢查。預設值為「已啟用」。
`primarySpec.dbLoadBalancerOptions`
`object` 選填	DBNetworkServiceOptions 可覆寫 Kubernetes Service 的部分詳細資料，這些 Service 是為了公開資料庫連線而建立。
`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 機器學習擴充功能設定。
`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` 選填	IsStopped 設為 true 時，會停止執行個體。這個欄位預設為 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` 必填	key 是選取器套用的標籤鍵。
`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` 必填	與對應權重相關聯的廣告連播親和字詞。
`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` 必填	key 是選取器套用的標籤鍵。
`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` 必填	key 是選取器套用的標籤鍵。
`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 位於相同位置 (親和性)，或位於不同位置 (反親和性)。「共置」是指在節點上執行，且該節點的標籤值 (鍵為 topologyKey) 與任何執行所選 Pod 的節點標籤值相符。topologyKey 不得留空。
`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` 必填	key 是選取器套用的標籤鍵。
`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` 必填	key 是選取器套用的標籤鍵。
`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 執行的節點相符，則定義為共置。topologyKey 不得留空。
`primarySpec.schedulingConfig.podAntiAffinity`
`object` 選填	PodAntiAffinity 說明執行個體的 Pod 反親和性排程規則。
`primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution`
`object` 選填	排程器會優先將 Pod 排程至符合這個欄位指定反相依性運算式的節點，但排程器可能會選擇違反一或多個運算式的節點。最偏好的節點是權重總和最大的節點，換句話說，對於符合所有排程需求 (資源要求、requiredDuringScheduling 反親和性運算式等) 的每個節點，請逐一疊代這個欄位的元素，並將「權重」加到總和中 (如果節點有符合對應 podAffinityTerm 的 Pod)。總和最高的節點最優先。
`primarySpec.schedulingConfig.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm`
`object` 必填	與對應權重相關聯的廣告連播親和字詞。
`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` 必填	key 是選取器套用的標籤鍵。
`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` 必填	key 是選取器套用的標籤鍵。
`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 位於相同位置 (親和性)，或位於不同位置 (反親和性)。「共置」是指在節點上執行，且該節點的標籤值 (鍵為 topologyKey) 與任何執行所選 Pod 的節點標籤值相符。topologyKey 不得留空。
`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` 必填	key 是選取器套用的標籤鍵。
`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` 必填	key 是選取器套用的標籤鍵。
`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 執行的節點相符，則定義為共置。topologyKey 不得留空。
`primarySpec.schedulingConfig.tolerations`
`object` 選填	容忍度可用於管理是否允許在套用特定污點的 Kubernetes 節點上排定執行個體。
`primarySpec.schedulingConfig.tolerations.effect`
`string` 選填	效果表示要比對的汙染效果。留空表示比對所有污點影響。指定時，允許的值為 NoSchedule、PreferNoSchedule 和 NoExecute。
`primarySpec.schedulingConfig.tolerations.key`
`string` 選填	鍵是容許事項適用的污點鍵。如果留空，則代表比對所有污點索引鍵。如果鍵為空白，運算子必須為 Exists。這個組合代表比對所有值和所有鍵。
`primarySpec.schedulingConfig.tolerations.operator`
`string` 選填	運算子代表鍵與值的關係。有效運算子為 Exists 和 Equal。預設為「Equal」。Exists 相當於值的萬用字元，因此 Pod 可以容忍特定類別的所有污點。
`primarySpec.schedulingConfig.tolerations.tolerationSeconds`
`integer` 選填	TolerationSeconds 代表容忍度 (必須為 NoExecute 效果，否則系統會忽略這個欄位) 容忍污點的時間長度。根據預設，這個欄位不會設定，這表示永遠容許 taint (不會移除)。系統會將零和負值視為 0 (立即剔除)。
`primarySpec.schedulingConfig.tolerations.value`
`string` 選填	值是容許事項比對的汙染值。如果運算子為 Exists，值必須為空白，否則必須為一般字串。
`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 包含相同命名空間中的憑證 Secret 名稱。這個 Secret 必須包含 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 會參照相同命名空間中的憑證 Secret。Secret 必須包含 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，在資料庫設定為使用提供的伺服器憑證後，這個值應參照相同的 Secret。
`certificateReference.certificateKey`
`string` 選填	CertificateKey 是用來搜尋憑證密鑰的金鑰。
`certificateReference.secretRef`
`object` 選填	SecretRef 是指包含憑證的 Secret。
`certificateReference.secretRef.name`
`string` 選填	命名空間中的名稱不得重複，用於參照密鑰資源。
`certificateReference.secretRef.namespace`
`string` 選填	命名空間會定義密鑰名稱不得重複的空間。
`conditions`
`list (object)` 選填	「條件」代表實體目前狀態的最新可用觀察結果。
`conditions[]`
`object` 選填	Conditions 包含這項 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` 必填	條件類型，採用駝峰式大小寫或 foo.example.com/CamelCase。許多 .condition.type 值在「可用」等資源中是一致的，但由於任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。比對的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
`criticalIncidents`
`object` 選填	CriticalIncidents 是所有未解決重大事件的平面清單。
`criticalIncidents[]`
`object` 選填	CriticalIncident 包含進行中重大事件的所有資訊。
`criticalIncidents[].code`
`string` 必填	Code 是這項特定錯誤的錯誤代碼。錯誤代碼為 DBSE+數字字串，例如「DBSE1012」。
`criticalIncidents[].createTime`
`string` 必填	CreateTime 是在來源建立這個事件的時間戳記。
`criticalIncidents[].message`
`string` 選填	訊息會說明發生的事件或錯誤。
`criticalIncidents[].messageTemplateParams`
`object` 選填	MessageTemplateParams 包含產生使用者介面中資料驅動型 Message 容易使用版本的必要鍵/值組合。
`criticalIncidents[].resource`
`object` 必填	資源包含回報事件的資料庫服務元件相關資訊，以及 Kubernetes 資源的相關資訊。
`criticalIncidents[].resource.component`
`string` 必填	元件是回報事件的資料庫服務子系統內部 ID。
`criticalIncidents[].resource.location`
`object` 選填	位置
`criticalIncidents[].resource.location.cluster`
`string` 選填	「Cluster」是受影響 Kubernetes 資源的叢集名稱。
`criticalIncidents[].resource.location.group`
`string` 選填	Group 是 Kubernetes 資源的群組名稱。
`criticalIncidents[].resource.location.kind`
`string` 選填	Kind 是 Kubernetes 資源的種類。
`criticalIncidents[].resource.location.name`
`string` 選填	Name 是受影響 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` 必填	條件類型，格式為駝峰式大小寫或 foo.example.com/CamelCase。許多 .condition.type 值在「可用」等資源中是一致的，但由於任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。比對的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
`latestFailoverStatus.status.createTime`
`string` 選填	CreateTime 是指建立內部容錯移轉工作流程機制的時間。
`latestFailoverStatus.status.criticalIncidents`
`object` 選填	CriticalIncidents 是所有有效重大事件的平面清單。
`latestFailoverStatus.status.criticalIncidents.code`
`string` 必填	Code 是這項特定錯誤的錯誤代碼。錯誤代碼為 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` 必填	元件是回報事件的資料庫服務子系統內部 ID。
`latestFailoverStatus.status.criticalIncidents.resource.location`
`object` 選填	位置
`latestFailoverStatus.status.criticalIncidents.resource.location.cluster`
`string` 選填	「Cluster」是受影響 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` 選填	Name 是受影響 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` 選填	內部則由系統控制器使用。請勿依賴本節中的資訊。
`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` 選填	State 是容錯移轉作業的目前狀態。值包括 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` 必填	Conditions 代表執行個體目前狀態的最新可用觀察結果。
`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` 必填	條件類型，格式為駝峰式大小寫或 foo.example.com/CamelCase。許多 .condition.type 值在「可用」等資源中是一致的，但由於任意條件可能很有用 (請參閱 .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` 選填	端點是用來建立資料庫連線的位址。已淘汰：改用「Endpoints」欄位。
`primary.endpoints`
`object` 選填	「端點」包含所有可存取這個執行個體的端點。
`primary.endpoints.name`
`string` 必填	「Name」(名稱) 包含端點名稱。
`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 是要匯出的資料庫叢集名稱，位於相同命名空間。
`primary.latestExport.spec.exportLocation`
`object` 必填	ExportLocation 會指定匯出檔案的儲存位置。請務必確保從運算子內部正確寫入儲存空間 bucket。
`primary.latestExport.spec.exportLocation.gcsOptions`
`object` 選填	GCSOptions 是指 Cloud Storage 依附選項。
`primary.latestExport.spec.exportLocation.gcsOptions.bucket`
`string` 必填	Bucket 為必填欄位，例如 dbs-dump-bucket。您必須確保 Operator 具備適當的儲存空間 bucket 寫入權限。
`primary.latestExport.spec.exportLocation.gcsOptions.key`
`string` 必填	傾印檔案的物件鍵，例如 ods-dump/scottschema.dmp。
`primary.latestExport.spec.exportLocation.gcsOptions.secretRef`
`object` 選填	SecretRef 是指儲存 Cloud Storage 存取資訊的 Secret。
`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` 必填	條件類型，採用駝峰式大小寫或 foo.example.com/CamelCase。許多 .condition.type 值在「可用」等資源中是一致的，但由於任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力非常重要。比對的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
`primary.latestExport.status.criticalIncidents`
`object` 選填	CriticalIncidents 是所有有效重大事件的平面清單。
`primary.latestExport.status.criticalIncidents.code`
`string` 必填	Code 是這項特定錯誤的錯誤代碼。錯誤代碼為 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` 必填	元件是回報事件的資料庫服務子系統內部 ID。
`primary.latestExport.status.criticalIncidents.resource.location`
`object` 選填	位置
`primary.latestExport.status.criticalIncidents.resource.location.cluster`
`string` 選填	「Cluster」是受影響 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` 選填	Name 是受影響 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，表示系統只會下載 dump 檔案，但不會匯入資料庫。預設值為 false。
`primary.latestImport.spec.dumpStorage`
`object` 必填	DumpStorage 會指定匯入傾印檔案的儲存位置。請務必確保 Operator 具備適當的儲存空間 bucket 讀取權限。
`primary.latestImport.spec.dumpStorage.gcsOptions`
`object` 選填	GCSOptions 是指 Cloud Storage 依附選項。
`primary.latestImport.spec.dumpStorage.gcsOptions.bucket`
`string` 必填	Bucket 為必填欄位，例如 dbs-dump-bucket。您必須確保 Operator 具備適當的儲存空間 bucket 寫入權限。
`primary.latestImport.spec.dumpStorage.gcsOptions.key`
`string` 必填	傾印檔案的物件鍵，例如 ods-dump/scottschema.dmp。
`primary.latestImport.spec.dumpStorage.gcsOptions.secretRef`
`object` 選填	SecretRef 是指儲存 Cloud Storage 存取資訊的 Secret。
`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 可選擇指定儲存空間位置，將匯入記錄複製到該位置。請務必確保從運算子內部正確寫入儲存空間 bucket。
`primary.latestImport.spec.logStorage.gcsOptions`
`object` 選填	GCSOptions 是指 Cloud Storage 依附選項。
`primary.latestImport.spec.logStorage.gcsOptions.bucket`
`string` 必填	Bucket 為必填欄位，例如 dbs-dump-bucket。您必須確保 Operator 具備適當的儲存空間 bucket 寫入權限。
`primary.latestImport.spec.logStorage.gcsOptions.key`
`string` 必填	dump 檔案的物件金鑰。
`primary.latestImport.spec.logStorage.gcsOptions.secretRef`
`object` 選填	SecretRef 是指儲存 Cloud Storage 存取資訊的 Secret。
`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` 必填	條件類型，採用駝峰式大小寫或 foo.example.com/CamelCase 格式。許多 .condition.type 值在各項資源中都一致 (例如 Available)，但由於任意條件可能很有用 (請參閱 .node.status.conditions)，因此必須能夠解決衝突。比對的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
`primary.latestImport.status.criticalIncidents`
`object` 選填	CriticalIncidents 是所有有效重大事件的平面清單。
`primary.latestImport.status.criticalIncidents.code`
`string` 必填	Code 是這項特定錯誤的錯誤代碼。錯誤代碼為 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` 必填	元件是回報事件的資料庫服務子系統內部 ID。
`primary.latestImport.status.criticalIncidents.resource.location`
`object` 選填	位置
`primary.latestImport.status.criticalIncidents.resource.location.cluster`
`string` 選填	「Cluster」是受影響 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` 選填	Name 是受影響 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 是下載的 dump 檔案路徑，僅適用於下載匯入。
`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 高可用性設定至少有 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 生態系統中的其他服務互動。如要進一步瞭解各項作業，包括所需權限，請參閱相關說明文件。

DBCluster v1.1.1 自訂資源定義 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

規格結構定義

狀態結構定義

DBCluster v1.1.1 自訂資源定義