Admin - Get Capacities As Admin

Service:

Power BI REST APIs

API Version:

v1.0

Kuruluş için kapasitelerin listesini döndürür.

İzinler

• Kullanıcının yönetici haklarına (Office 365 Genel Yönetici veya Power BI Hizmet Yöneticisi gibi) sahip 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 uygulamanın Azure portal Power BI için yönetici onayı için gerekli izinlere sahip olmaması gerekir.

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.

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}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
$expand	query		string	İlgili 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

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"
      }
    }
  ]
}

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 kapasite üzerinde sahip olduğu erişim hakkı
TenantKey	Şifreleme anahtarı bilgileri

Capacities

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

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

Capacity

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	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	Şifreleme anahtarının kimliği (yalnızca yönetici yolu için geçerlidir)

CapacityState

Kapasite durumu

Name	Tür	Description
Active	string	Kapasite kullanıma hazır
Deleted	string	Kapasite silindi ve kullanılamıyor
Deleting	string	Kapasite silme işlemi devam ediyor
Invalid	string	Kapasite kullanılamıyor
NotActivated	string	Desteklenmeyen
PreSuspended	string	Desteklenmeyen
ProvisionFailed	string	Kapasite sağlanamadı
Provisioning	string	Kapasitenin etkinleştirilmesi sürüyor
Suspended	string	Kapasitenin kullanımı askıya alındı
UpdatingSku	string	Kapasite SKU'su değişikliği devam ediyor

capacityUserAccessRight

Kullanıcının kapasite üzerinde sahip olduğu erişim hakkı

Name	Tür	Description
Admin	string	Kullanıcının kapasite üzerinde yönetici hakları var
Assign	string	Kullanıcı katkıda bulunan haklarına sahiptir ve kapasiteye çalışma alanları atayabilir
None	string	Kullanıcının kapasiteye erişimi yok

TenantKey

Şifreleme anahtarı bilgileri

Name	Tür	Description
createdAt	string	Şifreleme anahtarının oluşturma tarihi ve saati
id	string	Ş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 şifreleme anahtarını benzersiz olarak belirten URI
name	string	Şifreleme anahtarının adı
updatedAt	string	Şifreleme anahtarının son güncelleştirme tarihi ve saati