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

AI 助理
備案控制臺
文檔
輸入文檔關(guān)鍵字查找
首頁 負(fù)載均衡 應(yīng)用型負(fù)載均衡ALB 開發(fā)參考 API參考 API目錄 監(jiān)聽 CreateListener - 創(chuàng)建監(jiān)聽

CreateListener - 創(chuàng)建監(jiān)聽

更新時間：
產(chǎn)品詳情
我的收藏

創(chuàng)建監(jiān)聽。

接口說明

CreateListener 接口屬于異步接口，即系統(tǒng)返回一個請求 ID，但該 HTTP、HTTPS 或 QUIC 監(jiān)聽尚未創(chuàng)建成功，系統(tǒng)后臺的創(chuàng)建任務(wù)仍在進行。您可以調(diào)用 GetListenerAttribute 查詢 HTTP、HTTPS 或 QUIC 監(jiān)聽的創(chuàng)建狀態(tài)：

  • 當(dāng) HTTP、HTTPS 或 QUIC 監(jiān)聽處于 Provisioning 狀態(tài)時，表示 HTTP、HTTPS 或 QUIC 監(jiān)聽正在創(chuàng)建中。
  • 當(dāng) HTTP、HTTPS 或 QUIC 監(jiān)聽處于 Running 狀態(tài)時，表示 HTTP、HTTPS 或 QUIC 監(jiān)聽創(chuàng)建成功。

調(diào)試

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

授權(quán)信息

下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：

  • 操作：是指具體的權(quán)限點。
  • 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
    • 對于必選的資源類型，用背景高亮的方式表示。
    • 對于不支持資源級授權(quán)的操作，用全部資源表示。
  • 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
  • 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
操作訪問級別資源類型條件關(guān)鍵字關(guān)聯(lián)操作
alb:CreateListenercreate
*LoadBalancer
acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}
*SecurityPolicy
acs:alb:{#regionId}:{#accountId}:securitypolicy/{#securitypolicyId}
*ServerGroup
acs:alb:{#regionId}:{#accountId}:servergroup/{#servergroupId}
  • alb:ListenerProtocol
無

請求參數(shù)

名稱類型必填描述示例值
LoadBalancerIdstring是

應(yīng)用型負(fù)載均衡實例 ID。

alb-n5qw04uq8vavfe****
ClientTokenstring否

客戶端 Token，用于保證請求的冪等性。

從您的客戶端生成一個參數(shù)值，確保不同請求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符。

說明 若您未指定，則系統(tǒng)自動使用 API 請求的 RequestId 作為 ClientToken 標(biāo)識。每次 API 請求的 RequestId 不一樣。
123e4567-e89b-12d3-a456-426655440000
DryRunboolean否

是否只預(yù)檢此次請求，取值：

  • true：發(fā)送檢查請求，不會創(chuàng)建監(jiān)聽。檢查項包括是否填寫了必需參數(shù)、請求格式、業(yè)務(wù)限制。如果檢查不通過，則返回對應(yīng)錯誤。如果檢查通過，則返回錯誤碼DryRunOperation。

  • false（默認(rèn)值）：發(fā)送正常請求，通過檢查后返回 HTTP 2xx 狀態(tài)碼并直接進行操作。

false
ListenerProtocolstring是

監(jiān)聽協(xié)議。

取值：HTTP、HTTPS 或 QUIC。

HTTP
ListenerPortinteger是

負(fù)載均衡實例前端使用的端口。

取值：1~65535。

80
ListenerDescriptionstring否

自定義監(jiān)聽名稱。

長度為 2~256 個字符，必須是中文和無害字符串中的字符，可包含中文、字母、數(shù)字、短劃線（-）、正斜線（/）、半角句號（.）、下劃線（_）。

HTTP_80
RequestTimeoutinteger否

指定請求超時時間。單位：秒。

取值：1~180。

默認(rèn)值：60。

如果在超時時間內(nèi)后端服務(wù)器一直沒有響應(yīng)，負(fù)載均衡將放棄等待，并給客戶端返回HTTP 504錯誤碼。

60
IdleTimeoutinteger否

指定連接空閑超時時間。單位：秒。

取值范圍：1~60。

默認(rèn)值：15。

如果在超時時間內(nèi)一直沒有訪問請求，負(fù)載均衡會暫時中斷當(dāng)前連接，直到一下次請求來臨時重新建立新的連接。

3
GzipEnabledboolean否

是否開啟Gzip壓縮，對特定文件類型進行壓縮。取值：

  • true（默認(rèn)值）：是。
  • false：否。
true
Http2Enabledboolean否

是否開啟HTTP/2特性。取值：

  • true（默認(rèn)值）：是。
  • false：否。
說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
true
SecurityPolicyIdstring否

安全策略 ID。支持系統(tǒng)安全策略和自定義安全策略。

默認(rèn)值：tls_cipher_policy_1_0（系統(tǒng)安全策略）。

說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
tls_cipher_policy_1_0
CaEnabledboolean否

是否開啟雙向認(rèn)證。取值：

  • true：開啟。
  • false（默認(rèn)值）：不開啟。
false
XForwardedForConfigobject否

XForward 字段配置信息。

XForwardedForClientCertClientVerifyAliasstring否

自定義頭名稱，只有當(dāng) XForwardedForClientCertClientVerifyEnabled 的值為 true 的時候，該值才會生效；否則該值不會生效。

取值：1~40 個字符。支持字母 a~z、短劃線（-）、下劃線（_）和數(shù)字。

說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
test_client-verify-alias_123456
XForwardedForClientCertClientVerifyEnabledboolean否

是否通過X-Forwarded-Clientcert-clientverify頭字段獲取對訪問負(fù)載均衡實例客戶端證書的校驗結(jié)果。取值：

  • true：是。
  • false（默認(rèn)值）：否。
說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
true
XForwardedForClientCertFingerprintAliasstring否

自定義頭名稱，只有當(dāng) XForwardedForClientCertFingerprintEnabled 的值為 true 時生效。

取值：1~40 個字符。支持字母 a~z、短劃線（-）、下劃線（_）和數(shù)字。

說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
test_finger-print-alias_123456
XForwardedForClientCertFingerprintEnabledboolean否

是否通過X-Forwarded-Clientcert-fingerprint頭字段獲取訪問負(fù)載均衡實例客戶端證書的指紋取值。取值：

  • true：是。
  • false（默認(rèn)值）：否。
說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
true
XForwardedForClientCertIssuerDNAliasstring否

自定義頭名稱，只有當(dāng) XForwardedForClientCertIssuerDNEnabled 的值為 true 的時候，此值才會生效。

取值：1~40 個字符。支持字母 a~z、短劃線（-）、下劃線（_）和數(shù)字。

說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
test_issue-dn-alias_123456
XForwardedForClientCertIssuerDNEnabledboolean否

是否通過X-Forwarded-Clientcert-issuerdn頭字段獲取訪問負(fù)載均衡實例客戶端證書的發(fā)行者信息。取值：

  • true：是。
  • false（默認(rèn)值）：否。
說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
true
XForwardedForClientCertSubjectDNAliasstring否

自定義頭名稱，只有當(dāng) XForwardedForClientCertSubjectDNEnabled 的值為 true 時，此值才會生效。

取值：1~40 個字符。支持字母 a~z、短劃線（-）、下劃線（_）和數(shù)字。

說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
test_subject-dn-alias_123456
XForwardedForClientCertSubjectDNEnabledboolean否

是否通過X-Forwarded-Clientcert-subjectdn頭字段獲取訪問負(fù)載均衡實例客戶端證書的所有者信息。取值：

  • true：是。
  • false（默認(rèn)值）：否。
說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
true
XForwardedForClientSrcPortEnabledboolean否

是否通過X-Forwarded-Client-srcport頭字段獲取訪問負(fù)載均衡實例客戶端的端口。取值：

  • true：是。
  • false（默認(rèn)值）：否。
說明 HTTP 和 HTTPS 監(jiān)聽支持此參數(shù)。
true
XForwardedForEnabledboolean否

是否通過X-Forwarded-For頭字段獲取來訪者真實 IP。取值：

  • true（默認(rèn)值）：是。
  • false：否。
說明
  • 配置 true，XForwardedForProcessingMode 默認(rèn)取值 append，支持修改為 remove。
  • 配置 false，ALB 將請求發(fā)送至后端服務(wù)之前保留X-Forwarded-For頭字段，不做額外處理。
  • HTTP 和 HTTPS 監(jiān)聽支持此參數(shù)。
    •
    		true
    XForwardedForProcessingModestring否

    處理X-Forwarded-For頭字段的模式。只有當(dāng) XForwardedForEnabled 為 true 時，此值才會生效。取值：

    • append（默認(rèn)值）：附加。
    • remove：刪除。
    說明
  • 配置 append，將請求發(fā)送至后端服務(wù)之前把最后一跳 IP 加入X-Forwarded-For頭字段。
  • 配置 remove，請求發(fā)送至后端服務(wù)之前刪除X-Forwarded-For標(biāo)頭，無論請求是否攜帶X-Forwarded-For頭字段。
  • HTTP 和 HTTPS 監(jiān)聽支持此參數(shù)。
    •
    		append
    XForwardedForProtoEnabledboolean否

    是否通過X-Forwarded-Proto頭字段獲取負(fù)載均衡實例的監(jiān)聽協(xié)議。取值：

    • true：是。
    • false（默認(rèn)值）：否。
    說明 HTTP、HTTPS 和 QUIC 監(jiān)聽支持此參數(shù)。
    		false
    XForwardedForSLBIdEnabledboolean否

    是否通過SLB-ID頭字段獲取負(fù)載均衡實例 ID。取值：

    • true：是。
    • false（默認(rèn)值）：否。
    說明 HTTP、HTTPS 和 QUIC 監(jiān)聽支持此參數(shù)。
    		false
    XForwardedForSLBPortEnabledboolean否

    是否通過X-Forwarded-Port頭字段獲取負(fù)載均衡實例的監(jiān)聽端口。取值：

    • true：是。
    • false（默認(rèn)值）：否。
    說明 HTTP、HTTPS 和 QUIC 監(jiān)聽支持此參數(shù)。
    		false
    XForwardedForClientSourceIpsEnabledboolean否

    是否允許 ALB 從 X-Forwarded-For 頭字段中查找真實客戶端 IP。取值：

    • true：是。
    • false（默認(rèn)值）：否。
    說明 HTTP、HTTPS 監(jiān)聽支持此參數(shù)。
    		false
    XForwardedForClientSourceIpsTrustedstring否

    指定可信的代理 IP。

    應(yīng)用型負(fù)載均衡 ALB 會從后往前遍歷X-Forwarded-For，選取第一個不在可信 IP 列表中的 IP 作為真實的客戶端 IP，該 IP 會被用于源 IP 限速。

    		10.1.1.0/24
    XForwardedForHostEnabledboolean否

    是否開啟通過X-Forwarded-Host頭字段獲取訪問負(fù)載均衡實例客戶端的域名。取值：

    • true：是。
    • false（默認(rèn)值）：否。
    說明 HTTP、HTTPS 和 QUIC 監(jiān)聽支持此參數(shù)。
    		false
    QuicConfigobject否

    配置關(guān)聯(lián)的 QUIC 監(jiān)聽。

    QuicListenerIdstring否

    需要關(guān)聯(lián)的 QUIC 監(jiān)聽 ID，HTTPS 監(jiān)聽時有效，當(dāng) QuicUpgradeEnabled 為 true 時該參數(shù)必選。

    說明 原始監(jiān)聽和關(guān)聯(lián)的 QUIC 監(jiān)聽必須屬于同一個 ALB 實例，并且此 QUIC 監(jiān)聽之前沒有被關(guān)聯(lián)過。
    		lsn-o4u54y73wq7b******
    QuicUpgradeEnabledboolean否

    是否開啟 QUIC 升級。取值：

    • true：是。
    • false（默認(rèn)值）：否。
    說明 僅 HTTPS 監(jiān)聽支持此參數(shù)。
    		false
    Certificatesarray<object>否

    證書列表信息。

    object否

    證書結(jié)構(gòu)體。

    CertificateIdstring否

    證書 ID，當(dāng)前僅支持服務(wù)器證書。最多支持添加 20 個證書 ID。

    說明 當(dāng) ListenerProtocol 參數(shù)取值為 HTTPS 或 QUIC 的時候，此參數(shù)為必填。
    		103705*******
    CaCertificatesarray<object>否

    監(jiān)聽配置的 CA 證書列表。目前僅支持添加 1 個 CA 證書。

    object否

    監(jiān)聽配置的 CA 證書結(jié)構(gòu)。

    CertificateIdstring否

    CA 證書 ID。

    說明 當(dāng) CaEnabled 參數(shù)取值為 true 的時候，此參數(shù)為必填。
    		123157*******
    DefaultActionsarray<object>是

    規(guī)則動作列表。

    object是

    規(guī)則動作列表。

    ForwardGroupConfigobject是

    轉(zhuǎn)發(fā)動作對應(yīng)的配置。最多支持添加 20 個轉(zhuǎn)發(fā)動作對應(yīng)的配置。

    ServerGroupTuplesarray<object>是

    轉(zhuǎn)發(fā)目標(biāo)服務(wù)器元組。

    object是

    轉(zhuǎn)發(fā)目標(biāo)服務(wù)器元組。

    ServerGroupIdstring是

    轉(zhuǎn)發(fā)到的目的服務(wù)器組 ID。

    		sgp-8ilqs4axp6******
    Typestring是

    動作類型。最多支持添加 1 個動作類型。

    取值：ForwardGroup，表示轉(zhuǎn)發(fā)至多個服務(wù)器組。

    		ForwardGroup
    Tagarray<object>否

    標(biāo)簽。

    object否

    標(biāo)簽結(jié)構(gòu)。

    Keystring否

    標(biāo)簽鍵。最多支持 128 個字符，不能以 aliyun 或 acs:開頭，不能包含 http://或 https://。

    		env
    Valuestring否

    標(biāo)簽值。最多支持 128 個字符，不能以 aliyun 或 acs:開頭，不能包含 http://或 https://。

    		product

    返回參數(shù)

    名稱類型描述示例值
    object

    創(chuàng)建監(jiān)聽。

    JobIdstring

    異步任務(wù) ID。

    		72dcd26b-f12d-4c27-b3af-18f6aed5****
    ListenerIdstring

    監(jiān)聽 ID。

    		lsn-o4u54y73wq7b******
    RequestIdstring

    請求 ID。

    		CEF72CEB-54B6-4AE8-B225-F876*******

    示例

    正常返回示例

    JSON格式

    {
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "ListenerId": "lsn-o4u54y73wq7b******",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876*******"
}

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400ResourceAlreadyExist.ListenerThe specified resource %s is already exist.同端口監(jiān)聽已存在。
    400IncorrectStatus.LoadBalancerThe status of %s [%s] is incorrect.實例的當(dāng)前狀態(tài)不支持本次操作。
    400IncorrectBusinessStatus.LoadBalancerThe business status of %s [%s]  is incorrect.資源%s [%s]的業(yè)務(wù)狀態(tài)無效。
    400ResourceQuotaExceeded.LoadBalancerListenersNumThe quota of %s is exceeded for resource %s, usage %s/%s.配額%s已超額度限制，資源是%s，目前已使用%s，配額為%s。
    400OperationDenied.CrossLoadBalancerQUICListenerThe operation is not allowed because of %s.操作被拒絕，原因是%s。
    400ResourceAlreadyAssociated.ListenerThe specified resource %s is already associated.資源%s已被關(guān)聯(lián)。
    400ResourceQuotaExceeded.SecurityPolicyAttachedNumThe quota of %s is exceeded for resource %s, usage %s/%s.配額%s已超額度限制，資源是%s，目前已使用%s，配額為%s。
    400ResourceQuotaExceeded.ServerGroupAttachedNumThe quota of %s is exceeded for resource %s, usage %s/%s.服務(wù)器組可被關(guān)聯(lián)數(shù)已超額度限制。
    400ResourceQuotaExceeded.LoadBalancerServersNumThe quota of %s is exceeded for resource %s, usage %s/%s.后端服務(wù)器數(shù)已超額度限制。
    400ResourceQuotaExceeded.ServerAddedNumThe quota of %s is exceeded for resource %s, usage %s/%s.服務(wù)器添加到組已超額度限制。
    400Mismatch.VpcIdThe %s is mismatched for %s and %s.%s在%s和%s中不匹配。
    400OperationDenied.ServerGroupProtocolNotSupportThe operation is not allowed because of ServerGroupProtocolNotSupport.操作被拒絕，原因是ServerGroupProtocolNotSupport。
    400OperationDenied.GRPCServerGroupThe operation is not allowed because of %s.操作被拒絕，原因是存在綁定本GRPC服務(wù)器組的監(jiān)聽沒有啟用HTTP2.0。
    400Mismatch.LoadBalancerEditionAndConnectionDrainThe %s and %s are mismatched.參數(shù)%s和%s不匹配。
    400Mismatch.LoadBalancerEditionAndSlowStartEnableThe %s and %s are mismatched.參數(shù)%s和%s不匹配。
    400InvalidParameterInvalid parameter, please check the parameter input.無效參數(shù)，請檢查參數(shù)輸入。
    403Forbidden.SecurityPolicyAuthentication has failed for SecurityPolicy.對SecurityPolicy鑒權(quán)失敗
    403Forbidden.LoadBalancerAuthentication is failed for %s.負(fù)載均衡操作鑒權(quán)失敗。
    403Forbidden.ListenerAuthentication is failed for %s.監(jiān)聽鑒權(quán)失敗。
    404ResourceNotFound.LoadBalancerThe specified resource %s is not found.資源%s不存在。
    404ResourceNotFound.ServerGroupThe specified resource %s is not found.后端服務(wù)器組不存在。
    404ResourceNotFound.SecurityPolicyThe specified resource %s is not found.資源%s不存在。
    404ResourceNotFound.ListenerThe specified resource %s is not found.監(jiān)聽不存在。
    404ResourceNotFound.CertificateThe specified resource %s is not found.資源%s不存在。

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

    變更歷史

    變更時間變更內(nèi)容概要操作
    2024-12-20OpenAPI 錯誤碼發(fā)生變更查看變更詳情
    2024-09-03OpenAPI 錯誤碼發(fā)生變更查看變更詳情
    2024-01-29OpenAPI 錯誤碼發(fā)生變更查看變更詳情
    2024-01-29OpenAPI 錯誤碼發(fā)生變更查看變更詳情
    2024-01-18OpenAPI 錯誤碼發(fā)生變更查看變更詳情
    2023-11-06OpenAPI 錯誤碼發(fā)生變更查看變更詳情