DescribeHanaInstances - - Centre de documentation Alibaba Cloud

Consulte une ou plusieurs instances SAP HANA qui répondent aux conditions spécifiées.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

hbr:DescribeHanaInstances

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
VaultId	string	Non	L'identifiant du coffre de sauvegarde.	v-000b0ov******6zs
ClusterId	string	Non	L'identifiant de l'instance SAP HANA.	cl-0001zfc******50pr3
PageNumber	integer	Non	Le numéro de page. Les pages commencent à la page 1. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page. Valeurs valides : 1 à 99. Valeur par défaut : 10.	10
Tag	array<object>	Non	Les balises de l'instance SAP HANA.
	object	Non	Les balises de l'instance SAP HANA.
Key	string	Non	La clé de la balise.	ace:rm:rgld
Value	string	Non	La valeur de la balise.	rg-acfmwutpyat2kwy
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-aekz24ikcjyqjkq

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	4003DD68-3C3C-5071-B4FC-631A6C1BAC1C
Success	boolean	Indique si la requête a réussi. Valeurs valides :\n\n* true\n* false.	true
Code	string	Le code de réponse. Le code d'état 200 indique que la requête a réussi.	200
Message	string	Le message renvoyé. Si la requête a réussi, « successful » est renvoyé. Si la requête a échoué, un message d'erreur est renvoyé.	successful
PageNumber	integer	Le numéro de page. Les pages commencent à la page 1. Valeur par défaut : 1.	1
PageSize	integer	Le nombre d'entrées par page. Valeurs valides : 1 à 99. Valeur par défaut : 10.	10
TotalCount	integer	Le nombre total d'entrées renvoyées.	21
Hanas	object
Hana	array<object>	Les informations sur les instances SAP HANA.
	array<object>	L'instance SAP HANA.
Status	integer	The status of the SAP HANA instance. Valid values: INITIALIZING: The instance is being initialized. INITIALIZED: The instance is registered. INVALID_HANA_NODE: The instance is invalid. INITIALIZE_FAILED: The client fails to be installed on the instance.	INITIALIZED
Host	string	The private or internal IP address of the host where the primary node of the SAP HANA instance resides.	47.100.XX.XX
VaultId	string	The ID of the backup vault.	v-0000s974******1hl
UseSsl	boolean	Indicates whether the SAP HANA instance is connected over Secure Sockets Layer (SSL). Valid values: true: The SAP HANA instance is connected over SSL. false: The SAP HANA instance is not connected over SSL.	true
HanaName	string	The name of the SAP HANA instance.	HANA-DEV
InstanceNumber	integer	The instance number of the SAP HANA system.	00
ValidateCertificate	boolean	Indicates whether the SSL certificate of the SAP HANA instance is verified.	false
AlertSetting	string	The alert settings. Valid value: INHERITED, which indicates that the Cloud Backup client sends alert notifications by using the same method configured for the backup vault.	INHERITED
UserName	string	The username of the SYSTEMDB database.	admin
StatusMessage	string	The status information.	INSTALL_CLIENT_FAILED
ClusterId	string	The ID of the SAP HANA instance.	cl-0004cf6g6******0yd7y
Tags	object
Tag	array<object>	The tags of the SAP HANA instance.
	object	The tags of SAP HANA instance.
Key	string	The tag key.	ace:rm:rgld
Value	string	The tag value.	rg-acfmwutpyat2kwy
ResourceGroupId	string	The resource group ID.	rg-acfmvnf22m7itha
CrossAccountType	string	Specifies whether data is backed up within the same Alibaba Cloud account or across Alibaba Cloud accounts. Valid values: SELF_ACCOUNT: Data is backed up within the same Alibaba Cloud account. CROSS_ACCOUNT: Data is backed up across Alibaba Cloud accounts.	CROSS_ACCOUNT
CrossAccountUserId	integer	The ID of the source Alibaba Cloud account that authorizes the current Alibaba Cloud account to back up data across Alibaba Cloud accounts.	158975xxxxx4625
CrossAccountRoleName	string	The name of the Resource Access Management (RAM) role that is created within the source Alibaba Cloud account and assigned to the current Alibaba Cloud account to authorize the current Alibaba Cloud account to back up data across Alibaba Cloud accounts.	hbrcrossrole

Exemples

JSON format

{
  "RequestId": "4003DD68-3C3C-5071-B4FC-631A6C1BAC1C",
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 21,
  "Hanas": {
    "Hana": [
      {
        "Status": 0,
        "Host": "47.100.XX.XX",
        "VaultId": "v-0000s974******1hl",
        "UseSsl": true,
        "HanaName": "HANA-DEV",
        "InstanceNumber": 0,
        "ValidateCertificate": false,
        "AlertSetting": "INHERITED",
        "UserName": "admin",
        "StatusMessage": "INSTALL_CLIENT_FAILED",
        "ClusterId": "cl-0004cf6g6******0yd7y",
        "Tags": {
          "Tag": [
            {
              "Key": "ace:rm:rgld",
              "Value": "rg-acfmwutpyat2kwy"
            }
          ]
        },
        "ResourceGroupId": "rg-acfmvnf22m7itha",
        "CrossAccountType": "CROSS_ACCOUNT",
        "CrossAccountUserId": 0,
        "CrossAccountRoleName": "hbrcrossrole"
      }
    ]
  }
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.