Skip to content

/AWS1/CL_RDS=>MODIFYTENANTDATABASE()

About ModifyTenantDatabase

Modifies an existing tenant database in a DB instance. You can change the tenant database name or the master user password. This operation is supported only for RDS for Oracle CDB instances using the multi-tenant configuration.

Method Signature

IMPORTING

Required arguments:

IV_DBINSTANCEIDENTIFIER TYPE /AWS1/RDSSTRING /AWS1/RDSSTRING

The identifier of the DB instance that contains the tenant database that you are modifying. This parameter isn't case-sensitive.

Constraints:

  • Must match the identifier of an existing DB instance.

IV_TENANTDBNAME TYPE /AWS1/RDSSTRING /AWS1/RDSSTRING

The user-supplied name of the tenant database that you want to modify. This parameter isn’t case-sensitive.

Constraints:

  • Must match the identifier of an existing tenant database.

Optional arguments:

IV_MASTERUSERPASSWORD TYPE /AWS1/RDSSENSITIVESTRING /AWS1/RDSSENSITIVESTRING

The new password for the master user of the specified tenant database in your DB instance.

Amazon RDS operations never return the password, so this action provides a way to regain access to a tenant database user if the password is lost. This includes restoring privileges that might have been accidentally revoked.

Constraints:

  • Can include any printable ASCII character except /, " (double quote), @, & (ampersand), and ' (single quote).

Length constraints:

  • Must contain between 8 and 30 characters.

IV_NEWTENANTDBNAME TYPE /AWS1/RDSSTRING /AWS1/RDSSTRING

The new name of the tenant database when renaming a tenant database. This parameter isn’t case-sensitive.

Constraints:

  • Can't be the string null or any other reserved word.

  • Can't be longer than 8 characters.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_RDSMODTENANTDATABAS01 /AWS1/CL_RDSMODTENANTDATABAS01