Capacities - Create

Riferimento

Servizio:: Power BI Embedded

Versione API:: 2021-01-01

Effettua il provisioning della capacità dedicata specificata in base alla configurazione specificata nella richiesta.

PUT 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	Nome della capacità dedicata. Deve essere un minimo di 3 caratteri e un massimo di 63. Criterio di espressione regolare: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	Nome del gruppo di risorse di Azure di cui fa parte una determinata capacità PowerBIDedicated. Questo nome deve avere una lunghezza di almeno 1 carattere e non più di 90. Criterio di espressione regolare: `^[-\w\._]+$`
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version	query	True	string	Versione dell'API client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione della risorsa dedicata di PowerBI.
sku	True	CapacitySku	SKU della risorsa di capacità dedicata di PowerBI.
properties.administration		DedicatedCapacityAdministrators	Raccolta di amministratori della capacità dedicata
properties.mode		Mode	Specifica la generazione della capacità di Power BI Embedded. Se non viene specificato alcun valore, viene usato il valore predefinito 'Gen2'. Altre informazioni
systemData		SystemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
tags		object	Coppie chiave-valore di proprietà di provisioning di risorse aggiuntive.

Risposte

Nome	Tipo	Descrizione
200 OK	DedicatedCapacity	OK. Operazione riuscita.
201 Created	DedicatedCapacity	Inprogress. L'operazione è ancora in corso.
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

Create capacity

Esempio di richiesta

HTTP

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

{
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    }
  }
}

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",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/servers/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "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 PowerBI.
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 dell'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'. Altre informazioni
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

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

Nome	Tipo	Descrizione
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

CapacitySku

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

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

CapacitySkuTier

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

Nome	Tipo	Descrizione
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

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'. Altre informazioni
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à di provisioning di risorse aggiuntive.
type	string	Tipo della risorsa dedicata di PowerBI.

DedicatedCapacityAdministrators

Matrice di identità utente dell'amministratore

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

Error

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

Descrive il formato della risposta di errore.

Nome	Tipo	Descrizione
error	Error	Oggetto error

IdentityType

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

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

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

Nome	Tipo	Descrizione
Gen1	string
Gen2	string

State

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

Nome	Tipo	Descrizione
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

SystemData

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

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

Condividi tramite