規格結構定義
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 的 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 的預設資料庫容器映像檔。建議 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選填 | 排程器會優先排程符合這個欄位中指定親和性運算式的節點。排程器仍可能會選擇未完全符合條件的節點。總權重最高的節點會優先採用。計算這個權重時,會加總滿足所有排程需求的每個節點值 (例如資源要求或 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選填 | Location | 
| 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選填 | Location | 
| 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。 
 | 
| 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選填 | Location | 
| 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選填 | Location | 
| 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 生態系統中的其他服務互動。如要進一步瞭解各項作業,包括所需權限,請參閱相關說明文件。 |