Consulte les informations sur les actifs répondant aux critères conditionnels définis, par exemple en recherchant des actifs spécifiques selon des conditions telles que le nom de l'instance d'actif ou la région à laquelle l'instance appartient. Actuellement, les méthodes de pagination et NextToken sont toutes deux disponibles pour les requêtes conditionnelles, et la méthode NextToken est recommandée.
Description de l'opération
Vous pouvez rechercher des actifs selon des conditions telles que l'identifiant de l'instance, le nom de l'instance, l'identifiant du VPC, la région et l'adresse IP publique. Vous pouvez également définir des relations logiques entre différentes conditions de recherche pour rechercher des actifs répondant à plusieurs conditions.
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
|
yundun-sas:DescribeCloudCenterInstances |
get |
*Actif.
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
RegionId
deprecated
|
string |
Non |
L'identifiant de la région dans laquelle l'instance se trouve. |
cn-hangzhou |
| Criteria |
string |
Non |
Les conditions de recherche pour les actifs. Ce paramètre est au format JSON. Faites attention à la casse lors de la spécification de ce paramètre. Remarque
Vous pouvez rechercher des actifs selon des conditions telles que l'identifiant de l'instance, le nom de l'instance, l'identifiant du VPC, la région et l'adresse IP publique. Vous pouvez appeler l'opération DescribeCriteria pour interroger les conditions de recherche prises en charge. |
[{"name":"riskStatus","value":"YES"},{"name":"internetIp","value":"1.2.XX.XX"}] |
| MachineTypes |
string |
Non |
Le type d'actif à interroger. Valeurs valides :
|
ecs |
| LogicalExp |
string |
Non |
La relation logique entre plusieurs conditions de recherche. Valeur par défaut : OR. Valeurs valides :
|
OR |
| PageSize |
integer |
Non |
Le nombre d'entrées d'actifs à afficher sur chaque page lors de la configuration de la pagination pour une requête paginée. Valeur par défaut : 20, ce qui signifie que 20 entrées d'actifs sont affichées par page. |
100 |
| CurrentPage |
integer |
Non |
Le numéro de la page à renvoyer. Valeur par défaut : 1. |
1 |
| Importance |
integer |
Non |
L'importance de l'actif. Valeurs valides :
|
2 |
| NoGroupTrace |
boolean |
Non |
Indique si le groupe par défaut Ungrouped doit être internationalisé. Valeur par défaut : false. Valeurs valides :
|
false |
| Lang |
string |
Non |
La langue de la requête et de la réponse. Valeur par défaut : zh. Valeurs valides :
|
zh |
| UseNextToken |
boolean |
Non |
Indique si la méthode NextToken doit être utilisée pour extraire les données de la liste des actifs. Si vous utilisez ce paramètre, TotalCount n'est pas renvoyé. Valeurs valides :
|
false |
| NextToken |
string |
Non |
La valeur NextToken renvoyée lorsque la méthode NextToken est utilisée. Laissez ce paramètre vide pour la première requête. |
E17B501887A2D3AA5E8360A6EFA3B*** |
| ResourceDirectoryAccountId |
integer |
Non |
L'identifiant du compte Alibaba Cloud auquel appartiennent les comptes membres du dossier de ressources. Remarque
Vous pouvez appeler l'opération DescribeMonitorAccounts pour obtenir ce paramètre. |
1232428423234**** |
| Flags |
string |
Non |
Le fournisseur d'actifs. Séparez plusieurs fournisseurs d'actifs par des virgules (,). Valeurs valides :
|
1,2,3 |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| Success |
boolean |
Le statut du résultat de l'appel d'API. Valeurs valides :
|
true |
| RequestId |
string |
L'identifiant de la requête. Cet identifiant unique est généré par Alibaba Cloud pour la requête et peut être utilisé pour le dépannage. |
32A73759-4C0F-4801-BE98-901223ACEE9A |
| PageInfo |
object |
Les informations de pagination. |
|
| CurrentPage |
integer |
Le numéro de la page actuelle dans une requête paginée. |
1 |
| PageSize |
integer |
Le nombre d'actifs renvoyés par page dans une requête paginée. Valeur par défaut : 20, ce qui indique que 20 actifs sont affichés sur chaque page. |
20 |
| TotalCount |
integer |
Le nombre total d'actifs interrogés. |
50 |
| Count |
integer |
Le nombre d'actifs renvoyés sur la page actuelle. |
10 |
| NextToken |
string |
La valeur NextToken renvoyée lorsque la méthode de pagination NextToken est utilisée. |
B604532DEF982B875E8360A6EFA3B*** |
| Instances |
array<object> |
La liste des détails des actifs. |
|
|
object |
Les détails de l'actif. |
||
| Status |
string |
L'état de fonctionnement de l'instance. Valeurs valides :
|
Running |
| CpuInfo |
string |
Les informations sur le processeur de l'actif. |
Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz |
| InternetIp |
string |
L'adresse IP publique de l'instance. |
1.2.XX.XX |
| Kernel |
string |
Les informations sur la version du noyau. |
3.10.0-1127.19.1.el7.x86_64 |
| Bind |
boolean |
Indique si l'actif est lié à une autorisation. Valeurs valides :
|
true |
| OsName |
string |
La version du noyau de l'instance. |
- |
| Tag |
string |
Le nom de la balise de l'instance d'actif. |
InternetIp,test |
| ClientStatus |
string |
L'état de connexion du client sur l'instance. Valeurs valides :
|
online |
| Mem |
integer |
La taille de la mémoire. Unité : Mo. |
1024 |
| VpcInstanceId |
string |
L'identifiant du VPC auquel l'instance appartient. |
vpc-uf60agqq65bs98zoo**** |
| TagId |
string |
L'identifiant de la balise de l'actif. |
121313,41412 |
| Flag |
integer |
Indique si l'instance est un actif Alibaba Cloud. Valeurs valides :
|
0 |
| LastLoginTimestamp |
integer |
L'horodatage de la dernière connexion du client. Unité : millisecondes. |
1637592907000 |
| AuthVersion |
integer |
La version d'autorisation de l'actif. Valeurs valides :
|
1 |
| Region |
string |
L'identifiant de la région à laquelle l'instance appartient. |
cn-hangzhou-cm***-*** |
| InstanceName |
string |
Le nom de l'instance. |
yztest-l*** |
| PodCount |
integer |
Le nombre de pods. |
1 |
| VulCount |
integer |
Le nombre de vulnérabilités sur l'instance. |
2 |
| HcStatus |
string |
Indique si des risques de référence sont détectés sur l'instance. Valeurs valides :
|
YES |
| CreatedTime |
integer |
L'horodatage de la création du cluster. Unité : millisecondes. |
1607365213000 |
| GroupTrace |
string |
Le nom du groupe auquel l'actif appartient. |
default |
| ClusterId |
string |
L'identifiant du cluster. |
c690a0789419f4284a4e0a29e12fe**** |
| RiskStatus |
string |
Indique si des risques de sécurité existent sur l'actif. Valeurs valides :
|
NO |
| Cores |
integer |
Le nombre de cœurs de processeur de l'actif. |
4 |
| VulStatus |
string |
Indique si des vulnérabilités existent sur l'instance. Valeurs valides :
|
YES |
| AlarmStatus |
string |
Indique si des alertes de sécurité existent sur l'actif. Valeurs valides :
|
NO |
| MacListString |
string |
L'adresse MAC du système. |
00:13:3e:31:13:39,02:12:67:b8:**:** |
| Importance |
integer |
Le niveau d'importance de l'actif. Valeurs valides :
|
2 |
| HealthCheckCount |
integer |
Le nombre de risques de référence sur l'instance. |
1 |
| Ip |
string |
L'adresse IP publique de l'instance. |
1.2.XX.XX |
| Os |
string |
Le système d'exploitation de l'instance. |
Linux |
| AuthModifyTime |
integer |
L'horodatage de la liaison de l'autorisation à l'actif. Unité : millisecondes. |
1627974044000 |
| SafeEventCount |
integer |
Le nombre d'alertes de sécurité sur l'actif. |
5 |
| InstanceId |
string |
L'identifiant de l'instance. |
i-m5*** |
| AssetType |
string |
Le type de l'actif. Valeurs valides :
|
0 |
| IntranetIp |
string |
L'adresse IP privée de l'instance. |
1.2.XX.XX |
| Vendor |
integer |
Le fournisseur de l'actif. Valeurs valides :
|
0 |
| RegionId |
string |
L'identifiant de la région où réside l'actif. |
cn-hanghzou |
| Uuid |
string |
L'UUID de l'instance. |
c9107c04-942f-40c1-981a-f1c1*** |
| GroupId |
integer |
L'identifiant du groupe auquel l'instance appartient. |
4120080 |
| RegionName |
string |
Le nom de la région où réside l'actif. |
China (Hangzhou) |
| VendorName |
string |
Le nom du fournisseur de services pour l'actif. Valeurs valides :
|
IDC |
| AuthVersionName |
string |
Le nom spécifique de la version d'autorisation de l'actif. Valeurs valides :
|
Ultimate Edition |
| ClusterName |
string |
Le nom du cluster. |
cluster1 |
| ExposedStatus |
integer |
L'état d'exposition de l'actif. Valeurs valides :
|
0 |
| RiskCount |
string |
Les statistiques des éléments à risque sur l'actif. La valeur est au format JSON et contient les champs suivants :
|
{ "account": 0, "appNum": 0, "asapVulCount": 0, "baselineHigh": 0, "baselineLow": 0, "baselineMedium": 0, "baselineNum": 0, "cmsNum": 0, "containerAsap": 0, "containerLater": 0, "containerNntf": 0, "containerRemind": 0, "containerSerious": 0, "containerSuspicious": 0, "cveNum": 0, "emgNum": 0, "health": 0, "imageBaselineHigh": 0, "imageBaselineLow": 0, "imageBaselineMedium": 0, "imageBaselineNum": 0, "imageMaliciousFileRemind": 0, "imageMaliciousFileSerious": 0, "imageMaliciousFileSuspicious": 0, "imageVulAsap": 0, "imageVulLater": 0, "imageVulNntf": 0, "laterVulCount": 0, "newSuspicious": 0, "nntfVulCount": 0, "remindNum": 0, "scaNum": 0, "seriousNum": 0, "suspNum": 0, "suspicious": 0, "sysNum": 0, "trojan": 0, "uuid": "inet-37316411-37fe-4b72-b245-346a2721****", "vul": 0, "weakPWNum": 0 } |
| IpListString |
string |
La liste des adresses IP du système. |
172.31.XX.XX,172.171.XX.XX |
| AssetTypeName |
string |
Le nom du type de l'actif. |
Elastic Compute Service |
| FlagName |
string |
Le fournisseur de l'actif. Valeurs valides :
|
ASK |
| AppId |
string |
L'identifiant de l'application. Remarque
Ce champ n'est renvoyé que lorsque Vendor est défini sur 9. |
test |
| AppName |
string |
Le nom de l'application. Remarque
Ce champ n'est renvoyé que lorsque Vendor est défini sur 9. |
testAppName |
| ClientSubStatus |
string |
Le sous-état du client sur l'instance. Valeurs valides :
|
online |
| TagResources |
string |
Les balises personnalisées du nœud Lingjun. Ce champ n'est renvoyé que lorsque l'instance est une instance Lingjun. |
app:test,type:lingjun |
| PostPaidFlag |
integer |
La méthode de facturation de la version de protection associée à l'actif. Valeurs valides :
|
0 |
| HasContainer |
string |
Indique si l'actif contient des conteneurs. Valeurs valides :
|
YES |
| ServiceId |
string |
L'identifiant du service. Ce champ n'a de valeur que lorsque l'instance est une instance sans serveur et appartient à Machine Learning Platform for AI (PAI). |
dsw-76jlywunsif09bp15p |
| VendorUid |
string |
L'identifiant du compte de l'instance multi-cloud. |
123 |
| VendorUserName |
string |
Le nom du compte de l'instance multi-cloud. |
VendorUserName |
| Namespace |
string |
L'espace de noms. |
crm-test |
| BindFileProtectType |
string |
Indique si l'autorisation de protection contre les altérations est liée. Valeurs valides :
|
block |
| EdrAuthVersion |
string |
L'identifiant de la version d'autorisation EDR actuellement utilisée par l'actif. |
|
| FreeType |
string |
Le type de quota gratuit utilisé par l'actif. |
Exemples
JSON format
{
"Success": true,
"RequestId": "32A73759-4C0F-4801-BE98-901223ACEE9A",
"PageInfo": {
"CurrentPage": 1,
"PageSize": 20,
"TotalCount": 50,
"Count": 10,
"NextToken": "B604532DEF982B875E8360A6EFA3B***"
},
"Instances": [
{
"Status": "Running",
"CpuInfo": "Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz",
"InternetIp": "1.2.XX.XX",
"Kernel": "3.10.0-1127.19.1.el7.x86_64",
"Bind": true,
"OsName": "-",
"Tag": "InternetIp,test",
"ClientStatus": "online",
"Mem": 1024,
"VpcInstanceId": "vpc-uf60agqq65bs98zoo****",
"TagId": "121313,41412",
"Flag": 0,
"LastLoginTimestamp": 1637592907000,
"AuthVersion": 1,
"Region": "cn-hangzhou-cm***-***",
"InstanceName": "yztest-l***",
"PodCount": 1,
"VulCount": 2,
"HcStatus": "YES",
"CreatedTime": 1607365213000,
"GroupTrace": "default",
"ClusterId": "c690a0789419f4284a4e0a29e12fe****",
"RiskStatus": "NO",
"Cores": 4,
"VulStatus": "YES",
"AlarmStatus": "NO",
"MacListString": "00:13:3e:31:13:39,02:12:67:b8:**:**",
"Importance": 2,
"HealthCheckCount": 1,
"Ip": "1.2.XX.XX",
"Os": "Linux",
"AuthModifyTime": 1627974044000,
"SafeEventCount": 5,
"InstanceId": "i-m5***",
"AssetType": "0",
"IntranetIp": "1.2.XX.XX",
"Vendor": 0,
"RegionId": "cn-hanghzou",
"Uuid": "c9107c04-942f-40c1-981a-f1c1***",
"GroupId": 4120080,
"RegionName": "China (Hangzhou)",
"VendorName": "IDC",
"AuthVersionName": "Ultimate Edition",
"ClusterName": "cluster1",
"ExposedStatus": 0,
"RiskCount": "{\n \"account\": 0,\n \"appNum\": 0,\n \"asapVulCount\": 0,\n \"baselineHigh\": 0,\n \"baselineLow\": 0,\n \"baselineMedium\": 0,\n \"baselineNum\": 0,\n \"cmsNum\": 0,\n \"containerAsap\": 0,\n \"containerLater\": 0,\n \"containerNntf\": 0,\n \"containerRemind\": 0,\n \"containerSerious\": 0,\n \"containerSuspicious\": 0,\n \"cveNum\": 0,\n \"emgNum\": 0,\n \"health\": 0,\n \"imageBaselineHigh\": 0,\n \"imageBaselineLow\": 0,\n \"imageBaselineMedium\": 0,\n \"imageBaselineNum\": 0,\n \"imageMaliciousFileRemind\": 0,\n \"imageMaliciousFileSerious\": 0,\n \"imageMaliciousFileSuspicious\": 0,\n \"imageVulAsap\": 0,\n \"imageVulLater\": 0,\n \"imageVulNntf\": 0,\n \"laterVulCount\": 0,\n \"newSuspicious\": 0,\n \"nntfVulCount\": 0,\n \"remindNum\": 0,\n \"scaNum\": 0,\n \"seriousNum\": 0,\n \"suspNum\": 0,\n \"suspicious\": 0,\n \"sysNum\": 0,\n \"trojan\": 0,\n \"uuid\": \"inet-37316411-37fe-4b72-b245-346a2721****\",\n \"vul\": 0,\n \"weakPWNum\": 0\n}",
"IpListString": "172.31.XX.XX,172.171.XX.XX",
"AssetTypeName": "Elastic Compute Service",
"FlagName": "ASK",
"AppId": "test",
"AppName": "testAppName",
"ClientSubStatus": "online",
"TagResources": "app:test,type:lingjun",
"PostPaidFlag": 0,
"HasContainer": "YES",
"ServiceId": "dsw-76jlywunsif09bp15p",
"VendorUid": "123",
"VendorUserName": "VendorUserName",
"Namespace": "crm-test",
"BindFileProtectType": "block",
"EdrAuthVersion": "",
"FreeType": ""
}
]
}
Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | NoPermission | no permission | |
| 400 | RdCheckNoPermission | Resource directory account verification has no permission. | |
| 500 | ServerError | ServerError | |
| 500 | RdCheckInnerError | Resource directory account service internal error. | |
| 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.