Capacities - Update

Riferimento

Servizio:: Power BI Embedded

Versione API:: 2021-01-01

Aggiornamenti lo stato corrente della capacità dedicata specificata.

PATCH 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 almeno 3 caratteri in lunghezza e non più 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 essere almeno 1 carattere in lunghezza 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	Tipo	Descrizione
properties.administration	DedicatedCapacityAdministrators	Raccolta di amministratori di capacità dedicati
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
sku	CapacitySku	SKU della risorsa di capacità dedicata.
tags	object	Coppie chiave-valore di proprietà di provisioning aggiuntive.

Risposte

Nome	Tipo	Descrizione
200 OK	DedicatedCapacity	OK
202 Accepted	DedicatedCapacity	Accettato
Other Status Codes	ErrorResponse	Risposta di errore che descrive perché 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

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Esempio di richiesta

HTTP

PATCH 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"
  },
  "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:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationstatuses/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01
Location: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationresults/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01

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

Update capacity to Generation 2

Esempio di richiesta

HTTP

PATCH 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"
  },
  "properties": {
    "mode": "Gen2"
  }
}

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"
      ]
    },
    "mode": "Gen2",
    "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:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationstatuses/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01
Location: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationresults/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01

{
  "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"
      ]
    },
    "mode": "Gen2",
    "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 di 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 amministratore
DedicatedCapacityUpdateParameters	Specifica della richiesta di provisioning
Error	Oggetto error
ErrorResponse	Descrive il formato della risposta all'errore.
IdentityType	Tipo di identità che ha creato o 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 di 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 di capacità dedicati
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 di 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 amministratore

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

DedicatedCapacityUpdateParameters

Specifica della richiesta di provisioning

Nome	Tipo	Descrizione
properties.administration	DedicatedCapacityAdministrators	Raccolta di amministratori di capacità dedicati
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.tenantId	string	ID tenant per la capacità. Usato per la creazione di capacità Pro Plus.
sku	CapacitySku	SKU della risorsa di capacità dedicata.
tags	object	Coppie chiave-valore di proprietà di provisioning aggiuntive.

Error

Oggetto error

Nome	Tipo	Descrizione
code	string	Codice di errore
message	string	Messaggio di errore che indica perché l'operazione non è riuscita.

ErrorResponse

Descrive il formato della risposta all'errore.

Nome	Tipo	Descrizione
error	Error	Oggetto error

IdentityType

Tipo di identità che ha creato o 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 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	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 l'ultima risorsa

Condividi tramite

Capacities - Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Update capacity parameters

Esempio di richiesta

Risposta di esempio

Update capacity to Generation 2

Esempio di richiesta

Risposta di esempio

Definizioni

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Risorse aggiuntive