Gunakan DescribeAssetDetailByUuid untuk mengkueri detail aset server berdasarkan UUID - Security Center - Alibaba Cloud - Security Center

Mengkueri detail dan informasi tambahan aset server berdasarkan UUID.

Catatan

API ini telah ditinggalkan. Kami merekomendasikan migrasi ke Sas(2018-12-03) - GetAssetDetailByUuid guna memperoleh fungsionalitas yang lebih baik dan dukungan berkelanjutan. Meskipun API yang telah ditinggalkan ini masih dapat diakses sementara, tidak akan ada pembaruan atau perbaikan bug lebih lanjut.

Deskripsi operasi

Operasi ini akan segera dihentikan. Panggil operasi GetAssetDetailByUuid untuk mendapatkan detail aset.

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

get

*All Resources

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
SourceIp	string	No	Alamat IP sumber akses.	192.0.XX.XX
Uuid	string	Yes	UUID aset yang ingin Anda kueri. Catatan Panggil operasi DescribeCloudCenterInstances untuk mendapatkan parameter ini.	9e6cad93-a379-46fd-a701-9bbf02f4****
Lang	string	No	Bahasa konten dalam permintaan dan tanggapan. Nilai default: zh. Nilai valid: zh: Bahasa Mandarin en: Bahasa Inggris.	zh

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan, yaitu pengidentifikasi unik yang dibuat oleh Alibaba Cloud untuk permintaan tersebut. Anda dapat menggunakan ID ini untuk memecahkan masalah.	39031E31-6BBA-5C99-A870-D807E78918CD
AssetDetail	object	Detail aset.
CpuInfo	string	Detail CPU.	Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz
InternetIp	string	Alamat IP publik server.	192.168.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.	-
Tag	string	Tag server.	InternetIp
ClientStatus	string	Status klien agen. Nilai valid: pause: Perlindungan dijeda. online: Dilindungi. offline: Tidak dilindungi.	online
Mem	integer	Ukuran memori, dalam GB.	32
Memory	integer	Ukuran memori, dalam MB.	512
VpcInstanceId	string	ID instans 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-hangzhou-dg-a01
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.	192.168.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 MongoDB. 5: Database 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 klien agen.	2.0.0
IpList	array	Daftar alamat IP server.
	string	Daftar alamat IP server.	["192.168.XX.XX"]
MacList	array	Alamat MAC.
	string	Alamat MAC.	[ "00:16:3:1:9*:cf" ]
DiskInfoList	array	Kumpulan informasi disk.
	string	Informasi disk. Parameter berikut mendeskripsikan disk: diskName: nama disk. totalSize: kapasitas disk total, dalam GB. useSize: kapasitas disk yang digunakan, dalam GB. useSizeByte: kapasitas disk yang digunakan, dalam byte. totalSizeByte: kapasitas disk total, dalam byte.	{diskName: "/dev/vda1", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	NoPermission	no permission	Anda tidak memiliki izin untuk mengakses layanan.
500	ServerError	ServerError	Terjadi kesalahan layanan. Coba lagi nanti.
403	NoPermission	caller has no permission	Operasi saat ini tidak diotorisasi. Gunakan akun Alibaba Cloud untuk memberikan izin di konsol Resource Access Management (RAM) sebelum Anda melakukan operasi.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.