GetAssetDetailByUuid を使用したサーバー詳細クエリ - Security Center

サーバーの UUID を使用して、サーバーの詳細と拡張情報を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-sas:GetAssetDetailByUuid

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SourceIp	string	任意	リクエストのソース IP アドレスです。このパラメーターはシステムによって指定されます。	120.245.XX.XX
Uuid	string	必須	照会するサーバーの UUID です。説明 DescribeCloudCenterInstances 操作を呼び出して、サーバーの UUID を照会できます。	9e6cad93-a379-46fd-a701-9bbf02f4****
Lang	string	任意	リクエストと応答内のコンテンツの言語です。デフォルト値：zh。有効な値： zh：中国語 en：英語	zh

レスポンスフィールド

フィールド	型	説明	例
	object	返されるデータです。
RequestId	string	リクエスト ID です。問題の特定やトラブルシューティングに使用されます。	4892B68B-47BC-5E56-B327-9C2ACC6C1C09
AssetDetail	object	サーバーの詳細です。
CpuInfo	string	CPU の詳細です。	Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz
InternetIp	string	サーバーのパブリック IP アドレスです。	120.47.XX.XX
OsDetail	string	サーバーのオペレーティングシステムのバージョンです。	Linux 64bit
CreateTime	integer	Security Center がサーバーの詳細を記録したときのタイムスタンプです。単位：ミリ秒。	1603863599000
Kernel	string	オペレーティングシステムのカーネルバージョンです。	4.18.0-80.11.2.el8_0.x86_64
Bind	boolean	Security Center がアセットを保護する権限を持っているかどうかを示します。有効な値： true：Security Center はアセットを保護する権限を持っています。 false：Security Center はアセットを保護する権限を持っていません。	true
OsName	string	サーバーが実行するオペレーティングシステムの名前です。	CentOS 7.4 64bit
Tag	string	サーバーに追加されたタグです。	InternetIp
ClientStatus	string	Security Center エージェントのステータスです。有効な値： pause：Security Center エージェントはサーバーの保護を停止します。 online：Security Center エージェントはサーバーを保護しています。 offline：Security Center エージェントはサーバーを保護していません。	online
Mem	integer	サーバーのメモリサイズです。単位：GB。	16
Memory	integer	サーバーのメモリサイズです。単位：MB。	16384
VpcInstanceId	string	サーバーが存在する Virtual Private Cloud (VPC) の ID です。	vpc-bp1fs3bwonlfq503w****
AuthVersion	integer	サーバーを保護する権限を持つ Security Center のエディションです。有効な値： 1：ベーシック (権限なし) 。 6：ウイルス対策。 5：アドバンスト。 3：エンタープライズ。 7：Ultimate。	7
InstanceName	string	サーバーの名前です。	i-fasdfasdfadfafa****
Region	string	サーバーが存在するリージョンです。	cn-shanghai
GroupTrace	string	サーバーが属するグループです。デフォルトでは、グループ化されていないサーバーは Default グループに属します。	default
Ip	string	Elastic Compute Service (ECS) インスタンスに割り当てられている IP アドレスです。	120.47.XX.XX
HostName	string	ホストの名前です。	qewrqwerqs****
Os	string	サーバーのオペレーティングシステムの種類です。	linux
AuthModifyTime	integer	Security Center がアセットを保護する権限を付与されたときのタイムスタンプです。単位：ミリ秒。	1627974044000
InstanceId	string	サーバーの ID です。	i-uf6h7p2fgk6rkk0g****
IntranetIp	string	サーバーのプライベート IP アドレスです。	192.168.XX.XX
AssetType	string	サーバーの種類です。有効な値： 0：ECS インスタンス 1：Server Load Balancer (SLB) インスタンス 2：NAT ゲートウェイ 3：ApsaraDB RDS インスタンス 4：ApsaraDB for MongoDB インスタンス 5：ApsaraDB for Redis インスタンス 6：イメージ 7：コンテナ	0
RegionId	string	アセットが存在するリージョンの ID です。	cn-hanghzou
SysInfo	string	サーバーに関するオペレーティングシステム情報です。	CentOS Linux 8.0.1905
Uuid	string	サーバーの UUID です。	9e6cad93-a379-46fd-a701-9bbf02f4****
Cpu	integer	CPU コアの数です。	2
RegionName	string	サーバーが存在するリージョンの名前です。	China (Hohhot)
Flag	integer	アセットが Alibaba Cloud によって提供されているかどうかを示します。有効な値： 0：サーバーは Alibaba Cloud によって提供されています。 1：サーバーは Alibaba Cloud によって提供されていません。	0
ClientVersion	string	Security Center エージェントのバージョンです。	2.0.0
IpList	array	サーバーの IP アドレスで構成される配列です。
	string	サーバーの IP アドレスです。	120.47.XX.XX
MacList	array	サーバーの MAC (Media Access Control) アドレスで構成される配列です。
	string	サーバーの MAC アドレスです。	00:16:3:1:9*:cf
DiskInfoList	array<object>	ディスクに関する情報のリストです。
	object	ディスクに関する情報です。
DiskName	string	ディスクの名前です。	/dev/vda1
UseSizeByte	integer	使用されているディスク領域の量です。単位：バイト。	2998996992
TotalSize	integer	合計ディスク領域です。単位：GB。	40
UseSize	integer	使用されているディスク領域の量です。単位：GB。	2
TotalSizeByte	integer	合計ディスク領域です。単位：バイト。	42140479488
ClientSubStatus	string	サーバー上の Security Center エージェントのサブステータスです。有効な値： online：アセット上の Security Center エージェントは有効です。 offline：アセット上の Security Center エージェントは無効です。 pause：Security Center エージェントは一時停止しています。 uninstalled：Security Center エージェントはアンインストール済みです。 stopped：アセットはシャットダウンしています。	online
VendorAuthAlias	string	AccessKey ペアが属するアカウントです。説明このパラメーターは、サードパーティのクラウドサーバーによってのみ返されます。パラメーター値が空の場合、返されません。	test

例

成功レスポンス

JSONJSON

{
  "RequestId": "4892B68B-47BC-5E56-B327-9C2ACC6C1C09",
  "AssetDetail": {
    "CpuInfo": "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
    "InternetIp": "120.47.XX.XX",
    "OsDetail": "Linux 64bit",
    "CreateTime": 1603863599000,
    "Kernel": "4.18.0-80.11.2.el8_0.x86_64",
    "Bind": true,
    "OsName": "CentOS  7.4 64bit",
    "Tag": "InternetIp",
    "ClientStatus": "online",
    "Mem": 16,
    "Memory": 16384,
    "VpcInstanceId": "vpc-bp1fs3bwonlfq503w****",
    "AuthVersion": 7,
    "InstanceName": "i-fasdfasdfadfafa****",
    "Region": "cn-shanghai",
    "GroupTrace": "default",
    "Ip": "120.47.XX.XX",
    "HostName": "qewrqwerqs****",
    "Os": "linux",
    "AuthModifyTime": 1627974044000,
    "InstanceId": "i-uf6h7p2fgk6rkk0g****",
    "IntranetIp": "192.168.XX.XX",
    "AssetType": "0",
    "RegionId": "cn-hanghzou",
    "SysInfo": "CentOS Linux 8.0.1905",
    "Uuid": "9e6cad93-a379-46fd-a701-9bbf02f4****",
    "Cpu": 2,
    "RegionName": "China (Hohhot)",
    "Flag": 0,
    "ClientVersion": "2.0.0",
    "IpList": [
      "120.47.XX.XX"
    ],
    "MacList": [
      "00:16:3*:1*:9*:cf"
    ],
    "DiskInfoList": [
      {
        "DiskName": "/dev/vda1",
        "UseSizeByte": 2998996992,
        "TotalSize": 40,
        "UseSize": 2,
        "TotalSizeByte": 42140479488
      }
    ],
    "ClientSubStatus": "online",
    "VendorAuthAlias": "test"
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	NoPermission	no permission
500	ServerError	ServerError
403	NoPermission	caller has no permission

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。