インスタンスに実装されている検査・スコアリング機能の結果を照会します。

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
MySQL と Redis のみがサポートされています。
InstanceArea String 必須 RDS

インスタンスのデータベースタイプ。 有効値:

  • RDS: クラウドインスタンス
  • ECS: 自己管理型 ECS インスタンス
  • IDC: Alibaba Cloud にデプロイされていない自己管理型インスタンス
    IDC はあなたのデータセンターです。
PageNo String 必須 1

返されるページ数。 値は 0 より大きく、INTEGER データ型の最大値を超えない整数である必要があります。 デフォルト値: 1。

PageSize String 必須 10

各ページで返されるエントリ数。 デフォルト値: 10。

StartTime String 必須 1608888296000

照会する期間の開始時刻。 UNIX タイムスタンプをミリ秒単位で指定します。

SearchMap String 任意 InstanceId

フィルターの条件を設定します。 以下のフィルター条件を使用できます。

  • InstanceId: 単一インスタンスの ID。
  • InstanceIds: 複数のインスタンス ID のリスト。
  • region: インスタンスがデプロイされているリージョン。

レスポンスパラメーター

パラメーター データ型 説明
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
MySQL と Redis のみがサポートされています。
EngineVersion String 5.7

データベースエンジンのバージョン番号。

InstanceArea String RDS

インスタンスのデータベースタイプ。 有効値:

  • RDS: クラウドインスタンス
  • ECS: 自己管理型 ECS インスタンス
  • IDC: Alibaba Cloud にデプロイされていない自己管理型インスタンス
    IDC はあなたのデータセンターです。
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

リクエストが成功したかどうかを示します。

  • true: リクエストは成功です。
  • false: リクエストは失敗です。

リクエストの例

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 エラーセンター」をご参照ください。