Udostępnij przez

Gateways - Get Gateway

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

Zwraca określoną bramę.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora bramy.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

Ograniczenia

Bramy sieci wirtualnej nie są obsługiwane. 

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
gatewayId
 path True

string (uuid)

Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do bramy podstawowej (pierwszej) w klastrze. W takich przypadkach identyfikator bramy jest podobny do identyfikatora klastra bramy.

Odpowiedzi

Nazwa Typ Opis
200 OK

Gateway

OK

Przykłady

Example

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934

Przykładowa odpowiedź

Kod stanu:
200 
{
  "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "name": "My_Sample_Gateway",
  "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

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