該接口用于查詢定向分組的訪問地址列表。

使用說明

僅新版定向服務菜單支持定向分組功能，如果您使用的是舊版定向服務菜單，無法使用該接口。更多信息，請參見定向服務。

調試

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

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 ListDirectionalAddress

系統規定參數。取值：ListDirectionalAddress。

PageSize Integer 是 10

每頁的數量，支持10、15、25、40。
PageNo Integer 是 1

查詢頁數，需結合PageSize參數使用。
GroupId String 是 5

定向分組ID。

您可調用接口GetCardDetail在返回參數中查看定向分組ID（DirectionalGroupId）。

返回數據

名稱 類型 示例值 描述
Code String 200

接口返回碼。

  • 200：調用成功。
  • 其他：調用失敗。錯誤碼詳情，請參見錯誤碼。
ErrorMessage String InstanceId cannot be empty.

調用失敗時，返回的錯誤信息。
RequestId String E4F94B97-1D64-4080-BFD2-67461667AA43

請求ID，阿里云為該請求生成的標識符。
Success Boolean true

是否調用成功。

  • true：調用成功。
  • false：調用失敗。
LocalizedMessage String InstanceId cannot be empty.

根據當前所在地展示對應語言的錯誤提示。
Data Object

返回的訪問地址。
PageNo Integer 1

查詢頁數。
PageSize Integer 10

每頁的數量。
PageCount Integer 9

列表總頁數。
Total Integer 90

列表總數量。
List Array of UnityPayPool

訪問地址。
Address String *.aliyun.com

定向訪問地址。
AddressType String Domain

地址類型。

  • Ip：IP地址。
  • Domain：域名。
Source String user_defined

地址來源。

  • user_defined：用戶配置。
  • aliyun_defined：阿里云預配。
GroupId String 5

定向分組ID。
State Integer 500

地址狀態。

  • 100：新增處理中。
  • 200：刪除處理中。
  • 300：新增失敗。
  • 400：刪除失敗。
  • 500：新增成功。

示例

請求示例

http(s)://linkcard.aliyuncs.com/?Action=ListDirectionalAddress
&PageSize=10
&PageNo=1
&GroupId=5
&公共請求參數

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListDirectionalAddressResponse>
    <Code>200</Code>
    <ErrorMessage>InstanceId cannot be empty.</ErrorMessage>
    <RequestId>E4F94B97-1D64-4080-BFD2-67461667AA43</RequestId>
    <Success>true</Success>
    <LocalizedMessage>InstanceId cannot be empty.</LocalizedMessage>
    <Data>
        <PageNo>1</PageNo>
        <PageSize>10</PageSize>
        <PageCount>9</PageCount>
        <Total>90</Total>
        <List>
            <Address>*.aliyun.com</Address>
            <AddressType>Domain</AddressType>
            <Source>user_defined</Source>
            <GroupId>5</GroupId>
            <State>500</State>
        </List>
    </Data>
</ListDirectionalAddressResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Code" : "200",
  "ErrorMessage" : "InstanceId cannot be empty.",
  "RequestId" : "E4F94B97-1D64-4080-BFD2-67461667AA43",
  "Success" : true,
  "LocalizedMessage" : "InstanceId cannot be empty.",
  "Data" : {
    "PageNo" : 1,
    "PageSize" : 10,
    "PageCount" : 9,
    "Total" : 90,
    "List" : [ {
      "Address" : "*.aliyun.com",
      "AddressType" : "Domain",
      "Source" : "user_defined",
      "GroupId" : "5",
      "State" : 500
    } ]
  }
}