All Products
Search
Document Center

ApsaraDB for OceanBase:DescribeTenantSecurityConfigs

Last Updated:Apr 29, 2024

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

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****
TenantIdstringNo

The ID of the tenant.

t4louaeei****
CheckIdstringNo

The unique identifier of the security check.

****

Response parameters

ParameterTypeDescriptionExample
object

The return result of the request.

RequestIdstring

The ID of the request.

523E7183-****-590D-****-12DFD316614B
Configsobject

The list of parameters.

TotalCheckCountinteger

The total number of security check items.

4
TotalRiskCountinteger

The total number of detected security risks.

0
TenantSecurityConfigsobject []

The check result.

TenantIdstring

The ID of the tenant.

xxx
TenantNamestring

The name of the tenant.

xxx
RiskCountinteger

The number of detected tenant security risks.

0
SecurityConfigsobject []

The list of risks.

ConfigGroupstring

The group of the risk.

WHITELIST
ConfigNamestring

The name of the risk.

WHITELIST_RANGE_LARGE
Riskboolean

Indicates whether the risk causes security issues.

true
RiskDescriptionstring

The description of the risk.

The scope of the allowlist is too big.
ConfigDescriptionstring

The name of the check item.

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

The unique identifier of the check.

 xxx
InstanceIdstring

The ID of the OceanBase cluster.

ob317v4uif****
CheckTimestring

The time when the check was performed.

2023-08-07 15:30:00

Examples

Sample success responses

JSONformat

{
  "RequestId": "523E7183-****-590D-****-12DFD316614B",
  "Configs": {
    "TotalCheckCount": 4,
    "TotalRiskCount": 0,
    "TenantSecurityConfigs": [
      {
        "TenantId": "xxx",
        "TenantName": "xxx",
        "RiskCount": 0,
        "SecurityConfigs": [
          {
            "ConfigGroup": "WHITELIST",
            "ConfigName": "WHITELIST_RANGE_LARGE",
            "Risk": true,
            "RiskDescription": "The scope of the allowlist is too big.",
            "ConfigDescription": "Check whether the scope of the cluster allowlist is too big"
          }
        ]
      }
    ],
    "CheckId": " xxx",
    "InstanceId": "ob317v4uif****",
    "CheckTime": "2023-08-07 15:30:00"
  }
}

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.