Modifier les paramètres d'une instance - - Centre de documentation Alibaba Cloud

Modifiez les paramètres directement ou via un modèle de paramètres. Après soumission de la demande, ApsaraDB RDS lance une tâche pour appliquer les nouvelles valeurs à l'instance. Si une nouvelle valeur de paramètre ne prend effet qu'après un redémarrage, ApsaraDB RDS redémarre l'instance automatiquement. Pour connaître la liste des paramètres configurables, consultez la rubrique Configurer les paramètres d'une instance ApsaraDB RDS for MySQL.

Remarque

Avant d'exécuter la tâche de modification, ApsaraDB RDS vérifie l'existence des paramètres, leur configurabilité et la validité des nouvelles valeurs.

Débogage

OpenAPI Explorer calcule automatiquement la signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil 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	ModifyParameter	Opération à effectuer. Définissez la valeur sur ModifyParameter.
ClientToken	String	Non	ETnLKlblzczshOTUbOCzxxxxxxxxxx	Jeton client garantissant l'idempotence de la requête. Générez la valeur via le client en veillant à son unicité pour chaque requête. Le jeton ne doit contenir que des caractères ASCII et ne pas dépasser 64 caractères.
DBInstanceId	String	Oui	rm-uf6wjk5xxxxxxx	ID de l'instance.
Parameters	String	Oui	{"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}	Chaînes JSON des paramètres et de leurs valeurs. Toutes les valeurs sont de type chaîne. Format : {"Nom du paramètre 1":"Valeur du paramètre 1","Nom du paramètre 2":"Valeur du paramètre 2"...}. Appelez l'opération DescribeParameterTemplates pour récupérer les noms et valeurs des paramètres. Remarque Si vous spécifiez ce paramètre, inutile de spécifier le paramètre ParameterGroupId.
Forcerestart	Boolean	Non	false	Indique si l'instance doit être redémarrée pour appliquer la nouvelle valeur du paramètre. Valeurs possibles : true : Redémarrage forcé de l'instance. Si la nouvelle valeur ne prend effet qu'après redémarrage, définissez ce paramètre sur true. Sinon, la modification ne sera pas appliquée. false : Aucun redémarrage forcé. Valeur par défaut : false
ParameterGroupId	String	Non	rpg-xxxxxxxxx	ID du modèle de paramètres. Remarque Si vous spécifiez ce paramètre, inutile de spécifier le paramètre Parameters. Si le modèle de paramètres nécessite un redémarrage de l'instance pour s'appliquer, vous devez spécifier le paramètre Forcerestart.
SwitchTimeMode	String	Non	ScheduleTime	Moment de prise d'effet de la modification. Valeurs possibles : Immediately : Modification immédiate (valeur par défaut). MaintainTime : Modification durant la fenêtre de maintenance de l'instance. Appelez l'opération ModifyDBInstanceMaintainTime pour modifier cette fenêtre. ScheduleTime : La modification prend effet à l'instant spécifié. Si vous choisissez cette option, vous devez également spécifier le paramètre SwitchTime.
SwitchTime	String	Non	2022-05-06T09:24:00Z	Moment de prise d'effet de la modification. Indiquez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ (UTC). Remarque L'heure spécifiée doit être postérieure à l'appel de cette opération.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	542BB8D6-4268-45CC-A557-B03EFD7AB30A	ID de la requête.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=ModifyParameter
&DBInstanceId=rm-uf6wjk5xxxxxxx
&Parameters={"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ModifyParameterResponse>
       <RequestId>542BB8D6-4268-45CC-A557-B03EFD7AB30A</RequestId>
</ModifyParameterResponse>

JSON format

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

{
  "RequestId" : "542BB8D6-4268-45CC-A557-B03EFD7AB30A"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	PendingActionOverdue	the action execution time is already overdue	L'heure spécifiée pour la prise d'effet de la modification est dépassée.
400	InvalidParameters.Format	Specified parameters is not valid.	La valeur d'un paramètre spécifié n'est pas valide.
400	InvalidParameters.Format	The format of the specified parameter is invalid.	Le format d'un paramètre spécifié n'est pas valide.
400	Invalid.ParamGroupDBCategory	ParamGroup category is basic, not standard.	La catégorie du modèle de paramètres spécifié est « basic » au lieu de « standard ».
403	IncorrectDBInstanceType	The current database instance type does not support the operation.	La configuration de l'instance ne prend pas en charge cette opération.
403	IncorrectDBInstanceState	The current database status does not support the operation.	L'état de l'instance ne prend pas en charge cette opération. Vérifiez que l'instance est dans l'état Running.
403	Invalid.Parameter	Specified parameters is not valid.	Un paramètre spécifié n'est pas valide.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	L'instance spécifiée est introuvable. Vérifiez l'ID de l'instance.

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