Udostępnij przez

Datasets - Discover Gateways

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Zwraca listę bram, z których można powiązać określony zestaw danych z Mój obszar roboczy.

To wywołanie interfejsu API dotyczy tylko zestawów danych, które mają co najmniej jedno połączenie lokalne. W przypadku zestawów danych z połączeniami tylko w chmurze to wywołanie interfejsu API zwraca pustą listę.

Wymagany zakres

Dataset.Read.All 

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

Identyfikator zestawu danych

Odpowiedzi

Nazwa Typ Opis
200 OK

Gateways

OK

Przykłady

Example

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
Gateway

Brama usługi Power BI
GatewayPublicKey

Klucz publiczny bramy usługi Power BI
Gateways

Otoka odpowiedzi OData dla listy bram usługi Power BI

Gateway

Objekt

Brama usługi Power BI

Nazwa Typ Opis
gatewayAnnotation

string

Metadane bramy w formacie JSON
gatewayStatus

string

Stan łączności bramy
id

string (uuid)

Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odnosi się do bramy podstawowej (pierwszej) w klastrze i jest podobny do identyfikatora klastra bramy.
name

string

Nazwa bramy
publicKey

GatewayPublicKey

Klucz publiczny bramy
type

string

Typ bramy

GatewayPublicKey

Objekt

Klucz publiczny bramy usługi Power BI

Nazwa Typ Opis
exponent

string

Wykładnik klucza publicznego
modulus

string

Modulo klucza publicznego

Gateways

Objekt

Otoka odpowiedzi OData dla listy bram usługi Power BI

Nazwa Typ Opis
@odata.context

string

value

Gateway[]

Lista bram