調(diào)用UpdateEndpointGroups接口批量修改某個(gè)監(jiān)聽下的終端節(jié)點(diǎn)組。
接口說明
使用說明
- UpdateEndpointGroups 接口屬于異步接口,即系統(tǒng)會(huì)先返回一個(gè)請(qǐng)求 ID,但終端節(jié)點(diǎn)組配置信息并未修改完成,系統(tǒng)后臺(tái)的修改任務(wù)仍在進(jìn)行。您可以調(diào)用 DescribeEndpointGroup 或 ListEndpointGroups 查詢終端節(jié)點(diǎn)組的狀態(tài):
- 當(dāng)終端節(jié)點(diǎn)組處于 updating 狀態(tài)時(shí),表示終端節(jié)點(diǎn)組配置信息正在修改中,在該狀態(tài)下,您只能執(zhí)行查詢操作,不能執(zhí)行其他操作。
- 當(dāng)終端節(jié)點(diǎn)組處于 active 狀態(tài)時(shí),表示終端節(jié)點(diǎn)組配置信息修改完成。
- UpdateEndpointGroups 接口不支持在同一個(gè)全球加速實(shí)例內(nèi)并發(fā)修改終端節(jié)點(diǎn)組配置信息。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別:是指每個(gè)操作的訪問級(jí)別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
ga:UpdateEndpointGroups | update |
|
| 無 |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 全球加速實(shí)例所在的地域 ID,僅取值:cn-hangzhou。 | cn-hangzhou |
ClientToken | string | 否 | 客戶端 Token,用于保證請(qǐng)求的冪等性。 從您的客戶端生成一個(gè)參數(shù)值,確保不同請(qǐng)求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定,則系統(tǒng)自動(dòng)使用 API 請(qǐng)求的 RequestId 作為 ClientToken 標(biāo)識(shí)。每次 API 請(qǐng)求的 RequestId 不一樣。
| 123e4567-e89b-12d3-a456-426655440000 |
DryRun | boolean | 否 | 是否只預(yù)檢此次請(qǐng)求,取值:
| true |
EndpointGroupConfigurations | array<object> | 是 | 終端節(jié)點(diǎn)組配置信息。 | |
object | 是 | 終端節(jié)點(diǎn)組配置信息。 | ||
EndpointGroupName | string | 否 | 終端節(jié)點(diǎn)組的名稱。 名稱長(zhǎng)度為 1~128 個(gè)字符,以大小寫字母或中文開頭,可包含數(shù)字、半角句號(hào)(.)下劃線(_)和短劃線(-)。 | group1 |
EndpointGroupDescription | string | 否 | 終端節(jié)點(diǎn)組描述信息。 描述長(zhǎng)度最大 200 字符,不能以 http://和 https://開頭。 | group1 |
TrafficPercentage | long | 否 | 監(jiān)聽實(shí)例有多個(gè)終端節(jié)點(diǎn)組時(shí),配置到不同終端節(jié)點(diǎn)組的流量比例。 取值范圍:1~100。 | 20 |
HealthCheckEnabled | boolean | 否 | 是否開啟健康檢查。
| true |
HealthCheckIntervalSeconds | long | 否 | 健康檢查的時(shí)間間隔。單位:秒。取值范圍:1-50。 | 3 |
HealthCheckPath | string | 否 | 健康檢查路徑。 | /healthcheck |
HealthCheckPort | long | 否 | 健康檢查的端口。 取值范圍:1~65535。 | 20 |
HealthCheckProtocol | string | 否 | 健康檢查的協(xié)議。
| tcp |
ThresholdCount | long | 否 | 針對(duì)健康檢查狀態(tài)變化所需要的連續(xù)健康檢查次數(shù),即從成功到失敗的連續(xù)健康檢查失敗次數(shù)或從失敗到成功的連續(xù)健康檢查成功次數(shù)。 取值范圍:2~10。 | 3 |
EndpointConfigurations | array<object> | 否 | 終端節(jié)點(diǎn)配置信息。 | |
object | 是 | 終端節(jié)點(diǎn)配置信息。 | ||
Type | string | 是 | 終端節(jié)點(diǎn)類型。
說明
更多信息,請(qǐng)參見服務(wù)關(guān)聯(lián)角色。 | Ip |
Weight | long | 是 | 終端節(jié)點(diǎn)的權(quán)重。 取值范圍:0~255。 說明
如果某個(gè)終端節(jié)點(diǎn)的權(quán)重設(shè)置為 0,全球加速將終止向該終端節(jié)點(diǎn)分發(fā)流量,請(qǐng)您謹(jǐn)慎操作。
| 20 |
Endpoint | string | 是 | 根據(jù) Type(終端節(jié)點(diǎn)類型)輸入對(duì)應(yīng)的 IP、域名或?qū)嵗?ID。 | 47.0.XX.XX |
SubAddress | string | 否 | 彈性網(wǎng)卡的私網(wǎng) IP 地址。 說明
| 172.168.XX.XX |
EndpointRequestProtocol | string | 否 | 后端服務(wù)協(xié)議。取值:
說明
| HTTP |
EndpointProtocolVersion | string | 否 | 智能路由類型監(jiān)聽的終端節(jié)點(diǎn)后端服務(wù)協(xié)議版本。取值:
說明
僅當(dāng) EndpointRequestProtocol(終端節(jié)點(diǎn)后端服務(wù)協(xié)議)值為 HTTPS 時(shí),支持配置終端節(jié)點(diǎn)后端服務(wù)協(xié)議版本。
| HTTP1.1 |
PortOverrides | array<object> | 否 | 端口映射關(guān)系。 | |
object | 否 | 端口映射關(guān)系。 | ||
ListenerPort | long | 否 | 監(jiān)聽端口。 取值范圍:1~65499。 說明
| 443 |
EndpointPort | long | 否 | 終端節(jié)點(diǎn)端口。 取值范圍:1~65499。 | 80 |
EnableClientIPPreservationToa | boolean | 否 | 是否使用 TOA 方式保留客戶端源 IP。取值:
| false |
EnableClientIPPreservationProxyProtocol | boolean | 否 | 是否使用 ProxyProtocol 方式保留客戶端源 IP。取值:
| false |
EndpointGroupId | string | 是 | 終端節(jié)點(diǎn) ID。 | ep-bp1d2utp8qqe2a44t**** |
ListenerId | string | 是 | 監(jiān)聽實(shí)例 ID。 | lsr-bp1bpn0kn908w4nbw**** |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
"EndpointGroupIds": [
"epg-bp1dmlohjjz4kqaun****"
]
}
錯(cuò)誤碼
HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
400 | NoPermission.EnableHealthCheck | You do not have permission to enable health check. | 該賬號(hào)沒有啟用健康檢查的權(quán)限。 |
400 | NotExist.EndPointGroup | The endpoint group does not exist. | 終端節(jié)點(diǎn)組不存在 |
400 | StateError.EndPointGroup | The specified state of endpoint group is invalid. | 終端節(jié)點(diǎn)組狀態(tài)非法 |
400 | NotExist.Listener | The listener does not exist. | 監(jiān)聽器不存在 |
400 | NotActive.Listener | The state of the listener is not active. | 監(jiān)聽器狀態(tài)非穩(wěn)態(tài) |
400 | NotExist.Accelerator | The accelerated instance does not exist. | 加速實(shí)例不存在。 |
400 | StateError.Accelerator | The state of the accelerated instance is invalid. | 加速實(shí)例狀態(tài)非法。 |
400 | QuotaExceeded.EndPoint | The maximum number of endpoints is exceeded. | 終端節(jié)點(diǎn)達(dá)到Quota限制 |
400 | NoPermission.VpcEndpoint | You are not authorized to perform the operation. | 用戶沒有創(chuàng)建服務(wù)關(guān)聯(lián)角色的權(quán)限,請(qǐng)聯(lián)系主賬號(hào)或權(quán)限管理員授權(quán)當(dāng)前用戶AliyunGlobalAccelerationFullAccess或者創(chuàng)建服務(wù)關(guān)聯(lián)角色的自定義權(quán)限。自定義權(quán)限策略的相關(guān)信息包含以下內(nèi)容:ServiceName為vpcendpoint.ga.aliyuncs.com,服務(wù)關(guān)聯(lián)角色名稱為AliyunServiceRoleForGaVpcEndpoint,執(zhí)行該操作所需的用戶權(quán)限為ram:CreateServiceLinkedRole。 |
400 | EndPointRequestProtocolIllegal.EndpointGroup | endpoint group request protoco is illegal | - |
400 | QuotaExceeded.PortOverride | The number of port override exceeds the limit. | 端口轉(zhuǎn)發(fā)數(shù)量超過限制 |
400 | NotExist.ListenerPort | listener port %s is not exist | - |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-07-20 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
2023-11-22 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
2023-09-14 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |