更新負載均衡實例可用區(qū)。
接口說明
- UpdateLoadBalancerZones 屬于異步接口，即系統(tǒng)返回一個請求 ID，但該實例可用區(qū)及可用區(qū)屬性尚未修改成功，系統(tǒng)后臺的變更任務仍在進行。您可以調用 GetLoadBalancerAttribute 查詢網關型負載均衡實例的更新狀態(tài)：
- 當網關型負載均衡實例處于 Configuring 狀態(tài)時，表示網關型負載均衡實例正在更新中。
- 當網關型負載均衡實例處于 Active 狀態(tài)時，表示網關型負載均衡實例更新成功。
注意 每次調用該接口時，請確保您傳入該網關型負載均衡實例的所有可用區(qū)參數(shù)，包括當前和新增的可用區(qū)。如您未傳入當前的可用區(qū)參數(shù)，表示需要將當前可用區(qū)刪除。您可以通過 GetLoadBalancerAttribute 接口查詢該實例的當前可用區(qū)。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯(lián)操作：是指成功執(zhí)行操作所需要的其他權限。操作者必須同時具備關聯(lián)操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯(lián)操作 |
|---|---|---|---|---|
| gwlb:UpdateLoadBalancerZones | update | *LoadBalancer acs:gwlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}*VSwitch acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| LoadBalancerId | string | 是 | 網關型負載均衡實例的 ID。 | gwlb-9njtjmqt7zfcqm**** |
| ZoneMappings | array<object> | 是 | 可用區(qū)及交換機映射列表。至少需要添加一個可用區(qū)，最多支持添加 20 個可用區(qū)。若當前地域支持 2 個及以上的可用區(qū)，建議添加 2 個及以上可用區(qū)。 | |
| ZoneEniModel | object | 是 | ||
| VSwitchId | string | 是 | 可用區(qū)對應的交換機，每個可用區(qū)只能使用一臺交換機和一個子網。 | vsw-bp1n75pbs77v5q6p3**** |
| ZoneId | string | 是 | 可用區(qū) ID，通過調用網關型負載均衡 DescribeZones 接口獲得。 | cn-hangzhou-h |
| DryRun | boolean | 否 | 是否只預檢此次請求。取值：
| false |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 由客戶端生成該參數(shù)值，要保證在不同請求間唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統(tǒng)自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 123e4567-e89b-12d3-a456-42665544**** |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "ED8905C2-A4F6-5E43-87B7-6A5DC8757146"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | OperationDenied.VSwitchChangeNotSupport | The operation is not allowed because of VSwitchChangeNotSupport. | 修改交換機Vswitch操作不支持 |
| 400 | DuplicatedParam.VSwitchId | The param of VSwitchId is duplicated. | 列表中的VSwitchId參數(shù)重復 |
| 400 | DuplicatedParam.ZoneId | The param of ZoneId is duplicated. | 列表中的ZoneId參數(shù)重復 |
| 400 | IllegalParamSize.ZoneMappings | The param size of ZoneMappings is illegal. | ZoneMappings列表數(shù)量不合法 |
| 400 | IncorrectBusinessStatus.LoadBalancer | The business status of %s [%s] is incorrect. | 資源%s業(yè)務狀態(tài)%s不支持當前操作 |
| 400 | IncorrectStatus.LoadBalancer | The status of %s [%s] is incorrect. | 資源%s當前狀態(tài)%s不支持操作 |
| 400 | Mismatch.ZoneIdAndVSwitchId | The ZoneId and VSwitchId are mismatched. | 參數(shù)ZoneId和VSwitchId的值不匹配 |
| 400 | MissingParam.LoadBalancerId | The param of LoadBalancerId is missing. | 負載均衡ID參數(shù)缺失 |
| 400 | OperationDenied.VSwitchNotSupportIpv6 | The operation is not allowed because of VSwitchNotSupportIpv6. | 交換機Vswitch沒有開啟IPv6，操作不支持 |
| 400 | ResourceAlreadyAssociated.GwlbeAssociated | The specified resource of %s is already associated. | 指定資源%s已被關聯(lián) |
| 400 | ResourceNotEnough.VSwitchIp | The specified resource of VSwitchIp is not enough. | VSwitch IP資源不足 |
| 400 | ResourceNotFound.LoadBalancer | The specified resource of %s is not found. | 指定的負載均衡資源不存在 |
訪問錯誤中心查看更多錯誤碼。