CreateCompressPointCloudTask -

Fitur kompresi point cloud mengompres data point cloud di Object Storage Service (OSS) untuk mengurangi volume transmisi data melalui jaringan.

Deskripsi operasi

Sebelum menggunakan API ini, pastikan Anda memahami metode penagihan dan harga Intelligent Media Management.
Penting Waktu penyelesaian tugas asinkron tidak dijamin.
Format file: Hanya file point cloud dalam format PCD yang didukung.
API ini bersifat asinkron. Setelah tugas dimulai, informasinya hanya disimpan selama 7 hari. Setelah periode tersebut, informasi tidak dapat diambil kembali. Untuk melihat informasi tugas, panggil operasi GetTask atau ListTasks menggunakan TaskId yang dikembalikan. Anda juga dapat mengatur parameter Notification untuk menerima informasi tugas melalui pesan notifikasi.

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

imm:CreateCompressPointCloudTask

create

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ProjectName	string	Yes	Nama proyek. Untuk informasi selengkapnya, lihat Buat proyek.	test-project
SourceURI	string	Yes	URI OSS dari file point cloud. URI harus dalam format oss://${Bucket}/${Object}. ${Bucket} adalah nama Bucket OSS di Wilayah yang sama dengan proyek. ${Object} adalah path lengkap file, termasuk ekstensi nama file.	oss://test/src/test.pcd
TargetURI	string	Yes	URI OSS dari file output setelah kompresi. URI harus dalam format oss://${Bucket}/${Object}. ${Bucket} adalah nama Bucket OSS di Wilayah yang sama dengan proyek. ${Object} adalah path lengkap file, termasuk ekstensi nama file.	oss://test/tgt
PointCloudFileFormat	string	No	Format file point cloud. Hanya format PCD yang didukung. Nilai default-nya adalah pcd.	pcd
CompressMethod	string	Yes	Nama algoritma kompresi. Nilai yang valid: octree: octree kdtree: K-d tree	octree
PointCloudFields	array	Yes	Bidang properti PCD yang akan dikompresi dan urutan kompresinya. Setelah dikompresi, data didekompresi sesuai urutan ini. Jika Anda menggunakan kompresi Octree dari Point Cloud Library (PCL), hanya ["xyz"] yang didukung. Jika Anda menggunakan kompresi K-d tree dari library Draco, ["xyz"] atau ["xyz", "intensity"] didukung.
	string	No	Bidang properti PCD yang akan dikompresi. Nilai yang valid: xyz intensity	["xyz"]
KdtreeOption	KdtreeOption	No	Parameter untuk kompresi K-d tree.
OctreeOption	OctreeOption	No	Parameter untuk kompresi Octree.
UserData	string	No	Informasi kustom yang dikembalikan dalam pesan notifikasi asinkron. Anda dapat menggunakan informasi ini untuk mengaitkan pesan notifikasi dalam sistem Anda. Panjang maksimum adalah 2048 byte.	{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}
Tags	object	No	Tag kustom untuk mencari dan memfilter tugas asinkron.	{"LabelKey": "Value"}
CredentialConfig	CredentialConfig	No	Jika Anda tidak memiliki persyaratan khusus, biarkan parameter ini kosong. Konfigurasi otorisasi berantai. Parameter ini bersifat opsional. Untuk informasi selengkapnya, lihat Gunakan otorisasi berantai untuk mengakses sumber daya entitas lain.
Notification	Notification	No	Konfigurasi notifikasi. Untuk informasi selengkapnya, klik Notification. Mengenai format pesan notifikasi asinkron, lihat Format pesan notifikasi asinkron. Catatan Callback API Intelligent Media Management tidak mendukung penentuan alamat webhook. Gunakan MNS sebagai gantinya.

Elemen respons

Element	Type	Description	Example
	object	Skema respons
RequestId	string	ID permintaan.	CA995EFD-083D-4F40-BE8A-BDF75FFF****
TaskId	string	ID tugas.	PointCloudCompress-badda57d-a3ab-4e6d-938f-49b77ce****
EventId	string	ID event.	0B7-1LR4Wcue1aBhk2xT85MfL*****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFF****",
  "TaskId": "PointCloudCompress-badda57d-a3ab-4e6d-938f-49b77ce****",
  "EventId": "0B7-1LR4Wcue1aBhk2xT85MfL*****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.