Tüm Ürünler
Search
Belge Merkezi

:CreateAccount

Son Güncelleme:Oct 02, 2026

Bir veritabanı hesabı oluşturur.

Operation description

Uygulanabilir motorlar.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

rds:CreateAccount

create

*DBInstance

acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

  • rds:ResourceTag
  • rds:ResourceTag
  • rds:ResourceTag
None

Request parameters

Parameter

Type

Required

Description

Example

DBInstanceId

string

Yes

Örnek kimliği. Örnek kimliğini sorgulamak için DescribeDBInstances API'sini çağırabilirsiniz.

rm-uf6wjk5****

AccountName

string

Yes

Veritabanı hesabının adı.

Not

Ad benzersiz olmalıdır ve büyük harfler (yalnızca MySQL tarafından desteklenir), küçük harfler, rakamlar veya alt çizgiler içerebilir. Her motora özgü adlandırma kuralları için şu konulara bakın: MySQL hesabı oluşturma, PostgreSQL hesabı oluşturma, SQL Server hesabı oluşturma, MariaDB hesabı oluşturma.

test1

AccountPassword

string

Yes

Veritabanı hesabının parolası.

Not
  • Parola 8 ila 32 karakter uzunluğunda olmalıdır.

  • Parola şu karakter türlerinden en az üçünü içermelidir: büyük harfler, küçük harfler, rakamlar ve özel karakterler (!@#$%^&*()_+-=).

Test123456

AccountDescription

string

No

Hesabın açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve bir harf veya Çince karakter ile başlamalıdır. Rakamlar, Çince karakterler, harfler, alt çizgiler (_) ve tireler (-) içerebilir.

Not

Açıklama http:// veya https:// ile başlayamaz.

testuser

AccountType

string

No

Hesap türü. Geçerli değerler:

  • Normal (varsayılan): standart hesap.

  • Super: ayrıcalıklı kullanıcı. Örnek başına en fazla bir ayrıcalıklı kullanıcı oluşturabilirsiniz.

  • Sysadmin (yalnızca ApsaraDB RDS for SQL Server): SA izinlerine sahip veritabanı hesabı. Bu hesabı oluşturmadan önce örneğin önkoşulları karşılayıp karşılamadığını kontrol edin.

  • GlobalRO (yalnızca ApsaraDB RDS for SQL Server): global salt okunur hesap. Örnek başına en fazla iki global salt okunur hesap oluşturabilirsiniz. Veritabanı motoru sürümü SQL Server 2016 veya sonraki bir sürüm olmalı ve örnek türü adanmış örnek veya genel amaçlı örnek olmalıdır.

Normal

CheckPolicy

boolean

No

SQL Server örneğinin hesap parolası ilkesi. Geçerli değerler:

  • true: İlke uygulanır.

  • false: İlke uygulanmaz.

Not

true

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

RequestId

string

İstek kimliği.

D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD

Examples

Success response

JSON format

{
  "RequestId": "D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD"
}

Error response

JSON format

{
    "RequestId": "7463B73D-35CC-4D19-A010-6B8D65D242EF",
    "HostId": "rds.aliyuncs.com",
    "Code": "UnsupportedOperation",
    "Message": "The specified action is not supported."
}

Error codes

HTTP status code

Error code

Error message

Description

400 GeneralIns.Creating The general instance is creating.
400 GeneralIns.Maintaining The general instance is maintaining.
400 GeneralIns.Switching The general instance is Switching.
400 InvalidEngineVersion.NotSupported Current db instance does not support sysadmin.
400 Database.ConnectError Database connect error. please check instance status and database processlist
400 Account.AddError Create Account failed, please check your input value or may your input value not satisfy instance current policy
400 InvalidAccountPassword.Format Specified account password is not valid.
400 InvalidAccountDescription.Format Specified account description is not valid.
400 InvalidGeneralGroupNameOrGdnInstanceName The specified params generalGroupName or gdnInstanceName should not be null.
400 InvalidAccountPrivilege.Malformed Specified account privilege is not valid.
400 InvalidAccountName.Forbid Specified account name is a keyword in RDS.
400 InvalidDBDescription.Format Specified DB description is not valid.
400 %s DB Operation Failed:%s.
400 InvalidAccountType.Format The first account can't be normal type.
400 Order.ComboInstanceNotAllowOperate A package instance is not allowed to operate independently.
400 Price.PricingPlanResultNotFound Pricing plan price result not found.
400 Order.NoRealNameAuthentication You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication.
400 InsufficientAvailableQuota Your account quota limit is less than 0, please recharge before trying to purchase.
400 CommodityServiceCalling.Exception Failed to call commodity service.
400 RegionDissolvedEOM Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support.
400 Commodity.InvalidComponent The module you purchased is not legal, please buy it again.
400 RegionEndTimeDissolvedAustralia Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024.
400 Price.CommoditySys Commodity system call exception.
400 Pay.InsufficientBalance Insufficient available balance.
400 Order.PeriodInvalid There is a problem with the period you selected, please choose again.
400 pay.noCreditCard Account not bound to credit card.
400 Order.InstHasUnpaidOrder There is an unpaid order for the service you have purchased. Please pay or void it before placing the order.
400 noAvailablePaymentMethod No payment method is specified for your account. We recommend that you add a payment method.
400 BasicInfoUncompleted Your information is incomplete. Complete your information before the operation.
400 Risk.RiskControlRejection Your account is abnormal, please contact customer service for details.
400 Api.NotSupport Specified api is not supported.
400 ContainForbiddenLabelError There is a label that prohibits placing orders. Please contact your distributor for assistance.
400 InvalidDBInstanceId.NotFound The DBInstanceId provided does not exist in records.
400 InvalidInstanceLevel.DiskType Specified instance level not support request disk type
400 InvalidParam Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica.
400 KmsApiError User secret key invalid.
400 System.SaleValidateFailed Sales expression validation system error.
400 Abs.InvalidAccount.NotFound account is not found.
400 SqlExecuteFailedOrTimeout sql command execution failed or timed out:%s.
400 ColdData.EngineVersionNotSupport The current instance engine version not support coldDataEnabled.
400 ColdData.MinorVersionNotSupport The current instance minor version not support coldDataEnabled.
400 IncorrectTargetClasscode The current instance type does not support this operation.
400 InvalidConnectionString.Duplicate Specified connection string already exists in the RDS.
400 RequiredParam.NotFound Required input param is not found.
400 Parameters.Invalid Parameter error, please check the parameters.
400 BackupPolicyNotSupport Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy.
400 InvalideStatus.Format The instance status does not support this operation.
400 InvalidReleasedKeepPolicy.Format Specified Released Keep Policy is not valid.
400 InvalidDBInstanceEngineType.Format the DB instance engine type does not support this operation.
400 Pay.NoCreditCard No credit cards.
400 VpcNetworkTypeNotSupport The vpc network type instance does not support this operation.
400 MirrorInsExists Specified DB instance mirror ins already existed.
400 UnsupportedClassCode The specified DB instance class stops selling.
400 InvalidBackupSet The specified database does not exist in the backup set.
400 OrdTCommodityQueryError Failed to query for product.
400 ProductInstanceReleased The instance has been released. Please check before placing the order.
400 RegionEndTimeDissolvedIndia The region is no longer supported.
400 Account.QueryError Query Account failed, please check your input value.
400 InvalidConnectionInfo Specified ConnectionInfo is not valid.
400 InvalidCharacter.DbOrAccount The database name or account name contains invalid characters.
400 InstanceAccountSameWithOsAccount The instance account name cannot be the same as the OS account name.
400 InvalidDBName.Duplicate Specified DB name already exists in the This instance.
400 GlobalReadonlyAccountMaxCountExceed The number of global read-only accounts exceeds the limit.
500 ExternalFailure The request processing has failed due to external service failure.
500 RequestMetaDataFailed The service request failed. Please try again later or contact service personnel.
500 InvokeProxyFailure The request processing has failed due to service failure of rds api.
403 IncorrectDBInstanceState Current DB instance state does not support this operation.
403 IncorrectAccountType Current account type does not support this operation.
403 AccountLimitExceeded AccountQuotaExceeded: Exceeding the allowed amount of account
403 OrderStatus.UnPaid The specified db instance has unpaid order.
403 InvalidReduceDiskSize The storage capacity after the scale-down must be larger than the used amount.
403 CloudSSDNotSupport Cloud ssd does not support this operation, please upgrade to essd.
403 InvalidUserOperatorPermission The user permission does not support this operation.
403 InvalidVswitchId Specified conn vswitch id is not valid.
403 IncorrectMinorVersion Current engine minor version does not support operations.
403 OperationDenied.ZoneResource There is no available zone for inventory.
403 NotInFlowController Sorry,no permission.
403 InvalidKmsKey Kms key is disabled.
403 InvalidInstanceLevel.Malformed Current DB instance level does not support this operation.
403 GuardDBInstanceNotSupport Guard instance does not support this operation.
404 InvalidDBInstanceName.NotFound The database instance does not exist.
404 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation.
404 InvalidClusterKms The current instance does not authorized to access the Key Management Service.
404 Request.NotFound The requested resource is not available.
404 HostInfo.NotFound The specified host info is not found.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.