All Products
Search

This Product

    ApsaraDB RDS:CreateTempDBInstance

    Document Center

    ApsaraDB RDS:CreateTempDBInstance

    Last Updated:Apr 17, 2024

    Creates a temporary instance for an RDS instance that runs SQL Server 2008 R2 and uses local disks.

    Operation description

    Supported database engines

    Your RDS instance runs SQL Server 2008 R2 with local disks.

    References

    Note Before you call this operation, carefully read the following documentation. Make sure that you fully understand the prerequisites and impacts for calling this operation.

    Restore the data of an ApsaraDB RDS for SQL Server instance by using a temporary RDS instance

    Debugging

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

    Authorization information

    The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

    • Operation: the value that you can use in the Action element to specify the operation on a resource.
    • Access level: the access level of each operation. The levels are read, write, and list.
    • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
      • The required resource types are displayed in bold characters.
      • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
    • Condition Key: the condition key that is defined by the cloud service.
    • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
    OperationAccess levelResource typeCondition keyAssociated operation
    rds:CreateTempDBInstanceWRITE
    • DBInstance
      acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}
    • rds:ResourceTag
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    DBInstanceIdstringYes

    The instance ID.

    		rm-uf6wjk5******
    BackupIdintegerNo

    The backup set ID. You can call the DescribeBackups operation to query the backup set ID.

    Note You must specify at least one of the BackupId or RestoreTime parameters.
    		603******
    RestoreTimestringNo

    The specified point in time within the backup retention period. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

    Note
  • The time can be set to a point in time within the last seven days and must be more than 30 minutes earlier than the current time. The default time zone is UTC.
  • You must specify at least one of the BackupId and RestoreTime parameters.
    •
    		2011-06-11T16:00:00Z
    ResourceGroupIdstringNo

    The resource group ID.

    		rg-acfmy*****

    Response parameters

    ParameterTypeDescriptionExample
    object

    The response parameters.

    TempDBInstanceIdstring

    The temporary instance ID.

    		sub138****_rm-******
    RequestIdstring

    The request ID.

    		248DE93F-8647-4B9D-8287-4A4A0FE56AD5

    Examples

    Sample success responses

    JSONformat

    {
  "TempDBInstanceId": "sub138****_rm-******",
  "RequestId": "248DE93F-8647-4B9D-8287-4A4A0FE56AD5"
}

    Error codes

    HTTP status codeError codeError messageDescription
    400OperationDenied.DBInstanceStatusThe operation is not permitted due to status of instance.The instance status does not support the operation.
    400IncorrectInstanceNetworkTypeThe specified parameter InstanceNetworkType is not valid.-
    400InvalidAvailableArea.NotFoundSpecified available area does not exist in RDS.-
    400InvalidRestoreType.FormatSpecified restore type is not valid.The restoration type is invalid. Specify a valid restoration type.
    400ParamTypeErrorThe parameter type error.The parameter type is invalid.
    400InvalidRetainInstance.FormatSpecified retain instance is not valid.The value of the RestoreTime parameter is invalid. Check the value of this parameter.
    400InvalidRestoreTime.FormatSpecified restore time is not valid.The operation failed. The point in time is invalid. Specify a valid point in time.
    400InvalidRegion.FormatSpecified Region is not valid.The region ID is invalid. Check the region ID.
    400InvalidInstanceLevelExtraInfoSpecified class code has error extra info.-
    403OperationDenied.TempDBInstanceExistsThe operation is not permitted due to temp instance exist.The operation failed. A temporary RDS instance has been created for the RDS instance.
    403IncorrectDBInstanceTypeCurrent DB instance engine and type does not support operations.The operation failed. The operation is not supported for the database engine of the RDS instance.
    403IncorrectDBInstanceStateCurrent DB instance state does not support this operation.-
    403IncorrectDBInstanceCharacterTypeCurrent DB Instance character_type does not support this operation.This operation is not supported for the character type of the current instance.
    403InvalidBackupLogStatusCurrent backup log enable status does not support this operation.The operation failed. Log backups are not enabled, and therefore data cannot be restored to a specified point in time.
    403ChildDBInstanceExistsCurrent DB instance had child instance.The read-only instance already exists.
    403IncorrectDBInstanceThe current DB instance does not support this operation.The operation failed. The operation is not supported for the RDS instance.
    403IncorrectBackupSetMethodCurrent backup set method does not support operations.The operation failed. The data backup file does not support the restoration of individual databases and tables.
    403IncorrectBackupSetStateCurrent backup set state does not support operations.The operation failed. The data backup file is not in a ready state.
    403IncorrectDBInstanceConnTypeCurrent DB instance conn type does not support this operation.The operation is not supported for the connection type of the RDS instance.
    403IncorrectDBInstanceStateThe current database instance state does not support the operation.The operation failed. The RDS instance is not running.
    404InvalidDBInstanceName.NotFoundThe specified db instance is not found.The operation failed. The instance ID cannot be found.
    404IncorrectDBInstanceLockModeCurrent DB instance lock mode does not support this operation.The operation failed. The RDS instance is locked.
    404InvalidBackupSetID.NotFoundSpecified backup set ID does not exist.The backup set does not exist. Specify an available backup set.

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

    Change history

    Change timeSummary of changesOperation
    No change history