Capacities - Get Details

Riferimento

Servizio:: Power BI Embedded

Versione API:: 2021-01-01

Ottiene i dettagli sulla capacità dedicata specificata.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
dedicatedCapacityName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Nome della capacità dedicata. Deve essere un minimo di 3 caratteri e un massimo di 63.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nome del gruppo di risorse di Azure di cui fa parte una determinata capacità PowerBIDedicated. Questo nome deve avere una lunghezza minima di 1 carattere e non più di 90.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API client.

Risposte

Nome	Tipo	Descrizione
200 OK	DedicatedCapacity	OK. Operazione riuscita.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get details of a capacity

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
CapacityProvisioningState	Stato di distribuzione corrente della risorsa dedicata di PowerBI. ProvisioningState indica gli stati per il provisioning delle risorse.
CapacitySku	Rappresenta il nome dello SKU e il piano tariffario di Azure per la risorsa capacità dedicata di Power BI.
CapacitySkuTier	Nome del piano tariffario di Azure a cui si applica lo SKU.
DedicatedCapacity	Rappresenta un'istanza di una risorsa capacità dedicata.
DedicatedCapacityAdministrators	Matrice di identità utente amministratore
Error	Oggetto error
ErrorResponse	Descrive il formato della risposta di errore.
IdentityType	Tipo di identità che ha creato/modificato la risorsa.
Mode	Specifica la generazione della capacità di Power BI Embedded. Se non viene specificato alcun valore, viene usato il valore predefinito 'Gen2'. Scopri di più
State	Stato corrente della risorsa dedicata di PowerBI. Lo stato consiste nell'indicare più stati al di fuori del provisioning delle risorse.
SystemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

CapacityProvisioningState

Enumerazione

Stato di distribuzione corrente della risorsa dedicata di PowerBI. ProvisioningState indica gli stati per il provisioning delle risorse.

Valore	Descrizione
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

CapacitySku

Object

Rappresenta il nome dello SKU e il piano tariffario di Azure per la risorsa capacità dedicata di Power BI.

Nome	Tipo	Descrizione
capacity	integer (int32)	Capacità dello SKU.
name	string	Nome del livello sku.
tier	CapacitySkuTier	Nome del piano tariffario di Azure a cui si applica lo SKU.

CapacitySkuTier

Enumerazione

Nome del piano tariffario di Azure a cui si applica lo SKU.

Valore	Descrizione
AutoPremiumHost
PBIE_Azure
Premium

DedicatedCapacity

Object

Rappresenta un'istanza di una risorsa capacità dedicata.

Nome	Tipo	Descrizione
id	string	Identificatore che rappresenta la risorsa dedicata di PowerBI.
location	string	Posizione della risorsa dedicata di PowerBI.
name	string	Nome della risorsa dedicata di PowerBI.
properties.administration	DedicatedCapacityAdministrators	Raccolta di amministratori della capacità dedicata
properties.friendlyName	string	Nome della capacità
properties.mode	Mode	Specifica la generazione della capacità di Power BI Embedded. Se non viene specificato alcun valore, viene usato il valore predefinito 'Gen2'. Scopri di più
properties.provisioningState	CapacityProvisioningState	Stato di distribuzione corrente della risorsa dedicata di PowerBI. ProvisioningState indica gli stati per il provisioning delle risorse.
properties.state	State	Stato corrente della risorsa dedicata di PowerBI. Lo stato consiste nell'indicare più stati al di fuori del provisioning delle risorse.
properties.tenantId	string	ID tenant per la capacità. Usato per la creazione della capacità Pro Plus.
sku	CapacitySku	SKU della risorsa di capacità dedicata di PowerBI.
systemData	SystemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
tags	object	Coppie chiave-valore di proprietà aggiuntive per il provisioning delle risorse.
type	string	Tipo della risorsa dedicata di PowerBI.

DedicatedCapacityAdministrators

Object

Matrice di identità utente amministratore

Nome	Tipo	Descrizione
members	string[]	Matrice di identità utente dell'amministratore.

Error

Object

Oggetto error

Nome	Tipo	Descrizione
code	string	Codice di errore
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

Object

Descrive il formato della risposta di errore.

Nome	Tipo	Descrizione
error	Error	Oggetto error

IdentityType

Enumerazione

Tipo di identità che ha creato/modificato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

Mode

Enumerazione

Specifica la generazione della capacità di Power BI Embedded. Se non viene specificato alcun valore, viene usato il valore predefinito 'Gen2'. Scopri di più

Valore	Descrizione
Gen1
Gen2

State

Enumerazione

Stato corrente della risorsa dedicata di PowerBI. Lo stato consiste nell'indicare più stati al di fuori del provisioning delle risorse.

Valore	Descrizione
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

SystemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC)
createdBy	string	Identificatore per l'identità che ha creato la risorsa
createdByType	IdentityType	Tipo di identità che ha creato la risorsa
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identificatore per l'identità che ha modificato per l'ultima volta la risorsa
lastModifiedByType	IdentityType	Tipo di identità che ha modificato l'ultima volta la risorsa

Condividi tramite

Capacities - Get Details

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Get details of a capacity

Esempio di richiesta

Risposta di esempio

Definizioni

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Risorse aggiuntive