Admin - Get Capacities As Admin

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Kuruluşun kapasitelerinin listesini döndürür.

İzinler

Kullanıcının Doku yöneticisi olması veya hizmet sorumlusu kullanarak kimlik doğrulaması yapması gerekir.
Temsilci izinleri desteklenir.

Hizmet özel kimlik doğrulaması altında çalıştırılırken, bir uygulama Azure portalında Power BI için yönetici onayı gerekli izinlerin ayarlanmaması.

Gerekli Kapsam

Tenant.Read.All veya Tenant.ReadWrite.All

Yalnızca standart bir yönetici temsilcisi erişim belirteci aracılığıyla kimlik doğrulaması yaparken geçerlidir. Hizmet sorumlusu aracılığıyla kimlik doğrulaması kullanıldığında mevcut olmamalıdır.

Sınırlamalar

Saatte en fazla 200 istek.

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
$expand	query		string	İlişkili varlıkları satır içi olarak genişletir

Yanıtlar

Name	Tür	Description
200 OK	Capacities	TAMAM

Örnekler

Example

Example with expand on tenant key

Example

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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"
      }
    }
  ]
}

Tanımlar

Name	Description
Capacities	Power BI kapasite listesi için OData yanıt sarmalayıcısı
Capacity	Power BI kapasitesi
CapacityState	Kapasite durumu
capacityUserAccessRight	Kullanıcının kapasitede sahip olduğu erişim hakkı
TenantKey	Şifreleme anahtarı bilgileri

Capacities

Object

Power BI kapasite listesi için OData yanıt sarmalayıcısı

Name	Tür	Description
@odata.context	string
value	Capacity[]	Kapasite listesi

Capacity

Object

Power BI kapasitesi

Name	Tür	Description
admins	string[]	Kapasite yöneticileri dizisi
capacityUserAccessRight	capacityUserAccessRight	Kullanıcının kapasitede sahip olduğu erişim hakkı
displayName	string	Kapasitenin görünen adı
id	string (uuid)	Kapasite kimliği
region	string	Kapasitenin sağlandığı Azure bölgesi
sku	string	Kapasite SKU'su
state	CapacityState	Kapasite durumu
tenantKey	TenantKey	Şifreleme anahtarı bilgileri (yalnızca yönetici yolları için geçerlidir)
tenantKeyId	string (uuid)	Şifreleme anahtarının kimliği (yalnızca yönetici yolu için geçerlidir)

CapacityState

Listeleme

Kapasite durumu

Değer	Description
NotActivated	Desteklenme -yen
Active	Kapasite kullanıma hazır
Provisioning	Kapasitenin etkinleştirilmesi devam ediyor
ProvisionFailed	Kapasite sağlanamadı
PreSuspended	Desteklenme -yen
Suspended	Kapasitenin kullanımı askıya alındı
Deleting	Kapasite silme işlemi devam ediyor
Deleted	Kapasite silindi ve kullanılamıyor
Invalid	Kapasite kullanılamıyor
UpdatingSku	Kapasite SKU'su değişikliği devam ediyor

capacityUserAccessRight

Listeleme

Kullanıcının kapasitede sahip olduğu erişim hakkı

Değer	Description
None	Kullanıcının kapasiteye erişimi yok
Assign	Kullanıcının katkıda bulunan hakları vardır ve kapasiteye çalışma alanları atayabilir
Admin	Kullanıcının kapasite üzerinde yönetici hakları var

TenantKey

Object

Şifreleme anahtarı bilgileri

Name	Tür	Description
createdAt	string (date-time)	Şifreleme anahtarının oluşturma tarihi ve saati
id	string (uuid)	Şifreleme anahtarının kimliği
isDefault	boolean	Şifreleme anahtarının kiracının tamamı için varsayılan anahtar olup olmadığı. Yeni oluşturulan tüm kapasiteler varsayılan anahtarı devralır.
keyVaultKeyIdentifier	string	Azure Key Vault'ta şifreleme anahtarını benzersiz olarak belirten URI
name	string	Şifreleme anahtarının adı
updatedAt	string (date-time)	Şifreleme anahtarının son güncelleştirme tarihi ve saati