Capacities - Get Details

Reference

Služba:: Power BI Embedded

Verze rozhraní API:: 2021-01-01

Získá podrobnosti o zadané vyhrazené kapacitě.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
dedicatedCapacityName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Název vyhrazené kapacity. Musí mít maximálně 3 znaky a maximálně 63 znaků.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Název skupiny prostředků Azure, pro kterou je daná kapacita PowerBIDedicated součástí. Tento název musí mít délku alespoň 1 znak a nesmí být delší než 90 znaků.
subscriptionId	path	True	string	Jedinečný identifikátor předplatného Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.
api-version	query	True	string	Verze klientského rozhraní API.

Odpovědi

Name	Typ	Description
200 OK	DedicatedCapacity	OK. Operace byla úspěšná.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Get details of a capacity

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest?api-version=2021-01-01

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {},
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

Definice

Name	Description
CapacityProvisioningState	Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.
CapacitySku	Představuje název skladové položky a cenovou úroveň Azure pro prostředek kapacity PowerBI Dedicated.
CapacitySkuTier	Název cenové úrovně Azure, na kterou se skladová položka vztahuje.
DedicatedCapacity	Představuje instanci prostředku vyhrazené kapacity.
DedicatedCapacityAdministrators	Pole identit uživatelů správce
Error	Objekt chyby
ErrorResponse	Popisuje formát odpovědi na chybu.
IdentityType	Typ identity, která prostředek vytvořila nebo upravila.
Mode	Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace
State	Aktuální stav vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků.
SystemData	Metadata týkající se vytvoření a poslední změny prostředku.

CapacityProvisioningState

Výčet

Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.

Hodnota	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

CapacitySku

Objekt

Představuje název skladové položky a cenovou úroveň Azure pro prostředek kapacity PowerBI Dedicated.

Name	Typ	Description
capacity	integer (int32)	Kapacita skladové položky.
name	string	Název úrovně skladové položky.
tier	CapacitySkuTier	Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

CapacitySkuTier

Výčet

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

Hodnota	Description
AutoPremiumHost
PBIE_Azure
Premium

DedicatedCapacity

Objekt

Představuje instanci prostředku vyhrazené kapacity.

Name	Typ	Description
id	string	Identifikátor, který představuje prostředek PowerBI Dedicated.
location	string	Umístění vyhrazeného prostředku PowerBI
name	string	Název prostředku PowerBI Dedicated.
properties.administration	DedicatedCapacityAdministrators	Kolekce správců vyhrazené kapacity
properties.friendlyName	string	Název kapacity
properties.mode	Mode	Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace
properties.provisioningState	CapacityProvisioningState	Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.
properties.state	State	Aktuální stav vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků.
properties.tenantId	string	ID tenanta pro kapacitu Používá se k vytváření kapacity Pro Plus.
sku	CapacitySku	Skladová položka prostředku kapacity PowerBI Dedicated.
systemData	SystemData	Metadata týkající se vytvoření a poslední změny prostředku.
tags	object	Páry klíč-hodnota dalších vlastností zřizování prostředků.
type	string	Typ prostředku PowerBI Dedicated.

DedicatedCapacityAdministrators

Objekt

Pole identit uživatelů správce

Name	Typ	Description
members	string[]	Pole identit uživatelů správce.

Error

Objekt

Objekt chyby

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

ErrorResponse

Objekt

Popisuje formát odpovědi na chybu.

Name	Typ	Description
error	Error	Objekt chyby

IdentityType

Výčet

Typ identity, která prostředek vytvořila nebo upravila.

Hodnota	Description
Application
Key
ManagedIdentity
User

Mode

Výčet

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

Hodnota	Description
Gen1
Gen2

State

Výčet

Aktuální stav vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků.

Hodnota	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

SystemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC)
createdBy	string	Identifikátor identity, která vytvořila prostředek
createdByType	IdentityType	Typ identity, která prostředek vytvořila
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identifikátor identity, která naposledy změnila prostředek
lastModifiedByType	IdentityType	Typ identity, která naposledy změnila prostředek

Sdílet prostřednictvím

Capacities - Get Details

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Get details of a capacity

Ukázkový požadavek

Ukázková odpověď

Definice

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Další materiály