大量のデータが返される API の場合、返されるデータは通常、読みやすいようにページに表示されます。
使用可能なイメージのクエリを例にとると、40 のエントリが返された場合、結果はデフォルトで 4 ページに表示され、各ページには10エントリが含まれます。したがって、返されたデータは不完全なように見えます。
より多くのデータを読み込むには、PageSize
およびPageNumber
パラメータを使用します。2 つのパラメータの特徴は次のとおりです。
パラメータ | 型 | 必須 | 説明 |
---|---|---|---|
PageNumber | 整数 | いいえ | インスタンスステータスリストのページ番号。初期値:1;デフォルト値:1 |
PageSize | 整数 | いいえ | ページ設定クエリ中に設定された各ページの行数。最大値:100;デフォルト値:10 |
例えば、ミラークエリーの場合、杭州の公用公衆鏡の照会結果のTotalCount
に 39 個のデータが表示されている場合、結果はデフォルトで 4 ページに分割されます。クエリ結果を一度に取得するには、リクエストにPageSize
パラメータを追加し、39 より大きい値に設定します(Java SDKが使用されている場合、PageSizeは、setPageSizeメソッドを使用して39より大きい値に設定できます)。 Requestオブジェクト)。この場合、約 39 のミラーのデータは、要求後に一度に返すことができます。
Java SDKによる設定の表示
Java SDK の場合、リクエストオブジェクトのsetPageSize()メソッドを利用してPageSize
を 39 以上に設定することができます。
Java SDK でPageSize
の値が設定されていない場合、null は getPageSize メソッドを介して返され、API サーバーはデフォルトでPageSize
を 10 に設定します
デフォルトでは、
PageSize
の値は 10 です。コードの一部は次のとおりです。DescribeImagesRequest describe = new DescribeImagesRequest();
//describe.setPageSize(50);//By default, if not set, the value of PageSize is 10.
describe.setRegionId("cn-hangzhou");
describe.setImageOwnerAlias("system");
System.out.println("PageSize of the current request:"+describe.getPageSize());
DescribeImagesResponse response
= client.getAcsResponse(describe);
System.out.println("Total number of images:"+response.getTotalCount());
System.out.println("Number of images in the returned response="+response.getImages().size());
setPageSize を使用して
PageSize
を 50 に設定します。そして、一度にすべての画像を返すことができます:コードの一部は次のとおりです。DescribeImagesRequest describe = new DescribeImagesRequest();
describe.setPageSize(50);//Here in the Request, the value of PageSize is set to 50 through the setPageSize() method.
describe.setRegionId("cn-hangzhou");
describe.setImageOwnerAlias("system");
System.out.println("PageSize of the current request:"+describe.getPageSize());
try {
DescribeImagesResponse response
= client.getAcsResponse(describe);
System.out.println("Total number of images:"+response.getTotalCount());
System.out.println("Number of images in the returned response="+response.getImages().size());
注意:
PageSize
の最大値は 100 です。クエリ結果に100を超えるデータが含まれている場合、最後の数ページのデータをPageNumber
から取得する必要があります。つまり、PageNumber
を 1、2、3 に設定して複数のリクエストが送信されます。 返されたすべての情報を取得します。PageNumber
の値は、setPageNumber() を使用してリクエスト内で指定できます。