Consultar recursos disponíveis - : Central de Documentação do Alibaba Cloud

Chame a operação DescribeAvailableResource para consultar os recursos disponíveis em uma região.

A operação DescribeAvailableResource foi descontinuada. Use as operações DescribeAvailableZones e DescribeAvailableClasses como alternativas.

Nota

Você pode chamar a operação DescribeAvailableResource até 20 vezes por minuto.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeAvailableResource	A operação a ser executada. Defina o valor como DescribeAvailableResource.
RegionId	String	No	cn-hangzhou	ID da região da instância. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
ZoneId	String	No	cn-hangzhou-b	ID da zona da instância.
InstanceChargeType	String	Yes	Postpaid	Método de faturamento da instância. Valores válidos: Prepaid: assinatura Postpaid: pagamento conforme o uso
Engine	String	No	MySQL	Mecanismo de banco de dados da instância. Valores válidos: MySQL SQLServer PostgreSQL MariaDB
EngineVersion	String	No	5,7	Versão do mecanismo de banco de dados da instância. Valores válidos: Se Engine for MySQL: 5,5, 5,6, 5,7 e 8,0 Se Engine for SQLServer: 2008r2, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_ent e 2019_ent Se Engine for PostgreSQL: 10,0, 11,0, 12,0, 13,0, 14,0 e 15,0 Se Engine for MariaDB: 10,3
DBInstanceClass	String	No	rds.mysql.s1.small	Tipo da instância. Para mais informações, consulte Tipos de instância primária do ApsaraDB RDS.
OrderType	String	No	BUY	Tipo do pedido. Defina o valor como BUY.
DBInstanceStorageType	String	No	local_ssd	Tipo de armazenamento da instância. Valores válidos: local_ssd: SSD local cloud_ssd: SSD padrão cloud_essd: SSD aprimorado (ESSD) de nível de desempenho 1 (PL1) cloud_essd2: ESSD de PL2 cloud_essd3: ESSD de PL3
Category	String	No	Basic	Edição do RDS da instância. Valores válidos: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition AlwaysOn: RDS Cluster Edition Finance: RDS Enterprise Edition
DispenseMode	Integer	No	0	Especifica se as zonas com suporte à implantação em zona única devem ser retornadas. Valores válidos: 1: retorna as zonas. 0: não retorna as zonas. Valor padrão: 0. Nota A implantação em zona única permite implantar uma instância do RDS Enterprise Edition em uma única zona.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	A32E046E-2643-4B65-828D-23FEED4853A3	ID da solicitação.
AvailableZones	Array of AvailableZone		Matriz composta pelas zonas com recursos disponíveis.
AvailableZone
ZoneId	String	cn-hangzhou-b	ID da zona da instância.
Status	String	Enable	Indica se os recursos na região podem ser adquiridos. Valores válidos: Enable: Os recursos na região podem ser adquiridos. Disable: Os recursos na região não podem ser adquiridos.
RegionId	String	cn-hangzhou	ID da região da instância.
SupportedEngines	Array of SupportedEngine		Matriz composta pelos mecanismos de banco de dados disponíveis na zona.
SupportedEngine
Engine	String	MySQL	Mecanismo de banco de dados da instância.
SupportedEngineVersions	Array of SupportedEngineVersion		Matriz composta pelas versões do mecanismo de banco de dados disponíveis na zona.
SupportedEngineVersion
Version	String	5,7	Versão do mecanismo de banco de dados da instância.
SupportedCategorys	Array of SupportedCategory		Matriz composta pelas edições do RDS disponíveis.
SupportedCategory
Category	String	HighAvailability	Edição do RDS da instância.
SupportedStorageTypes	Array of SupportedStorageType		Matriz composta pelos tipos de armazenamento disponíveis.
SupportedStorageType
StorageType	String	local_ssd	Tipo de armazenamento da instância.
AvailableResources	Array of AvailableResource		Matriz composta pelos recursos disponíveis.
AvailableResource
StorageRange	String	"{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"	Intervalo da capacidade de armazenamento. O valor inclui a capacidade máxima, a capacidade mínima e o incremento de armazenamento.
DBInstanceClass	String	rds.mysql.s1.small	Tipo da instância.
DBInstanceStorageRange	Object		Matriz composta pelos intervalos de capacidade de armazenamento.
Step	Integer	5	Incremento de aumento da capacidade de armazenamento. Unidade: GB.
Max	Integer	2000	Capacidade máxima de armazenamento que pode ser adquirida. Unidade: GB.
Min	Integer	5	Capacidade mínima de armazenamento que deve ser adquirida. Unidade: GB.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableResource
&InstanceChargeType=Postpaid
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeAvailableResourceResponse>
    <RequestId>A32E046E-2643-4B65-828D-23FEED4853A3</RequestId>
    <AvailableZones>
        <ZoneId>cn-hangzhou-b</ZoneId>
        <Status>Enable</Status>
        <RegionId>cn-hangzhou</RegionId>
        <SupportedEngines>
            <Engine>MySQL</Engine>
            <SupportedEngineVersions>
                <Version>5.7</Version>
                <SupportedCategorys>
                    <Category>HighAvailability</Category>
                    <SupportedStorageTypes>
                        <StorageType>local_ssd</StorageType>
                        <AvailableResources>
                            <StorageRange>"{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"</StorageRange>
                            <DBInstanceClass>rds.mysql.s1.small</DBInstanceClass>
                            <DBInstanceStorageRange>
                                <Step>5</Step>
                                <Max>2000</Max>
                                <Min>5</Min>
                            </DBInstanceStorageRange>
                        </AvailableResources>
                    </SupportedStorageTypes>
                </SupportedCategorys>
            </SupportedEngineVersions>
        </SupportedEngines>
    </AvailableZones>
</DescribeAvailableResourceResponse>

Formato JSON

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

{
  "RequestId" : "A32E046E-2643-4B65-828D-23FEED4853A3",
  "AvailableZones" : [ {
    "ZoneId" : "cn-hangzhou-b",
    "Status" : "Enable",
    "RegionId" : "cn-hangzhou",
    "SupportedEngines" : [ {
      "Engine" : "MySQL",
      "SupportedEngineVersions" : [ {
        "Version" : "5.7",
        "SupportedCategorys" : [ {
          "Category" : "HighAvailability",
          "SupportedStorageTypes" : [ {
            "StorageType" : "local_ssd",
            "AvailableResources" : [ {
              "StorageRange" : "\"{\\\"values\\\":[{\\\"max\\\":2000,\\\"min\\\":5,\\\"step\\\":5}]}\"",
              "DBInstanceClass" : "rds.mysql.s1.small",
              "DBInstanceStorageRange" : {
                "Step" : 5,
                "Max" : 2000,
                "Min" : 5
              }
            } ]
          } ]
        } ]
      } ]
    } ]
  } ]
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	ArticleNotFound	Article not found	Nenhum artigo relevante foi encontrado.

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