Membuat task pelacakan. Setelah Anda membuat task tersebut, sistem akan mengirimkan laporan operasional kepada Anda melalui email secara berkala.
Deskripsi operasi
Anda dapat memanggil operasi ini hingga tiga kali per detik per akun.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Name |
string |
Yes |
Nama dari tracking task. |
Domain name report |
| Reports |
string |
Yes |
Operations reports yang dilacak oleh task tersebut. Data harus di-escape dalam format JSON. |
\[{\\"reportId\\":1,\\"conditions\\":\[{\\"field\\":\\"prov\\",\\"op\\":\\"in\\",\\"value\\":\[\\"Heilongjiang\\",\\"Beijing\\"]}]}] |
| DomainName |
string |
No |
Nama domain yang akan dilacak. Pisahkan multiple domain names dengan koma (,). Anda dapat menentukan hingga 500 nama domain. Jika ingin menentukan lebih dari 500 nama domain, submit a ticket. Catatan
Jika Anda tidak menentukan nama domain, tracking task akan dibuat untuk semua nama domain yang terkait dengan Akun Alibaba Cloud Anda. |
www.example1.com,www.example2.com |
| Deliver |
string |
Yes |
Metode yang digunakan untuk mengirim operations reports. Operations reports hanya dikirimkan melalui email. Pengaturan harus di-escape dalam format JSON. |
{"email":{"subject":"the email subject","to":\["username@example.com","username@example.org"]}} |
| Schedule |
string |
Yes |
Parameter yang menentukan interval waktu pengiriman operations reports oleh tracking task. Pengaturan harus di-escape dalam format 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\\"}" |
Fields in the ReDatas parameter
| Field | Type | Required | Description |
| reportId | String | Yes | ID dari operations report. |
| conditions | ConDatas[] | No | Kondisi filter untuk laporan tersebut. |
Fields in the ConDatas parameter
| Field | Type | Required | Description |
| field | String | No | Bidang filter. |
| op | String | No | Operasi filter. |
| value | String[] | No | Array nilai bidang tersebut. |
Fields in the email parameter
| Field | Type | Required | Description |
| subject | String | Yes | Subject email. |
| to | String[] | Yes | Alamat email tujuan pengiriman operations reports. |
Fields in the Deliver parameter
| Field | Type | Required | Description |
| subject | String | No | Subject email. |
| to | String[] | Yes | Alamat email tujuan pengiriman operations reports. |
Fields in the Schedule parameter
| Field | Type | Required | Description |
| schedName | String | No | Nama dari tracking task. |
| description | String | No | Deskripsi dari tracking task. |
| crontab | String | Yes | Menentukan kapan tracking task dijadwalkan berjalan. |
| frequency | String | Yes | Interval pengiriman laporan. Nilai yang valid: h: per jam d: per hari w: per minggu |
| status | String | No | Status dari tracking task. Nilai yang valid : enable disable |
| effectiveFrom | String | No | Waktu mulai dari tracking task. |
| effectiveEnd | String | No | Waktu berakhir dari tracking task. |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| DeliverId |
string |
ID dari tracking task. |
1025 |
| RequestId |
string |
ID dari permintaan. |
04F0F334-1335-436C-A1D7-6C044FE73368 |
Contoh
Respons sukses
JSONformat
{
"DeliverId": "1025",
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid. | |
| 400 | TimeParseFailed | Failed to parse the time parameter. | Failed to parse the time parameter. |
| 400 | SubscriptionNotFound | The subscription is not found. | The subscription is not found. |
| 400 | NameAlreadyExists | The name already exists. | The specified name already exists. |
| 400 | DeliverExceedLimit | The maximum number of subscribed tasks is exceeded. | The number of tracking tasks has reached the upper limit. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.