DedicatedIpList - Direct Mail - Alibaba Cloud ドキュメントセンター

購入済みの専用 IP アドレスの一覧を表示します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

dm:DedicatedIpList

none

*All Resource

*

なし

リクエスト構文

GET  HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
PageIndex	integer	必須	ページインデックス（1 から始まる）。	1
PageSize	integer	必須	1 ページあたりの表示件数。	10
Keyword	string	任意	IP アドレスを検索するキーワード。	xxx

レスポンスフィールド

フィールド	型	説明	例
	object	応答オブジェクト。
TotalCounts	integer	購入済みの専用 IP アドレスの合計数。	5
RequestId	string	リクエスト ID。	xxx
HasMore	boolean	次のページの結果が存在するかどうかを示します。	false
CurrentPage	integer	現在のページ番号。	1
PageSize	integer	1 ページあたりの表示件数。	10
Ips	array<object>	IP アドレスの一覧。
	array<object>	購入済み IP アドレスの詳細情報。
Id	string	IP アドレスの ID。これは、購入済みインスタンスの ID と一致します。	xxx
Ip	string	IP アドレス。	xxx
InstanceId	string	購入済みインスタンスの ID。	xxx
StartTime	string	IP アドレスの購入日時。	2025-05-12T09:19:20Z
ExpiredTime	string	有効期限。	2025-06-12T09:19:20Z
Status	string	IP アドレスのステータス。列挙値: sold : 購入済み expired : 有効期限切れ	sold
WarmupStatus	string	ウォームアップのステータス。列挙値: init : 未開始 processing : 実行中 finish : 完了	finish
WarmupType	string	ウォームアップ方式。列挙値: sysCusStream : システムによる自動ウォームアップ cusSelfManager : 手動ウォームアップ	cusSelfManager
IpPoolName	string	IP アドレスが所属する IP プールの名前。	xxx
IpExt	object	拡張プロパティ。
HasSendMail	boolean	メール送信済みかどうかを示します。列挙値: true : はい false : いいえ	true
AutoRenewal	boolean	自動更新が有効かどうかを示します。列挙値: true : はい false : いいえ	false
LastWarmUpTypeChangedTime	string	ウォームアップステータスが最後に変更された日時。	2025-08-07T07:23:49.329Z
ZoneId	string	IP アドレスが配置されているゾーンの ID。 ap-southeast-1a ap-southeast-1b cn-hangzhou-k cn-shanghai-l eu-central-1a eu-central-1b us-east-1a us-east-1b	ap-southeast-1a

例

成功レスポンス

JSONJSON

{
  "TotalCounts": 5,
  "RequestId": "xxx",
  "HasMore": false,
  "CurrentPage": 1,
  "PageSize": 10,
  "Ips": [
    {
      "Id": "xxx",
      "Ip": "xxx",
      "InstanceId": "xxx",
      "StartTime": "2025-05-12T09:19:20Z",
      "ExpiredTime": "2025-06-12T09:19:20Z",
      "Status": "sold",
      "WarmupStatus": "finish",
      "WarmupType": "cusSelfManager",
      "IpPoolName": "xxx",
      "IpExt": {
        "HasSendMail": true,
        "AutoRenewal": false,
        "LastWarmUpTypeChangedTime": "2025-08-07T07:23:49.329Z"
      },
      "ZoneId": "ap-southeast-1a"
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。