Consulta de recursos disponibles - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribeAvailableResource para consultar los recursos disponibles en una región.

La operación DescribeAvailableResource ya no está disponible. En su lugar, utilice las operaciones DescribeAvailableZones y DescribeAvailableClasses.

Nota

Puede llamar a la operación DescribeAvailableResource hasta 20 veces por minuto.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos 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í	DescribeAvailableResource	La operación que desea ejecutar. Establezca el valor en DescribeAvailableResource.
RegionId	String	No	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.
ZoneId	String	No	cn-hangzhou-b	El ID de zona de la instancia.
InstanceChargeType	String	Sí	Postpaid	El método de facturación de la instancia. Valores válidos: Prepaid: suscripción Postpaid: pay-as-you-go
Engine	String	No	MySQL	El motor de base de datos de la instancia. Valores válidos: MySQL SQLServer PostgreSQL MariaDB
EngineVersion	String	No	5.7	La versión del motor de base de datos de la instancia. Valores válidos: Valores válidos cuando establece el parámetro Engine en MySQL: 5.5, 5.6, 5.7 y 8.0 Valores válidos cuando establece el parámetro Engine en SQLServer: 2008r2, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_ent y 2019_ent Valores válidos cuando establece el parámetro Engine en PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0 y 15.0 Valores válidos cuando establece el parámetro Engine en MariaDB: 10.3
DBInstanceClass	String	No	rds.mysql.s1.small	El tipo de instancia. Para obtener más información, consulte Tipos de instancias principales de ApsaraDB RDS.
OrderType	String	No	BUY	El tipo de pedido. Establezca el valor en BUY.
DBInstanceStorageType	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 mejorados (ESSD) de nivel de rendimiento 1 (PL1) cloud_essd2: ESSD de PL2 cloud_essd3: ESSD de PL3
Category	String	No	Basic	La edición de RDS de la instancia. 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 si se deben devolver las zonas donde se admite el despliegue en zona única. Valores válidos: 1: devuelve las zonas. 0: no devuelve las zonas. Valor predeterminado: 0. Nota El despliegue en zona única permite implementar una instancia que ejecuta RDS Enterprise Edition en una sola zona.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	A32E046E-2643-4B65-828D-23FEED4853A3	El ID de la solicitud.
AvailableZones	Array of AvailableZone		Matriz que contiene las zonas con recursos disponibles.
AvailableZone
ZoneId	String	cn-hangzhou-b	El ID de zona de la instancia.
Status	String	Enable	Indica si es posible adquirir los recursos en la región. Valores válidos: Enable: Los recursos en la región están disponibles para compra. Disable: No es posible adquirir los recursos en la región.
RegionId	String	cn-hangzhou	El ID de región de la instancia.
SupportedEngines	Array of SupportedEngine		Matriz que contiene los motores de base de datos disponibles en la zona.
SupportedEngine
Engine	String	MySQL	El motor de base de datos que ejecuta la instancia.
SupportedEngineVersions	Array of SupportedEngineVersion		Matriz que contiene las versiones del motor de base de datos disponibles en la zona.
SupportedEngineVersion
Version	String	5.7	La versión del motor de base de datos que ejecuta la instancia.
SupportedCategorys	Array of SupportedCategory		Matriz que contiene las ediciones de RDS disponibles.
SupportedCategory
Category	String	HighAvailability	La edición de RDS de la instancia.
SupportedStorageTypes	Array of SupportedStorageType		Matriz que contiene los tipos de almacenamiento disponibles.
SupportedStorageType
StorageType	String	local_ssd	El tipo de almacenamiento de la instancia.
AvailableResources	Array of AvailableResource		Matriz que contiene los recursos disponibles.
AvailableResource
StorageRange	String	"{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"	El rango de capacidad de almacenamiento. El valor incluye la capacidad máxima, la capacidad mínima y el incremento de almacenamiento.
DBInstanceClass	String	rds.mysql.s1.small	El tipo de instancia.
DBInstanceStorageRange	Object		Matriz que contiene los rangos de capacidad de almacenamiento.
Step	Integer	5	El incremento de la capacidad de almacenamiento. Unidad: GB.
Max	Integer	2000	La capacidad máxima de almacenamiento que puede adquirir. Unidad: GB.
Min	Integer	5	La capacidad mínima de almacenamiento que debe adquirir. Unidad: GB.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	ArticleNotFound	Article not found	El mensaje de error indica que no se encontraron artículos relevantes.

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