Tous les produits
Search
Centre de documentation

ApsaraDB for HBase:DescribeInstance

Dernière mise à jour :Aug 10, 2026

Récupère les détails d'une instance ApsaraDB for HBase spécifiée, notamment son état, son édition, la configuration des nœuds, les paramètres réseau, la méthode de facturation et l'état des fonctionnalités.

Paramètres de requête

Paramètre Type Obligatoire Exemple Description
Action String Oui DescribeInstance Opération à effectuer. Définissez la valeur sur DescribeInstance.
ClusterId String Oui ld-bp150tns0sjxs**** ID de l'instance à interroger.

Paramètres de réponse

ParamètreTypeExempleDescription
RequestIdString3F429923-B6F6-52C5-9C2A-5B8A8C6BBA66ID de la requête.
ClusterIdStringld-bp150tns0sjxs****ID de l'instance.
InstanceIdStringld-bp150tns0sjxs****ID de l'instance.
ClusterNameStringtesthbaseNom de l'instance.
InstanceNameStringtesthbaseNom de l'instance.
ClusterTypeStringclusterType d'instance. Valeurs valides : cluster (instance en cluster), single (instance autonome).
EngineStringhbaseueÉdition de l'instance. Valeurs valides : hbase (ApsaraDB for HBase Édition standard ou Édition autonome), hbaseue (ApsaraDB for HBase Édition améliorée pour les performances), serverlesshbase (ApsaraDB for HBase Édition serverless), bds (Édition BDS utilisant Lindorm Tunnel Service (LTS)).
StatusStringACTIVATIONÉtat de l'instance. Valeurs valides : CREATING (création de l'instance en cours), ACTIVATION (instance en cours d'exécution), DELETING (suppression de l'instance en cours), RESTARTING (redémarrage de l'instance en cours), MINOR_VERSION_TRANSING (mise à jour de la version mineure en cours).
RegionIdStringcn-hangzhouID de la région où l'instance est déployée.
ZoneIdStringcn-hangzhou-fID de la zone où l'instance est déployée.
PayTypeStringPrepaidMéthode de facturation. Valeurs valides : Prepaid (abonnement), Postpaid (paiement à l'utilisation).
CreatedTimeString2021-07-19T11:23:22Date et heure de création de l'instance.
CreatedTimeUTCString2021-07-19T03:23:22ZDate et heure de création de l'instance. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et est exprimée en UTC.
ExpireTimeString2022-02-24T00:00:00Date et heure d'expiration de l'instance.
ExpireTimeUTCString2022-02-23T16:00:00ZDate et heure d'expiration de l'instance. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et est exprimée en UTC.
MajorVersionString2.0Version majeure de l'instance.
MinorVersionString2.2.9.1Version mineure de l'instance.
IsLatestVersionBooleantrueIndique si l'instance exécute la dernière version. Valeurs valides : true, false.
IsHaBooleantrueIndique si l'instance offre une haute disponibilité. Valeurs valides : true (haute disponibilité), false (pas de haute disponibilité).
Remarque

Par défaut, une instance en cluster dispose de deux nœuds maîtres pour garantir la haute disponibilité. Une instance autonome ne comporte qu'un seul nœud et sa capacité de stockage totale équivaut à la capacité du disque de ce nœud.

IsMultiModelBooleantrueIndique si l'instance prend en charge plusieurs modèles de données. Valeurs valides : true (l'instance est une instance en cluster qui prend en charge plusieurs modèles de données), false (ne prend pas en charge plusieurs modèles de données).
NetworkTypeStringVPCType de réseau. Valeurs valides : VPC (réseau privé virtuel (VPC)), CLASSIC (réseau classique). Si la valeur est VPC, les paramètres VpcId et VswitchId sont également renvoyés.
VpcIdStringvpc-bp15s22y1a7sff5gj****ID du VPC. Ce paramètre n'est renvoyé que lorsque NetworkType a la valeur VPC.
VswitchIdStringvsw-bp1foll427ze3d4ps****ID du vSwitch. Ce paramètre n'est renvoyé que lorsque NetworkType a la valeur VPC.
MasterNodeCountInteger2Catégorie des nœuds maîtres. Valeurs valides : 0 (nœud autonome), 2 (nœud en cluster).
MasterInstanceTypeStringhbase.sn2.largeType d'instance des nœuds maîtres.
MasterDiskSizeInteger0Capacité du disque de chaque nœud maître, en Go.
MasterDiskTypeStringcloud_efficiencyType de disque des nœuds maîtres. Valeurs valides : cloud_efficiency (disque ultra), cloud_ssd (SSD standard).
Remarque

Ce paramètre n'est renvoyé que pour les instances autonomes.

CoreNodeCountInteger2Nombre de nœuds principaux.
CoreInstanceTypeStringhbase.sn2.2xlargeType d'instance des nœuds principaux.
CoreDiskCountString4Nombre de disques sur chaque nœud principal.
CoreDiskSizeInteger100Capacité du disque de chaque nœud principal, en Go.
CoreDiskTypeStringcloud_ssdType de disque des nœuds principaux. Valeurs valides : cloud_efficiency (disque ultra), cloud_ssd (SSD standard), local_hdd (HDD local), local__ssd (SSD local).
BackupStatusStringopenÉtat de la fonctionnalité de sauvegarde. Valeurs valides : open (activée), close (désactivée).
ColdStorageStatusStringopenÉtat de la fonctionnalité de stockage froid. Valeurs valides : open (activée), close (désactivée).
ColdStorageSizeInteger800Capacité du stockage froid, en Go.
MaintainStartTimeString18:00ZHeure de début de la fenêtre de maintenance, en UTC.
MaintainEndTimeString22:00ZHeure de fin de la fenêtre de maintenance, en UTC.
ConfirmMaintainTimeStringtrueIndique si la fenêtre de maintenance a été confirmée. Valeurs valides : true (confirmée), false (non confirmée).
Remarque

La boîte de dialogue Confirm Maintenance Window n'apparaît que la première fois que vous ouvrez la page Basic Information de votre instance.

IsDeletionProtectionBooleanfalseIndique si la protection contre la suppression est activée. Valeurs valides : true (activée), false (désactivée).
EncryptionTypeStringNoEncryptionType de chiffrement. Valeurs valides : NoEncryption (le chiffrement des disques n'est pas activé), CloudDisk (le chiffrement des disques est activé ; le paramètre EncryptionKey est également renvoyé).
Remarque

Le chiffrement des disques ne peut pas être désactivé une fois activé.

EncryptionKeyString0d2470df-da7b-4786-b981-9a164dae****Clé cryptographique. Ce paramètre n'est renvoyé que lorsque EncryptionType a la valeur CloudDisk.
AutoRenewalBooleanfalseIndique si le renouvellement automatique est activé. Valeurs valides : true (activé), false (désactivé).
Remarque

Ce paramètre n'est pas renvoyé pour les instances avec paiement à l'utilisation.

DurationInteger12Cycle de renouvellement automatique. Pour les abonnements mensuels, le cycle est de 1 mois. Pour les abonnements annuels, le cycle est de 12 mois.
Remarque

Ce paramètre n'est pas renvoyé pour les instances avec paiement à l'utilisation.

NeedUpgradeBooleanfalseIndique si les composants de l'instance peuvent être mis à niveau. Valeurs valides : true (mise à niveau possible), false (mise à niveau impossible).
NeedUpgradeCompsList[lindorm, hdfs]Noms des composants pouvant être mis à niveau. Ce paramètre n'est renvoyé que lorsque NeedUpgrade a la valeur true.
TaskProgressString25.00Progression de la tâche en cours d'exécution sur l'instance, exprimée en pourcentage. Les tâches incluent la modification des spécifications, la mise à l'échelle horizontale des nœuds, le redémarrage de l'instance et la mise à jour de la version mineure.
ResourceGroupIdStringrg-acfmyiu4ekp****ID du groupe de ressources contenant l'instance.
ModuleIdInteger0ID du module.
ModuleStackVersionStringphoenxi:4.0Version de la pile de modules.
ParentIdStringld-uf699153o1m2l****ID de l'instance parente.
TagsArray of TagTags associés à l'instance.
Tag
KeyStringtest_keyClé du tag.
ValueStringtest_valueValeur du tag.

Exemples

Exemple de requête

http(s)://hbase.aliyuncs.com/?Action=DescribeInstance
&ClusterId=ld-bp150tns0sjxs****
&<Common request parameters>

Exemple de réponses réussies

Format XML

<DescribeInstanceResponse>
  <CreatedTime>2021-07-19T11:23:22</CreatedTime>
  <ResourceGroupId>rg-acfmyiu4ekp****</ResourceGroupId>
  <NeedUpgrade>false</NeedUpgrade>
  <ModuleId>0</ModuleId>
  <Engine>hbaseue</Engine>
  <NeedUpgradeComps>
</NeedUpgradeComps>
  <Tags>
</Tags>
  <Status>ACTIVATION</Status>
  <ColdStorageSize>800</ColdStorageSize>
  <EncryptionType>NoEncryption</EncryptionType>
  <MasterDiskSize>0</MasterDiskSize>
  <ExpireTimeUTC>2022-02-23T16:00:00Z</ExpireTimeUTC>
  <RequestId>3F429923-B6F6-52C5-9C2A-5B8A8C6BBA66</RequestId>
  <InstanceId>ld-bp150tns0sjxs****</InstanceId>
  <PayType>Prepaid</PayType>
  <VswitchId>vsw-bp1foll427ze3d4ps****</VswitchId>
  <InstanceName>testhbase</InstanceName>
  <MasterNodeCount>2</MasterNodeCount>
  <VpcId>vpc-bp15s22y1a7sff5gj****</VpcId>
  <AutoRenewal>false</AutoRenewal>
  <CoreDiskType>cloud_ssd</CoreDiskType>
  <ExpireTime>2022-02-24T00:00:00</ExpireTime>
  <BackupStatus>open</BackupStatus>
  <IsHa>true</IsHa>
  <TaskProgress>25.00</TaskProgress>
  <MasterInstanceType>hbase.sn1.2xlarge</MasterInstanceType>
  <IsDeletionProtection>false</IsDeletionProtection>
  <IsLatestVersion>true</IsLatestVersion>
  <MaintainEndTime>22:00Z</MaintainEndTime>
  <NetworkType>VPC</NetworkType>
  <CoreInstanceType>hbase.sn2.2xlarge</CoreInstanceType>
  <ClusterName>testhbase</ClusterName>
  <MasterDiskType></MasterDiskType>
  <MaintainStartTime>18:00Z</MaintainStartTime>
  <MajorVersion>2.0</MajorVersion>
  <CoreDiskCount>4</CoreDiskCount>
  <ZoneId>cn-hangzhou-f</ZoneId>
  <CoreNodeCount>2</CoreNodeCount>
  <ClusterId>ld-bp150tns0sjxs****</ClusterId>
  <ColdStorageStatus>open</ColdStorageStatus>
  <MinorVersion>2.2.9.1</MinorVersion>
  <CreatedTimeUTC>2021-07-19T03:23:22Z</CreatedTimeUTC>
  <IsMultiModel>true</IsMultiModel>
  <ClusterType>cluster</ClusterType>
  <RegionId>cn-hangzhou</RegionId>
  <CoreDiskSize>100</CoreDiskSize>
  <ConfirmMaintainTime>true</ConfirmMaintainTime>
</DescribeInstanceResponse>

Format JSON

{
    "CreatedTime": "2021-07-19T11:23:22",
    "ResourceGroupId": "rg-acfmyiu4ekp****",
    "NeedUpgrade": false,
    "ModuleId": 0,
    "Engine": "hbaseue",
    "NeedUpgradeComps": {
        "Comps": []
    },
    "Tags": {
        "Tag": []
    },
    "Status": "ACTIVATION",
    "ColdStorageSize": 800,
    "EncryptionType": "NoEncryption",
    "MasterDiskSize": 0,
    "ExpireTimeUTC": "2022-02-23T16:00:00Z",
    "RequestId": "3F429923-B6F6-52C5-9C2A-5B8A8C6BBA66",
    "InstanceId": "ld-bp150tns0sjxs****",
    "PayType": "Prepaid",
    "VswitchId": "vsw-bp1foll427ze3d4ps****",
    "InstanceName": "testhbase",
    "MasterNodeCount": 2,
    "VpcId": "vpc-bp15s22y1a7sff5gj****",
    "AutoRenewal": false,
    "CoreDiskType": "cloud_ssd",
    "ExpireTime": "2022-02-24T00:00:00",
    "BackupStatus": "open",
    "IsHa": true,
    "TaskProgress": "25.00",
    "MasterInstanceType": "hbase.sn1.2xlarge",
    "IsDeletionProtection": false,
    "IsLatestVersion": true,
    "MaintainEndTime": "22:00Z",
    "NetworkType": "VPC",
    "CoreInstanceType": "hbase.sn2.2xlarge",
    "ClusterName": "testhbase",
    "MasterDiskType": "",
    "MaintainStartTime": "18:00Z",
    "MajorVersion": "2.0",
    "CoreDiskCount": 4,
    "ZoneId": "cn-hangzhou-f",
    "CoreNodeCount": 2,
    "ClusterId": "ld-bp150tns0sjxs****",
    "ColdStorageStatus": "open",
    "MinorVersion": "2.2.9.1",
    "CreatedTimeUTC": "2021-07-19T03:23:22Z",
    "IsMultiModel": true,
    "ClusterType": "cluster",
    "RegionId": "cn-hangzhou",
    "ConfirmMaintainTime": true,
    "CoreDiskSize": 100
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.