Modifier un modèle de paramètres - - Centre de documentation Alibaba Cloud

Configurez plusieurs paramètres simultanément à l'aide d'un modèle de paramètres, puis appliquez-le aux instances. 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 ou Utiliser un modèle de paramètres pour configurer les paramètres des instances ApsaraDB RDS for PostgreSQL.

Remarque

Vous ne pouvez appliquer des modèles de paramètres qu'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, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ModifyParameterGroup	Opération à effectuer. Définissez la valeur sur ModifyParameterGroup.
ParameterGroupId	String	Oui	rpg-13ppdh****	ID du modèle de paramètres. Appelez l'opération DescribeParameterGroups pour interroger les ID des modèles de paramètres.
ParameterGroupName	String	Non	testgroup1	Nom du modèle de paramètres. Le nom doit commencer par une lettre et peut contenir des lettres, des chiffres, des points (.) et des traits de soulignement (_). La longueur du nom doit être comprise entre 8 et 64 caractères. Remarque Si vous ne spécifiez pas ce paramètre, le nom d'origine du modèle de paramètres est conservé.
ParameterGroupDesc	String	Non	test	Description du modèle de paramètres. La description ne doit pas dépasser 200 caractères. Remarque Si vous ne spécifiez pas ce paramètre, la description d'origine du modèle de paramètres est conservée.
Parameters	String	Non	{"back_log":"3000"}	Chaîne JSON contenant les paramètres à modifier dans le modèle de paramètres et leurs nouvelles valeurs. 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. Remarque Si vous définissez le paramètre ModifyMode sur Individual et que vous spécifiez ce paramètre, les nouveaux paramètres écrasent ceux du modèle d'origine. Si vous définissez le paramètre ModifyMode sur Collectivity et que vous spécifiez ce paramètre, les nouveaux paramètres sont ajoutés au modèle d'origine ou les paramètres existants sont modifiés. Si vous ne spécifiez pas ce paramètre, les paramètres du modèle d'origine restent inchangés.
RegionId	String	Oui	cn-hangzhou	ID de la région. Appelez l'opération DescribeRegions pour obtenir la liste la plus récente des régions. Remarque Vous ne pouvez pas modifier la région associée à un modèle de paramètres. Pour répliquer un modèle de paramètres dans une autre région, utilisez l'opération CloneParameterGroup.
ModifyMode	String	Non	Collectivity	Mode de modification du modèle de paramètres. Valeurs possibles : Collectivity : ajoute de nouveaux paramètres ou modifie les paramètres existants dans le modèle d'origine. Il s'agit de la valeur par défaut. Remarque Si vous définissez le paramètre ModifyMode sur Collectivity, le système ajoute la valeur du paramètre Parameters au modèle d'origine ou modifie les paramètres correspondants. Les autres paramètres du modèle d'origine ne sont pas affectés. Individual : écrase les paramètres d'origine. Remarque Si vous définissez le paramètre ModifyMode sur Individual, le système utilise la valeur du paramètre Parameters pour écraser les paramètres du modèle d'origine.

Paramètres de réponse

Paramètre	Type	Exemple	Description
ParameterGroupId	String	rpg-13ppdh****	ID du modèle de paramètres.
RequestId	String	857DC00B-7B85-4853-8B27-AD65EB618BC6	ID de la requête.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=ModifyParameterGroup
&ParameterGroupId=rpg-13ppdh****
&Parameters={"back_log":"3000"}
&ModifyMode=Collectivity
&Common request parameters

Exemple de réponse réussie

Format XML

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

<ModifyParameterGroupResponse>
    <ParameterGroupId>rpg-13ppdh****</ParameterGroupId>
    <RequestId>857DC00B-7B85-4853-8B27-AD65EB618BC6</RequestId>
</ModifyParameterGroupResponse>

Format JSON

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

{
  "ParameterGroupId" : "rpg-13ppdh****",
  "RequestId" : "857DC00B-7B85-4853-8B27-AD65EB618BC6"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	ParamGroupsNameInvalid	The 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, commencer par une lettre et ne contenir que des lettres, des chiffres, des points (.) et des traits de soulignement (_).

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.