Freigeben über


Capacities - Update

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

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

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

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

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