All Products
Search
Document Center

ApsaraDB for OceanBase (Deprecated):ModifyTenantEncryption

Last Updated:Jan 13, 2026

You can call this operation to enable transparent encryption for a tenant.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdstringYes

The ID of the OceanBase cluster.

ob317v4uif****
TenantIdstringYes

The ID of the tenant.

ob2mr3oae0****
EncryptionTypestringYes

The encryption type. Valid values:

  • INTERNAL: a service key (automatically generated by the cloud service)
  • USER_KMS: a custom key (Alibaba Cloud KMS)
Note After transparent encryption is enabled for cloud disks, it cannot be disabled.
INTERNAL
EncryptionKeyIdstringNo

The ID of the key.

key-shh322****470h8v0-g2ll85****

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

Id of the request

EE205C00-30E4-****-****-87E3A8A2AA0C
TenantEncryptionobject

job

InstanceIdstring

The ID of the OceanBase cluster.

ob317v4uif****
TenantIdstring

The ID of the tenant.

ob2mr3oae0****
EncryptionTypestring

The encryption type. Valid values:

  • INTERNAL: a service key (automatically generated by the cloud service)
  • USER_KMS: a custom key (Alibaba Cloud KMS)
Note After transparent encryption is enabled for cloud disks, it cannot be disabled.
INTERNAL

Examples

Sample success responses

JSONformat

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "TenantEncryption": {
    "InstanceId": "ob317v4uif****",
    "TenantId": "ob2mr3oae0****",
    "EncryptionType": "INTERNAL"
  }
}

Error codes

HTTP status codeError codeError message
500InternalErrorThe request processing has failed due to some unknown error.

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

Change history

Change timeSummary of changesOperation
No change history