Gunakan GetAssetDetailByUuid untuk kueri detail server - Security Center - Alibaba Cloud - Security Center

Mengkueri detail dan informasi tambahan aset server berdasarkan UUID.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

yundun-sas:GetAssetDetailByUuid

get

*All Resources

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
SourceIp	string	No	Alamat IP sumber permintaan. Anda tidak perlu menentukan parameter ini. Sistem secara otomatis memperoleh nilai ini.	120.245.XX.XX
Uuid	string	Yes	UUID aset yang ingin Anda kueri. Catatan Panggil operasi DescribeCloudCenterInstances untuk memperoleh parameter ini.	9e6cad93-a379-46fd-a701-9bbf02f4****
Lang	string	No	Tipe bahasa untuk pesan permintaan dan tanggapan. Nilai default: zh. Nilai valid: zh: Bahasa Tionghoa en: Bahasa Inggris.	zh

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan, yaitu pengenal unik yang dibuat oleh Alibaba Cloud untuk permintaan. Anda dapat menggunakan ID ini untuk memecahkan masalah.	4892B68B-47BC-5E56-B327-9C2ACC6C1C09
AssetDetail	object	Detail aset.
CpuInfo	string	Detail CPU.	Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz
InternetIp	string	Alamat IP publik server.	120.47.XX.XX
OsDetail	string	Versi dan arsitektur sistem operasi server.	Linux 64bit
CreateTime	integer	Stempel waktu saat Pusat Keamanan mencatat informasi aset, dalam milidetik.	1603863599000
Kernel	string	Versi kernel sistem operasi.	4.18.0-80.11.2.el8_0.x86_64
Bind	boolean	Apakah aset terikat pada otorisasi. Nilai valid: true: Aset terikat pada otorisasi. false: Aset tidak terikat pada otorisasi.	true
OsName	string	Nama sistem operasi server.	CentOS 7.4 64bit
Tag	string	Tag server.	InternetIp
ClientStatus	string	Status Agen Pusat Keamanan. Nilai valid: pause: Perlindungan dijeda. online: Dilindungi. offline: Tidak dilindungi.	online
Mem	integer	Ukuran memori, dalam GB.	16
Memory	integer	Ukuran memori, dalam MB.	16384
VpcInstanceId	string	ID instans yang terhubung ke VPC tempat server berada.	vpc-bp1fs3bwonlfq503w****
AuthVersion	integer	Versi otorisasi aset. Nilai valid: 1: Edisi Gratis (tidak diotorisasi). 6: Edisi Antivirus. 5: Edisi Lanjutan. 3: Edisi Perusahaan. 7: Edisi Ultimate.	7
InstanceName	string	Nama server.	i-fasdfasdfadfafa****
Region	string	Wilayah tempat server berada.	cn-shanghai
GroupTrace	string	Kelompok tempat server berada. Server yang tidak ditetapkan ke kelompok mana pun secara default termasuk dalam kelompok Ungrouped.	default
Ip	string	Alamat IP yang ditetapkan oleh ECS.	120.47.XX.XX
HostName	string	Hostname.	qewrqwerqs****
Os	string	Tipe sistem operasi server.	linux
AuthModifyTime	integer	Stempel waktu saat otorisasi aset diikat, dalam milidetik.	1627974044000
InstanceId	string	ID server.	i-uf6h7p2fgk6rkk0g****
IntranetIp	string	Alamat IP privat server.	192.168.XX.XX
AssetType	string	Tipe aset. Nilai valid: 0: Server Elastic Compute Service (ECS). 1: Server Load Balancer (SLB). 2: Gerbang NAT. 3: Database ApsaraDB RDS. 4: Database ApsaraDB for MongoDB. 5: Database ApsaraDB for Redis. 6: Gambar kontainer. 7: Kontainer.	0
RegionId	string	ID wilayah aset.	cn-hanghzou
SysInfo	string	Informasi sistem operasi server.	CentOS Linux 8.0.1905
Uuid	string	UUID server.	9e6cad93-a379-46fd-a701-9bbf02f4****
Cpu	integer	Jumlah inti CPU.	2
RegionName	string	Nama wilayah tempat server berada.	China (Hohhot)
Flag	integer	Apakah aset merupakan aset Alibaba Cloud. Nilai valid: 0: Aset Alibaba Cloud. 1: Aset non-Alibaba Cloud.	0
ClientVersion	string	Versi Agen Pusat Keamanan.	2.0.0
IpList	array	Daftar alamat IP server.
	string	Daftar alamat IP server.	120.47.XX.XX
MacList	array	Alamat MAC.
	string	Alamat MAC.	00:16:3:1:9*:cf
DiskInfoList	array<object>	Daftar informasi disk.
	object	Informasi disk.
DiskName	string	Nama disk.	/dev/vda1
UseSizeByte	integer	Kapasitas terpakai disk. Unit: byte.	2998996992
TotalSize	integer	Kapasitas total disk. Unit: GB.	40
UseSize	integer	Kapasitas terpakai disk. Unit: GB.	2
TotalSizeByte	integer	Kapasitas total disk. Unit: byte.	42140479488
ClientSubStatus	string	Substatus Klien pada instans. Nilai valid: online: Online. Agen Pusat Keamanan diaktifkan. offline: Offline. Agen Pusat Keamanan dinonaktifkan. pause: Dijeda. Agen Pusat Keamanan dalam status perlindungan dijeda. uninstalled: Tidak terinstal. Agen Pusat Keamanan tidak terinstal. stopped: Server dimatikan. Agen Pusat Keamanan dalam status server dimatikan.	online
VendorAuthAlias	string	Nama akun tempat Pasangan Kunci Akses berada. Catatan Parameter ini hanya dikembalikan untuk aset host pihak ketiga. Jika nilai kosong, parameter ini tidak dikembalikan.	test

Contoh

Respons sukses

JSONformat

{
  "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"
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	NoPermission	no permission	You do not have the access permissions to the service.
500	ServerError	ServerError	A service failure occurred. Please try again later.
403	NoPermission	caller has no permission	The current operation is not authorized. Use the Alibaba Cloud account to grant permissions in the RAM console and try again.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.