GetCloudAssetDetail - Security Center - Centre de documentation Alibaba Cloud

Obtient les détails des actifs cloud.

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.

yundun-sas:GetCloudAssetDetail

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Vendor	integer	Oui	Le fournisseur de services de l'actif cloud. Valeurs valides : 0 : Alibaba Cloud. 1 : fournisseur de services non reconnu. 2 : centre de données. 3, 4, 5 et 7 : fournisseur de services tiers. 8 : serveur d'application simple.	0
AssetType	integer	Oui	Le type de l'actif cloud. Valeurs valides : 0 : Elastic Compute Service (ECS). 1 : Server Load Balancer (SLB). 3 : ApsaraDB RDS. 4 : ApsaraDB for MongoDB. 5 : ApsaraDB for Redis. 6 : Container Registry. 8 : Container Service for Kubernetes. 9 : Virtual Private Cloud (VPC). 11 : ActionTrail. 12 : Alibaba Cloud CDN (CDN). 13 : Certificate Management Service. 14 : Apsara Devops. 15 : Resource Access Management (RAM). 16 : Anti-DDoS. 17 : Web Application Firewall (WAF). 18 : Object Storage Service (OSS). 19 : PolarDB. 20 : ApsaraDB RDS for PostgreSQL. 21 : Microservices Engine (MSE). 22 : File Storage NAS (NAS). 23 : Data Security Center (DSC). 24 : Elastic IP Address (EIP). 25 : Identity as a Service (IDaaS)-Employee Identity and Access Management (EIAM). 26 : PolarDB-X. 27 : Elasticsearch.	14
AssetSubType	integer	Oui	Le sous-type du service cloud.	0
CloudAssetInstances	array<object>	Non	Les détails des actifs.
	object	Non	Les détails de l'actif.
RegionId	string	Non	La région dans laquelle réside l'actif cloud. Remarque Pour plus d'informations sur le mappage entre les identifiants de région et les noms de région, consultez la section Régions et zones.	cn-hangzhou.
InstanceId	string	Oui	L'identifiant de l'instance de l'actif cloud.	sg-wz9hf86vbzbrrde7****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les données renvoyées.
RequestId	string	L'identifiant de la requête, utilisé pour localiser et résoudre les problèmes.	CB45CAED-31C3-517A-8619-10F632D3****
Instances	array<object>	Un tableau composé des détails des actifs cloud.
	object	Les détails de l'actif cloud.
RegionId	string	La région dans laquelle réside l'actif cloud. Remarque Pour plus d'informations sur le mappage entre les identifiants de région et les noms de région, consultez la section Régions et zones.	cn-hanghzou.
Vendor	integer	Le fournisseur de services de l'actif cloud. Valeurs valides : 0 : Alibaba Cloud. 1 : fournisseur de services non reconnu. 2 : centre de données. 3, 4, 5 et 7 : fournisseur de services tiers. 8 : serveur d'application simple.	0
AssetType	integer	Le type de l'actif cloud. Valeurs valides : 0 : ECS. 1 : SLB. 3 : ApsaraDB RDS. 4 : ApsaraDB for MongoDB. 5 : ApsaraDB for Redis. 6 : Container Registry. 8 : Container Service for Kubernetes. 9 : VPC. 11 : ActionTrail. 12 : CDN. 13 : Certificate Management Service. 14 : Apsara Devops. 15 : RAM. 16 : Anti-DDoS. 17 : WAF. 18 : OSS. 19 : PolarDB. 20 : ApsaraDB RDS for PostgreSQL. 21 : MSE. 22 : NAS. 23 : DSC. 24 : EIP. 25 : IDaaS-EIAM. 26 : PolarDB-X. 27 : Elasticsearch.	3
AssetSubType	integer	Le sous-type de l'actif cloud.	0
InstanceId	string	L'identifiant de l'instance de l'actif cloud.	rm-uf6t6u05n6g48****
InstanceName	string	Le nom de l'instance de l'actif cloud.	yztest-l***
CreatedTime	integer	L'heure de création de l'instance. La valeur est un horodatage.	1607365213000
InternetIp	string	L'adresse IP publique de l'instance.	1.2.XX.XX
AlarmStatus	string	Indique si des alertes sont générées pour l'actif cloud actuel. Valeurs valides : YES NO	NO
RiskStatus	string	Indique si des risques sont détectés sur l'actif cloud actuel. Valeurs valides : YES NO	NO
AssetTypeName	string	Le nom du type d'actif cloud.	RDS.
AssetSubTypeName	string	Le nom du sous-type d'actif cloud.	INSTANCE.
SecurityInfo	string	Les informations de sécurité concernant l'actif cloud.	{\"seriousNum\":0,\"appNum\":0,\"baselineMedium\":0,\"remindNum\":0,\"imageVulNntf\":0,\"cveNum\":0,\"vul\":0,\"uuid\":\"rm-uf6t6u05n6g485o70\",\"emgNum\":0,\"weakPWNum\":0,\"imageMaliciousFileRemind\":0,\"imageBaselineMedium\":0,\"laterVulCount\":0,\"cmsNum\":0,\"imageMaliciousFileSerious\":0,\"agentlessMalicious\":0,\"suspNum\":0,\"imageBaselineHigh\":0,\"asapVulCount\":0,\"imageVulLater\":0,\"agentlessAll\":0,\"sysNum\":0,\"containerLater\":0,\"containerSuspicious\":0,\"imageBaselineNum\":0,\"newSuspicious\":0,\"nntfVulCount\":0,\"scaNum\":0,\"containerNntf\":0,\"health\":0,\"trojan\":0,\"suspicious\":0,\"imageMaliciousFileSuspicious\":0,\"containerRemind\":0,\"baselineLow\":0,\"imageVulAsap\":0,\"imageBaselineLow\":0,\"containerAsap\":0,\"agentlessBaseline\":0,\"agentlessVulSca\":0,\"agentlessVulCve\":0,\"containerSerious\":0,\"baselineHigh\":0,\"account\":0,\"baselineNum\":6}
DetailLink	string	Le lien détaillé de l'actif cloud.	https://rds.console.alibabacloud.com/detail/rm-uf6t6u05n6g48****/basicInfo?region=cn-shanghai.
VendorUid	string	L'identifiant du compte pour les instances multi-cloud.	123
VendorUserName	string	Le nom du compte de l'instance multi-cloud.	test.
OriginalAssetInfo	string	Les informations détaillées sur l'actif.	{"owner":{"displayName":"123","id":"123"},"intranetEndpoint":"oss-cn-shanghai-internal.aliyuncs.com","extranetEndpoint":"oss-cn-shanghai.aliyuncs.com","storageClass":"Standard","name":"test","location":"oss-cn-shanghai","creationDate":1629882579000,"region":"cn-shanghai"}
Count	integer	Le nombre d'instances dans la liste des actifs cloud renvoyée.	1

Exemples

JSON format

{
  "RequestId": "CB45CAED-31C3-517A-8619-10F632D3****",
  "Instances": [
    {
      "RegionId": "cn-hanghzou",
      "Vendor": 0,
      "AssetType": 3,
      "AssetSubType": 0,
      "InstanceId": "rm-uf6t6u05n6g48****",
      "InstanceName": "yztest-l***",
      "CreatedTime": 1607365213000,
      "InternetIp": "1.2.XX.XX",
      "AlarmStatus": "NO",
      "RiskStatus": "NO",
      "AssetTypeName": "RDS",
      "AssetSubTypeName": "INSTANCE",
      "SecurityInfo": "{\\\"seriousNum\\\":0,\\\"appNum\\\":0,\\\"baselineMedium\\\":0,\\\"remindNum\\\":0,\\\"imageVulNntf\\\":0,\\\"cveNum\\\":0,\\\"vul\\\":0,\\\"uuid\\\":\\\"rm-uf6t6u05n6g485o70\\\",\\\"emgNum\\\":0,\\\"weakPWNum\\\":0,\\\"imageMaliciousFileRemind\\\":0,\\\"imageBaselineMedium\\\":0,\\\"laterVulCount\\\":0,\\\"cmsNum\\\":0,\\\"imageMaliciousFileSerious\\\":0,\\\"agentlessMalicious\\\":0,\\\"suspNum\\\":0,\\\"imageBaselineHigh\\\":0,\\\"asapVulCount\\\":0,\\\"imageVulLater\\\":0,\\\"agentlessAll\\\":0,\\\"sysNum\\\":0,\\\"containerLater\\\":0,\\\"containerSuspicious\\\":0,\\\"imageBaselineNum\\\":0,\\\"newSuspicious\\\":0,\\\"nntfVulCount\\\":0,\\\"scaNum\\\":0,\\\"containerNntf\\\":0,\\\"health\\\":0,\\\"trojan\\\":0,\\\"suspicious\\\":0,\\\"imageMaliciousFileSuspicious\\\":0,\\\"containerRemind\\\":0,\\\"baselineLow\\\":0,\\\"imageVulAsap\\\":0,\\\"imageBaselineLow\\\":0,\\\"containerAsap\\\":0,\\\"agentlessBaseline\\\":0,\\\"agentlessVulSca\\\":0,\\\"agentlessVulCve\\\":0,\\\"containerSerious\\\":0,\\\"baselineHigh\\\":0,\\\"account\\\":0,\\\"baselineNum\\\":6}",
      "DetailLink": "https://rds.console.alibabacloud.com/detail/rm-uf6t6u05n6g48****/basicInfo?region=cn-shanghai",
      "VendorUid": "123",
      "VendorUserName": "test",
      "OriginalAssetInfo": "{\"owner\":{\"displayName\":\"123\",\"id\":\"123\"},\"intranetEndpoint\":\"oss-cn-shanghai-internal.aliyuncs.com\",\"extranetEndpoint\":\"oss-cn-shanghai.aliyuncs.com\",\"storageClass\":\"Standard\",\"name\":\"test\",\"location\":\"oss-cn-shanghai\",\"creationDate\":1629882579000,\"region\":\"cn-shanghai\"}"
    }
  ],
  "Count": 1
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	NoPermission	no permission
500	ServerError	ServerError
403	NoPermission	caller has no permission

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

Notes de version

Consultez Notes de version pour la liste complète.