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

:DescribeUserUsageDataExportTask

最終更新日:Dec 14, 2025

過去 3 か月以内に作成された使用量エクスポートタスクを照会します。

操作説明

説明

1 つのアカウントで、1 秒あたり最大 100 回この操作を呼び出すことができます。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cdn:DescribeUserUsageDataExportTask

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

PageSize

string

任意

各ページに返すエントリの数。 デフォルト値:20。 最大値:50

有効な値:150 の整数。

20

PageNumber

string

任意

返すページ番号。 有効な値:1100000

1

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

A91BE91F-0B34-4CBF-8E0F-A2977E15AA52

UsageDataPerPage

object

ページごとに返される使用量の詳細。

PageSize

integer

ページごとに返されるエントリ数。

10

PageNumber

integer

返されたページのページ番号。

1

TotalCount

integer

返されたエントリの合計数。

10

Data

object

DataItem

array<object>

タスクに関する情報。

array<object>

Status

string

タスクの状態。

  • created:タスクは作成中です。

  • success:タスクは成功しました。

  • failed:タスクは失敗しました。

success

UpdateTime

string

タスクが最後に更新された時間。

2019-12-31T08:45:02Z

DownloadUrl

string

ダウンロード URL。

https://cdn-polaris.xxxx

CreateTime

string

タスクが作成された時間。

2019-12-31T08:43:21Z

TaskName

string

タスクの名前。

Refresh

TaskId

string

タスクの ID。

A91BE91F-0B34-4CBF-8E0F-A2977

TaskConfig

object

タスクの設定。

EndTime

string

照会された期間の終了時刻。

2019-12-30T15:59:59Z

StartTime

string

データが照会された期間の開始時刻。

2019-12-29T16:00:00Z

成功レスポンス

JSONJSON

{
  "RequestId": "A91BE91F-0B34-4CBF-8E0F-A2977E15AA52",
  "UsageDataPerPage": {
    "PageSize": 10,
    "PageNumber": 1,
    "TotalCount": 10,
    "Data": {
      "DataItem": [
        {
          "Status": "success",
          "UpdateTime": "2019-12-31T08:45:02Z",
          "DownloadUrl": "https://cdn-polaris.xxxx",
          "CreateTime": "2019-12-31T08:43:21Z",
          "TaskName": "刷新",
          "TaskId": "A91BE91F-0B34-4CBF-8E0F-A2977",
          "TaskConfig": {
            "EndTime": "2019-12-30T15:59:59Z",
            "StartTime": "2019-12-29T16:00:00Z"
          }
        }
      ]
    }
  }
}

エラーレスポンス

JSONJSON

{
  "RequestId": "A91BE91F-0B34-4CBF-8E0F-A2977E15AA52",
  "UsageDataPerPage": {
    "PageSize": 10,
    "TotalCount": 1,
    "PageNumber": 1,
    "Data": {
      "DataItem": [
        {
          "TaskId": 11,
          "UpdateTime": "2018-10-09T06:35:01Z",
          "DownloadUrl": "example.com",
          "UpdateTime": "2018-10-09T06:35:46Z",
          "CreateTime": "2018-10-09T06:33:38Z",
          "Status": "success"
          "TaskConfig": {
            "StartTime": "2018-07-31T16:00:00Z",
            "EndTime": "2018-08-31T15:59:59Z"
          },
        }
      ]
    }
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameterProduct Invalid Parameter Product.
400 InvalidParameterOperator Invalid Parameter Operator.

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

変更履歴

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