Capacities - Update

Dienst:: Power BI Embedded

API-Version:: 2021-01-01

Aktualisiert den aktuellen Status der angegebenen dedizierten Kapazität.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dedicatedCapacityName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Der Name der dedizierten Kapazität. Es muss mindestens 3 Zeichen und maximal 63 Zeichen sein.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.administration	DedicatedCapacityAdministrators	Eine Sammlung dedizierter Kapazitätsadministratoren
properties.mode	Mode	Gibt die Generierung der Power BI Embedded-Kapazität an. Wenn kein Wert angegeben ist, wird der Standardwert "Gen2" verwendet. Weitere Informationen
sku	CapacitySku	Die SKU der dedizierten Kapazitätsressource.
tags	object	Schlüsselwertpaare zusätzlicher Bereitstellungseigenschaften.

Antworten

Name	Typ	Beschreibung
200 OK	DedicatedCapacity	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
202 Accepted	DedicatedCapacity	Die Anforderung wurde zur Verarbeitung akzeptiert, die Verarbeitung wurde jedoch noch nicht abgeschlossen. Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

DedicatedCapacity

Der Azure-Vorgang wurde erfolgreich abgeschlossen.

202 Accepted

DedicatedCapacity

Die Anforderung wurde zur Verarbeitung akzeptiert, die Verarbeitung wurde jedoch noch nicht abgeschlossen.

Header

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 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

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

Update capacity to Generation 2

Beispielanforderung

HTTP

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

{
  "properties": {
    "mode": "Gen2"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 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

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

Definitionen

Name	Beschreibung
CapacityProvisioningState	Der aktuelle Bereitstellungsstatus der dedizierten PowerBI-Ressource. Der provisioningState ist das Angeben von Status für die Ressourcenbereitstellung.
CapacitySku	Stellt den SKU-Namen und die Azure-Preisstufe für die Dedizierte PowerBI-Kapazitätsressource dar.
CapacitySkuTier	Der Name des Azure-Preisniveaus, auf das die SKU angewendet wird.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DedicatedCapacity	Stellt eine Instanz einer dedizierten Kapazitätsressource dar.
DedicatedCapacityAdministrators	Ein Array von Administratorbenutzeridentitäten
DedicatedCapacityUpdateParameters	Spezifikation der Bereitstellungsanforderung
Error	Das Fehlerobjekt.
ErrorResponse	Das Fehlerobjekt
Mode	Gibt die Generierung der Power BI Embedded-Kapazität an. Wenn kein Wert angegeben ist, wird der Standardwert "Gen2" verwendet. Weitere Informationen
State	Der aktuelle Status der dedizierten PowerBI-Ressource. Der Zustand besteht darin, weitere Zustände außerhalb der Ressourcenbereitstellung anzugeben.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

CapacityProvisioningState

Enumeration

Der aktuelle Bereitstellungsstatus der dedizierten PowerBI-Ressource. Der provisioningState ist das Angeben von Status für die Ressourcenbereitstellung.

Wert	Beschreibung
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

CapacitySku

Objekt

Stellt den SKU-Namen und die Azure-Preisstufe für die Dedizierte PowerBI-Kapazitätsressource dar.

Name	Typ	Beschreibung
capacity	integer (int32)	Die Kapazität der SKU.
name	string	Name der SKU-Ebene.
tier	CapacitySkuTier	Der Name des Azure-Preisniveaus, auf das die SKU angewendet wird.

CapacitySkuTier

Enumeration

Der Name des Azure-Preisniveaus, auf das die SKU angewendet wird.

Wert	Beschreibung
PBIE_Azure
Premium
AutoPremiumHost

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DedicatedCapacity

Objekt

Stellt eine Instanz einer dedizierten Kapazitätsressource dar.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.administration	DedicatedCapacityAdministrators	Eine Sammlung dedizierter Kapazitätsadministratoren
properties.friendlyName	string	Name der Kapazität
properties.mode	Mode	Gibt die Generierung der Power BI Embedded-Kapazität an. Wenn kein Wert angegeben ist, wird der Standardwert "Gen2" verwendet. Weitere Informationen
properties.provisioningState	CapacityProvisioningState	Der aktuelle Bereitstellungsstatus der dedizierten PowerBI-Ressource. Der provisioningState ist das Angeben von Status für die Ressourcenbereitstellung.
properties.state	State	Der aktuelle Status der dedizierten PowerBI-Ressource. Der Zustand besteht darin, weitere Zustände außerhalb der Ressourcenbereitstellung anzugeben.
properties.tenantId	string	Mandanten-ID für die Kapazität. Wird zum Erstellen der Pro Plus-Kapazität verwendet.
sku	CapacitySku	Die SKU der dedizierten PowerBI-Kapazitätsressource.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

DedicatedCapacityAdministrators

Objekt

Ein Array von Administratorbenutzeridentitäten

Name	Typ	Beschreibung
members	string[]	Ein Array von Administratorbenutzeridentitäten.

DedicatedCapacityUpdateParameters

Objekt

Spezifikation der Bereitstellungsanforderung

Name	Typ	Beschreibung
properties.administration	DedicatedCapacityAdministrators	Eine Sammlung dedizierter Kapazitätsadministratoren
properties.friendlyName	string	Name der Kapazität
properties.mode	Mode	Gibt die Generierung der Power BI Embedded-Kapazität an. Wenn kein Wert angegeben ist, wird der Standardwert "Gen2" verwendet. Weitere Informationen
properties.tenantId	string	Mandanten-ID für die Kapazität. Wird zum Erstellen der Pro Plus-Kapazität verwendet.
sku	CapacitySku	Die SKU der dedizierten Kapazitätsressource.
tags	object	Schlüsselwertpaare zusätzlicher Bereitstellungseigenschaften.

Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Objekt

Das Fehlerobjekt

Name	Typ	Beschreibung
error	Error	Das Fehlerobjekt.

Mode

Enumeration

Gibt die Generierung der Power BI Embedded-Kapazität an. Wenn kein Wert angegeben ist, wird der Standardwert "Gen2" verwendet. Weitere Informationen

Wert	Beschreibung
Gen1
Gen2

State

Enumeration

Der aktuelle Status der dedizierten PowerBI-Ressource. Der Zustand besteht darin, weitere Zustände außerhalb der Ressourcenbereitstellung anzugeben.

Wert	Beschreibung
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

Capacities - Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Update capacity parameters

Beispielanforderung

Beispiel für eine Antwort

Update capacity to Generation 2

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CapacityProvisioningState

CapacitySku

CapacitySkuTier

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

Mode

State

systemData