追跡タスクを作成します。追跡タスクを作成すると、システムは定期的に運用レポートをメールで送信します。
操作説明
1 つのアカウントで、毎秒 3 回までこの操作を呼び出すことができます。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Name |
string |
必須 |
追跡タスクの名前。 |
Domain name report |
| Reports |
string |
必須 |
タスクによって追跡される運用レポート。データは JSON 形式でエスケープする必要があります。 |
\[{\\"reportId\\":1,\\"conditions\\":\[{\\"field\\":\\"prov\\",\\"op\\":\\"in\\",\\"value\\":\[\\"Heilongjiang\\",\\"Beijing\\"]}]}] |
| DomainName |
string |
任意 |
追跡するドメイン名。複数のドメイン名はコンマ (,) で区切ります。最大 500 個のドメイン名を指定できます。500 個を超えるドメイン名を指定する場合は、チケットを送信してください。 説明
ドメイン名を指定しない場合、ご利用の Alibaba Cloud アカウントに属するすべてのドメイン名に対して追跡タスクが作成されます。 |
www.example1.com,www.example2.com |
| Deliver |
string |
必須 |
運用レポートの送信に使用されるメソッド。運用レポートはメールでのみ送信されます。設定は JSON 形式でエスケープする必要があります。 |
{"email":{"subject":"the email subject","to":\["username@example.com","username@example.org"]}} |
| Schedule |
string |
必須 |
追跡タスクが運用レポートを送信する時間間隔を指定するパラメーター。設定は JSON 形式でエスケープする必要があります。 |
{\\"schedName\\":\\"The name of the tracking task\\",\\"description\\":\\"The description\\",\\"crontab\\":\\"000\*\*?\\",\\"frequency\\":\\"d\\",\\"status\\":\\"enable\\",\\"effectiveFrom\\":\\"2020-09-17T00:00:00Z\\",\\"effectiveEnd\\":\\"2020-11-17T00:00:00Z\\"}" |
ReDatas パラメーターのフィールド
| フィールド | 型 | 必須 | 説明 |
| reportId | String | はい | 運用レポートの ID。 |
| conditions | ConDatas[] | いいえ | レポートのフィルター条件。 |
ConDatas パラメーターのフィールド
| フィールド | 型 | 必須 | 説明 |
| field | String | いいえ | フィルターフィールド。 |
| op | String | いいえ | フィルター操作。 |
| value | String[] | いいえ | フィールド値の配列。 |
email パラメーターのフィールド
| フィールド | 型 | 必須 | 説明 |
| subject | String | はい | メールの件名。 |
| to | String[] | はい | 運用レポートの送信先メールアドレス。 |
Deliver パラメーターのフィールド
| フィールド | 型 | 必須 | 説明 |
| subject | String | いいえ | メールの件名。 |
| to | String[] | はい | 運用レポートの送信先メールアドレス。 |
Schedule パラメーターのフィールド
| フィールド | 型 | 必須 | 説明 |
| schedName | String | いいえ | 追跡タスクの名前。 |
| description | String | いいえ | 追跡タスクの説明。 |
| crontab | String | はい | 追跡タスクの実行がスケジュールされている時刻を指定します。 |
| frequency | String | はい | レポートが送信される間隔。有効な値: h:時間単位 d:日単位 w:週単位 |
| status | String | いいえ | 追跡タスクのステータス。有効な値: enable disable |
| effectiveFrom | String | いいえ | 追跡タスクの開始時刻。 |
| effectiveEnd | String | いいえ | 追跡タスクの終了時刻。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| DeliverId |
string |
追跡タスクの ID。 |
1025 |
| RequestId |
string |
リクエストの ID。 |
04F0F334-1335-436C-A1D7-6C044FE73368 |
例
成功レスポンス
JSONJSON
{
"DeliverId": "1025",
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid. | |
| 400 | TimeParseFailed | Failed to parse the time parameter. | |
| 400 | SubscriptionNotFound | The subscription is not found. | |
| 400 | NameAlreadyExists | The name already exists. | |
| 400 | DeliverExceedLimit | The maximum number of subscribed tasks is exceeded. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。