Parametrelerin geçerli ve varsayılan değerlerini sorgulama -

Bir örnek için parametrelerin geçerli ve varsayılan değerlerini sorgulamak üzere DescribeParameterTemplates işlemini çağırabilirsiniz.

Bu işlemi çağırmadan önce, örneğin aşağıdaki veritabanı altyapılarından birini kullandığından emin olun:

MySQL 5.5, MySQL 5.6, MySQL 5.7 veya MySQL 8.0
SQL Server 2008 R2
PostgreSQL 10, PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 veya PostgreSQL 15
MariaDB 10.3

Hata Ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	DescribeParameterTemplates	Gerçekleştirmek istediğiniz işlem. Değeri DescribeParameterTemplates olarak ayarlayın.
ClientToken	String	Hayır	ETnLKlblzczshOTUbOCz****	İsteğin yinelenmezliğini (idempotence) sağlamak için kullanılan istemci belirteci. Değeri istemci tarafında üretebilirsiniz; ancak oluşturulan belirtecin farklı istekler arasında benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.
Engine	String	Evet	mysql	Örneğin veritabanı altyapısı. Geçerli değerler: mysql: MySQL mssql: SQL Server PostgreSQL: PostgreSQL MariaDB: MariaDB
EngineVersion	String	Evet	8.0	Örneğin veritabanı altyapı sürümü. Engine parametresini mysql olarak ayarladığınızda geçerli değerler: 5.5, 5.6, 5.7 ve 8.0. Engine parametresini mssql olarak ayarladığınızda geçerli değerler: 2008r2. Engine parametresini PostgreSQL olarak ayarladığınızda geçerli değerler: 10.0, 11.0, 12.0, 13.0, 14.0 ve 15.0. Engine parametresini MariaDB olarak ayarladığınızda geçerli değerler: 10.3.
Category	String	Hayır	Basic	Örneğin RDS sürümü. Geçerli değerler: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition Finance: RDS Enterprise Edition
RegionId	String	Hayır	cn-hangzhou	Örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
DBInstanceId	String	Evet	rm-bp1imnm****	Örneğin kimliği.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	0F9B7410-EC73-510C-B385-8339455C12C6	İsteğin kimliği.
Engine	String	mysql	Örneğin veritabanı altyapısı.
ParameterCount	String	2	Parametre sayısı.
EngineVersion	String	8.0	Örneğin veritabanı altyapı sürümü.
Parameters	TemplateRecord dizisi		Parametre ayrıntılarını içeren bir dizi.
TemplateRecord
CheckingCode	String	[0-1024]	Parametrenin geçerli değerleri.
ParameterName	String	loose_multi_blocks_ddl_count	Parametrenin adı.
ParameterValue	String	0	Parametrenin varsayılan değeri.
ForceModify	String	true	Parametrenin yeniden yapılandırılabileceğini gösterir. Geçerli değerler: true: Parametre yeniden yapılandırılabilir. false: Parametre yeniden yapılandırılamaz.
ForceRestart	String	false	Değişikliklerin etkili olması için örneği yeniden başlatmanız gerekip gerekmediğini gösterir. Geçerli değerler: true: Değişikliklerin etkili olması için örneği yeniden başlatmanız gerekir. false: Değişikliklerin etkili olması için örneği yeniden başlatmanıza gerek yoktur.
ParameterDescription	String	Page numbers of multi blocks reading once in some ddl query.	Parametrenin açıklaması.

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=DescribeParameterTemplates
&ClientToken=ETnLKlblzczshOTUbOCz****
&Engine=mysql
&EngineVersion=8.0
&Category=Basic
&RegionId=cn-hangzhou
&DBInstanceId=rm-bp1imnm****
&Common request parameters

Örnek başarılı yanıt

XML biçimi

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

<DescribeParameterTemplatesResponse>
    <ParameterCount>2</ParameterCount>
    <EngineVersion>8.0</EngineVersion>
    <Parameters>
        <TemplateRecord>
            <ForceModify>true</ForceModify>
            <CheckingCode>[OFF|ON]</CheckingCode>
            <ParameterValue>OFF</ParameterValue>
            <ForceRestart>false</ForceRestart>
            <ParameterName>loose_recycle_scheduler</ParameterName>
            <ParameterDescription>Switch of purge thread.</ParameterDescription>
        </TemplateRecord>
        <TemplateRecord>
            <ForceModify>true</ForceModify>
            <CheckingCode>[0-1024]</CheckingCode>
            <ParameterValue>0</ParameterValue>
            <ForceRestart>false</ForceRestart>
            <ParameterName>loose_multi_blocks_ddl_count</ParameterName>
            <ParameterDescription>Page numbers of multi blocks reading once in some ddl query.</ParameterDescription>
        </TemplateRecord>
    </Parameters>
    <RequestId>0F9B7410-EC73-510C-B385-8339455C12C6</RequestId>
    <Engine>mysql</Engine>
</DescribeParameterTemplatesResponse>

JSON biçimi

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

{
  "ParameterCount" : 2,
  "EngineVersion" : "8.0",
  "Parameters" : {
    "TemplateRecord" : [ {
      "ForceModify" : "true",
      "CheckingCode" : "[OFF|ON]",
      "ParameterValue" : "OFF",
      "ForceRestart" : "false",
      "ParameterName" : "loose_recycle_scheduler",
      "ParameterDescription" : "Switch of purge thread."
    }, {
      "ForceModify" : "true",
      "CheckingCode" : "[0-1024]",
      "ParameterValue" : "0",
      "ForceRestart" : "false",
      "ParameterName" : "loose_multi_blocks_ddl_count",
      "ParameterDescription" : "Page numbers of multi blocks reading once in some ddl query."
    } ]
  },
  "RequestId" : "0F9B7410-EC73-510C-B385-8339455C12C6",
  "Engine" : "mysql"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	Invalid.ParamGroupDBCategory	Invalid parameter group category	Parametre grubu kategorileri geçersiz olduğu için dönen hata mesajı.

Hata kodlarının listesi için bkz. Hizmet hata kodları.