Aracılığıyla paylaş

Admin - Get Capacities As Admin

  • Başvuru
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

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

Enumeration

Kapasite durumu

Değer Description
Active

Kapasite kullanıma hazır
Deleted

Kapasite silindi ve kullanılamıyor
Deleting

Kapasite silme işlemi devam ediyor
Invalid

Kapasite kullanılamıyor
NotActivated

Desteklenme -yen
PreSuspended

Desteklenme -yen
ProvisionFailed

Kapasite sağlanamadı
Provisioning

Kapasitenin etkinleştirilmesi devam ediyor
Suspended

Kapasitenin kullanımı askıya alındı
UpdatingSku

Kapasite SKU'su değişikliği devam ediyor

capacityUserAccessRight

Enumeration

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

Değer Description
Admin

Kullanıcının kapasite üzerinde yönetici hakları var
Assign

Kullanıcının katkıda bulunan hakları vardır ve kapasiteye çalışma alanları atayabilir
None

Kullanıcının kapasiteye erişimi yok

TenantKey

Object

Ş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'ta ş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