Capacities - Get Capacities

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Vrátí seznam kapacit, ke kterým má uživatel přístup.

Povolení

Toto volání rozhraní API může volat instanční profil. Další informace najdete v tématu: Profily instančního objektu v Power BI Embedded. Tvůrce profilu musí mít oprávnění ke kapacitě.

Požadovaný obor

Capacity.Read.All nebo Capacity.ReadWrite.All

GET https://api.powerbi.com/v1.0/myorg/capacities

Odpovědi

Name	Typ	Description
200 OK	Capacities	OK

Příklady

Example

Ukázkový požadavek

GET https://api.powerbi.com/v1.0/myorg/capacities

Ukázková odpověď

Stavový kód:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin"
    }
  ]
}

Definice

Name	Description
Capacities	Obálka odpovědí OData pro seznam kapacit Power BI
Capacity	Kapacita Power BI
CapacityState	Stav kapacity
capacityUserAccessRight	Přístupové právo, které má uživatel v kapacitě
TenantKey	Informace o šifrovacím klíči

Capacities

Objekt

Obálka odpovědí OData pro seznam kapacit Power BI

Name	Typ	Description
@odata.context	string
value	Capacity[]	Seznam kapacity

Capacity

Objekt

Kapacita Power BI

Name	Typ	Description
admins	string[]	Pole správců kapacity
capacityUserAccessRight	capacityUserAccessRight	Přístupové právo, které má uživatel na kapacitě
displayName	string	Zobrazovaný název kapacity
id	string (uuid)	ID kapacity
region	string	Oblast Azure, ve které byla kapacita zřízena
sku	string	Skladová položka kapacity
state	CapacityState	Stav kapacity
tenantKey	TenantKey	Informace o šifrovacím klíči (platí jenom pro trasy správce)
tenantKeyId	string (uuid)	ID šifrovacího klíče (platí jenom pro trasu správce)

CapacityState

Výčet

Stav kapacity

Hodnota	Description
NotActivated	Nepodporované
Active	Kapacita je připravená k použití.
Provisioning	Probíhá aktivace kapacity
ProvisionFailed	Zřizování kapacity se nezdařilo.
PreSuspended	Nepodporované
Suspended	Použití kapacity je pozastaveno.
Deleting	Probíhá odstranění kapacity.
Deleted	Kapacita byla odstraněna a není k dispozici.
Invalid	Kapacitu nejde použít.
UpdatingSku	Probíhá změna skladové položky kapacity.

capacityUserAccessRight

Výčet

Přístupové právo, které má uživatel v kapacitě

Hodnota	Description
None	Uživatel nemá přístup ke kapacitě.
Assign	Uživatel má práva přispěvatele a může přiřazovat pracovní prostory ke kapacitě.
Admin	Uživatel má oprávnění správce ke kapacitě.

TenantKey

Objekt

Informace o šifrovacím klíči

Name	Typ	Description
createdAt	string (date-time)	Datum a čas vytvoření šifrovacího klíče
id	string (uuid)	ID šifrovacího klíče
isDefault	boolean	Určuje, jestli je šifrovací klíč výchozím klíčem pro celého tenanta. Všechny nově vytvořené kapacity dědí výchozí klíč.
keyVaultKeyIdentifier	string	Identifikátor URI, který jednoznačně určuje šifrovací klíč ve službě Azure Key Vault
name	string	Název šifrovacího klíče
updatedAt	string (date-time)	Datum a čas poslední aktualizace šifrovacího klíče