UUID によるサーバー資産詳細のクエリ - Security Center - Alibaba Cloud - Security Center

UUID を指定してサーバーアセットの詳細と拡張情報を照会します。

説明

この API は廃止されました。一時的にアクセス可能ですが、更新やバグ修正対応は一切行われません。代わりに Sas(2018-12-03) - GetAssetDetailByUuid への移行を推奨します。より強化された機能に加え、サポートも引き続きご利用いただけます。

操作説明

この操作は間もなく非推奨になります。 GetAssetDetailByUuid 操作を呼び出してアセットの詳細を取得してください。

今すぐお試しください

この 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:DescribeAssetDetailByUuid

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SourceIp	string	任意	アクセスソースの IP アドレス。	192.0.XX.XX
Uuid	string	必須	クエリするアセットの UUID。説明 DescribeCloudCenterInstances 操作を呼び出してこのパラメーターを取得できます。	9e6cad93-a379-46fd-a701-9bbf02f4****
Lang	string	任意	リクエストおよび応答のコンテンツの言語。デフォルト値: zh。有効な値: zh: 中国語 en: 英語。	zh

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。Alibaba Cloud がリクエストに対して生成する一意の識別子です。この ID を使用して問題をトラブルシューティングできます。	39031E31-6BBA-5C99-A870-D807E78918CD
AssetDetail	object	アセットの詳細。
CpuInfo	string	CPU の詳細。	Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz
InternetIp	string	サーバーのパブリック IP アドレス。	192.168.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	アセットが権限付与にバインドされているかどうかを示します。有効な値: true: アセットは権限付与にバインドされています。 false: アセットは権限付与にバインドされていません。	true
OsName	string	サーバーのオペレーティングシステム名。	-
Tag	string	サーバーのタグ。	InternetIp
ClientStatus	string	Security Center エージェントクライアントのステータス。有効な値: pause: 保護一時停止。 online: オンライン（保護中）。 offline: オフライン（未保護）。	online
Mem	integer	メモリサイズ（GB 単位）。	32
Memory	integer	メモリサイズ（MB 単位）。	512
VpcInstanceId	string	サーバーが存在する VPC インスタンスの ID。	vpc-bp1fs3bwonlfq503w****
AuthVersion	integer	アセットの権限付与バージョン。有効な値: 1: 無料版（未権限付与）。 6: アンチウイルスエディション。 5: アドバンストエディション。 3: Enterprise Edition。 7: Ultimate。	7
InstanceName	string	サーバーの名前。	i-fasdfasdfadfafa****
Region	string	サーバーが存在するリージョン。	cn-hangzhou-dg-a01
GroupTrace	string	サーバーが属するグループ。グループに割り当てられていないサーバーは、デフォルトで Ungrouped グループに属します。	default
Ip	string	ECS によって割り当てられた IP アドレス。	192.168.XX.XX
HostName	string	ホスト名。	qewrqwerqs****
Os	string	サーバーのオペレーティングシステムタイプ。	linux
AuthModifyTime	integer	アセットの権限付与がバインドされたタイムスタンプ（ミリ秒単位）。	1627974044000
InstanceId	string	サーバーの ID。	i-uf6h7p2fgk6rkk0g****
IntranetIp	string	サーバーの非公開 IP アドレス。	192.168.XX.XX
AssetType	string	アセットタイプ。有効な値: 0: Elastic Compute サービス (ECS) サーバー。 1: サーバーロードバランサー (SLB)。 2: NAT ゲートウェイ。 3: ApsaraDB RDS データベース。 4: MongoDB データベース。 5: 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	エージェントクライアントのバージョン。	2.0.0
IpList	array	サーバーの IP アドレスのリスト。
	string	サーバーの IP アドレスのリスト。	["192.168.XX.XX"]
MacList	array	MAC アドレス。
	string	MAC アドレス。	[ "00:16:3:1:9*:cf" ]
DiskInfoList	array	ディスク情報のコレクション。
	string	ディスク情報。以下のパラメーターでディスクを説明します: diskName: ディスク名。 totalSize: 合計ディスク容量（GB 単位）。 useSize: 使用済みディスク容量（GB 単位）。 useSizeByte: 使用済みディスク容量（バイト単位）。 totalSizeByte: 合計ディスク容量（バイト単位）。	{diskName: "/dev/vda1", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}

例

成功レスポンス

JSONJSON

{
  "RequestId": "39031E31-6BBA-5C99-A870-D807E78918CD",
  "AssetDetail": {
    "CpuInfo": "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
    "InternetIp": "192.168.XX.XX",
    "OsDetail": "Linux 64bit",
    "CreateTime": 1603863599000,
    "Kernel": "4.18.0-80.11.2.el8_0.x86_64",
    "Bind": true,
    "OsName": "-",
    "Tag": "InternetIp",
    "ClientStatus": "online",
    "Mem": 32,
    "Memory": 512,
    "VpcInstanceId": "vpc-bp1fs3bwonlfq503w****",
    "AuthVersion": 7,
    "InstanceName": "i-fasdfasdfadfafa****",
    "Region": "cn-hangzhou-dg-a01",
    "GroupTrace": "default",
    "Ip": "192.168.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": [
      "[\"192.168.XX.XX\"]"
    ],
    "MacList": [
      "[\n      \"00:16:3*:1*:9*:cf\"\n]"
    ],
    "DiskInfoList": [
      "{diskName: \"/dev/vda1\", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}"
    ]
  }
}

エラーコード

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

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

変更履歴

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