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

ListForwardingRules - 獲取轉發規則列表

調用ListForwardingRules接口獲取轉發規則列表。

接口說明

說明 調用該接口只能查看自定義轉發策略信息,無法查看默認轉發策略信息。

調試

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

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
ga:ListForwardingRuleslist
  • Listener
    acs:ga:{#regionId}:{#accountId}:listener/{#listenerId}

請求參數

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

全球加速實例所屬的地域 ID,僅取值:cn-hangzhou

cn-hangzhou
ClientTokenstring

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

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

說明 若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
02fb3da4****
ListenerIdstring

監聽實例 ID。

lsr-bp1s0vzbi5bxlx5pw****
AcceleratorIdstring

全球加速實例 ID。

ga-bp17frjjh0udz4qzk****
ForwardingRuleIdstring

轉發策略 ID。

frule-bp19a3t3yzr21q3****
NextTokenstring

是否擁有下一次查詢的令牌(Token)。取值:

  • 第一次查詢和沒有下一次查詢時,均無需填寫。
  • 如果有下一次查詢,取值為上一次 API 調用返回的 NextToken 值。
FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResultsinteger

分批次查詢時每次顯示的條目數。取值范圍:1~100。默認值:20

20

返回參數

名稱類型描述示例值
object

返回信息列表。

RequestIdstring

請求 ID。

CFC67ED9-4AB1-431F-B6E3-A752B7B8CCD4
TotalCountinteger

列表條目數。

1
NextTokenstring

是否擁有下一次查詢的令牌(Token)。取值:

  • 如果 NextToken 為空表示沒有下一次查詢。
  • 如果 NextToken 有返回值,該取值表示下一次查詢開始的令牌。
FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResultsinteger

分批次查詢時每次顯示的條目數。

20
ForwardingRulesarray<object>

轉發策略信息列表。

object

轉發策略信息列表。

Priorityinteger

轉發策略優先級。

返回為 1~10000。值越小表示優先級越高。

1000
ForwardingRuleIdstring

轉發策略 ID。

frule-bp19a3t3yzr21q3****
ForwardingRuleNamestring

轉發策略名稱。

auto_named_rule
ForwardingRuleDirectionstring

規則生效方向。

目前默認返回 request,表示請求方向生效。

request
ForwardingRuleStatusstring

轉發策略狀態。

  • active:正常。
  • configuring:變配中。
  • deleting:刪除中。
active
RuleConditionsarray<object>

轉發條件列表。

object

轉發條件列表。

RuleConditionTypestring

轉發條件類型。

  • Host:域名。
  • Path:路徑。
  • RequestHeader:HTTP 標頭。
  • Query:查詢字符串。
  • Method:HTTP 請求方法。
  • Cookie:Cookie。
  • SourceIP:源 IP。
Host
RuleConditionValuestring

轉發條件類型對應的值。

根據 RuleConditionType 返回不同的 JSON 字符串值。

  • RuleConditionTypeHost 時,該參數返回域名條件配置信息。若一個轉發規則內返回多個域名,多個域名間為“或”關系。

  • RuleConditionTypePath 時,該參數返回路徑條件配置信息。一個轉發策略若返回多個路徑類型轉發規則,多個路徑類型轉發規則間為”或“關系,一個轉發路徑類型規則若返回多個路徑,多個路徑間為“或”關系。

  • RuleConditionTypeRequestHeader 時,該參數返回 HTTP 標頭字段條件配置信息,由鍵(Key)和值(Value)組成。

  • RuleConditionTypeQuery 時,該參數返回查詢字符串條件配置信息,由鍵(Key)和值(Value)組成。

  • RuleConditionTypeMethod 時,該參數返回請求方法配置信息。

  • RuleConditionTypeCookie 時,該參數返回 Cookie 配置信息,由鍵(Key)和值(Value)組成。

  • RuleConditionTypeSourceIP 時,該參數返回源 IP 配置信息。若一個轉發規則內返回了多個源 IP,多個 IP 之間為“或”關系。

["www.example.com", "www.aliyun.com"]
PathConfigobject

路徑配置信息。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleConditionTypeRuleConditionValue 查看轉發條件信息。
Valuesarray

路徑配置信息。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleConditionTypeRuleConditionValue 查看轉發條件信息。
string

路徑。

路徑長度為 1~128 個字符,必須以正斜線(/)開頭,只允許包含字母、數字、美元符號($)、短劃線(-)、下劃線(_)、半角句號(.)、加號(+)、正斜線(/)、and(&)、波浪線(~)、at(@)、半角冒號(:)、半角單引號('),支持使用星號(*)和半角問號(?)作為通配符。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleConditionTypeRuleConditionValue 查看轉發條件信息。
/test
HostConfigobject

域名配置信息。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleConditionTypeRuleConditionValue 查看轉發條件信息。
Valuesarray

域名配置信息。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleConditionTypeRuleConditionValue 查看轉發條件信息。
string

域名。

域名長度為 3~128 個字符,允許包含字母、數字、短劃線(-)和半角句號(.),支持使用星號(*)和半角問號(?)作為通配符。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleConditionTypeRuleConditionValue 查看轉發條件信息。
www.example.com
RuleActionsarray<object>

轉發動作。

object

轉發動作。

Orderinteger

轉發優先級。

說明 當前無實際意義。
1
RuleActionTypestring

轉發動作類型。

  • ForwardGroup:轉發。
  • Redirect:重定向。
  • FixResponse:返回固定響應。
  • Rewrite:重寫。
  • AddHeader:寫入頭字段。
  • RemoveHeader:刪除頭字段。
  • Drop:丟棄。
ForwardGroup
RuleActionValuestring

轉發動作類型對應的值。

根據 RuleActionType 返回不同的 JSON 字符串值。

  • RuleActionTypeForwardGroup 時,該參數返回虛擬終端節點組信息。其中:

    • typeendpointgroup

    • value:目標虛擬終端節點組 ID。

  • RuleActionTypeRedirect 時,該參數返回重定向配置信息。其中:

    • protocol:要跳轉的協議。

    • domain:要跳轉的域名。

    • port:要跳轉的端口。

    • path:要跳轉的路徑。

    • query:要跳轉的查詢字符串。

    • code:跳轉方式。

  • RuleActionTypeFixResponse 時,該參數返回配置的返回固定響應信息。其中:

    • code:響應狀態碼。

    • type:響應正文類型。

    • content:響應正文。

  • RuleActionTypeAddHeader 時,該參數返回插入 HTTP 標頭字段配置信息。其中:

    • name:HTTP 標頭字段名稱。

    • type:HTTP 標頭字段內容類型。

    • value:HTTP 標頭字段內容。

  • RuleActionTypeRemoveHeader 時,該參數返回刪除 HTTP 標頭字段信息。

  • RuleActionTypeRewrite 時,該參數返回重寫配置信息。其中:

    • domain:要跳轉的域名。

    • path:要跳轉的路徑。

    • query:要跳轉的查詢字符串。

  • RuleActionType 取值為 Drop 時,該參數返回空字符串。

[{"type":"endpointgroup", "value":"epg-bp1enpdcrqhl78g6r****"}]
ForwardGroupConfigobject

轉發動作配置信息。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleActionTypeRuleActionValue 查看轉發動作信息。
ServerGroupTuplesarray<object>

終端節點組信息。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleActionTypeRuleActionValue 查看轉發動作信息。
object

終端節點組信息。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleActionTypeRuleActionValue 查看轉發動作信息。
EndpointGroupIdstring

終端節點組 ID。

說明 針對 2022 年 07 月 12 日之后創建的全球加速實例,支持所有轉發條件類型和轉發動作類型,建議通過 RuleActionTypeRuleActionValue 查看轉發動作信息。
epg-bp1enpdcrqhl78g6r****
ListenerIdstring

監聽實例 ID。

lsr-bp1s0vzbi5bxlx5****
ServiceIdstring

托管實例所屬的服務方 ID。

說明 僅在 ServiceManaged 參數為 True 時有效。
ALB
ServiceManagedboolean

是否為托管實例。取值:

  • true:是托管實例。
  • false:不是托管實例。
true
ServiceManagedInfosarray<object>

用戶在此托管實例下可執行的動作策略列表。

說明 僅在 ServiceManaged 參數為 True 時有效。
  • 當實例處于托管狀態時,用戶對實例的操作會受到限制,某些操作行為會被禁止。
  • object

    用戶在此托管實例下可執行的動作策略列表。

    Actionstring

    托管策略動作名稱,取值:

    • Create:創建實例。
    • Update:更新當前實例。
    • Delete:刪除當前實例。
    • Associate:引用/被引用當前實例。
    • UserUnmanaged:用戶解托管實例。
    • CreateChild:在當前實例下創建子資源。
    Update
    ChildTypestring

    子資源類型,取值:

    • Listener:監聽資源。

    • IpSet:加速地域資源。

    • EndpointGroup:終端節點組資源。

    • ForwardingRule:轉發策略資源。

    • Endpoint:終端節點資源。

    • EndpointGroupDestination:自定義路由監聽下的終端節點組協議映射資源。

    • EndpointPolicy:自定義路由監聽下的終端節點通行策略資源。

    說明 僅在 Action 參數為 CreateChild 時有效。
    Listener
    IsManagedboolean

    托管策略動作是否被托管,取值:

    • true:托管策略動作被托管,用戶無權在托管實例下執行 Action 指定的操作。

    • false:托管策略動作未被托管,用戶可在托管實例下執行 Action 指定的操作。

    false

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "CFC67ED9-4AB1-431F-B6E3-A752B7B8CCD4",
      "TotalCount": 1,
      "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
      "MaxResults": 20,
      "ForwardingRules": [
        {
          "Priority": 1000,
          "ForwardingRuleId": "frule-bp19a3t3yzr21q3****",
          "ForwardingRuleName": "auto_named_rule",
          "ForwardingRuleDirection": "request",
          "ForwardingRuleStatus": "active",
          "RuleConditions": [
            {
              "RuleConditionType": "Host",
              "RuleConditionValue": "[\"www.example.com\", \"www.aliyun.com\"]",
              "PathConfig": {
                "Values": [
                  "/test"
                ]
              },
              "HostConfig": {
                "Values": [
                  "www.example.com"
                ]
              }
            }
          ],
          "RuleActions": [
            {
              "Order": 1,
              "RuleActionType": "ForwardGroup",
              "RuleActionValue": "[{\"type\":\"endpointgroup\", \"value\":\"epg-bp1enpdcrqhl78g6r****\"}]",
              "ForwardGroupConfig": {
                "ServerGroupTuples": [
                  {
                    "EndpointGroupId": "epg-bp1enpdcrqhl78g6r****"
                  }
                ]
              }
            }
          ],
          "ListenerId": "lsr-bp1s0vzbi5bxlx5****",
          "ServiceId": "ALB",
          "ServiceManaged": true,
          "ServiceManagedInfos": [
            {
              "Action": "Update",
              "ChildType": "Listener",
              "IsManaged": false
            }
          ]
        }
      ]
    }

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400NotExist.ListenerThe listener does not exist.監聽器不存在
    400NotActive.ListenerThe state of the listener is not active.監聽器狀態非穩態
    400NotExist.AcceleratorThe accelerated instance does not exist.加速實例不存在。
    400StateError.AcceleratorThe state of the accelerated instance is invalid.加速實例狀態非法。
    400NotExist.BusinessRegionThe business region does not exist.業務region并不存在
    400NotExist.BasicBandwidthPackageYou must specify the basic bandwidth package.缺少基礎帶寬包
    400QuotaExceeded.EndPointThe maximum number of endpoints is exceeded.終端節點達到Quota限制
    400Exist.EndpointGroupThe endpoint group already exists.終端節點組已存在
    400NoPermission.VpcEndpointYou are not authorized to perform the operation.用戶沒有創建服務關聯角色的權限,請聯系主賬號或權限管理員授權當前用戶AliyunGlobalAccelerationFullAccess或者創建服務關聯角色的自定義權限。自定義權限策略的相關信息包含以下內容:ServiceName為vpcendpoint.ga.aliyuncs.com,服務關聯角色名稱為AliyunServiceRoleForGaVpcEndpoint,執行該操作所需的用戶權限為ram:CreateServiceLinkedRole。

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

    變更歷史

    變更時間變更內容概要操作
    2024-08-30OpenAPI 錯誤碼發生變更查看變更詳情
    2023-08-15OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更查看變更詳情