Consultar versões secundárias de mecanismo disponíveis para uma instância - : Central de Documentação do Alibaba Cloud

Antes de adquirir ou atualizar uma instância que executa MySQL ou PostgreSQL, chame a operação DescribeDBMiniEngineVersions para consultar as versões secundárias de mecanismo disponíveis para a instância.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeDBMiniEngineVersions	A operação a ser executada. Defina o valor como DescribeDBMiniEngineVersions.
Engine	String	No	MySQL	O mecanismo de banco de dados da instância. Valores válidos: MySQL e PostgreSQL.
EngineVersion	String	No	5.7	A versão do mecanismo de banco de dados da instância. Valores válidos quando o parâmetro Engine é definido como MySQL: 8.0, 5.7, 5.6 e 5.5 Valores válidos quando o parâmetro Engine é definido como PostgreSQL: 15.0, 14.0, 13.0, 12.0, 11.0 e 10.0
NodeType	String	No	HighAvailability	A edição RDS da instância. Valores válidos: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition Finance: RDS Enterprise Edition
StorageType	String	No	local_ssd	O tipo de armazenamento da instância. Valores válidos: local_ssd: SSD local cloud_ssd: SSD padrão cloud_essd: SSD avançado (ESSD) de nível de desempenho 1 (PL1) cloud_essd2: ESSD de PL2 cloud_essd3: ESSD de PL3
DedicatedHostGroupId	String	No	dhg-4n*****	O ID do cluster dedicado ao qual a instância pertence. Chame a operação DescribeDedicatedHostGroups para consultar o ID do cluster dedicado.
MinorVersionTag	String	No	rds_20220731	A versão secundária de mecanismo da instância. Especifique este parâmetro para consultar a versão secundária de mecanismo da instância.
DBInstanceId	String	No	rm-uf6wjk5*******	O ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.
RegionId	String	Yes	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Response parameters

Parameter	Type	Example	Description
DBInstanceId	String	rm-uf6wjk5*****	O ID da instância.
RequestId	String	EFB6083A-7699-489B-8278-C0CB4793A96E	O ID da solicitação.
TotalCount	Integer	2	O número total de entradas retornadas.
PageNumbers	Integer	1	O número da página retornada.
MaxRecordsPerPage	Integer	10	O número de entradas retornadas por página.
MinorVersionItems	Array of MinorVersionItems		Array com os detalhes da versão secundária de mecanismo.
ReleaseNote	String	https://example.com	A URL das notas de versão da versão secundária de mecanismo.
NodeType	String	HighAvailability	A edição RDS da instância que executa a versão secundária de mecanismo. Valores válidos: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition Finance: RDS Enterprise Edition
IsHotfixVersion	Boolean	True	Parâmetro interno. Ignore este parâmetro.
Engine	String	MySQL	O mecanismo de banco de dados correspondente à versão secundária de mecanismo.
ReleaseType	String	BETA	O tipo de lançamento. Valores válidos: LTS: versão de longo prazo BETA: versão de pré-visualização
StatusDesc	String	Online	O status da versão secundária de mecanismo.
EngineVersion	String	5.7	A versão do mecanismo de banco de dados correspondente à versão secundária de mecanismo.
MinorVersion	String	rds_20220731	A versão secundária de mecanismo.
CommunityMinorVersion	String	13.6	A versão do PostgreSQL à qual a versão secundária de mecanismo corresponde. Para obter mais informações, consulte Notas de versão do AliPG. Nota Este parâmetro é válido somente quando o parâmetro Engine é definido como PostgreSQL.
Tag	String	pgsql_babelfish_image	A tag correspondente à versão secundária de mecanismo. Valores válidos: pgsql_docker_image: tag da instância comum pgsql_babelfish_image: tag da instância com Babelfish ativado Nota Este parâmetro é válido somente quando o parâmetro Engine é definido como PostgreSQL.

Examples

Exemplos de requisição

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>

Exemplos de resposta bem-sucedida

XML format

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>

JSON format

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"
  } ]
}

Error codes

HTTP status code	Error code	Error message	Description
400	MinorVersionAttr.NotFound	Cannot find minor version attribute by given custins.	A versão secundária de mecanismo não foi encontrada.
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	O nome da instância especificado não foi encontrado.
400	EngineNotSupported	Engine specified cannot be supported the operation.	Esta operação não é compatível com o mecanismo de banco de dados da instância. Atualize a versão secundária de mecanismo.
400	MissingMinorVersionTag	You must specify MinorVersionTag.	O parâmetro MinorVersionTag não foi especificado. Especifique o parâmetro.
400	MissingParameter.Engine	You must specify Engine.	O parâmetro Engine não foi especificado. Especifique o parâmetro.
400	MissingParameter.EngineVersion	You must specify EngineVersion.	O parâmetro EngineVersion não foi especificado. Especifique o parâmetro.
400	InvalidInstanceNodeType.NotFound	The specified NodeType is not found.	O parâmetro NodeType não foi especificado. Especifique o parâmetro.
400	MinorVersionTag.NotFound	Minor version tags cannot be parsed by the instance.	A tag que indica a versão secundária de mecanismo da instância RDS não pôde ser interpretada.
404	InvalidInstanceStorageType.NotFound	The specified DBInstanceStorageType is not found.	O parâmetro InstanceStorageType não foi especificado. Especifique o parâmetro.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	A instância especificada não foi encontrada. Verifique o ID da instância.

Para obter a lista de códigos de erro, consulte Códigos de erro do serviço.