CreateDBInstance - - Centre de documentation Alibaba Cloud

Crée une instance ApsaraDB for SelectDB.

Description de l'opération

Les instances par abonnement ne peuvent pas être supprimées.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

selectdb:CreateDBInstance

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-aekzt2zaluvuvqa_fake
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête et éviter les soumissions de requêtes répétées. Le jeton est généré par le client et doit être unique pour chaque requête. Le jeton peut contenir jusqu'à 64 caractères ASCII et ne peut pas contenir de caractères non ASCII.	AB
Engine	string	Non	Le type de base de données. Valeur par défaut : selectdb.	selectdb
EngineVersion	string	Oui	La version du moteur de base de données. Valeur par défaut : 4.1. Description des valeurs valides :	4.1
ChargeType	string	Oui	Le mode de facturation de l'instance. Valeurs valides :	PrePaid
UsedTime	integer	Non	La durée d'abonnement de l'instance. Description des valeurs valides :	1
Period	string	Non	Indique si le cluster payé à l'avance est facturé sur une base annuelle ou mensuelle. Description des valeurs valides :	Month
DBInstanceClass	string	Oui	Les spécifications de l'instance. Vous pouvez appeler l'opération DescribeAllDBInstanceClass pour interroger les spécifications de l'instance.	selectdb.xlarge
RegionId	string	Oui	L'identifiant de la région.	cn-hangzhou
ZoneId	string	Oui	L'identifiant de la zone.	cn-hangzhou-e
CacheSize	integer	Oui	La taille du cache réservé.	200GB
VpcId	string	Oui	L'identifiant du VPC.	vpc-bp175iuvg8nxqraf2****
VSwitchId	string	Oui	L'identifiant du vSwitch.	vsw-bp1gzt31twhlo0sa5****
DBInstanceDescription	string	Non	La description de l'instance.	Test de nouvelle instance
ConnectionString	string	Non	Le point de terminaison de la base de données.	selectdb-cn-7213c8y****-public.selectdbfe.pre.rds.aliyuncs.com
SecurityIPList	string	Non	La liste blanche d'adresses IP de l'instance. Séparez les adresses IP multiples par des virgules (,).	192.168.1.1
Tag	array<object>	Non	La liste des balises de l'instance.
	object	Non	La liste des balises de l'instance.
Key	string	Non	La clé de la balise.	testKey
Value	string	Non	La valeur de la balise.	testValue
DeployScheme	string	Non	Le mode de déploiement de l'instance.	single_az
MultiZone	array<object>	Non	La configuration multizone.
	object	Non	La liste des zones multiples.
ZoneId	string	Non	L'identifiant de la zone.	cn-hangzhou-k
VSwitchIds	array	Non	La liste des identifiants de vSwitch.
	string	Non	L'identifiant du vSwitch.	vsw-bp10dbralpn4bzmgkkh8f
AddVPCIPs	string	Non	Indique si le bloc CIDR du VPC doit être ajouté à la liste blanche. Description des valeurs valides :	1
ClusterNodeType	string	Non
ClusterNodeCount	integer	Non
ScaleMax	number	Non
ScaleMin	number	Non
ConfigPatternType	string	Non	Le modèle de configuration appliqué à l'instance.
		Non	Les spécifications de nœud d'un nœud de cluster FE unique. Ce paramètre prend effet uniquement lors de la création d'une instance à la demande ou par abonnement. Valeur par défaut : selectdb_fe.xlarge16.
		Non	Le nombre de nœuds de cluster FE. Ce paramètre prend effet uniquement lors de la création d'une instance à la demande ou par abonnement. Valeur par défaut : 3. Valeurs valides : 1 à 11 (uniquement des nombres impairs).

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	4773E4EC-025D-509F-AEA9-D53123FDFB0F
Data	object	Le résultat renvoyé.
DBInstanceId	string	L'identifiant de l'instance.	selectdb-cn-7213cjv****
OrderId	integer	L'identifiant de la commande.	21137950671****

Exemples

JSON format

{
  "RequestId": "4773E4EC-025D-509F-AEA9-D53123FDFB0F",
  "Data": {
    "DBInstanceId": "selectdb-cn-7213cjv****",
    "OrderId": 0
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	COMMODITY.INVALID_COMPONENT	Order configuration parameters do not meet the verification conditions, please re-match the product.
400	DocumentConvertFailed.ExceedFileSizeLimit	The conversion has been failed, exceed file size limit.
400	Forbidden	User not authorized to operate on the specified resource, or this API does not support RAM.
400	InvalidDBName	The specified database name is not allowed.
400	CreateOrderFailed	Failed to create order.
400	InvalidVSwitchId.Malformed	The specified parameter "VSwitchId" is not valid.
400	InvalidMultiZone.NotThreeZones	The number of zones must be three.
400	InvalidZoneId.Duplicated	The zones cannot be repeated please select different zones.
400	EngineVersionDoNotSupportMultiZone	The specified engine version doesn't support multi zone.
400	InvalidChargeType.Malformed	The specified parameter "ChargeType" is not valid.
400	InvalidBuyConfigCpuOrCacheSize	The specified purchase configuration CPU or cache size is invalid.
400	InvalidZoneId.Malformed	The specified parameter "ZoneId" is not valid.
400	InvalidVpcId.Malformed	The specified parameter "VpcId" is not valid.
400	ORDER.INST_HAS_UNPAID_ORDER	Instance has unpaid order.
400	OperationDenied.OrderProcessing	There are orders in process.
400	InvalidInstanceClass.MultiAZ	The instance with 4-core BE cluster does not support multi-zone redundancy.
400	InvalidFEClassCode.Blank	The specified parameter "FEClassCode" is blank.
400	InvalidFENodeCount	The specified parameter "FENodeCount" is not valid.
400	InvalidFENodeCount.Blank	The specified parameter "FENodeCount" is blank.
400	InvalidInstanceClass.ForMultiAZ	The instance with 4-core BE cluster does not support upgrading to multi-zone redundancy.
400	InvalidFENodeCount.ForMultiAZ	The instance with FENodeCount that less than 3 does not support upgrading to multi-zone redundancy.
403	DBClusterNotSupported	The requested operation can not be performed while the cluster is not sale.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.
403	InstanceEngineType.NotSupport	The instance engine and type does not support operations.
403	InvalidDBInstanceState.NotSupport	The specified instance state does't support this operation.
403	MoneyLessThan100	The Account Monet less Than 100.
403	OperationDenied.DBNameAndAccountPrivilegeCount	The operation is not permitted due to count of database or account privilege.
403	InsufficientResourceCapacity	The resource is out of usage.
403	INSUFFICIENT_AVAILABLE_QUOTA	Your account available limit is less than 0, please recharge before trying to purchase.
403	OperationDenied.SpecificClassCodeNotSupported	The uid is not in specific classcode whitelist.
404	DBInstanceLocked	The current instance lock mode does not support this operation.
404	IncorrectVswitchId	The specified parameter VSwitchId is not valid.
404	InvalidApi.NotFound	Specified api is not found, please check your url and method.
404	InvalidDBInstance.NotFound	The specified instance is not found.
404	InvalidDBInstanceClass.NotFound	The specified instance classic does not exist.
404	InvalidRegionId.NotFound	The provided RegionId does not exist in our records.
404	QueryPrice.Failed	The inquiry failed. Contact Alibaba Cloud customer service representatives.
404	InvalidVSwitch.NoIP	VSwitch has zero available IP.
404	InvalidDBClusterClass.NotFound	The specified cluster class does not exist.
404	InvalidVPC.NotFound	VPC or VSwitch is not valid.
404	InvalidFEClass.NotFound	The specified fe class doesn't exist.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.