Consulta de versiones menores del motor disponibles para una instancia -

Puede llamar a la operación DescribeDBMiniEngineVersions para consultar las versiones menores del motor disponibles para instancias de ApsaraDB RDS for MySQL y ApsaraDB RDS for PostgreSQL.

Antes de adquirir o actualizar una instancia que ejecuta MySQL o PostgreSQL, puede llamar a la operación DescribeDBMiniEngineVersions para consultar las versiones menores del motor disponibles para dicha instancia.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeDBMiniEngineVersions	La operación que desea ejecutar. Establezca el valor en DescribeDBMiniEngineVersions.
Engine	String	No	MySQL	El motor de base de datos de la instancia. Valores válidos: MySQL y PostgreSQL.
EngineVersion	String	No	5.7	La versión del motor de base de datos de la instancia. Valores válidos si establece el parámetro Engine en MySQL: 8.0, 5.7, 5.6 y 5.5 Valores válidos si establece el parámetro Engine en PostgreSQL: 15.0, 14.0, 13.0, 12.0, 11.0 y 10.0
NodeType	String	No	HighAvailability	La edición de RDS de la instancia. Valores válidos: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition Finance: RDS Enterprise Edition
StorageType	String	No	local_ssd	El tipo de almacenamiento de la instancia. Valores válidos: local_ssd: SSD local cloud_ssd: SSD estándar cloud_essd: SSD mejorado (ESSD) de nivel de rendimiento 1 (PL1) cloud_essd2: ESSD de PL2 cloud_essd3: ESSD de PL3
DedicatedHostGroupId	String	No	dhg-4n*****	El ID del clúster dedicado al que pertenece la instancia. Puede llamar a la operación DescribeDedicatedHostGroups para consultar el ID del clúster dedicado.
MinorVersionTag	String	No	rds_20220731	La versión menor del motor de la instancia. Especifique este parámetro para consultar la versión menor del motor de la instancia.
DBInstanceId	String	No	rm-uf6wjk5*******	El ID de la instancia. Puede llamar a la operación DescribeDBInstances para consultar el ID de la instancia.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
DBInstanceId	String	rm-uf6wjk5*****	El ID de la instancia.
RequestId	String	EFB6083A-7699-489B-8278-C0CB4793A96E	El ID de la solicitud.
TotalCount	Integer	2	El número total de entradas devueltas.
PageNumbers	Integer	1	El número de la página devuelta.
MaxRecordsPerPage	Integer	10	El número de entradas devueltas por página.
MinorVersionItems	Array of MinorVersionItems		Una matriz que contiene los detalles de la versión menor del motor.
ReleaseNote	String	https://example.com	La URL de las notas de la versión para la versión menor del motor.
NodeType	String	HighAvailability	La edición de RDS de la instancia que ejecuta la versión menor del motor. Valores válidos: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition Finance: RDS Enterprise Edition
IsHotfixVersion	Boolean	True	Un parámetro interno. Puede ignorar este parámetro.
Engine	String	MySQL	El motor de base de datos correspondiente a la versión menor del motor.
ReleaseType	String	BETA	El tipo de versión. Valores válidos: LTS: una versión de soporte a largo plazo BETA: una versión preliminar
StatusDesc	String	Online	El estado de la versión menor del motor.
EngineVersion	String	5.7	La versión del motor de base de datos correspondiente a la versión menor del motor.
MinorVersion	String	rds_20220731	La versión menor del motor.
CommunityMinorVersion	String	13.6	La versión de PostgreSQL a la que corresponde la versión menor del motor. Para obtener más información, consulte Notas de la versión de AliPG. Nota Este parámetro solo es válido cuando el parámetro Engine se establece en PostgreSQL.
Tag	String	pgsql_babelfish_image	La etiqueta correspondiente a la versión menor del motor. Valores válidos: pgsql_docker_image: etiqueta de la instancia común pgsql_babelfish_image: etiqueta de la instancia con Babelfish habilitado Nota Este parámetro solo es válido cuando el parámetro Engine se establece en PostgreSQL.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=DescribeDBMiniEngineVersions
&Engine=MySQL
&EngineVersion=5.7
&NodeType=HighAvailability
&StorageType=local_ssd
&DedicatedHostGroupId=dhg-4n*****
&MinorVersionTag=key1
&DBInstanceId=rm-uf6wjk5*******
&RegionId=cn-hangzhou
&callerBid=268**
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<DescribeDBMiniEngineVersionsResponse>
    <DBInstanceId>rm-uf6wjk5*****</DBInstanceId>
    <RequestId>EFB6083A-7699-489B-8278-C0CB4793A96E</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumbers>1</PageNumbers>
    <MaxRecordsPerPage>10</MaxRecordsPerPage>
    <MinorVersionItems>
        <ReleaseNote>https://example.com</ReleaseNote>
        <NodeType>HighAvailability</NodeType>
        <IsHotfixVersion>true</IsHotfixVersion>
        <Engine>MySQL</Engine>
        <ReleaseType>BETA</ReleaseType>
        <StatusDesc>Online</StatusDesc>
        <EngineVersion>5.7</EngineVersion>
        <MinorVersion>rds_20220731</MinorVersion>
    </MinorVersionItems>
</DescribeDBMiniEngineVersionsResponse>

Formato JSON

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

{
  "DBInstanceId" : "rm-uf6wjk5*****",
  "RequestId" : "EFB6083A-7699-489B-8278-C0CB4793A96E",
  "TotalCount" : 2,
  "PageNumbers" : 1,
  "MaxRecordsPerPage" : 10,
  "MinorVersionItems" : [ {
    "ReleaseNote" : "https://example.com",
    "NodeType" : "HighAvailability",
    "IsHotfixVersion" : true,
    "Engine" : "MySQL",
    "ReleaseType" : "BETA",
    "StatusDesc" : "Online",
    "EngineVersion" : "5.7",
    "MinorVersion" : "rds_20220731"
  } ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MinorVersionAttr.NotFound	Cannot find minor version attribute by given custins.	El mensaje de error devuelto porque no se encuentra la versión menor del motor.
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	El mensaje de error devuelto porque no se encuentra el nombre de la instancia.
400	EngineNotSupported	Engine specified cannot be supported the operation.	El mensaje de error devuelto porque el motor de base de datos que ejecuta la instancia no admite esta operación. Actualice la versión menor del motor.
400	MissingMinorVersionTag	You must specify MinorVersionTag.	El mensaje de error devuelto porque no se especificó el parámetro MinorVersionTag. Especifique el parámetro.
400	MissingParameter.Engine	You must specify Engine.	El mensaje de error devuelto porque no se especificó el parámetro Engine. Especifique el parámetro.
400	MissingParameter.EngineVersion	You must specify EngineVersion.	El mensaje de error devuelto porque no se especificó el parámetro EngineVersion. Especifique el parámetro.
400	InvalidInstanceNodeType.NotFound	The specified NodeType is not found.	El mensaje de error devuelto porque no se especificó el parámetro NodeType. Especifique el parámetro.
400	MinorVersionTag.NotFound	Minor version tags cannot be parsed by the instance.	El mensaje de error devuelto porque la instancia no puede analizar la etiqueta que indica la versión menor del motor de RDS.
404	InvalidInstanceStorageType.NotFound	The specified DBInstanceStorageType is not found.	El mensaje de error devuelto porque no se especificó el parámetro InstanceStorageType. Especifique el parámetro.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	El mensaje de error devuelto porque no se encuentra la instancia especificada. Compruebe el ID de la instancia.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.