Capacities - Update

Aktualizuje aktuální stav zadané vyhrazené kapacity.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
dedicatedCapacityName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-z][a-z0-9]*$

Název vyhrazené kapacity. Musí mít maximálně 3 znaky a maximálně 63 znaků.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.

subscriptionId
path True

string

minLength: 1

ID cílového předplatného.

api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Typ Description
properties.administration

DedicatedCapacityAdministrators

Kolekce správců vyhrazené kapacity

properties.mode

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

sku

CapacitySku

Skladová položka prostředku vyhrazené kapacity.

tags

object

Páry klíč-hodnota dalších vlastností zřizování.

Odpovědi

Name Typ Description
200 OK

DedicatedCapacity

Operace Azure byla úspěšně dokončena.

202 Accepted

DedicatedCapacity

Žádost byla přijata ke zpracování, ale zpracování ještě nebylo dokončeno.

Hlavičky

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Update capacity parameters
Update capacity to Generation 2

Update capacity parameters

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
CapacityProvisioningState

Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.

CapacitySku

Představuje název skladové položky a cenovou úroveň Azure pro prostředek kapacity PowerBI Dedicated.

CapacitySkuTier

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

createdByType

Typ identity, která prostředek vytvořila.

DedicatedCapacity

Představuje instanci prostředku vyhrazené kapacity.

DedicatedCapacityAdministrators

Pole identit uživatelů správce

DedicatedCapacityUpdateParameters

Specifikace žádosti o zřízení

Error

Objekt chyby.

ErrorResponse

Objekt chyby

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

State

Aktuální stav vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

CapacityProvisioningState

Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.

Hodnota Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

CapacitySku

Představuje název skladové položky a cenovou úroveň Azure pro prostředek kapacity PowerBI Dedicated.

Name Typ Description
capacity

integer (int32)

Kapacita skladové položky.

name

string

Název úrovně skladové položky.

tier

CapacitySkuTier

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

CapacitySkuTier

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

Hodnota Description
PBIE_Azure
Premium
AutoPremiumHost

createdByType

Typ identity, která prostředek vytvořila.

Hodnota Description
User
Application
ManagedIdentity
Key

DedicatedCapacity

Představuje instanci prostředku vyhrazené kapacity.

Name Typ Description
id

string

Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Geografické umístění, ve kterém se nachází zdroj

name

string

Název prostředku

properties.administration

DedicatedCapacityAdministrators

Kolekce správců vyhrazené kapacity

properties.friendlyName

string

Název kapacity

properties.mode

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

properties.provisioningState

CapacityProvisioningState

Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.

properties.state

State

Aktuální stav vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků.

properties.tenantId

string

ID tenanta pro kapacitu Používá se k vytváření kapacity Pro Plus.

sku

CapacitySku

Skladová položka prostředku kapacity PowerBI Dedicated.

systemData

systemData

Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.

tags

object

Značky prostředků

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

DedicatedCapacityAdministrators

Pole identit uživatelů správce

Name Typ Description
members

string[]

Pole identit uživatelů správce.

DedicatedCapacityUpdateParameters

Specifikace žádosti o zřízení

Name Typ Description
properties.administration

DedicatedCapacityAdministrators

Kolekce správců vyhrazené kapacity

properties.friendlyName

string

Název kapacity

properties.mode

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

properties.tenantId

string

ID tenanta pro kapacitu Používá se k vytváření kapacity Pro Plus.

sku

CapacitySku

Skladová položka prostředku vyhrazené kapacity.

tags

object

Páry klíč-hodnota dalších vlastností zřizování.

Error

Objekt chyby.

Name Typ Description
code

string

Kód chyby

message

string

Chybová zpráva označující, proč operace selhala.

ErrorResponse

Objekt chyby

Name Typ Description
error

Error

Objekt chyby.

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

Hodnota Description
Gen1
Gen2

State

Aktuální stav vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků.

Hodnota Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string (date-time)

Časové razítko vytvoření prostředku (UTC).

createdBy

string

Identita, která prostředek vytvořila.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string (date-time)

Časové razítko poslední změny zdroje (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.