ModifyTenantName

2026-01-29 07:18:31  Updated

Overview

You can call this API to modify the name of a tenant in an OceanBase cluster.

API details

Constraints

The caller must have an AccessKey for accessing APIs. For information about how to obtain the AccessKey ID and AccessKey secret, see Manage AccessKeys.

Request path

PUT /api/v2/instances/{instanceId}/tenants/{tenantId}/tenantName

Request parameters

Query

Name Type Required Description Example value
instanceId String Yes The ID of the OceanBase cluster. ob317v4uif****
tenantId String Yes The ID of the tenant. t33h8y08k****
tenantName String Yes The name of the tenant.
The name of the tenant supports fuzzy matching.
pay_****

Response parameters

Name Type Description Example value
data object The information about the tenant.
tenantId String The ID of the tenant. t33h8y08k****

Examples

Request example

curl -v  --request PUT \
  --url 'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/tenants/{tenantId}/tenantName ' \
  --digest   -u 'ak:sk' \
  -H 'X-Ob-Project-Id: <Project ID>'
  --data  \ '{"tenantName":"testAPI2"}'

Note

  • A project ID uniquely identifies a project. For information about how to obtain the project ID of an instance, see Manage projects.
  • Make sure that the project ID corresponding to the specified instanceId is consistent with the specified project ID.

Response example

{
  "success":true,
  "data":{
    "tenantId":"Tenant ID"
  },
  "requestId":"uuid"
}

Contact Us