Queries the summary information about the check results of cloud service configurations. The summary information includes the number of risk items, the risk rate, the number of affected assets, the last check time, and the statistics on each type of check item.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeRiskCheckSummary

The operation that you want to perform.

Set the value to DescribeRiskCheckSummary.

SourceIp String No 1.2.X.X

The source IP address of the request.

Lang String No zh

The natural language of the request and response. Default value: zh. Valid values:

  • zh: Chinese
  • en: English
ResourceDirectoryAccountId String No 12324284232342432

The ID of the member that is added to the multi-account control list.

Response parameters

Parameter Type Example Description
RequestId String 291B49F9-1685-4005-9D34-606B6F78740F

The ID of the request, which is used to locate and troubleshoot issues.

RiskCheckSummary Struct

The summary information about the check results of cloud service configurations.

AffectedAssetCount Integer 0

The number of affected assets.

DisabledRiskCount Integer 0

The number of the check items that fail the check.

EnabledRiskCount Integer 3

The number of the check items that pass the check.

Groups Array of group

The statistics on each type of check item.

CountByStatus Array of statusCount

The statistics on check items.

Count Integer 2

The number of detected risk items.

Status String pass

The status of a check item after the check is finished. Valid values:

  • pass: The check item passes the check, which indicates that the check item is normal.
  • failed: The check item fails the check, which indicates that risks are detected for the check item.
Id Long 1

The type ID of the check item.

RemainingTime Integer 0

The remaining time before the check is complete.

Sort Integer 1

The sequence number of the check item type in the All Types drop-down list in the console.

Status String finish

The status of the check. Valid values:

  • finish: The check is finished.
  • running: The check is in process.
  • waiting: The check is pending.
  • notStart: The check is not started.
Title String Identity authentication and permissions

The type of the check items.

ItemCount Integer 4

The number of check items.

PreviousCount Integer 0

The number of detected risk items in the last check.

PreviousTime Long 1545012926000

The timestamp of the last check. Unit: milliseconds.

RiskCount Integer 1

The total number of detected risk items.

RiskLevelCount Array of levelCount

The number of check items at each severity level. Valid values:

  • high
  • medium
  • low
Count Integer 1

The number of check items at a specific severity level.

Key String medium

The severity level of a check item.

RiskRate Float 0.25

The proportion of risk items to all check items.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeRiskCheckSummary
&<Common request parameters>

Sample success responses

XML format

<DescribeRiskCheckSummary>
  <RequestId>291B49F9-1685-4005-9D34-606B6F78740F</RequestId>
  <RiskCheckSummary>
        <DisabledRiskCount>0</DisabledRiskCount>
        <PreviousTime>1545012926000</PreviousTime>
        <RiskRate>0.25</RiskRate>
        <ItemCount>4</ItemCount>
        <PreviousCount>0</PreviousCount>
        <EnabledRiskCount>3</EnabledRiskCount>
        <AffectedAssetCount>0</AffectedAssetCount>
        <RiskCount>1</RiskCount>
        <Groups>
              <Status>finish</Status>
              <RemainingTime>0</RemainingTime>
              <Sort>1</Sort>
              <Title>Identity authentication and permissions</Title>
              <Id>1</Id>
              <CountByStatus>
                    <Status>pass</Status>
                    <Count>2</Count>
              </CountByStatus>
        </Groups>
        <RiskLevelCount>
              <Count>1</Count>
              <Key>medium</Key>
        </RiskLevelCount>
  </RiskCheckSummary>
</DescribeRiskCheckSummary>

JSON format

{
    "RequestId": "291B49F9-1685-4005-9D34-606B6F78740F",
    "RiskCheckSummary": {
        "DisabledRiskCount": "0",
        "PreviousTime": "1545012926000",
        "RiskRate": "0.25",
        "ItemCount": "4",
        "PreviousCount": "0",
        "EnabledRiskCount": "3",
        "AffectedAssetCount": "0",
        "RiskCount": "1",
        "Groups": [
            {
                "Status": "finish",
                "RemainingTime": "0",
                "Sort": "1",
                "Title": "Identity authentication and permissions",
                "Id": "1",
                "CountByStatus": [
                    {
                        "Status": "pass",
                        "Count": "2"
                    }
                ]
            }
        ],
        "RiskLevelCount": [
            {
                "Count": "1",
                "Key": "medium"
            }
        ]
    }
}

Error codes

For a list of error codes, visit the API Error Center.