Interroger les modèles de paramètres - - Centre de documentation Alibaba Cloud

Les modèles de paramètres permettent de configurer plusieurs paramètres simultanément, puis d'appliquer ce modèle aux instances. Pour plus d'informations, consultez la rubrique 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

L'application de modèles de paramètres est uniquement prise en charge pour les instances ApsaraDB RDS for MySQL et ApsaraDB RDS for PostgreSQL.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser cet outil pour appeler cette opération. OpenAPI Explorer 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	DescribeParameterGroups	Opération à effectuer. Définissez ce paramètre sur DescribeParameterGroups.
RegionId	String	Oui	cn-hangzhou	ID de la région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
ResourceGroupId	String	Non	rg-acfmy****	ID du groupe de ressources.

Paramètres de réponse

Paramètre	Type	Exemple	Description
SignalForOptimizeParams	Boolean	false	Indique si des modèles de paramètres existent dans la région spécifiée. Valeurs possibles : true false
RequestId	String	D4A23265-C5B6-42E1-98A0-EFA1EB42E723	ID de la requête.
ParameterGroups	Array of ParameterGroup		Détails des modèles de paramètres.
ParameterGroup
UpdateTime	String	2019-11-21T02:21:35Z	Date et heure de la dernière mise à jour du modèle de paramètres. Le format suit la norme ISO 8601 (yyyy-MM-ddTHH:mm:ssZ) et l'heure est exprimée en UTC.
ParameterGroupDesc	String	1	Type de modèle de paramètres. Valeurs possibles : 0 : modèle de paramètres par défaut. 1 : modèle de paramètres personnalisé. 2 : modèle de paramètres de sauvegarde automatique. Lors de l'application de ce type de modèle, le système effectue automatiquement une sauvegarde des paramètres d'origine et enregistre cette sauvegarde sous forme de modèle.
CreateTime	String	2019-11-21T01:48:39Z	Date et heure de création du modèle de paramètres. Le format suit la norme ISO 8601 (yyyy-MM-ddTHH:mm:ssZ) et l'heure est exprimée en UTC.
ForceRestart	Integer	1	Indique si un redémarrage de l'instance est nécessaire pour que le modèle de paramètres prenne effet. Valeurs possibles : 0 : aucun redémarrage n'est requis. 1 : un redémarrage est requis.
ParameterGroupId	String	rpg-****	ID du modèle de paramètres.
ParameterGroupName	String	test1234	Nom du modèle de paramètres.
Engine	String	mysql	Moteur de base de données.
ParamCounts	Integer	2	Nombre de paramètres contenus dans le modèle de paramètres.
EngineVersion	String	5,7	Version du moteur de base de données de l'instance.
ParameterGroupType	Integer	1	Type de modèle de paramètres. Valeurs possibles : 0 : modèle de paramètres par défaut. 1 : modèle de paramètres personnalisé. 2 : modèle de paramètres de sauvegarde automatique. Lors de l'application de ce type de modèle, le système effectue automatiquement une sauvegarde des paramètres d'origine et enregistre cette sauvegarde sous forme de modèle.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=DescribeParameterGroups
&RegionId=cn-hangzhou
&Common request parameters

Exemple de réponse réussie

Format XML

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

<DescribeParameterGroupsResponse>
    <SignalForOptimizeParams>false</SignalForOptimizeParams>
    <RequestId>D4A23265-C5B6-42E1-98A0-EFA1EB42E723</RequestId>
    <ParameterGroups>
        <UpdateTime>2019-11-21T02:21:35Z</UpdateTime>
        <ParameterGroupDesc>1</ParameterGroupDesc>
        <CreateTime>2019-11-21T01:48:39Z</CreateTime>
        <ForceRestart>1</ForceRestart>
        <ParameterGroupId>rpg-****</ParameterGroupId>
        <ParameterGroupName>test1234</ParameterGroupName>
        <Engine>mysql</Engine>
        <ParamCounts>2</ParamCounts>
        <EngineVersion>5.7</EngineVersion>
        <ParameterGroupType>1</ParameterGroupType>
    </ParameterGroups>
</DescribeParameterGroupsResponse>

Format JSON

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

{
  "SignalForOptimizeParams" : false,
  "RequestId" : "D4A23265-C5B6-42E1-98A0-EFA1EB42E723",
  "ParameterGroups" : [ {
    "UpdateTime" : "2019-11-21T02:21:35Z",
    "ParameterGroupDesc" : "1",
    "CreateTime" : "2019-11-21T01:48:39Z",
    "ForceRestart" : 1,
    "ParameterGroupId" : "rpg-****",
    "ParameterGroupName" : "test1234",
    "Engine" : "mysql",
    "ParamCounts" : 2,
    "EngineVersion" : "5.7",
    "ParameterGroupType" : 1
  } ]
}

Codes d'erreur

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