All Products
Search
Document Center

ApsaraDB for OceanBase:DescribeInstanceSecurityConfigs

Last Updated:Apr 29, 2024

You can call this operation to query security check items of an OceanBase cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdstringYes

The ID of the OceanBase cluster.

ob317v4uif****
CheckIdstringNo

The unique identifier of the check.

xxx

Response parameters

ParameterTypeDescriptionExample
object

The return result of the request.

RequestIdstring

The ID of the request.

EE205C00-30E4-****-****-87E3A8A2AA0C
InstanceSecurityConfigsobject

The return result of the request.

TotalCheckCountinteger

The total number of security check items for the cluster.

5
TotalRiskCountinteger

The total number of detected cluster security risks.

0
SecurityConfigsobject []

The list of check items.

ConfigNamestring

The name of the specific check item.

xxx
Riskboolean

Specifies whether a risk is detected.

true
RiskDescriptionstring

Security recommendations.

xxx
ConfigGroupstring

The group of the check.

WHITELIST
ConfigDescriptionstring

The name of the check item.

Check whether the scope of the cluster allowlist is too big
CheckTimestring

The time when the check was performed.

2023-08-07 15:30:00
InstanceIdstring

The ID of the OceanBase cluster.

ob317v4uif****
CheckIdstring

The unique identifier of the check.

xxx

Examples

Sample success responses

JSONformat

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "InstanceSecurityConfigs": {
    "TotalCheckCount": 5,
    "TotalRiskCount": 0,
    "SecurityConfigs": [
      {
        "ConfigName": "xxx",
        "Risk": true,
        "RiskDescription": "xxx",
        "ConfigGroup": "WHITELIST",
        "ConfigDescription": "Check whether the scope of the cluster allowlist is too big"
      }
    ],
    "CheckTime": "2023-08-07 15:30:00",
    "InstanceId": "ob317v4uif****",
    "CheckId": "xxx"
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-10-30The request parameters of the API has changed. The response structure of the API has changedsee changesets
Change itemChange content
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: CheckId
Output ParametersThe response structure of the API has changed.