Créer un modèle de paramètres - - Centre de documentation Alibaba Cloud

Un modèle de paramètres permet de configurer plusieurs paramètres simultanément, puis de les appliquer à une instance. Pour plus d'informations, consultez les rubriques Utiliser un modèle de paramètres pour configurer les paramètres des instances ApsaraDB RDS for MySQL et Utiliser un modèle de paramètres pour configurer les paramètres des instances ApsaraDB RDS for PostgreSQL.

Remarque

Les modèles de paramètres s'appliquent uniquement aux instances ApsaraDB RDS for MySQL et ApsaraDB RDS for PostgreSQL.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateParameterGroup	L'action à effectuer. Définissez la valeur sur CreateParameterGroup.
RegionId	String	Yes	cn-hangzhou	L'ID de région du modèle de paramètres. Appelez l'opération DescribeRegions pour obtenir la liste des régions disponibles.
ParameterGroupName	String	Yes	test1234	Le nom du modèle de paramètres. Le nom peut contenir des lettres, des chiffres, des points (.) et des traits de soulignement (_), et doit commencer par une lettre. Le nom doit comporter entre 8 et 64 caractères.
Engine	String	Yes	mysql	Le moteur de base de données. Valeurs possibles : mysql PostgreSQL
EngineVersion	String	Yes	5,7	La version du moteur de base de données exécutée sur l'instance. Valeurs possibles : Si l'instance exécute MySQL, elle doit utiliser l'une des versions suivantes : 5,6 5,7 8,0 Si l'instance exécute PostgreSQL, elle doit utiliser l'une des versions suivantes : 10,0 11,0 12,0 13,0 14,0 15,0
Parameters	String	Yes	{"back_log":"3000","wait_timeout":"86400"}	Une chaîne JSON contenant les paramètres et leurs valeurs dans le modèle de paramètres. Format : {"Paramètre 1":"Valeur du paramètre 1","Paramètre 2":"Valeur du paramètre 2"...}. Pour plus d'informations sur les paramètres modifiables, consultez les rubriques Modifier les paramètres d'une instance ApsaraDB RDS for MySQL ou Modifier les paramètres d'une instance ApsaraDB RDS for PostgreSQL.
ParameterGroupDesc	String	No	test	La description du modèle de paramètres. Elle ne doit pas dépasser 200 caractères.

Paramètres de réponse

Parameter	Type	Example	Description
ParameterGroupId	String	rpg-q488w14xvsk****	L'ID du modèle de paramètres. Appelez l'opération DescribeParameterGroups pour interroger les ID des modèles de paramètres.
RequestId	String	7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1	L'ID de la requête.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=CreateParameterGroup
&RegionId=cn-hangzhou
&ParameterGroupName=test1234
&Engine=mysql
&EngineVersion=5.7
&Parameters={"back_log":"3000","wait_timeout":"86400"}
&<Common request parameters>

Exemple de réponse réussie

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateParameterGroupResponse>
    <ParameterGroupId>rpg-q488w14xvsk****</ParameterGroupId>
    <RequestId>7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1</RequestId>
</CreateParameterGroupResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ParameterGroupId" : "rpg-q488w14xvsk****",
  "RequestId" : "7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidParameters.Malformed	The specified parameter "Parameters" is not valid.	La valeur du paramètre Parameters n'est pas valide. Spécifiez une valeur valide.
400	ParamGroupsNameInvalid	The specified parameter group name is invalid.	Le nom du modèle de paramètres n'est pas valide. Le nom doit comporter entre 8 et 64 caractères, contenir des lettres, des chiffres, des points (.) et des traits de soulignement (_), et commencer par une lettre.
400	InvalidEngine.Malformed	Specified engine is not valid.	Le moteur de base de données spécifié n'est pas valide. Spécifiez un moteur de base de données valide.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	La version du moteur de base de données spécifiée n'est pas valide. Vérifiez la version du moteur de base de données et réessayez.
400	ParamGroupsDbTypeNotSupport	The parameter group does not support the specified database type.	Le modèle de paramètres est pris en charge uniquement pour les instances exécutant MySQL.
400	ParamGroupsDbVersionNotSupport	The parameter group does not support the database version.	Le modèle de paramètres est pris en charge uniquement pour les instances exécutant MySQL 5.6, MySQL 5.7 ou MySQL 8.0.
400	ParamNotExist	This param Not Exist	Le paramètre n'existe pas. Vérifiez la configuration du paramètre Parameters.
400	ParamTypeError	The parameter type error.	Le type de paramètre n'est pas valide.
400	ParamGroupsNotExistOrTypeNotSupport	The parameter group does not exist or its type is not supported.	Le modèle de paramètres n'existe pas ou son type n'est pas pris en charge.
400	InvalidRegion.Format	Specified Region is not valid.	La région spécifiée n'est pas valide.
400	InvalidParameters.Format	Specified parameter is not valid	Le format d'un paramètre spécifié n'est pas valide.
400	ParamGroupsDescInvalid	The maximum length of parameter group description is exceeded.	La description du modèle de paramètres dépasse 200 caractères.

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur du service.