EnPower Web API の呼び出し

アクセストークンの取得後、EnPower Web API の呼び出しに使用できます。詳細については、以下のセクションを参照してください。

データセンターと Web API URL

テナントのデータセンターを確認するには、AvePoint Online Services にサインインします。右上のプロファイル画像をクリックして、[組織プロファイル] をクリックします。組織プロファイル パネルで、組織ア所属するデータセンターを確認することができます。

データセンター	Web API URL
オーストラリア南東部 (ビクトリア)	https://graph-au.avepointonlineservices.com/smp
カナダ中部 (トロント)	https://graph-ca.avepointonlineservices.com/smp
ドイツ中西部 (フランクフルト)	https://graph-de.avepointonlineservices.com/smp
米国東部 (バージニア)	https://graph-us.avepointonlineservices.com/smp
フランス中部 (パリ)	https://graph-fr.avepointonlineservices.com/smp
西日本 (大阪)	https://graph-jp.avepointonlineservices.com/smp
韓国中部 (ソウル)	https://graph-kr.avepointonlineservices.com/smp
北ヨーロッパ (アイルランド)	https://graph-ne.avepointonlineservices.com/smp
東南アジア (シンガポール)	https://graph-sg.avepointonlineservices.com/smp
スイス北部 (チューリッヒ)	https://graph-ch.avepointonlineservices.com/smp
イギリス南部 (ロンドン)	https://graph-uk.avepointonlineservices.com/smp
米国バージニア州 (バージニア)	https://graph-gov.avepointonlineservices.com/smp
西ヨーロッパ (オランダ)	https://graph-we.avepointonlineservices.com/smp

Power Platform API エンドポイント

利用可能な EnPower Web API エンドポイントについては、以下の表を参照してください。{base_url} は、組織に関連する Web API データセンター URL に置き換える必要があります。

API エンドポイント	説明
GET {base_url}/api/v1/powerplatform/powerapps	EnPower > Power Platform > Power Apps > アプリタブに表示されているデータを含み、EnPower 内の Power Apps アプリに関するデータを取得します。
GET {base_url}/api/v1/powerplatform/powerautomate	EnPower > Power Platform > Power Automate > クラウドフロータブに表示されているデータを含み、EnPower 内の Power Automate クラウドフローに関するデータを取得します。
GET {base_url}/api/v1/powerplatform/connections	EnPower > Power Platform > 接続ページに表示されているデータを含み、EnPower 内の接続に関するデータを取得します。
GET {base_url}/api/v1/powerplatform/environments	EnPower > Power Platform > 環境ページに表示されているデータを含み、EnPower 内の環境に関するデータを取得します。
GET {base_url}/api/v1/powerplatform/powerbi/workspaces	EnPower > Power Platform > Power BI > ワークスペースタブに表示されているデータを含み、EnPower 内の Power BI ワークスペースに関するデータを取得します。
GET {base_url}/api/v1/powerplatform/powerbi/artifacts	EnPower > Power Platform > Power BI > アーティファクトタブに表示されているデータを含み、EnPower 内の Power BI アーティファクトに関するデータを取得します。

レスポンスの例

成功したリクエストは JSON 形式のレスパンスを返します。

{

"Results": [

{

"Id": "c7208b44-f730-ed11-9db0-000d3a541f7c_cf25f394-6434-4285-8b77-12628cee6a9f_default-cf25f394-6434-4285-8b77-12628cee6a9f",

"AppId": "c7208b44-f730-ed11-9db0-000d3a541f7c",

"Container": "Common.Container.Default.PowerApp",

"TenantDomain": "xxx",

"ContainerId": "a4a21ec1-caf3-4321-b5c8-dd1c578fdf5a",

"TenantId": "cf25f394-6434-4285-8b77-12628cee6a9f",

"Environment": "Default-cf25f394-6434-4285-8b77-12628cee6a9f"

…

}

"Status": 200,

"Message": "",

"Content": null,

"NextLink": "https://graph-us.avepointonlineservices.com/smp/api/v1/powerplatform/powerapps?Page=4lg3msyxnY%2BOgf2v0dFIdr67T7HjKX9A1SS94dhrhYFKDKGZLzK1vFMqXlvroGGCoBFIxTcvxPwF77wioqf9i54k1Qkgiox3gBjUnDgl9HLUbTeGTM%2F6MVWh1WvUrBQ5%2Fx6gy%2FTTLwzeCcCrSOTq3w%3D%3D"

}

以下のことに注意してください。

• 既定では、1 ページに返される結果の数は 100 です。これは、1 ページあたりの最大数です。ただし、top フィルターを使用して、この数をカスタマイズすることができます。

例: https://graph-us.avepointonlineservices.com/smp/api/v1/powerplatform/powerapps?top=10

• クエリが 100 件以上の結果を返す場合、レスパンスに次のページの結果セットを取得できる next リンクが含まれます。

例: https://graph-us.avepointonlineservices.com/smp/api/v1/powerplatform/powerapps?Page=4lg3msyxnY%2BOgf2v0dFIdr67T7HjKX9A1SS94dhrhYFKDKGZLzK1vFMqXlvroGGCoBFIxTcvxPwF77wioqf9i54k1Qkgiox3gBjUnDgl9HLUbTeGTM%2F6MVWh1WvUrBQ5%2Fx6gy%2FTTLwzeCcCrSOTq3w%3D%3D

• 特定テナントから情報をクエリするには、tenant フィルターを使用することができます。

例: https://graph-us.avepointonlineservices.com/smp/api/v1/powerplatform/powerapps?tenant=cf25f394-6434-4285-8b77-12628cee6a9f

• スロットリンク (リクエスト制限) しきい値は 15,000 です。レスパンスに 429 エラーコードがある際に、後で再試行してください。

例: HttpStatusCode 429 Status429TooManyRequests