日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

CreateDBClusterEndpoint - 創建自定義集群地址

創建PolarDB自定義集群地址。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

當前API暫無授權信息透出。

請求參數

名稱類型必填描述示例值
DBClusterIdstring

集群 ID。

pc-**************
EndpointTypestring

自定義集群地址類型,取值固定為 Custom

Custom
Nodesstring

加入目標地址的讀負載節點,多個節點間用英文逗號(,)分隔。 默認為全部節點。

說明
  • PolarDB MySQL 版需要傳入節點 ID。
  • PolarDB PostgreSQL 版和 PolarDB PostgreSQL 版(兼容 Oracle)需要傳入節點角色名稱,例如Writer,Reader1,Reader2
  • ReadWriteMode 取值為 ReadOnly 時,支持只掛載一個節點。但當此節點故障時,該地址可能會有最多 1 小時的不可用,請勿用于生產環境。因此,推薦至少選擇 2 個節點,以提升可用性。
  • ReadWriteMode 取值為 ReadWrite 時,至少要選擇 2 個節點。 * PolarDB MySQL 版支持選擇任意兩個節點。當兩個節點都是只讀節點時,寫請求都會發往主節點。 * PolarDB PostgreSQL 版和 PolarDB PostgreSQL 版(兼容 Oracle)必須包含主節點。
  • pi-**********,pi-*********
    ReadWriteModestring

    讀寫模式,取值范圍如下:

    • ReadWrite:可讀可寫(自動讀寫分離)。
    • ReadOnly(默認):只讀。
    ReadOnly
    AutoAddNewNodesstring

    新節點是否自動加入本地址,取值范圍如下:

    • Enable:新節點自動加入本地址。
    • Disable(默認):新節點不自動加入本地址。
    Disable
    EndpointConfigstring

    集群地址的高級配置,格式為 JSON,目前支持設置一致性級別、事務拆分、主庫不接受讀和連接池。

    • 設置負載均衡策略。格式為{"LoadBalancePolicy":"負載均衡策略"}。取值范圍如下:
      • 0:基于連接數負載均衡(默認)。
      • 1:基于活躍請求數負載均衡。
    • 設置一致性級別。格式為{"ConsistLevel":"一致性級別"},取值范圍如下:
      • 0:最終一致性。
      • 1:會話一致性(默認值)。
      • 2:全局一致性。
    • 設置事務拆分。格式為{"DistributedTransaction":"事務拆分"},取值范圍如下:
      • on:開啟事務拆分(默認值)。
      • off:關閉事務拆分。
    • 設置主庫是否接受讀。格式為{"MasterAcceptReads":"主庫不接受讀"},取值范圍如下:
      • on:表示主庫接受讀。
      • off:表示主庫不接受讀(默認值)。
    • 設置連接池。格式為{"ConnectionPersist":"連接池"},取值范圍如下:
      • off:關閉連接池(默認值)。
      • Session:開啟會話級連接池。
      • Transaction:開啟事務級連接池。
    • 設置并行查詢,格式為{"MaxParallelDegree":"并行查詢"}。取值范圍如下:
      • 具體的并發數量。示例:"MaxParallelDegree":"2"。
      • off:關閉并行查詢(默認)。
    • 設置行存/列存自動引流,格式為{"EnableHtapImci":"行存/列存自動引流"}。取值范圍如下:
      • on:開啟行存/列存自動引流功能。
      • off:關閉行存/列存自動引流功能(默認)。
    • 設置是否開啟過載保護,格式為{"EnableOverloadThrottle":"是否開啟過載保護"}。取值范圍如下:
      • on:開啟過載保護。
      • off:關閉過載保護(默認)。
    說明
  • 僅當 PolarDB MySQL 版集群地址的讀寫模式為**可讀可寫(自動讀寫分離)**時,支持設置事務拆分、主庫是否接受讀、連接池和是否開啟過載保護。
  • 當 PolarDB MySQL 版集群地址的讀寫模式為只讀時,支持基于連接數負載均衡基于活躍請求數負載均衡兩種負載均衡策略; 可讀可寫(自動讀寫分離)模式的集群地址僅支持基于活躍請求數負載均衡策略
  • 當 PolarDB MySQL 版集群地址的讀寫模式為可讀可寫(自動讀寫分離),或集群地址的讀寫模式為只讀且負載均衡策略為基于活躍請求數負載均衡時,支持設置行存/列存自動引流。
  • 僅 PolarDB MySQL 版支持將一致性級別設置為全局一致性。
  • 如果參數 ReadWriteMode 取值為 ReadOnly,一致性級別取值只能為 0
  • 您可以同時設置一致性級別、事務拆分、主庫不接受讀和連接池,例如{"ConsistLevel":"1","DistributedTransaction":"on","ConnectionPersist":"Session","MasterAcceptReads":"on"}
  • 事務拆分的設置受一致性級別設置的約束。例如一致性級別取值為 0 時,不支持開啟事務拆分;一致性級別取值為 12 時,支持開啟事務拆分。
  • {"ConsistLevel": "1","DistributedTransaction": "on"}
    ClientTokenstring

    用于保證請求的冪等性,防止重復提交請求。由客戶端生成該參數值,保證在不同請求間唯一,大小寫敏感、不超過 64 個 ASCII 字符。

    6000170000591aed949d0f******************
    DBEndpointDescriptionstring

    自定義集群地址名稱。

    test
    SccModestring

    節點是否開啟全局一致性(高性能模式)功能。取值范圍如下:

    • ON:開啟

    • OFF:關閉

    枚舉值:
    • on
    • off
    on
    PolarSccWaitTimeoutstring

    全局一致性超時時間

    100
    PolarSccTimeoutActionstring

    全局一致性超時策略。取值范圍如下:

    • 0:發送該請求到主節點

    • 2:超時降級,當全局一致性讀超時后,本次查詢操作會自動降級為非一致性讀取,且客戶端不會收到報錯信息

    0

    返回參數

    名稱類型描述示例值
    object
    RequestIdstring

    請求 ID。

    CD35F3-F3-44CA-AFFF-BAF869******

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "CD35F3-F3-44CA-AFFF-BAF869******"
    }

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400ClusterEndpoint.StatusNotValidCluster endpoint status is not valid.集群地址的狀態無效.
    400EndpointNum.ErrorEndpoint number error.Endpoint數量超過限制
    400LockTimeoutThe request processing has failed due to lock timeout.由于鎖定超時,請求處理失敗
    404EndpointConfig.InvalidEndpoint config is invalid.集群地址的高級配置參數無效
    404InvalidDBClusterId.NotFoundThe DBClusterId provided does not exist in our records.當前的記錄中不存在提供的 DBClusterId。
    404EndpointConfig.ConflictEndpoint config is invalid, CausalConsistRead should be session since node SCC mode enabled.Endpoint配置無效,CausalConsistRead應為會話,因為節點的全局一致性(高性能模式)已啟用。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內容概要操作
    2024-07-30OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情
    2022-11-24OpenAPI 錯誤碼發生變更查看變更詳情
    2022-09-28OpenAPI 錯誤碼發生變更查看變更詳情
    2022-07-13OpenAPI 錯誤碼發生變更查看變更詳情
    2022-04-25OpenAPI 錯誤碼發生變更查看變更詳情