Admin - Get Capacities As Admin
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
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 |
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
{
"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
{
"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 |
Capacity |
Stan pojemności |
capacity |
Prawo dostępu, które użytkownik ma w pojemności |
Tenant |
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 |
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 |
Stan pojemności |
|
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 |