Gunakan Alibaba Cloud CLI untuk menggabungkan hasil operasi paging - Alibaba Cloud CLI

Secara default, operasi paging hanya mengembalikan hasil pada satu halaman. Untuk mendapatkan hasil lengkap dari operasi paging, gunakan opsi --pager untuk menggabungkan hasil paging.

Bidang dan deskripsi

Anda dapat menggunakan opsi --pager di Alibaba Cloud CLI untuk menggabungkan hasil array dari operasi paging. Opsi ini mencakup bidang-bidang berikut:

Catatan

Jika nilai bidang yang dikembalikan oleh operasi berbeda dari nilai default bidang, kesalahan penguraian mungkin terjadi. Kami menyarankan Anda memetakan bidang secara manual berdasarkan struktur data yang dikembalikan untuk memastikan akurasi dan stabilitas data.

Bidang	Deskripsi	Nilai default
PageNumber	Nomor halaman yang akan dikembalikan.	`PageNumber`
PageSize	Jumlah maksimum entri yang akan dikembalikan di setiap halaman.	`PageSize`
TotalCount	Jumlah total entri.	`TotalCount`
NextToken	Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru.	`NextToken`
path	Array JMESPath dari data.	Path secara otomatis diidentifikasi. Sebagai contoh, ketika Anda memanggil operasi API `DescribeInstances` dari Elastic Compute Service (ECS), nilai default dari `path` adalah `Instances.Instance`.

Skenario

Catatan

Beberapa operasi mendukung parameter maxResult, yang menentukan jumlah maksimum entri yang akan dikembalikan per kueri. Jika Anda menentukan nilai yang lebih kecil dari yang diharapkan, frekuensi permintaan dan waktu pemrosesan mungkin meningkat secara signifikan. Untuk mengoptimalkan efisiensi kueri, kami menyarankan Anda menentukan nilai yang tepat untuk maxResult saat menggunakan opsi --pager di Alibaba Cloud CLI.

Operasi DescribeInstances dari ECS adalah operasi paging. Secara default, hanya hasil pada halaman pertama daftar instance yang dikembalikan.
```
aliyun ecs DescribeInstances
```

Contoh respons (sebagian):

{
    "PageNumber": 1,
    "TotalCount": 4,
    "PageSize": 10,
    "RequestId": "6EA82E70-9750-4A97-A738-E021D8A57F07",
    "Instances": {
        "Instance": [
            {    
                "InstanceId": "i-m5edv0cqkr9hawls****",
                "ImageId": "win2012r2_64_dtc_9600_zh-cn_40G_alibase_20190318.vhd",
                "SerialNumber": "f06857e8-7f3c-443a-9f88-8e84eb51****",
                "Cpu": 1,
                "Memory": 2048,
                "DeviceAvailable": true,
                "SecurityGroupIds": {
                    "SecurityGroupId": [
                        "sg-bp1fgviwol82z8ap****"
                    ]
                }
            }
        ]
    }
}

Setelah Anda mengaktifkan penggabungan untuk operasi paging, Anda dapat memperoleh informasi instance di semua halaman yang dikembalikan dari operasi sekaligus.
```
aliyun ecs DescribeInstances --pager PageNumber=PageNumber PageSize=PageSize TotalCount=TotalCount path=Instances.Instance
```
Jika nilai bidang sama dengan nilai default, Anda tidak perlu menentukan nilai eksplisit untuk bidang tersebut. Sebagai contoh, perintah sebelumnya dapat disederhanakan:
```
aliyun ecs DescribeInstances --pager
```

Setelah Anda menjalankan perintah, hasil gabungan akan dikembalikan. Keluaran berikut menunjukkan sebagian dari hasil.

Catatan

Hanya bidang yang digabungkan yang dikembalikan. Jika Anda perlu menyaring bidang tertentu, atur jalur penyaringan ke jalur gabungan di JMESPath. Untuk informasi lebih lanjut, lihat Ekstrak parameter dan tabelkan keluaran.

{
    "Instances": {
        "Instance": [
            {    
                "InstanceId": "i-m5edv0cqkr9hawls****",
                "ImageId": "win2012r2_64_dtc_9600_zh-cn_40G_alibase_20190318.vhd",
                "SerialNumber": "f06857e8-7f3c-443a-9f88-8e84eb51****",
                "Cpu": 1,
                "Memory": 2048,
                "DeviceAvailable": true,
                "SecurityGroupIds": {
                    "SecurityGroupId": [
                        "sg-bp1fgviwol82z8ap****"
                    ]
                }
            }
        ]
    }
}