Interroger les ressources disponibles - - Centre de documentation Alibaba Cloud

Appelez l'opération DescribeAvailableResource pour interroger les ressources disponibles dans une région.

L'opération DescribeAvailableResource n'est plus disponible. Utilisez plutôt les opérations DescribeAvailableZones et DescribeAvailableClasses.

Remarque

Vous pouvez appeler l'opération DescribeAvailableResource jusqu'à 20 fois par minute.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeAvailableResource	Opération à exécuter. Définissez la valeur sur DescribeAvailableResource.
RegionId	String	No	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
ZoneId	String	No	cn-hangzhou-b	ID de zone de l'instance.
InstanceChargeType	String	Yes	Postpaid	Mode de facturation de l'instance. Valeurs valides : Prepaid : abonnement Postpaid : paiement à l'utilisation
Engine	String	No	MySQL	Moteur de base de données de l'instance. Valeurs valides : MySQL SQLServer PostgreSQL MariaDB
EngineVersion	String	No	5,7	Version du moteur de base de données de l'instance. Valeurs valides : Si le paramètre Engine est défini sur MySQL : 5,5, 5,6, 5,7 et 8,0 Si le paramètre Engine est défini sur SQLServer : 2008r2, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_ent et 2019_ent Si le paramètre Engine est défini sur PostgreSQL : 10,0, 11,0, 12,0, 13,0, 14,0 et 15,0 Si le paramètre Engine est défini sur MariaDB : 10,3
DBInstanceClass	String	No	rds.mysql.s1.small	Type d'instance. Pour plus d'informations, consultez Types d'instances ApsaraDB RDS principales.
OrderType	String	No	BUY	Type de commande. Définissez la valeur sur BUY.
DBInstanceStorageType	String	No	local_ssd	Type de stockage de l'instance. Valeurs valides : local_ssd : SSD local cloud_ssd : SSD standard cloud_essd : Disque ESSD (enhanced SSD) de niveau de performance 1 (PL1) cloud_essd2 : Disque ESSD de PL2 cloud_essd3 : Disque ESSD de PL3
Category	String	No	Basic	Édition RDS de l'instance. Valeurs valides : Basic : Édition Basic RDS HighAvailability : Édition Haute disponibilité RDS AlwaysOn : Édition Cluster RDS Finance : Édition Enterprise RDS
DispenseMode	Integer	No	0	Indique s'il faut renvoyer les zones prenant en charge la méthode de déploiement mono-zone. Valeurs valides : 1 : renvoie les zones. 0 : ne renvoie pas les zones. Valeur par défaut : 0. Remarque La méthode de déploiement mono-zone permet de déployer une instance exécutant l'édition Enterprise RDS dans une seule zone.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	A32E046E-2643-4B65-828D-23FEED4853A3	ID de la requête.
AvailableZones	Array of AvailableZone		Tableau des zones dans lesquelles les ressources sont disponibles.
AvailableZone
ZoneId	String	cn-hangzhou-b	ID de zone de l'instance.
Status	String	Enable	Indique si les ressources de la région peuvent être achetées. Valeurs valides : Enable : Les ressources de la région peuvent être achetées. Disable : Les ressources de la région ne peuvent pas être achetées.
RegionId	String	cn-hangzhou	ID de région de l'instance.
SupportedEngines	Array of SupportedEngine		Tableau des moteurs de base de données disponibles dans la zone.
SupportedEngine
Engine	String	MySQL	Moteur de base de données exécuté par l'instance.
SupportedEngineVersions	Array of SupportedEngineVersion		Tableau des versions de moteur de base de données disponibles dans la zone.
SupportedEngineVersion
Version	String	5,7	Version du moteur de base de données exécutée par l'instance.
SupportedCategorys	Array of SupportedCategory		Tableau des éditions RDS disponibles.
SupportedCategory
Category	String	HighAvailability	Édition RDS de l'instance.
SupportedStorageTypes	Array of SupportedStorageType		Tableau des types de stockage disponibles.
SupportedStorageType
StorageType	String	local_ssd	Type de stockage de l'instance.
AvailableResources	Array of AvailableResource		Tableau des ressources disponibles.
AvailableResource
StorageRange	String	"{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"	Plage de capacité de stockage. La valeur comprend la capacité de stockage maximale, la capacité de stockage minimale et l'incrément d'augmentation de la capacité de stockage.
DBInstanceClass	String	rds.mysql.s1.small	Type d'instance.
DBInstanceStorageRange	Object		Tableau des plages de capacité de stockage.
Step	Integer	5	Incrément d'augmentation de la capacité de stockage. Unité : Go.
Max	Integer	2000	Capacité de stockage maximale pouvant être achetée. Unité : Go.
Min	Integer	5	Capacité de stockage minimale devant être achetée. Unité : Go.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format 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>

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

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	ArticleNotFound	Article not found	Le message d'erreur renvoyé car aucun article pertinent n'a été trouvé.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.