調用ConfigSetDetail API擷取指定配置集的詳細資料-Direct Mail-阿里雲 - Direct Mail

取得設定集詳細資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dm:ConfigSetDetail

none

*All Resource

*

無

請求文法

GET  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
Id	string	否	設定集 ID，必填。	xxx

返回參數

名稱	類型	描述	樣本值
	object	回應。
RequestId	string	請求 ID。	xxx
Detail	object	設定集資訊。
Id	string	設定集 ID。	xxx
Name	string	設定集名稱。	xxx
Description	string	描述。	xxx
IpPool	object	關聯 IP 集區。
IpPoolId	string	關聯 IP 集區 ID。	xxx
IpPoolName	string	關聯 IP 集區名稱。	xxx
IsPublicChannelBackoff	boolean	當關聯的獨立 IP 集區出現問題時，是否退避使用公共通道傳送。 true（退避）：系統在每次投遞時會剔除當前對目標信箱服務商被流量控制或列入黑名單的獨立 IP，優先使用集區內其餘可用 IP 傳送；當集區內 IP 對該信箱服務商全部被流量控制或列入黑名單時，自動改用公共通道傳送，以保障投遞成功率。流量控制或黑名單解除後自動恢復使用獨立 IP。 false（不退避）：僅使用關聯的獨立 IP 集區傳送；集區內 IP 被流量控制或列入黑名單時仍繼續使用這些 IP 投遞，可能導致投遞失敗或延遲，但可確保發信 IP 始終為您的獨立 IP。	true
ValidationOption	object	地址驗證功能選項。
Enabled	boolean	地址驗證功能是否啟用。 true：啟用。為地址驗證介面 ValidateEmail 介面的 BASIC_ONLY 模式。 false：不啟用。	true
ForbiddenStatusList	array	需要攔截的收件人地址驗證主狀態清單。發信前系統對收件人地址進行預先驗證，驗證結果主狀態命中本清單的郵件將被拒絕傳送。
	string	需要攔截的收件人地址驗證主狀態。取值： INVALID: 無效地址或地址不存在。 CATCH_ALL: Catch-all 地址，網域下任意信箱均可收信，無法確定地址真實存在。 DO_NOT_MAIL：可收信但不建議傳送，如角色帳號/一次性信箱。 UNKNOWN：無法提供驗證結果。	INVALID
ForbiddenSubStatusList	array	需要攔截的收件人地址驗證子狀態清單，提供比主狀態更細粒度的攔截控制，與 ForbiddenStatusList 取聯集生效（命中任一清單即攔截）。
	string	需要攔截的收件人地址驗證子狀態。取值： NO_DNS_ENTRIES : 無效地址，沒有 DNS 記錄。 MISSPELLED : 無效地址，拼寫錯誤。 DOES_NOT_ACCEPT_MAIL : 無效地址，郵件伺服器不接受郵件。 MAILBOX_NOT_EXISTS : 無效地址，信箱不存在。 SYSTEM_ERROR : 未知狀態，系統錯誤。 MX_FORWARD : 非正常地址，MX 轉寄。 SYNTAX_INVALID : 無效地址，語法錯誤。 ROLE_ACCOUNT : 非正常地址，角色帳號，例如 role@ info@ contact@ 等。 SMTP_CONNECT_FAILED : 未知狀態，連線對方 SMTP 伺服器失敗。 DISABLED : 無效地址，信箱已被停用。 UNSPECIFIED : 沒有說明，有效、CatchAll、未知狀態可能返回。 IP_UNROUTABLE : 無效地址，郵件伺服器 IP 不可達。 GRAY_LIST : 未知狀態，灰名單 MAILBOX_FULL : 無效地址，信箱已滿 DISPOSABLE : 非正常地址，臨時信箱，黑名單庫。 TIMEOUT_EXCEEDED : 未知狀態，超過指定的逾時時間。傳入未知取值將返回 InvalidParameter。	DISPOSABLE

樣本

正常返回樣本

JSON格式

{
  "RequestId": "xxx",
  "Detail": {
    "Id": "xxx",
    "Name": "xxx",
    "Description": "xxx",
    "IpPool": {
      "IpPoolId": "xxx",
      "IpPoolName": "xxx"
    },
    "IsPublicChannelBackoff": true,
    "ValidationOption": {
      "Enabled": true,
      "ForbiddenStatusList": [
        "INVALID"
      ],
      "ForbiddenSubStatusList": [
        "DISPOSABLE"
      ]
    }
  }
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。