合成 API モニタリングジョブの更新 API
このページでは、合成 API モニタリングジョブを更新するために使用される API について説明します。
Update an API Monitoring Job
指定された JSON ペイロードで API モニタリングジョブを更新します。
Resource URL
PUT /v1/synthetic/api/schedule/<id>
Request/Response Format
JSON
Example
- リクエスト
-
{ "_id": "job_id", "version": 2, "scheduleRunConfigs": [ { "rate": { "value": 15, "unit": "MINUTES" }, "daysOfWeek": [ "SUN", "WED", "FRI", "MON", "THUR", "SAT", "TUES" ], "timezone": "UTC" } ], "userEnabled": true, "systemEnabled": true, "type": "ALL_BROWSERS", "rate": { "value": 15, "unit": "MINUTES" }, "daysOfWeek": [ "SUN", "WED", "FRI", "MON", "THUR", "SAT", "TUES" ], "timezone": "UTC", "description": "appd1", "appKey": "appkey", "scheduleMode": "NONE", "script": { "contentType": "INLINE_PYTHON_3", "script": "pageUrl = \"http://www.appdynamics.com\"\ndriver.get(pageUrl)\nassert \"AppDynamics\" in driver.title, \"Title should contain AppDynamics\"" }, "browserCodes": [ "Chrome" ], "chromeVersions": [ "86" ], "locationCodes": [ "M50" ], "failOnPageError": true, "captureVisualMetrics": true, "simulateMobileBrowser": false, "networkProfile": { "name": "Native", "downloadKbps": 5000, "uploadKbps": 1000, "roundtripTimeMillis": 28, "packetLossPercent": 0, "isDefault": false }, "timeoutSeconds": 30, "state": { "lastFireTime": "2022-04-01T04:49:46.544Z" }, "projectedUsage": { "projectedDailyRuns": 96, "projectedMonthlyRuns": 2880 }, "performanceCriteria": { "retestOnWarning": false, "retestOnCritical": false, "criterion": [] }, "composableConfig": { "numBeforeConfirmedError": 0, "resourceErrorDetection": { "ignoreWhen": { "resourceUrlContains": [], "resourceMimeType": [] }, "onlyWhen": { "resourceUrlContains": [], "resourceMimeType": [] } } }, "created": "2022-04-01T04:49:46.538Z", "updated": "2022-04-01T04:50:13.325Z" } - レスポンス
-
{ "_id": "job_id", "version": 1, "scheduleRunConfigs": [ { "rate": { "value": 1, "unit": "MINUTES" }, "daysOfWeek": [ "WED", "FRI", "SUN", "SAT", "TUES", "MON", "THUR" ], "timezone": "UTC" } ], "userEnabled": true, "systemEnabled": true, "type": "ALL_BROWSERS", "rate": { "value": 15, "unit": "MINUTES" }, "daysOfWeek": [ "WED", "FRI", "SUN", "SAT", "TUES", "MON", "THUR" ], "timezone": "UTC", "description": "https://appdynamics.com", "appKey": "appKey", "scheduleMode": "NONE", "url": "https://appdynamics.com", "browserCodes": [ "Chrome" ], "chromeVersions": [ "86" ], "locationCodes": [ "BOM", "M50" ], "failOnPageError": true, "captureVisualMetrics": true, "simulateMobileBrowser": false, "networkProfile": { "name": "Native", "downloadKbps": 5000, "uploadKbps": 1000, "roundtripTimeMillis": 28, "packetLossPercent": 0, "isDefault": false }, "timeoutSeconds": 15, "state": { "lastFireTime": "2022-04-06T05:57:16.000Z", "nextFireTime": "2022-04-06T06:00:16.000Z" }, "projectedUsage": { "projectedDailyRuns": 2880, "projectedMonthlyRuns": 86400 }, "performanceCriteria": { "retestOnWarning": false, "retestOnCritical": false, "criterion": [] }, "composableConfig": { "numBeforeConfirmedError": 0, "resourceErrorDetection": { "ignoreWhen": { "resourceUrlContains": [], "resourceMimeType": [] }, "onlyWhen": { "resourceUrlContains": [], "resourceMimeType": [] } } }, "created": "2022-04-05T05:30:36.426Z", "updated": "2022-04-05T05:30:36.426Z" }
Enable or Disable an API Monitoring Job
次の値を更新することで、API モニタリングジョブを有効または無効にすることができます。
| アクション | フィールド名 | 値 |
|---|---|---|
|
API モニタリングジョブを有効にする |
ユーザー有効 | true |
| API モニタリングジョブを無効にする | userEnabled | false |
Response Parameter
| パラメータ名 | Parameter Type | 値 | 説明 | 必須リクエスト |
|---|---|---|---|---|
|
id | 文字列 |
API モニタリングジョブのジョブ ID |
API モニタリングジョブの一意の識別子。 ジョブ ID を取得するには、以下の手順を実行します。
| あり |
| version | 数 |
ジョブが更新されるたびに、バージョンの値が 1 倍に増加します。 "version" があるジョブ: | いいえ | |
scheduleRunConfigs | - | いいえ | ||
rate | - | いいえ | ||
value | 数 |
分:1 ~ 60 時間:1 ~ 24 日:「ヌル」 | いいえ | |
unit | 文字列 | 分、時間、または日 | いいえ | |
daysOfWeek | 文字列 | "SUN", "MON", "TUES", "WED", "THUR", "FRI", "SAT" | いいえ | |
timeRange | 文字列 | hh:mm AM/PM から hh:mm AM/PM まで | いいえ | |
timezone | 文字列 | "UTC" | GMT +/-hh:mm | いいえ |
startTime | 文字列 | dd/mm/yyyy hh:mm AM/PM | いいえ | |
endTime | 文字列 | dd/mm/yyyy hh:mm AM/PM | いいえ | |
userEnabled | ブーリアン | true または false | いいえ | |
systemEnabled | ブーリアン | ライセンスがなくなると、このフィールドは無効になります。 | いいえ | |
type | 文字列 | いいえ | ||
rate | 文字列 | いいえ | ||
value | 数字 | いいえ | ||
unit | 文字列 | いいえ | ||
daysOfWeek | 文字列 | いいえ | ||
timeRange | 文字列 | いいえ | ||
timezone | 文字列 | いいえ | ||
description | 文字列 | いいえ | ||
startTime | 文字列 | いいえ | ||
endTime | 文字列 | いいえ | ||
appKey | 文字列 | アプリケーションキー |
コントローラからアプリケーションキーを取得できます。
| いいえ |
scheduleMode | 文字列 | いいえ | ||
url | 文字列 | "null" または監視する URL |
監視する URL。 このパラメータを使用する場合、 | いいえ |
script | 文字列 |
"null" |
スクリプト化されたジョブがある場合は、ユーザーフローまたは動作のシミュレーションに使用される python ベースの selenium スクリプトを指定します。 このパラメータを使用する場合、 | いいえ |
contentType | 文字列 | "null" or "INLINE_PYTHON_3" |
| いいえ |
script | 文字列 | "null" or Python script | スクリプト化されたジョブ用の Python ベースの Selenium スクリプト | いいえ |
credentialPlaceholders | 文字列 | いいえ | ||
apiMetadata | 文字列 | Web モニタリングジョブのスクリプトオブジェクト | いいえ | |
browserCodes | 文字列 |
次の Synthetic 内部ブラウザコードを使用します。
| あり | |
chromeVersions | 文字列 | Chrome ブラウザバージョン 86 | あり | |
locationCodes | 文字列 |
各エージェントロケーションの Synthetic 内部ロケーションコード。「ロケーションコード」を参照してください。 | あり | |
failOnPageError | ブーリアン | いいえ | ||
captureVisualMetrics | ブーリアン | true または false | いいえ | |
simulateMobileBrowser | ブーリアン | true または false | いいえ | |
|
networkProfile | 文字列 | "name":"Native"、"downloadKbps":5000、"uploadKbps":1000、"roundtripTimeMillis":28、"packetLossPercent":0、"isDefault":false | いいえ | |
|
name | 文字列 | カスタム、ピクセル、iPad、iPhone SE | デバイスの名前 | いいえ |
|
説明 | 文字列 |
名前がカスタムの場合: 名前フィールドがカスタムでない場合: | Mozilla/5.0(Linux、Android 7.0、SAMSUNG SM-G950F Build/NRD90M)AppleWebKit/537.36(KHTML、例:Gecko)SamsungBrowser/5.2 Chrome/51.0.2704.106 Mobile Safari/537.36 | いいえ |
downloadKbps | 数字 | 数字 | ダウンロード帯域幅(kbps 単位) | いいえ |
uploadKbps | 数字 | 数字 | アップロード帯域幅(kbps 単位) | いいえ |
roundtripTimeMillis | 数字 | 数字 | 遅延時間(ミリ秒単位) | いいえ |
packetLossPercent | 数字 | 0~100 | パケット損失率 | いいえ |
isDefault | ブーリアン | true または false | いいえ | |
timeoutSeconds | 数字 | 5 ~ 300 | 秒 | いいえ |
state | - | いいえ | ||
lastFireTime | 文字列 | いいえ | ||
nextFireTime | 文字列 | いいえ | ||
projectedUsage | - | いいえ | ||
projectedDailyRuns | 数字 | いいえ | ||
projectedMonthlyRuns | 数字 | いいえ | ||
performanceCriteria | - | いいえ | ||
retestOnWarning | ブーリアン | true または false | 警告イベントで再テスト | いいえ |
retestOnCritical | ブーリアン | true または false | 重大なイベントで再テスト | いいえ |
criterion | 文字列 | いいえ | ||
composableConfig | - | このパラメータを使用して、以下を構成できます。
| いいえ | |
numBeforeConfirmedError | 数字 | 0、1、2、3、5、または 10 | Number of retries | いいえ |
resourceErrorDetection | - | いいえ | ||
ignoreWhen | - | いいえ | ||
resourceUrlContains | 文字列 | カンマ区切りリスト | リソース URL のリスト | いいえ |
resourceMimeType | 文字列 | いいえ | ||
onlyWhen | - | いいえ | ||
resourceUrlContains | 文字列 | カンマ区切りリスト | リソース URL のリスト | いいえ |
resourceMimeType | 文字列 | いいえ | ||
created | 文字列 | いいえ | ||
updated | 文字列 | いいえ |
Response Status Codes
| コード | 説明 |
|---|---|
| 200 | 成功 |
| 401 | Unauthorized |
| 402 | ジョブの制限を超えました |
| 422 | 検証の失敗 |
| 429 | スロットル |
| 500 | 内部サーバーエラーです |