インスタンスに実装されている検査・スコアリング機能の結果を照会します。
Database Autonomy Service (DAS) は、検査・スコアリング機能をサポートしています。 この機能により、インスタンスのヘルスステータスを定期的に検査してスコアリングすることができます。 これにより、データベースの実行ステータスを知ることができます。 詳細については、「検査とスコアリング」をご覧ください。
この操作を呼び出す前に、以下の条件が満たされていることを確認します。
- この操作は、ApsaraDB RDS for MySQL データベース、Elastic Compute Service (ECS) インスタンス上の自己管理型 MySQL データベース、データセンター内の自己管理型 MySQL データベース、および ApsaraDB for Redis データベースにのみ適用されます。
- Alibaba Cloud SDK を使用している場合は、aliyun-sdk-core のバージョンが V4.3.3 以降であることを確認します。 最新バージョンの使用を推奨します。
- DAS の SDK バージョンは、V1.0.3 以降である必要があります。
- SDK を使用して DAS サービスを呼び出す場合は、リージョンを cn-shanghai に設定する必要があります。
リクエストパラメーター
| パラメーター | データ型 | 必須/任意 | 例 | 説明 |
|---|---|---|---|---|
| Action | String | 必須 | GetInstanceInspections |
実行したい操作。 値を GetInstanceInspections に設定します。 |
| EndTime | String | 必須 | 1608888296000 |
照会する期間の終了時刻。 UNIX タイムスタンプをミリ秒単位で指定します。 注 終了時刻は開始時刻よりも後の時刻にする必要があります。
|
| Engine | String | 必須 | MySQL |
データベースのエンジンを設定します。 有効値:
注 MySQL と Redis のみがサポートされています。
|
| InstanceArea | String | 必須 | RDS |
インスタンスのデータベースタイプ。 有効値:
|
| PageNo | String | 必須 | 1 |
返されるページ数。 値は 0 より大きく、INTEGER データ型の最大値を超えない整数である必要があります。 デフォルト値: 1。 |
| PageSize | String | 必須 | 10 |
各ページで返されるエントリ数。 デフォルト値: 10。 |
| StartTime | String | 必須 | 1608888296000 |
照会する期間の開始時刻。 UNIX タイムスタンプをミリ秒単位で指定します。 |
| SearchMap | String | 任意 | InstanceId |
フィルターの条件を設定します。 以下のフィルター条件を使用できます。
|
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
|---|---|---|---|
| Code | String | 200 |
返された状態コード。 |
| Data | Struct |
詳細。 |
|
| List | BaseInspection の配列 |
詳細情報のリスト。 |
|
| BaseInspection | |||
| Data | String | "data": { "hasDeadLock": false, "exceptionTableMap": {}, "bigTransactionCount": 0, "cpu": 4, "isRds": true, "rdsEnable": true, "enable": false, "activeSessions": [], "bigTransactionList": [], "bigSessionList": [ { "blockDuration": 0, "active": false, "Time": 0, "db": "" }, |
返されたデータ。 |
| EndTime | Long | 1608888296000 |
照会する期間の終了時刻。 UNIX タイムスタンプをミリ秒単位で指定します。 注 終了時刻は開始時刻よりも後の時刻にする必要があります。
|
| GmtCreate | Long | 1603247192000 |
タスクが作成された時刻。 この値はミリ秒単位の UNIX タイムスタンプです。 |
| Instance | Struct |
インスタンス情報。 |
|
| AccountId | String | 108398049688**** |
アカウントの ID。 Alibaba Cloud アカウント管理センターのセキュリティ設定ページで、ログインアカウントの ID を照会できます。 |
| Engine | String | MySQL |
データベースのエンジン。 有効値:
注 MySQL と Redis のみがサポートされています。
|
| EngineVersion | String | 5.7 |
データベースエンジンのバージョン番号。 |
| InstanceArea | String | RDS |
インスタンスのデータベースタイプ。 有効値:
|
| InstanceClass | String | rds.mysql.s2.xlarge |
インスタンスタイプ。 |
| InstanceId | String | rm-bp10usoc1erj**** |
インスタンスの ID。 |
| NetworkType | String | Vpc |
インスタンスのネットワークタイプ。 |
| NodeId | String | rm-bp10usoc1erj7**** |
インスタンスのノードの ID。 |
| Region | String | cn-hangzhou |
インスタンスがデプロイされているリージョンの ID。 |
| Uuid | String | hdm_3063db6792965c080a4bcb6e6304**** |
インスタンスの一意の識別子。 |
| VpcId | String | vpc-bp1knt7m55z9exoo7**** |
インスタンスがデプロイされている VPC の ID。 |
| Score | Integer | 100 |
インスタンスの検査スコア。 |
| ScoreMap | String | "cpu": 4 |
スコアの減点の詳細。 |
| StartTime | Long | 1608888296000 |
照会する期間の開始時刻。 UNIX タイムスタンプをミリ秒単位で指定します。 |
| PageNo | Long | 1 |
返されるページ数。 値は 0 より大きく、INTEGER データ型の最大値を超えない整数である必要があります。 デフォルト値: 1。 |
| PageSize | Long | 10 |
1 ページあたりで返されるエントリ数。 デフォルト値: 10。 |
| Total | Long | 4 |
返されたエントリの総数。 |
| Message | String | Successful |
リクエストに対して返されるメッセージ。 注 リクエストが成功した場合、Successful が返されます。 リクエストが失敗した場合、エラーコードなどのリクエスト例外メッセージが返されます。
|
| RequestId | String | B6D17591-B48B-4D31-9CD6-9B9796B2**** |
リクエストの ID。 |
| Success | String | true |
リクエストが成功したかどうかを示します。
|
例
リクエストの例
http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetInstanceInspections
&PageNo=1
&PageSize=10
&<Common request parameters>
成功レスポンスの例
XML 形式
<GetInstanceInspectionsReponse>
<RequestId> B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
<Message>Successful</Message>
<Data>
<PageSize>10</PageSize>
<Total>4</Total>
<PageNo>1</PageNo>
<List>
<BaseInspection>
<GmtCreate>1603247192000</GmtCreate>
<Score>100</Score>
<ScoreMap>"cpu": 4</ScoreMap>
<EndTime>1608888296000</EndTime>
<StartTime>1608888296000</StartTime>
<Data>"data": { "hasDeadLock": false, "exceptionTableMap": {}, "bigTransactionCount": 0, "cpu": 4, "isRds": true, "rdsEnable": true, "enable": false, "activeSessions": [], "bigTransactionList": [], "bigSessionList": [ { "blockDuration": 0, "active": false, "Time": 0, "db": "" },</Data>
<Instance>
<Uuid>hdm_3063db6792965c080a4bcb6e6304****</Uuid>
<EngineVersion>5.7</EngineVersion>
<AccountId>123456678</AccountId>
<VpcId>vpc-bp1knt7m55z9exoo7****</VpcId>
<InstanceId>rm-bp10usoc1erj****</InstanceId>
<NetworkType>Vpc</NetworkType>
<InstanceArea>RDS</InstanceArea>
<NodeId>rm-bp10usoc1erj7****</NodeId>
<Region>cn-hangzhou</Region>
<InstanceClass>rds.mysql.s2.xlarge</InstanceClass>
<Engine>MySQL</Engine>
</Instance>
</BaseInspection>
</List>
</Data>
<Code>200</Code>
<Success>true</Success>
</GetInstanceInspectionsReponse>
JSON 形式
{"RequestId":" B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Message":"Successful",
"Data":{"PageSize":"10",
"Total":"4",
"PageNo":"1",
"List":{"BaseInspection":[{"GmtCreate":"1603247192000",
"Score":"100",
"ScoreMap":"\"cpu\": 4",
"EndTime":"1608888296000",
"StartTime":"1608888296000",
"Data":"\"data\": { \"hasDeadLock\": false, \"exceptionTableMap\": {}, \"bigTransactionCount\": 0, \"cpu\": 4, \"isRds\": true, \"rdsEnable\": true, \"enable\": false, \"activeSessions\": [], \"bigTransactionList\": [], \"bigSessionList\": [ { \"blockDuration\": 0, \"active\": false, \"Time\": 0, \"db\": \"\" },",
"Instance":{"Uuid":"hdm_3063db6792965c080a4bcb6e6304****",
"EngineVersion":"5.7",
"AccountId":"123456678",
"VpcId":"vpc-bp1knt7m55z9exoo7****",
"InstanceId":"rm-bp10usoc1erj****",
"NetworkType":"Vpc",
"InstanceArea":"RDS",
"NodeId":"rm-bp10usoc1erj7****",
"Region":"cn-hangzhou",
"InstanceClass":"rds.mysql.s2.xlarge",
"Engine":"MySQL"}}]}},
"Code":"200",
"Success":"true"}
エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。