Capacities - Update

Referenz

Dienst:: Power BI Embedded

API-Version:: 2021-01-01

Updates 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	Der Name der dedizierten Kapazität. Er muss mindestens 3 Zeichen lang sein und darf nicht mehr als 63 Zeichen lang sein. RegEx-Muster: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	Der Name der Azure-Ressourcengruppe, zu der eine bestimmte PowerBIDedizierte Kapazität gehört. Dieser Name muss mindestens 1 Zeichen lang und nicht mehr als 90 sein. RegEx-Muster: `^[-\w\._]+$`
subscriptionId	path	True	string	Ein eindeutiger Bezeichner für ein Microsoft Azure-Abonnement. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Die Client-API-Version.

Anforderungstext

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

Antworten

Name	Typ	Beschreibung
200 OK	DedicatedCapacity	OK
202 Accepted	DedicatedCapacity	Akzeptiert
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

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

Beispiel für eine Antwort

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

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

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

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

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

Beispiel für eine Antwort

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

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

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

Definitionen

Name	Beschreibung
CapacityProvisioningState	Der aktuelle Bereitstellungsstatus der PowerBI Dedicated-Ressource. ProvisioningState gibt Zustände für die Ressourcenbereitstellung an.
CapacitySku	Stellt den SKU-Namen und den Azure-Tarif für die PowerBI Dedicated-Kapazitätsressource dar.
CapacitySkuTier	Der Name des Azure-Tarifs, für den die SKU gilt.
DedicatedCapacity	Stellt einen instance einer Dedizierten Kapazitätsressource dar.
DedicatedCapacityAdministrators	Ein Array von Administratorbenutzeridentitäten
DedicatedCapacityUpdateParameters	Spezifikation der Bereitstellungsanforderung
Error	Das Fehlerobjekt
ErrorResponse	Beschreibt das Format der Fehlerantwort.
IdentityType	Der Identitätstyp, der die Ressource erstellt/geändert hat.
Mode	Gibt die Generierung der Power BI Embedded Kapazität an. Wenn kein Wert angegeben wird, wird der Standardwert "Gen2" verwendet. Weitere Informationen
State	Der aktuelle Status der PowerBI Dedicated-Ressource. Der Zustand ist, um mehr Zustände außerhalb der Ressourcenbereitstellung anzugeben.
SystemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

CapacityProvisioningState

Der aktuelle Bereitstellungsstatus der PowerBI Dedicated-Ressource. ProvisioningState gibt Zustände für die Ressourcenbereitstellung an.

Name	Typ	Beschreibung
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

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

Name	Typ	Beschreibung
capacity	integer	Die Kapazität der SKU.
name	string	Name der SKU-Ebene.
tier	CapacitySkuTier	Der Name des Azure-Tarifs, für den die SKU gilt.

CapacitySkuTier

Der Name des Azure-Tarifs, für den die SKU gilt.

Name	Typ	Beschreibung
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Stellt einen instance einer Dedizierten Kapazitätsressource dar.

Name	Typ	Beschreibung
id	string	Ein Bezeichner, der die PowerBI Dedicated-Ressource darstellt.
location	string	Speicherort der PowerBI Dedicated-Ressource.
name	string	Der Name der PowerBI Dedicated-Ressource.
properties.administration	DedicatedCapacityAdministrators	Eine Sammlung von Dedizierten Kapazitätsadministratoren
properties.friendlyName	string	Kapazitätsname
properties.mode	Mode	Gibt die Generierung der Power BI Embedded Kapazität an. Wenn kein Wert angegeben wird, wird der Standardwert "Gen2" verwendet. Weitere Informationen
properties.provisioningState	CapacityProvisioningState	Der aktuelle Bereitstellungsstatus der PowerBI Dedicated-Ressource. ProvisioningState gibt Zustände für die Ressourcenbereitstellung an.
properties.state	State	Der aktuelle Status der PowerBI Dedicated-Ressource. Der Zustand ist, um mehr Zustände außerhalb der Ressourcenbereitstellung anzugeben.
properties.tenantId	string	Mandanten-ID für die Kapazität. Wird zum Erstellen von Pro Plus-Kapazität verwendet.
sku	CapacitySku	Die SKU der PowerBI Dedicated-Kapazitätsressource.
systemData	SystemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
tags	object	Schlüssel-Wert-Paare zusätzlicher Ressourcenbereitstellungseigenschaften.
type	string	Der Typ der PowerBI Dedicated-Ressource.

DedicatedCapacityAdministrators

Ein Array von Administratorbenutzeridentitäten

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

DedicatedCapacityUpdateParameters

Spezifikation der Bereitstellungsanforderung

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

Error

Das Fehlerobjekt

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

ErrorResponse

Beschreibt das Format der Fehlerantwort.

Name	Typ	Beschreibung
error	Error	Das Fehlerobjekt

IdentityType

Der Identitätstyp, der die Ressource erstellt/geändert hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

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

Name	Typ	Beschreibung
Gen1	string
Gen2	string

State

Der aktuelle Status der PowerBI Dedicated-Ressource. Der Zustand ist, um mehr Zustände außerhalb der Ressourcenbereitstellung anzugeben.

Name	Typ	Beschreibung
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

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC)
createdBy	string	Ein Bezeichner für die Identität, die die Ressource erstellt hat.
createdByType	IdentityType	Der Identitätstyp, der die Ressource erstellt hat
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Ein Bezeichner für die Identität, die die Ressource zuletzt geändert hat
lastModifiedByType	IdentityType	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

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Zusätzliche Ressourcen