Admin - Get Capacities As Admin

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę pojemności dla organizacji.

Uprawnienia

• Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.
• Uprawnienia delegowane są obsługiwane.

W przypadku uruchamiania w ramach uwierzytelniania podstawowego usługi aplikacja nie może mieć żadnych premii wymaganych przez administratora dla usługi Power BI ustawionych w Azure Portal.

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
$expand	query		string	Rozwija powiązane jednostki w tekście

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Capacities	OK

Przykłady

Example

Example with expand on tenant key

Example

Sample Request

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

Sample Response

Status code:

200

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

Example with expand on tenant key

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "tenantKey": {
        "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
        "name": "Contoso Sales",
        "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
        "isDefault": true,
        "createdAt": "2019-04-30T21:35:15.867-07:00",
        "updatedAt": "2019-04-30T21:35:15.867-07:00"
      }
    }
  ]
}

Definicje

Nazwa	Opis
Capacities	Otoka odpowiedzi OData dla listy pojemności usługi Power BI
Capacity	Pojemność usługi Power BI
CapacityState	Stan pojemności
capacityUserAccessRight	Prawo dostępu, które użytkownik ma w pojemności
TenantKey	Informacje o kluczu szyfrowania

Capacities

Otoka odpowiedzi OData dla listy pojemności usługi Power BI

Nazwa	Typ	Opis
odata.context	string
value	Capacity[]	Lista pojemności

Capacity

Pojemność usługi Power BI

Nazwa	Typ	Opis
admins	string[]	Tablica administratorów pojemności
capacityUserAccessRight	capacityUserAccessRight	Prawo dostępu, które użytkownik ma w pojemności
displayName	string	Nazwa wyświetlana pojemności
id	string	Identyfikator pojemności
region	string	Region świadczenia usługi Azure, w którym aprowizowano pojemność
sku	string	Jednostka SKU pojemności
state	CapacityState	Stan pojemności
tenantKey	TenantKey	Informacje o kluczu szyfrowania (dotyczy tylko tras administratora)
tenantKeyId	string	Identyfikator klucza szyfrowania (dotyczy tylko trasy administratora)

CapacityState

Stan pojemności

Nazwa	Typ	Opis
Active	string	Pojemność jest gotowa do użycia
Deleted	string	Pojemność została usunięta i jest niedostępna
Deleting	string	Usuwanie pojemności jest w toku
Invalid	string	Nie można użyć pojemności
NotActivated	string	Nieobsługiwane
PreSuspended	string	Nieobsługiwane
ProvisionFailed	string	Inicjowanie obsługi administracyjnej pojemności nie powiodło się
Provisioning	string	Aktywacja pojemności jest w toku
Suspended	string	Użycie pojemności jest zawieszone
UpdatingSku	string	Trwa zmiana jednostki SKU pojemności

capacityUserAccessRight

Prawo dostępu, które użytkownik ma w pojemności

Nazwa	Typ	Opis
Admin	string	Użytkownik ma uprawnienia administratora do pojemności
Assign	string	Użytkownik ma prawa współautora i może przypisywać obszary robocze do pojemności
None	string	Użytkownik nie ma dostępu do pojemności

TenantKey

Informacje o kluczu szyfrowania

Nazwa	Typ	Opis
createdAt	string	Data i godzina utworzenia klucza szyfrowania
id	string	Identyfikator klucza szyfrowania
isDefault	boolean	Określa, czy klucz szyfrowania jest kluczem domyślnym dla całej dzierżawy. Każda nowo utworzona pojemność dziedziczy klucz domyślny.
keyVaultKeyIdentifier	string	Identyfikator URI, który jednoznacznie określa klucz szyfrowania w usłudze Azure Key Vault
name	string	Nazwa klucza szyfrowania
updatedAt	string	Data i godzina ostatniej aktualizacji klucza szyfrowania