Power Automate のクラウドフローでコネクタの nextLink を使用して続きのデータを取得する方法

こんにちは、Power Platform サポートチームの早坂です。

本記事では、Power Automate のクラウドフローからコネクタの一覧取得アクションを実行したときに、データが存在するのに一部のレコードしか取得できない という事象について、その理由と対処方法をご紹介します。アクションの 改ページ 設定を使用する方法と、フローで応答の nextLink をたどる方法の 2 つを、実機での確認結果とあわせて整理しています。

Note

本記事では、Power Platform for Admins コネクタの「環境一覧を管理者として作成する」(Get-AdminEnvironment) アクションを例にご説明します。ページングの対応有無、パラメーター名、1 ページあたりの既定件数はコネクタとアクションによって異なるため、実際にご利用になるアクションのコネクタリファレンスをあわせてご確認ください。

本記事のスクリーンショットは日本語表示の環境で取得しています。アクション名やパラメーター名の表示は、環境の言語設定によって異なる場合があります。

1. 一度の呼び出しですべてのデータを取得できない理由
2. 対応方法 1: 改ページ設定を使用する
- 2-1. 設定手順
- 2-2. 動作確認
3. 対応方法 2: フローで nextLink をたどる
4. 2 つの方法の使い分け
5. 設計時に確認しておきたい注意点
6. まとめ
参考情報

1. 一度の呼び出しですべてのデータを取得できない理由

クラウドフローから一覧を取得するコネクタアクションを実行すると、対象のデータが存在していても、一部のレコードしか返らない ことがあります。コネクタの一覧取得アクションには、応答サイズやサービス側の処理負荷を抑えるため、結果を一定件数ごとのページに分けて返すものがあります。

「環境一覧を管理者として作成する」アクションでは、詳細パラメーターとして次を指定できます。

パラメーター	説明
ページサイズ (`$top`)	1 ページに含める件数
トークンをスキップする (`$skiptoken`)	続きのページを取得するためのトークン
プロパティを展開する (`$expand`)	応答に展開するプロパティ

また、応答には主に次の値が含まれます。

プロパティ	説明
`value`	現在のページに含まれるデータ
`nextLink`	次のページを取得するための URL。最終ページでは返りません

改ページ設定がオフ (既定) の状態では、アクションは 1 ページ分の応答をそのまま返します。次の画像は、環境が 3 つ存在するテナントでページサイズに 1 を指定して実行した結果です。結果を確認しやすくするため、アクションの後に作成を置き、配列の件数を数える length() 関数で取得件数を出力しています。取得できたのは 1 件です。

改ページがオフのときの実行結果。取得できた件数が 1 で nextLink が返っている

アクションの未加工出力を確認すると、1 ページ目のデータを含む value に加えて、次のページを示す nextLink が返っています。

環境一覧を管理者として作成するアクションの未加工出力に nextLink が含まれている

nextLink は、$skiptoken を含むクエリ文字列付きの URL として返されます。

1	https://<host>/apim/powerplatformforadmins/<connection>/environments?api-version=2018-10-01&%24top=1&%24skiptoken=<トークン>&%24paginationId=<ID>

2. 対応方法 1: 改ページ設定を使用する

アクションの設定に 改ページ が用意されている場合は、この設定を使用するのが最も簡潔です。指定したしきい値に達するまで、Power Automate が nextLink を自動的にたどり、結果を 1 つの応答にまとめて返します。

2-1. 設定手順

デザイナーで対象のアクションを選択します。
設定タブを開きます。
ネットワーキング の 改ページ をオンにします。
しきい値 に、取得したい件数を入力します。

アクションの設定タブで改ページをオンにし、しきい値を入力した画面

Note

しきい値は取得件数の上限ではないため、指定した件数を超えるレコードが返る場合があります。詳細は「2-2. 動作確認」の補足をご覧ください。

改ページはすべてのアクションで使用できるわけではありません。設定タブに 改ページ の項目が表示されないアクションは、この方法を使用できません。その場合は「3. 対応方法 2: フローで nextLink をたどる」をご覧ください。

また、設定タブに 改ページ があっても、アクションが応答に継続トークンを返さない場合は効果がありません。詳細は「5-1. アクション自体の制限がないかを確認する」をご覧ください。

2-2. 動作確認

環境が 3 つ存在するテナントで、ページサイズを 1 にして動作を確認しました。

項目	内容
確認日	2026 年 8 月 3 日
使用コネクタ	Power Platform for Admins (「環境一覧を管理者として作成する」)
権限	Power Platform 管理者
対象テナントの環境数	3
確認方法	フローの実行履歴と actions API から取得した応答を確認

改ページ	ページサイズ	しきい値	取得件数	nextLink
オフ (既定)	1	-	1	あり
オン	1	100	3	なし

改ページをオンにしたときの実行結果。取得できた件数が 3 で nextLink が返っていない

改ページがオフの場合は 1 件だけでしたが、改ページをオンにすると、環境数と同じ 3 件が 1 つの応答として返りました。

重要

改ページのしきい値は、取得件数の上限ではなく「少なくともこの件数に達するまでページを取得する」という指定です。実際の取得件数はページ単位で決まります。たとえば、1 ページが 300 件、しきい値が 500 件の場合、1 ページ目の 300 件ではしきい値に達しないため、2 ページ目も取得し、最大 600 件が返る場合があります。取得件数の上限を厳密に制御したい場合は、返された配列から必要な件数だけを取り出すなど、フロー側で調整してください。

3. 対応方法 2: フローで nextLink をたどる

設定タブに 改ページ が表示されないアクションでは、応答に nextLink などの継続情報があり、次のページを呼び出せる場合に、フロー側で続きを取得できます。

たとえば、HTTP with Microsoft Entra ID コネクタのアクションには、改ページの項目自体がありません。

HTTP with Microsoft Entra ID のアクション設定。ネットワーキングに改ページの項目がない

3-1. nextLink の使用方法を確認する

nextLink の使用方法は、次のページを取得するアクションの入力形式によって異なります。

アクションの入力形式	nextLink の使用方法	本記事の例
`$skiptoken` など、継続トークンを入力する項目がある	`nextLink` からトークンだけを取り出す	Power Platform for Admins
要求 URL を入力できる	`nextLink` の URL 全体を次の要求に使用する	HTTP with Microsoft Entra ID

どちらの場合も、Do until などを使用して nextLink が返らなくなるまでページの取得を繰り返します。対象の API やコネクタの仕様を確認し、入力形式に合う方法を使用してください。

3-2. $skiptoken を取り出して使用する

「環境一覧を管理者として作成する」アクションには、次のページ用の URL を入力する項目はなく、$skiptoken を入力する項目があります。このため、nextLink から $skiptoken の値だけを取り出します。skiptoken= で分割して後半を取得し、さらに & で分割して先頭を取得します。

重要

取り出した値は URL エンコードされています。トークン末尾の = が %3d のままの状態で $skiptoken へ渡すと、次のエラーになります。

要求 URI の継続トークンが無効です。継続トークン - ‘<トークン>%3d’

decodeUriComponent() でデコードしてから渡してください。

デコードを含めた式は次のとおりです。環境一覧を管理者として作成する の部分は、ご利用のアクション名に読み替えてください。

if(
  empty(coalesce(body('環境一覧を管理者として作成する')?['nextLink'], '')),
  '',
  decodeUriComponent(
    first(
      split(
        last(
          split(body('環境一覧を管理者として作成する')?['nextLink'], 'skiptoken=')
        ),
        '&'
      )
    )
  )
)

フローの構成は次のとおりです。

順序	アクション	設定
1	変数を初期化する	名前 `varSkipToken` / 種類文字列 / 値空
2	変数を初期化する	名前 `varEnvNames` / 種類アレイ / 値空
3	Do until	条件 `varSkipToken` が次の値に等しい (空)
3-1	環境一覧を管理者として作成する	ページサイズ `1` / トークンをスキップする `varSkipToken`
3-2	配列変数に追加	取得したデータを `varEnvNames` へ追加
3-3	変数を設定する	`varSkipToken` に 3-2 の式を設定
4	作成	取得件数と結果を出力

Do until で nextLink をたどるフローのデザイナー画面

Do until は本体を実行してから条件を評価します。varSkipToken は初期値が空のため、1 周目は $skiptoken を指定しない状態で 1 ページ目を取得し、2 周目以降は前の周回で取り出したトークンを使用します。最終ページでは nextLink が返らないため varSkipToken が空になり、繰り返しが終了します。

警告

Do until には繰り返しの上限 (既定 60 回) とタイムアウト (既定 1 時間) があります。上限に達すると、途中までのデータしか取得できていない状態で Do until が終了します。想定するページ数に対して十分な上限を設定し、上限に達した場合を検知する処理をあわせて実装してください。

上記の構成で実行したところ、3 ページに分けて 3 件すべてを重複なく取得できました。

Do until で 3 ページ分を取得した実行結果

3-3. nextLink の URL をそのまま使用する

HTTP with Microsoft Entra ID コネクタでは、要求 URL を入力できます。このため、nextLink からトークンを取り出さず、URL 全体を次の要求に使用します。

最初に呼び出す URL を varNextLink へ設定します。次の例では、Flow Management API の一覧取得 URL を使用しています。<環境 ID> は取得対象の環境 ID に置き換えてください。

1	https://api.flow.microsoft.com/providers/Microsoft.ProcessSimple/environments/<環境 ID>/flows?api-version=2016-11-01&$top=50

Do until 内の HTTP アクションは、メソッドを GET、要求の URL を variables('varNextLink') にします。

HTTP アクションの要求 URL に varNextLink を指定した画面

HTTP アクションの実行後、varNextLink を次の式で更新します。最終ページでは nextLink が返らないため、空文字を設定してループを終了します。

1	coalesce(body('HTTP_Get_Flows')?['nextLink'], '')

HTTP 応答の nextLink で varNextLink を更新する画面

この構成で、実行時に nextLink が返らなくなるまで取得したところ、2 ページ、合計 100 件を取得できました。

HTTP アクションと Do until で 2 ページ 100 件を取得した実行結果

4. 2 つの方法の使い分け

方法	使用できる条件	特徴
改ページ設定 (2 章)	設定タブに改ページがある	設定するだけで済み、フローが単純になる
`Do until` + `nextLink` (3 章)	応答に継続情報があり、次のページを呼び出せる	実装量は増えるが、途中経過の記録や独自の停止条件を作り込める

改ページ設定が使用できる場合は、そちらをご検討ください。

5. 設計時に確認しておきたい注意点

5-1. アクション自体の制限がないかを確認する

一覧が全件返らない原因が改ページではなく、アクションそのものの制限 である場合があります。この場合は、改ページ設定を有効にしても Do until で nextLink をたどっても解消しません。

たとえば、2026 年 8 月 4 日 15 時 (日本時間) に Power Platform 管理センターで確認した既知の問題 6057285 では、Power Automate Management コネクタの List My Flows アクションは、環境内に 50 個以上のフローがある場合にすべてを返さないことがあると案内されていました。回避策は List Flows as Admin (V2) アクションの使用です。

アクション	改ページ	取得件数
自分のフローの一覧表示 (`List My Flows`)	オフ (既定)	51
自分のフローの一覧表示 (`List My Flows`)	オン (しきい値 5000)	51
管理者としてフローの一覧を取得 (V2) (`List Flows as Admin (V2)`)	オフ (既定)	106

3 つのアクションの取得件数を出力した作成アクションの実行結果

この検証では、List My Flows の改ページをオンにし、しきい値を 5000 に設定しても、取得件数は 51 件のままでした。応答に nextLink がなかったため、改ページ設定では続きを取得できませんでした。一方、List Flows as Admin (V2) では 106 件が返りました。

重要

既知の問題は一時的な情報であり、状態や回避策が変更される場合があります。期待した件数が返らないときは、対象アクションの応答に nextLink などの継続情報があるかを確認するとともに、Power Platform 管理センターの ヘルプとサポート > 既知の問題 とコネクタリファレンスで最新情報をご確認ください。

5-2. 本当に全件が必要かを確認する

全件取得は、実行時間、コネクタの呼び出し回数、フローが扱うデータ量をいずれも増加させます。フィルターで対象を絞れないかをあわせてご検討ください。

5-3. フィルターを指定した場合も改ページを確認する

フィルターで取得対象を絞っていても、改ページが必要な場合があります。SharePoint コネクタの 複数の項目の取得 アクションには、5,000 件を超えるリストでフィルタークエリを使用した場合、最初の 5,000 件に一致する項目がないと、結果が返らないことがあるという制限が公開されています。

たとえば、7,000 件のリストで条件に一致する 5 件が 5,001 件目以降にある場合、取得予定件数が 5 件でも、改ページがオフだと 0 件になる可能性があります。このような場合は、アクションの改ページをオンにして、続きのページも検索対象にします。

5-4. 最終ページを判定する

最終ページでは nextLink が返りません。空の値を $skiptoken に渡して再実行すると 1 ページ目が返るため、判定を省略すると同じデータを重複して取得します。empty() などで必ず確認してください。

5-5. コネクタの呼び出し回数の制限を確認する

ページングを実装すると、ページ数の分だけコネクタの呼び出し回数が増えます。Power Platform for Admins コネクタには、接続ごとに 60 秒あたり 100 回の API 呼び出し制限があります。利用者数と実行頻度を含めて、制限に到達しないかをご確認ください。

5-6. エラー処理を追加する

途中のページ取得に失敗した場合、結果には一部のデータだけが残る可能性があります。「全件取得できた」と誤解しないよう、実運用では Do until の終了条件と実行結果を確認し、失敗を検知する処理をあわせて実装してください。

6. まとめ

コネクタの応答に nextLink が含まれる場合、データは次のページへ続いています。改ページ設定がオフのアクションでは、通常はフロー側で続きを取得するための対応が必要です。

アクションの設定に 改ページ があれば、オンにしてしきい値を指定する
改ページがないアクションでは、Do until で nextLink をたどる
$skiptoken を自分で組み立てる場合は、decodeUriComponent() で URL エンコードを戻す
nextLink が返らなくなったことを判定して繰り返しを止める

なお、一覧が全件返らない原因がページングではなく、アクション自体の制限であることもあります。実装に着手する前に、対象アクションのリファレンスと既知の問題をあわせてご確認ください (5-1 参照)。

あわせて、Do until の繰り返し上限、コネクタの呼び出し回数の制限、エラー処理の実装もご確認いただけますと幸いです。

参考情報

Note

本記事に記載した数式は実装例です。エラー処理や各環境固有の条件をすべて含むものではありません。ご利用の際は、検証環境で十分に動作をご確認ください。

※本記事の執筆には生成 AI を使用しています。参考

※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。

Japan Dynamics CRM & Power Platform Support Blog

日本マイクロソフトの Dynamics CRM & Power Platform テクニカルサポートチームより、情報をお届けします！

Power Automate のクラウドフローでコネクタの nextLink を使用して続きのデータを取得する方法

目次

1. 一度の呼び出しですべてのデータを取得できない理由

2. 対応方法 1: 改ページ設定を使用する

2-1. 設定手順

2-2. 動作確認

3. 対応方法 2: フローで nextLink をたどる

3-1. nextLink の使用方法を確認する

3-2. $skiptoken を取り出して使用する

3-3. nextLink の URL をそのまま使用する

4. 2 つの方法の使い分け

5. 設計時に確認しておきたい注意点

5-1. アクション自体の制限がないかを確認する

5-2. 本当に全件が必要かを確認する

5-3. フィルターを指定した場合も改ページを確認する

5-4. 最終ページを判定する

5-5. コネクタの呼び出し回数の制限を確認する

5-6. エラー処理を追加する

6. まとめ

参考情報