すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud DNS:DescribeBatchResultCount

最終更新日:Sep 09, 2025

バッチ操作タスクの実行結果をタスク ID を使用してクエリします。タスク ID を指定しない場合は、最新のバッチタスクの結果が返されます。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

alidns:DescribeBatchResultCount

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Lang

string

任意

リクエストとレスポンスの言語。デフォルト値: zh。有効な値:

  • zh: 中国語

  • en: 英語

en

TaskId

integer

任意

タスク ID。

説明

タスク ID を指定すると、そのタスクの結果が返されます。このパラメータを空のままにすると、最新のタスクの結果が返されます。

1****

BatchType

string

任意

バッチ操作のタイプ。有効な値:

  • DOMAIN_ADD: ドメイン名をバッチ追加します。

  • DOMAIN_DEL: ドメイン名をバッチ削除します。

  • RR_ADD: DNS レコードをバッチ追加します。

  • RR_DEL: DNS レコードをバッチ削除します。

説明

このパラメータを空のままにすると、フィルタは適用されません。

DOMAIN_ADD

レスポンスフィールド

フィールド

説明

object

Status

integer

タスクのステータス。有効な値:

  • -1: ドメイン名または DNS レコードをインポートするためのタスクが送信されていません。

  • 0: 処理中

  • 1: 完了

  • 2: 失敗

0

TotalCount

integer

バッチで処理されるレコードの総数。

4

TaskId

integer

最後のタスクの ID。

1******

RequestId

string

リクエスト ID。

75446CC1-FC9A-4595-8D96-089D73D7A63D

FailedCount

integer

処理に失敗したドメイン名または DNS レコードの総数。

2

SuccessCount

integer

正常に処理されたドメイン名または DNS レコードの総数。

2

BatchType

string

バッチ操作のタイプ。

DOMAIN_ADD

Reason

string

タスクが失敗した理由。

No match is found for the domain name specified in the file.

成功レスポンス

JSONJSON

{
  "Status": 0,
  "TotalCount": 4,
  "TaskId": 0,
  "RequestId": "75446CC1-FC9A-4595-8D96-089D73D7A63D",
  "FailedCount": 2,
  "SuccessCount": 2,
  "BatchType": "DOMAIN_ADD",
  "Reason": "No match is found for the domain name specified in the file."
}

エラーコード

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

変更履歴

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