阿里云-負(fù)載均衡服務(wù)API手冊(cè)-D

1、負(fù)載均衡API使用手冊(cè)負(fù)載均衡/API使用手冊(cè)負(fù)載均衡/API使用手冊(cè) PAGE 109 PAGE 109API使用手冊(cè)簡介歡迎使用阿里云負(fù)載均衡服務(wù)（Server Load Balancer）。負(fù)載均衡服務(wù)通過設(shè)置虛擬服務(wù)地址（IP），將位于同一地域（Region）的多臺(tái)云服務(wù)器資源虛擬成一個(gè)高性能、高可用的應(yīng)用服務(wù)池；再根據(jù)應(yīng)用指定的方式，將來自客戶端的網(wǎng)絡(luò)請(qǐng)求分發(fā)到云服務(wù)池中。阿里云負(fù)載均衡服務(wù)會(huì)檢查服務(wù)池中云服務(wù)器的健康狀態(tài)，自動(dòng)隔離異常狀態(tài)云服務(wù)器，從而解決了單臺(tái)云服 務(wù)器的單點(diǎn)問題，同時(shí)提高了應(yīng)用的整體服務(wù)能力。在標(biāo)準(zhǔn)的負(fù)載均衡功能之外，負(fù)載均衡服務(wù)還具備TCP與HTTP抗DDoS

2、攻擊的特性，增強(qiáng)了應(yīng)用服務(wù)器的防護(hù)能力。阿里云負(fù)載均衡服務(wù)是云服務(wù)器面向多機(jī)方案的一個(gè)配套服務(wù)，需要同云服務(wù)器結(jié)合使用。 請(qǐng)確保在使用這些接口前，已充分了解負(fù)載均衡產(chǎn)品說明、使用協(xié)議和收費(fèi)方式。負(fù)載均衡API概念結(jié)構(gòu)圖- 阿里云負(fù)載均衡API主要由3個(gè)基本概念組成。LoadBalancer代表一個(gè)負(fù)載均衡實(shí)例Listener代表用戶定制的負(fù)載均衡策略和轉(zhuǎn)發(fā)規(guī)則BackendServer是后端的一組云服務(wù)器。來自外部的訪問請(qǐng)求，通過負(fù)載均衡實(shí)例并根據(jù)相關(guān)的策略和轉(zhuǎn)發(fā)規(guī)則分發(fā)到后端云服務(wù)器進(jìn)行處理。術(shù)語表術(shù)語全稱中文說明負(fù)載均衡Server Load Balancer負(fù)載均衡服務(wù)阿里云計(jì)算提供的一

3、種網(wǎng)絡(luò)負(fù)載均衡服務(wù)，可以結(jié)合阿里云提供的ECS服務(wù)為用戶提供基于ECS實(shí)例的TCP與HTTP負(fù)載均衡服務(wù)。Region地域代表資源所在的地域，每個(gè)地域包含一組數(shù)據(jù)中心。LoadBalancerLoad Balancer負(fù)載均衡服務(wù)實(shí)例負(fù)載均衡實(shí)例可以理解為負(fù)載均衡服務(wù)的一個(gè)運(yùn)行實(shí)例，用戶要使用負(fù)載均衡服務(wù)，就必須先創(chuàng)建一個(gè)負(fù)載均衡實(shí)例，LoadBalancerId是識(shí)別用戶負(fù)載均衡實(shí)例的唯一標(biāo)識(shí)。ListenerListener負(fù)載均衡服務(wù)監(jiān)聽。負(fù)載均衡服務(wù)監(jiān)聽，包括監(jiān)聽端口、負(fù)載均衡策略和健康檢查配置等。BackendServerBackend Server后端服務(wù)器。接受負(fù)載均衡分發(fā)請(qǐng)求的

4、一組云服務(wù)器，負(fù)載均衡服務(wù)將外部的訪問請(qǐng)求按照用戶設(shè)定的規(guī)則轉(zhuǎn)發(fā)到這一組后端服務(wù)器上進(jìn)行處理。業(yè)務(wù)限制資源規(guī)格限制說明阿里云負(fù)載均衡服務(wù)對(duì)每個(gè)用戶可擁有的負(fù)載均衡實(shí)例（LoadBalancer）數(shù)量、實(shí)例上的監(jiān)聽（Listener）數(shù) OpenAPI時(shí)，請(qǐng)參考官網(wǎng)上最新的業(yè)務(wù)限制規(guī)則和資源規(guī)格限制。查詢鏈接在本文檔的接口說明部分，凡出現(xiàn)對(duì)參數(shù)可選值、可用規(guī)格等方面與官網(wǎng)上給出的資源規(guī)格限制發(fā)生矛盾時(shí)，均以官網(wǎng)上給出的值為準(zhǔn)。API概覽LoadBalancer相關(guān)APIAPI描述CreateLoadBalancer創(chuàng)建LoadBalancer，根據(jù)參數(shù)生成負(fù)載均衡實(shí)例，分配服務(wù)地址和LoadBa

5、lancerIdModifyLoadBalancerInternetSpec修改LoadBalancer規(guī)格，根據(jù)參數(shù)修改負(fù)載均衡實(shí)例的計(jì)費(fèi)方式或規(guī)格DeleteLoadBalancer刪除LoadBalancer，根據(jù)參數(shù)刪除負(fù)載均衡實(shí)例，并清除負(fù)載均衡實(shí)例相關(guān)的配置SetLoadBalancerStatus配置LoadBalancer狀態(tài)，啟用或停用負(fù)載均衡實(shí)例SetLoadBalancerName配置LoadBalancer的別名DescribeLoadBalancers查詢用戶創(chuàng)建的所有負(fù)載均衡實(shí)例列表DescribeLoadBalancerAttribute查詢負(fù)載均衡實(shí)例信息Des

6、cribeRegions查詢可用的地域ServerCertificate相關(guān)APIUploadServerCertificate上傳安全證書DeleteServerCertificate刪除安全證書DescribeServerCertificates查詢安全證書SetServerCertificateName設(shè)置證書名稱Listener相關(guān)APIAPI描述CreateLoadBalancerHTTPListener創(chuàng)建HTTP Listener，為負(fù)載均衡實(shí)例創(chuàng)建基于HTTP協(xié)議的ListenerCreateLoadBalancerHTTPSListener創(chuàng)建HTTPS Listener，為

7、負(fù)載均衡實(shí)例創(chuàng)建基于HTTPS協(xié)議的ListenerCreateLoadBalancerTCPListener創(chuàng)建TCP Listener，為負(fù)載均衡實(shí)例創(chuàng)建基于TCP協(xié)議的ListenerCreateLoadBalanceUDPListener創(chuàng)建UDP Listener，為負(fù)載均衡實(shí)例創(chuàng)建基于UDP協(xié)議的ListenerDeleteLoadBalancerListener刪除Listener，將指定ListenerPort對(duì)應(yīng)的Listener刪除StartLoadBalancerListener啟動(dòng)指定的監(jiān)聽服務(wù)StopLoadBalancerListener停止指定的監(jiān)聽服務(wù)SetLo

8、adBalancerHTTPListenerAttribute配置HTTP Listener，為基于HTTP協(xié)議的負(fù)載均衡實(shí)例配置一系列策略和規(guī)則SetLoadBalancerHTTPSListenerAttribute配置HTTPS Listener，為基于HTTPS協(xié)議的負(fù)載均衡實(shí)例配置一系列策略和規(guī)則SetLoadBalancerTCPListenerAttribute配置TCP Listener，為基于TCP協(xié)議的負(fù)載均衡實(shí)例配置一系列策略和規(guī)則SetLoadBalancerUDPListenerAttribute配置UDP Listener，為基于UDP協(xié)議的負(fù)載均衡實(shí)例配置一系列策

9、略和規(guī)則SetListenerAccessControlStatus為指定監(jiān)聽開啟或關(guān)閉訪問控制功能DescribeLoadBalancerHTTPListenerAttributes查詢HTTP Listener信息，查詢基于HTTP協(xié)議的負(fù)載均衡實(shí)例當(dāng)前執(zhí)行的一系列策略和規(guī)則DescribeLoadBalancerHTTPSListenerAttribute查詢HTTPS Listener信息，查詢基于HTTPS協(xié)議的負(fù)載均衡實(shí)例當(dāng)前執(zhí)行的一系列策略和規(guī)則DescribeLoadBalancerTCPListenerAttribute查詢TCP Listener信息，查詢基于TCP協(xié)議的負(fù)

10、載均衡實(shí)例當(dāng)前執(zhí)行的一系列策略和規(guī)則DescribeLoadBalancerUDPListenerAttribute查詢UDP Listener信息，查詢基于UDP協(xié)議的負(fù)載均衡實(shí)例當(dāng)前執(zhí)行的一系列策略和規(guī)則DescribeListenerAccessControlAttribute查詢指定監(jiān)聽的訪問控制配置信息AddListenerWhiteListItem從指定監(jiān)聽的訪問控制列表中添加ip或ip段，該接口支持增量更新RemoveListenerWhiteListItem從指定監(jiān)聽的訪問控制列表中刪除ip或ip段，該接口支持增量更新BackendServer相關(guān)APIAPI描述AddBack

11、endServers添加后端服務(wù)器，為負(fù)載均衡實(shí)例添加一組后端服務(wù)器RemoveBackendServers刪除后端服務(wù)器，從負(fù)載均衡實(shí)例中刪除一組后端服務(wù)器SetBackendServers配置后端服務(wù)器權(quán)重DescribeHealthStatus后端服務(wù)器健康檢查，對(duì)負(fù)載均衡實(shí)例的后端服務(wù)器進(jìn)行健康檢查，返回后端服務(wù)器的健康狀況調(diào)用方式調(diào)用方式對(duì)負(fù)載均衡API接口調(diào)用是通過向負(fù)載均衡API的服務(wù)端地址發(fā)送HTTP GET請(qǐng)求，并按照接口說明在請(qǐng)求中加入相應(yīng)請(qǐng)求參數(shù)來完成的；根據(jù)請(qǐng)求的處理情況，系統(tǒng)會(huì)返回處理結(jié)果。- 主要根據(jù)以下四點(diǎn)來說明：請(qǐng)求結(jié)構(gòu)公共參數(shù)返回結(jié)果簽名機(jī)制請(qǐng)求結(jié)構(gòu)服務(wù)地址負(fù)

12、載均衡 API的服務(wù)接入地址為： 通信協(xié)議支持通過HTTP或HTTPS通道進(jìn)行請(qǐng)求通信。為了獲得更高的安全性，推薦您使用HTTPS通道發(fā)送請(qǐng) 求。請(qǐng)求方法支持HTTP GET方法發(fā)送請(qǐng)求，這種方式下請(qǐng)求參數(shù)需要包含在請(qǐng)求的URL中。請(qǐng)求參數(shù)每個(gè)請(qǐng)求都需要指定要執(zhí)行的操作，即Action參數(shù)（例如DescribeLoadBalancerAttribute），以及 每個(gè)操作都需要包含的公共請(qǐng)求參數(shù)和指定操作所特有的請(qǐng)求參數(shù)。字符編碼請(qǐng)求及返回結(jié)果都使用UTF-8字符集進(jìn)行編碼。公共參數(shù)公共請(qǐng)求參數(shù)公共請(qǐng)求參數(shù)是指每個(gè)接口都需要使用到的請(qǐng)求參數(shù)。名稱類型是否必須描述FormatString否返回消息

13、的格式化方式； 取 值 ：JSON or XML；默認(rèn)值：XMLVersionString是版本號(hào)為日期形式：YYYY-MM-DD。本版本對(duì)應(yīng)為2014-05- 15。AccessKeyIdString是阿里云頒發(fā)給用戶的訪問服務(wù)所用的密鑰 ID。取值：請(qǐng)?jiān)诎⒗镌乒倬W(wǎng)的用戶中心-我的服務(wù)-安全認(rèn)證頁面中查看和申請(qǐng)。SignatureString是簽名結(jié)果串，關(guān)于簽名的計(jì)算方法，請(qǐng)參見簽名機(jī)制。SignatureMethodString是簽名方式，目前支持HMAC-SHA1，取值：HMAC-SHA1TimestampString是請(qǐng)求的時(shí)間戳。日期格式按照ISO8601標(biāo)準(zhǔn)表示，并需要使用UTC

14、時(shí)間。格式為：YYYY-MM-DDThh:mm:ssZ；例如 ，2013-01- 10T12:00:00Z（為北京時(shí)間2013年1月10日20點(diǎn)0分0秒SignatureVersionString是簽名算法版本，目前版本是1.0，取值：1.0SignatureNonceString是唯一隨機(jī)數(shù)，用于防止網(wǎng)絡(luò)重放攻擊。用戶在不同請(qǐng)求間要使用不同的隨機(jī)數(shù)值。 HYPERLINK /?TimeStamp=2014-05-19T10%3A33%3A56Z /?TimeStamp=2014-05-19T10%3A33%3A56Z HYPERLINK /?TimeStamp=2014-05-19T10%3

15、A33%3A56Z /?TimeStamp=2014-05-19T10%3A33%3A56Z &Format=xml&AccessKeyId=testid &Action=DescribeLoadBalancerAttribute &SignatureMethod=Hmac-SHA1 &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 &SignatureNonce=NwDAxvLU6tFE0DVb &Version=2014-05-15&SignatureVersion=1.0 &Signature=FZnIrdNSLax4lnWf6NkKDc7m

16、p54%3D公共返回參數(shù)用戶發(fā)送的每次接口調(diào)用請(qǐng)求，無論成功與否，系統(tǒng)都會(huì)返回一個(gè)唯一識(shí)別碼RequestID給用戶。4C467B38-3910-447D-87BC-AC049166F216返回結(jié)果調(diào)用API服務(wù)后返回?cái)?shù)據(jù)采用統(tǒng)一格式，返回的HTTP狀態(tài)碼為2xx，代表調(diào)用成功；返回4xx或5xx的HTTP狀態(tài) 碼代表調(diào)用失敗。調(diào)用成功返回的數(shù)據(jù)格式主要有XML和JSON兩種，外部系統(tǒng)可以在請(qǐng)求時(shí)傳入?yún)?shù)來制定 返回的數(shù)據(jù)格式，默認(rèn)為XML格式。本文檔中的返回示例為了便于用戶查看，做了格式化處理，實(shí)際返回結(jié)果 是沒有進(jìn)行換行、縮進(jìn)等處理的。成功結(jié)果XML示例4C467B38-3910-447D

17、-87BC-AC049166F216RequestId:4C467B38-3910-447D-87BC-AC049166F216,/*返回結(jié)果數(shù)據(jù)*/RequestId:4C467B38-3910-447D-87BC-AC049166F216,/*返回結(jié)果數(shù)據(jù)*/錯(cuò)誤結(jié)果調(diào)用接口出錯(cuò)后，將不會(huì)返回結(jié)果數(shù)據(jù)。調(diào)用方可根據(jù)附表錯(cuò)誤代碼表來定位錯(cuò)誤原因。當(dāng)調(diào)用出錯(cuò)時(shí)，HTTP請(qǐng)求返回一個(gè)4xx或5xx的HTTP狀態(tài)碼。返回的消息體中是具體的錯(cuò)誤代碼及錯(cuò)誤信息。 另外還包含一個(gè)全局唯一的請(qǐng)求ID：RequestID和一個(gè)您該次請(qǐng)求訪問的站點(diǎn)ID：HostID。在調(diào)用方找不到錯(cuò) 誤原因，可以聯(lián)系阿里云客

18、服，并提供該HostID和RequestID，以便我們盡快幫您解決問題。8906582E-6722-409A-A6C4-0E7863B733A5UnsupportedOperationThe specified action is not supported.JSON示例RequestId:7463B73D-35CC-4D19-A010-6B8D65D242EF,HostId:, Code:UnsupportedOperation,Message:The specified action is not supported.簽名機(jī)制負(fù)載均衡服務(wù)會(huì)對(duì)每個(gè)訪問的請(qǐng)求進(jìn)行身份驗(yàn)證，所以無論使用HTTP

19、還是HTTPS協(xié)議提交請(qǐng)求，都需要在請(qǐng)求中包含簽名（Signature）信息。負(fù)載均衡通過使用Access Key ID和Access Key Secret進(jìn)行對(duì)稱加密的方法來驗(yàn)證請(qǐng)求的發(fā)送者身份。Access Key ID和Access Key Secret由阿里云官方頒發(fā)給訪問者（可以通過阿里云官方網(wǎng)站申請(qǐng)和管理），其中Access Key ID用于標(biāo)識(shí)訪問者的身份；Access Key Secret是用于加密簽名字符串和服務(wù)器端驗(yàn)證簽名字符串的密鑰，必須嚴(yán)格保密，只有阿里云和用戶知道。簽名方法用戶在訪問時(shí)，按照下面的方法對(duì)請(qǐng)求進(jìn)行簽名處理。使用請(qǐng)求參數(shù)構(gòu)造規(guī)范化的請(qǐng)求字符串（Canoni

20、calized Query String）按照參數(shù)名稱的字典順序?qū)φ?qǐng)求中所有的請(qǐng)求參數(shù)（包括文檔中描述的公共請(qǐng)求參數(shù)和 給定了的請(qǐng)求接口的自定義參數(shù)，但不能包括公共請(qǐng)求參數(shù)中提到Signature參數(shù)本身）進(jìn)行排序。 注：當(dāng)使用GET方法提交請(qǐng)求時(shí)，這些參數(shù)就是請(qǐng)求URI中的參數(shù)部分（即URI中?之后由&連接的部分）。A-Z、a-z、0-9以及字符-、_、.、不編碼；A-Z、a-z、0-9以及字符-、_、.、不編碼；對(duì)于其他字符編碼成%XY的格式，其中XY是字符對(duì)應(yīng)ASCII碼的16進(jìn)制表示。比如英文的雙引號(hào)（）對(duì)應(yīng)的編碼就是%22對(duì)于ASCII字符之外的UTF-8字符，在進(jìn)行UTF-8編碼后

21、按照兩個(gè)字節(jié)按（ii）描述的方式編碼；需要說明的是英文空格（）要被編碼是%20，而不是加號(hào)（+）。注：一般支持URL編碼的庫（比如Java中的.URLEncoder）都是按照application/x-www- 類型的規(guī)則進(jìn)行編碼的。實(shí)現(xiàn)時(shí)可以直接使用這類方式進(jìn)行編碼，把編碼后 的字符串中加號(hào)（+）替換成%20、星號(hào)（*）替換成%2A、%7E替換回波浪號(hào)（），即可得到上述規(guī) 則描述的編碼字符串。對(duì)編碼后的參數(shù)名稱和值使用英文等號(hào)（=）進(jìn)行連接。再把英文等號(hào)連接得到的字符串按參數(shù)名稱的字典順序依次使用&符號(hào)連接，即得到規(guī)范 化請(qǐng)求字符串。StringToSign= HTTPMethod + &

22、+ percentEncode(/) + & +percentEncode(CanonicalizedQueryString)StringToSign= HTTPMethod + & + percentEncode(/) + & +percentEncode(CanonicalizedQueryString)其中HTTPMethod是提交請(qǐng)求用的HTTP方法，比GET。 percentEncode(/)是按照1.b中描述的URL編碼規(guī)則對(duì)字符/進(jìn)行編碼得到的值，即%2F。percentEncode(CanonicalizedQueryString)是對(duì)第1步中構(gòu)造的規(guī)范化請(qǐng)求字符串按1.b中描

23、述的URL編碼規(guī)則編碼后得到的字符串。按照RFC2104的定義，使用上面的用于簽名的字符串計(jì)算簽名HMAC值。注意：計(jì)算簽名時(shí)使用的Key就是用戶持有的Access Key Secret并加上一個(gè)&字符(ASCII:38)，使用的哈希算法是SHA1。按照Base64編碼規(guī)則把上面的HMAC值編碼成字符串，即得到簽名值（Signature）。將得到的簽名值作為Signature參數(shù)添加到請(qǐng)求參數(shù)中，即完成對(duì)請(qǐng)求簽名的過程。 注意：得到的簽名值在作為最后的請(qǐng)求參數(shù)值提交給ECS服務(wù)器的時(shí)候，要和其他參數(shù)一樣，按照RFC3986的規(guī)則進(jìn) 行URL編碼）。簽名示例 HYPERLINK /?TimeSt

24、amp=2014-05-19T10%3A33%3A56Z /?TimeStamp=2014-05-19T10:33:56Z HYPERLINK /?TimeStamp=2014-05-19T10%3A33%3A56Z /?TimeStamp=2014-05-19T10:33:56Z &Format=xml&AccessKeyId=testid &Action=DescribeLoadBalancerAttribute &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 &SignatureMethod=Hmac-SHA1 &SignatureNonc

25、e=NwDAxvLU6tFE0DVb &Version=2014-05-15&SignatureVersion=1.0那么StringToSign就是：GET&%2F&AccessKeyID%3DtestidGET&%2F&AccessKeyID%3Dtestid%26Action%3DDescribeLoadBalancerAttribute%26Format%3Dxml%26SignatureMethod%3DHmac-SHA1%26SignatureNonce%3DNwDAxvLU6tFE0DVb%26SignatureVersion%3D1.0%26Timestamp%3D2014-0

26、5-19T10%253A33%253A56Z%26Version%3D2014-05-15%26LoadBalancerId%3D139a00604ad-cn-east-hangzhou-01假如使用的Access Key Id是testid，Access Key Secret是testsecret，用于計(jì)算HMAC的Key就是testsecret，則計(jì)算得到的簽名值是：注意：示例中的Signature值是根據(jù)我們的Access Key Id和Access Key Secret值生成的。用戶使用本Id和Key也不一定能得到完全相同的值，因?yàn)檫@個(gè)值的計(jì)算還包括了其它入?yún)⒑蜁r(shí)間戳等。FZnIrdN

27、SLax4lnWf6NkKDc7mp54=FZnIrdNSLax4lnWf6NkKDc7mp54= HYPERLINK /?TimeStamp=2014-05-19T10%3A33%3A56Z /?TimeStamp=2014-05-19T10%3A33%3A56Z HYPERLINK /?TimeStamp=2014-05-19T10%3A33%3A56Z /?TimeStamp=2014-05-19T10%3A33%3A56Z &Format=xml&AccessKeyId=testid &Action=DescribeLoadBalancerAttribute &SignatureMet

28、hod=Hmac-SHA1 &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 &SignatureNonce=NwDAxvLU6tFE0DVb &Version=2014-05-15&SignatureVersion=1.0 &Signature=FZnIrdNSLax4lnWf6NkKDc7mp54%3DRAM資源授權(quán)使用RAM實(shí)現(xiàn)負(fù)載均衡資源授權(quán)您通過云帳號(hào)創(chuàng)建的負(fù)載均衡實(shí)例，都是該帳號(hào)自己擁有的資源。默認(rèn)情況下，帳號(hào)對(duì)自己的資源擁有完整的 操作權(quán)限。使用阿里云的RAM（Resource Access Management）服務(wù)，您可以將您云賬

29、號(hào)下負(fù)載均衡資源的訪問及管理權(quán)限授予RAM中子用戶。如果您不需要使用RAM，請(qǐng)略過此章節(jié)。RAM資源授權(quán)RAM中可授權(quán)的負(fù)載均衡資源類型資源類型授權(quán)策略中的資源描述方法LoadBalanceracs:slb:$regionid:$accountid:loadbalancer/$lo 資源類型授權(quán)策略中的資源描述方法LoadBalanceracs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridacs:slb:$regionid:$accountid:loadbalancer/*acs:slb:*:$accountid:loadbala

30、ncer/*acs:slb:*:*:loadbalancer/*Certificateacs:slb:$regionid:$accountid:certificate/$serve rcertificateIdacs:slb:$regionid:$accountid:certificate/*其中：所有$regionid應(yīng)為某個(gè)region的id，或者*； 所有$accountid應(yīng)為資源擁有者的AccountId，或者*； 所有$loadbalancerid應(yīng)為某個(gè)loadbalancer的id，或者*； 以此類推。RAM中可對(duì)負(fù)載均衡資源進(jìn)行授權(quán)的接口在RAM中，可以對(duì)一個(gè)負(fù)載均衡資源進(jìn)行

31、以下Action的授權(quán)?？墒跈?quán)的接口可授權(quán)的接口CreateLoadBalancerModifyLoadBalancerInternetSpecDeleteLoadBalancerSetLoadBalancerStatusSetLoadBalancerNameDescribeLoadBalancersDescribeLoadBalancerAttributeDescribeRegionsUploadServerCertificateDeleteServerCertificateSetServerCertificateNameDescribeServerCertificatesCreateLoa

32、dBalancerHTTPSListenerCreateLoadBalancerHTTPListenerDeleteLoadBalancerListenerCreateLoadBalancerTCPListenerStopLoadBalancerListenerStartLoadBalancerListenerSetLoadBalancerHTTPListenerAttributeSetLoadBalancerTCPListenerAttributeSetLoadBalancerHTTPSListenerAttributeDescribeLoadBalancerHTTPSListenerAtt

33、ributeDescribeLoadBalancerHTTPListenerAttributeDescribeLoadBalancerTCPListenerAttributeRemoveBackendServersAddBackendServersDescribeHealthStatusSetBackendServers負(fù)載均衡API的鑒權(quán)規(guī)則當(dāng)子用戶通過負(fù)載均衡Open API進(jìn)行資源訪問時(shí)，負(fù)載均衡后臺(tái)向RAM進(jìn)行權(quán)限檢查，以確保調(diào)用者擁有相應(yīng)權(quán)限。ActionResource每個(gè)不同的負(fù)載均衡API會(huì)根據(jù)涉及到的資源以及API的語義來確定需要檢查哪些資源的權(quán)限。 ActionResour

34、ceCreateLoadBalanceracs:slb:$regionid:$accountid:loadbalancer/*ModifyLoadBalancerInternetSpecacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridDeleteLoadBalanceracs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridSetLoadBalancerStatusacs:slb:$regionid:$accountid:loadbalancer/$lo adbala

35、nceridSetLoadBalancerNameacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridDescribeLoadBalancersacs:slb:$regionid:$accountid:loadbalancer/*DescribeLoadBalancerAttributeacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridDescribeRegionsacs:slb:*:$accountid:*UploadServerCertificateacs:sl

36、b:%s:%s:certificate/*DeleteServerCertificateacs:slb:%s:%s:certificate/%DescribeServerCertificateacs:slb:%s:%s:certificate/%SetServerCertificateNameacs:slb:%s:%s:certificate/%DescribeServerCertificatesacs:slb:%s:%s:certificate/*CreateLoadBalancerHTTPListeneracs:slb:$regionid:$accountid:loadbalancer/$

37、lo adbalanceridCreateLoadBalancerHTTPSListeneracs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridacs:slb:%s:%s:certificate/%CreateLoadBalancerTCPListeneracs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridCreateLoadBalancerUDPListeneracs:slb:$regionid:$accountid:loadbalancer/$lo adbalan

38、ceridDeleteLoadBalancerListeneracs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridStartLoadBalancerListeneracs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridStopLoadBalancerListeneracs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridSetLoadBalancerHTTPListenerAttributeacs:slb:$r

39、egionid:$accountid:loadbalancer/$lo adbalanceridSetLoadBalancerHTTPSListenerAttributeacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridacs:slb:%s:%s:certificate/%SetLoadBalancerTCPListenerAttributeacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridSetLoadBalancerUDPListenerAttributeac

40、s:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridDescribeLoadBalancerHTTPListenerAttributeacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridDescribeLoadBalancerHTTPSListenerAttributeacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridDescribeLoadBalancerTCPListenerAttributeacs:s

41、lb:$regionid:$accountid:loadbalancer/$lo adbalanceridDescribeLoadBalancerUDPListenerAttributeacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridAddBackendServersacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridacs:ecs:$regionid:$accountid:instance/$instan ceidRemoveBackendServersacs:

42、slb:$regionid:$accountid:loadbalancer/$lo adbalanceridacs:ecs:$regionid:$accountid:instance/$instan ceidSetBackendServersacs:slb:$regionid:$accountid:loadbalancer/$lo adbalanceridacs:ecs:$regionid:$accountid:instance/$instan ceidDescribeHealthStatusacs:slb:$regionid:$accountid:loadbalancer/$lo adbal

43、anceridLoadBalancer相關(guān)APICreateLoadBalancer描述創(chuàng)建LoadBalancer，根據(jù)參數(shù)生成負(fù)載均衡實(shí)例，分配服務(wù)地址和LoadBalancerId。AddressType指定分配 的服務(wù)地址是公網(wǎng)IP還是內(nèi)網(wǎng)IP。 HYPERLINK 中的用戶中心-/ 創(chuàng)建實(shí)例需要通過實(shí)名認(rèn)證。沒有通過實(shí)名認(rèn)證的可以前往中的用戶中心-會(huì)員信息中進(jìn)行 實(shí)名認(rèn)證。請(qǐng)求參數(shù)名稱類型是否必須描述ActionString是操作接口名，系統(tǒng)規(guī)定參數(shù)。取值：CreateLoadBalanc erRegionIdString是負(fù)載均衡實(shí)例所屬的Region編號(hào)。取值：從Describe

44、Regions的返回值中選取。LoadBalancerNameString否負(fù)載均衡實(shí)例的顯示名稱。取值：用戶自定義字符串。長度限制為1- 80個(gè)字符，允許包含字母、數(shù)字、-、/、.、_這些字符。默認(rèn)值：無。不指定該參數(shù)時(shí)，默認(rèn)由系統(tǒng)分配一個(gè)實(shí)例名稱。AddressTypeString否Address類型。取值：internet | intranet默認(rèn)值：internetVSwitchIdString視情況而定負(fù)載均衡 VPC實(shí)例的VSwitchId。該參數(shù)用戶提供，用戶需要先創(chuàng)建VPC和VSwitch才能獲得VSwitchId。InternetChargeTypeString否公網(wǎng)類型實(shí)例

45、付費(fèi)方式。 取值：paybybandwidth | paybytraffic默認(rèn)值：paybytrafficBandwidthInteger否按固定帶寬計(jì)費(fèi)方式的公網(wǎng)類型實(shí)例的帶寬峰值。針對(duì)按固定帶寬計(jì)費(fèi)方式的公網(wǎng)類型實(shí)例，需要將當(dāng)前設(shè)定值通過Listener上的Bandwidth參數(shù)進(jìn)行分配后才能生效；針對(duì)按使用流量計(jì)費(fèi)方式的公網(wǎng)類型實(shí)例的帶寬峰值，請(qǐng)直接通過Listener 上 Bandwidth參數(shù)進(jìn)行設(shè)定，此時(shí)本參數(shù)會(huì)被忽略。取值：1-1000（單位為Mbps）默認(rèn)值：1注：私網(wǎng)實(shí)例系統(tǒng)會(huì)統(tǒng)一按流量計(jì)費(fèi)設(shè)置。ClientTokenString否用于保證請(qǐng)求的冪等性。由客戶端生成該參數(shù)值

46、，要保證在不同請(qǐng)求間唯一，最大不值過64個(gè)ASCII字符。注：該參數(shù)命名規(guī)則限制同LoadBalancerName 取值限制。具體參見附錄：如何保證冪等性。MasterZoneIdString否該創(chuàng)建實(shí)例的主可用區(qū)ID，通過DescribeZone接口可查到相應(yīng)Region下的主備可用區(qū)信息目前對(duì)金融云用戶暫時(shí)不支持多可用區(qū)功能SlaveZoneIdString否該創(chuàng)建實(shí)例的備可用區(qū)ID，通過DescribeZone接口可查到相應(yīng)Region下的主備可用區(qū)信息目前對(duì)金融云用戶暫時(shí)不支持多可用區(qū)功能返回參數(shù)名稱類型描述詳見LoadBalancerIdString負(fù)載均衡實(shí)例的唯一標(biāo)識(shí)Addres

47、sString系統(tǒng)分配的服務(wù)地址。用戶可以選擇該服務(wù)地址是否對(duì)外公開，來分別創(chuàng)建公網(wǎng)和內(nèi)網(wǎng)的負(fù)載均衡服務(wù)。VpcIdString負(fù)載均衡實(shí)例的VPC唯一標(biāo)識(shí)。VSwitchIdString負(fù)載均衡實(shí)例的VPC所屬VSwitch標(biāo)識(shí)。MasterZoneIdString該實(shí)例的主可用區(qū)。SlaveZoneIdString該實(shí)例的備可用區(qū)。LoadBalancerNameString負(fù)載均衡實(shí)例別名。示例/ &Action=CreateLoadBalancer &RegionId=cn-east-hangzhou-01 &LoadBalancerName=abc &AddressType=inte

48、rnet &InternetChargeType=paybytraffic &請(qǐng)求示例/ &Action=CreateLoadBalancer &RegionId=cn-east-hangzhou-01 &LoadBalancerName=abc &AddressType=internet &InternetChargeType=paybytraffic &返回示例365F4154-92F6-4AE4-92F8-7FF34B540710139a00604ad-cn-east-hangzhou-016classiccn-hangzhou-bcn-hangzhou-dabcRequestId:36

49、5F4154-92F6-4AE4-92F8-7FF34B540710,RequestId:365F4154-92F6-4AE4-92F8-7FF34B540710,LoadBalancerId:139a00604ad-cn-east-hangzhou-01, Address:6,NetworkType:classic MasterZoneId:cn-hangzhou-b, SlaveZoneId:cn-hangzhou-d, LoadBalancerName:abcModifyLoadBalancerInternetSpec描述修改LoadBalancer規(guī)格，根據(jù)參數(shù)修改負(fù)載均衡實(shí)例的計(jì)費(fèi)方

50、式或規(guī)格。請(qǐng)求參數(shù)名稱類型是否必須描述ActionString是操作接口名，系統(tǒng)規(guī)定參數(shù)。取值：ModifyLoadBalanc erInternetSpecLoadBalancerIdString是負(fù)載均衡實(shí)例的唯一標(biāo)識(shí)。InternetChargeTypeString否公網(wǎng)類型實(shí)例付費(fèi)方式。 取值：paybybandwidth | paybytraffic默認(rèn)值：無。用戶不指定此參數(shù)時(shí)，表示此次調(diào)用不修改此配置項(xiàng)，保持之前的配置。注：私網(wǎng)實(shí)例系統(tǒng)會(huì)統(tǒng)一按流量計(jì)費(fèi)設(shè)置，無法修改計(jì)費(fèi)類型。BandwidthInteger否公網(wǎng)類型實(shí)例按固定帶寬計(jì)費(fèi)方式時(shí)設(shè)定的帶寬峰值。取值：1- 1000（單

51、位為Mbps）默認(rèn)值：1針對(duì)公網(wǎng)類型實(shí)例，需要將當(dāng)前設(shè)定值通過Listener上的Bandwidth參數(shù)進(jìn)行分配后才能生效；針對(duì)公網(wǎng)類型實(shí)例按使用流量計(jì)費(fèi)方式的帶寬峰值，請(qǐng)直接通過Listener上Bandwidth參數(shù)進(jìn)行設(shè)定。返回參數(shù)全是公共返回參數(shù)，詳見示例/ &Action=ModifyLoadBalancerInternetSpec &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 / &Action=ModifyLoadBalancerInternetSpec &LoadBalancerId=139a00604ad-cn-east-ha

52、ngzhou-01 &InternetChargeType=paybybandwidth &Bandwidth=10&返回示例CEF72CEB-54B6-4AE8-B225-F876FF7BA984RequestId: CEF72CEB-54B6-4AE8-B225-F876FF7BA984RequestId: CEF72CEB-54B6-4AE8-B225-F876FF7BA984DeleteLoadBalancer描述刪除LoadBalancer，根據(jù)參數(shù)刪除負(fù)載均衡實(shí)例，清除負(fù)載均衡實(shí)例相關(guān)的配置；如果負(fù)載均衡實(shí)例上還有Listener，也會(huì)一并被刪除。請(qǐng)求參數(shù)名稱類型是否必須描述Act

53、ionString是操作接口名，系統(tǒng)規(guī)定參數(shù)。取值：DeleteLoadBalanc erLoadBalancerIdString是負(fù)載均衡實(shí)例的唯一標(biāo)識(shí)。返回參數(shù)全是公共返回參數(shù)，詳見示例/ &Action=DeleteLoadBalancer &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 / &Action=DeleteLoadBalancer &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 &返回示例CEF72CEB-54B6-4AE8-B225-F876FF7BA984RequestId:

54、 CEF72CEB-54B6-4AE8-B225-F876FF7BA984RequestId: CEF72CEB-54B6-4AE8-B225-F876FF7BA984SetLoadBalancerStatus描述配置LoadBalancer狀態(tài)。剛創(chuàng)建好的負(fù)載均衡實(shí)例，狀態(tài)默認(rèn)為active。LoadBalancerStatus為active，表示將負(fù)載均衡實(shí)例中所有Listener的配置下發(fā)到系統(tǒng)中，使之生效；LoadBalancerStatus為inactive，表示將負(fù)載均衡實(shí)例中所有Listener的配置都inactive，使之失效。請(qǐng)求參數(shù)名稱類型是否必須描述ActionStrin

55、g是操作接口名，系統(tǒng)規(guī)定參數(shù)。取值：SetLoadBalancerSt atusLoadBalancerIdString是負(fù)載均衡實(shí)例的唯一標(biāo)識(shí)。LoadBalancerStatusString是負(fù)載均衡實(shí)例狀態(tài)。取 值 ：inactive | active返回參數(shù)全是公共返回參數(shù)，詳見示例/ &Action=SetLoadBalancerStatus &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 / &Action=SetLoadBalancerStatus &LoadBalancerId=139a00604ad-cn-east-hangzh

56、ou-01 &LoadBalancerStatus=active&返回示例CEF72CEB-54B6-4AE8-B225-F876FF7BA984JSON格式RequestId: CEF72CEB-54B6-4AE8-B225-F876FF7BA984SetLoadBalancerName描述配置LoadBalancer的別名。請(qǐng)求參數(shù)名稱類型是否必須描述ActionString是操作接口名，系統(tǒng)規(guī)定參數(shù)。取值：SetLoadBalancerN ameLoadBalancerIdString是負(fù)載均衡實(shí)例的唯一標(biāo)識(shí)。LoadBalancerNameString是負(fù)載均衡實(shí)例的顯示名稱。取值：用

57、戶自定義字符串，長度限制為1- 80個(gè)字符，允許包含字母、數(shù)字、-、/、.、_這些字符。返回參數(shù)全是公共返回參數(shù)，詳見示例/ &Action=SetLoadBalancerName &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 / &Action=SetLoadBalancerName &LoadBalancerId=139a00604ad-cn-east-hangzhou-01 &LoadBalancerName=abc&返回示例CEF72CEB-54B6-4AE8-B225-F876FF7BA984RequestId: CEF72CEB-5

58、4B6-4AE8-B225-F876FF7BA984RequestId: CEF72CEB-54B6-4AE8-B225-F876FF7BA984DescribeLoadBalancers描述查詢用戶創(chuàng)建的所有LoadBalancer列表。查詢時(shí)，可使用LoadBalancerId、AddressTypee、ServerId等參數(shù)作為查詢條件。如果未使用以上任何一個(gè) 查詢條件作為過濾器，則返回用戶擁有的所有LoadBalancer。請(qǐng)求參數(shù)名稱類型是否必須描述ActionString是操作接口名，系統(tǒng)規(guī)定參數(shù)。取值：DescribeLoadBala ncersRegionIdString是負(fù)載

59、均衡實(shí)例所屬的Region編號(hào)。LoadBalancerIdString否以負(fù)載均衡實(shí)例ID作為過濾器。支持多值查詢。取值：可以輸入多個(gè)，以,分割默認(rèn)值：無。不設(shè)置該參數(shù)表示不使用該參數(shù)作為過濾條件。AddressTypeString否以Address類型作為過濾器。取 值 ：internet | intranet。默認(rèn)值：無不設(shè)置該參數(shù)表示不使用該參數(shù)作為過濾條件。NetworkTypeString否負(fù)載均衡實(shí)例網(wǎng)絡(luò)類型，vpc或者classic。VpcIdString否負(fù)載均衡實(shí)例Vpcid。VswitchIdString否負(fù)載均衡實(shí)例Vswitchid。AddressString否負(fù)載均

60、衡實(shí)例服務(wù)地址。InternetChargeTypeString否以公網(wǎng)類型實(shí)例付費(fèi)方式作為過濾器。取值：paybybandwidth | paybytraffic默認(rèn)值：無不設(shè)置該參數(shù)表示不使用該參數(shù)作為過濾條件ServerIdString否以后端服務(wù)器名稱ID（ECS實(shí)例ID）作為過濾器。若使用該條件，則只返回掛載了此服務(wù)器的負(fù)載均衡實(shí)例。取值：ECS實(shí)例ID默認(rèn)值：無不設(shè)置該參數(shù)表示不使用該參數(shù)作為過濾條件。MasterZoneIdString否該創(chuàng)建實(shí)例的主可用區(qū)ID。通過DescribeZone接口可查到相應(yīng)Region下的主備可用區(qū)信息。目前對(duì)金融云用戶暫時(shí)不支持多可用區(qū)功能。Sl