Datasets - Discover Gateways

サービス:

Power BI REST APIs

API バージョン:

v1.0

[マイ ワークスペース] から指定したデータセット バインドできるゲートウェイの一覧を返します。

この API 呼び出しは、少なくとも 1 つのオンプレミス接続を持つデータセットにのみ関連します。 クラウドのみの接続を持つデータセットの場合、この API 呼び出しは空のリストを返します。

必要なスコープ

Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.DiscoverGateways

URI パラメーター

名前	/	必須	型	説明
datasetId	path	True	string	データセット ID

応答

名前	型	説明
200 OK	Gateways	わかりました

例

Example

要求のサンプル

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

応答のサンプル

状態コード:

200

{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "ContosoGateway",
      "type": "Resource",
      "publicKey": {
        "exponent": "AQAB",
        "modulus": "o6j2....cLk="
      }
    }
  ]
}

定義

名前	説明
Gateway	Power BI ゲートウェイ
GatewayPublicKey	Power BI ゲートウェイの公開キー
Gateways	Power BI ゲートウェイの一覧の OData 応答ラッパー

Gateway

Object

Power BI ゲートウェイ

名前	型	説明
gatewayAnnotation	string	JSON 形式のゲートウェイ メタデータ
gatewayStatus	string	ゲートウェイの接続状態
id	string (uuid)	ゲートウェイ ID。 ゲートウェイ クラスターを使用する場合、ゲートウェイ ID はクラスター内のプライマリ (最初の) ゲートウェイを参照し、ゲートウェイ クラスター ID と似ています。
name	string	ゲートウェイ名
publicKey	GatewayPublicKey	ゲートウェイの公開キー
type	string	ゲートウェイの種類

GatewayPublicKey

Object

Power BI ゲートウェイの公開キー

名前	型	説明
exponent	string	公開キー指数
modulus	string	公開キーの剰余

Gateways

Object

Power BI ゲートウェイの一覧の OData 応答ラッパー

名前	型	説明
@odata.context	string
value	Gateway[]	ゲートウェイの一覧