Capacities - Update

Tjänst:: Power BI Embedded

API-version:: 2021-01-01

Uppdaterar det aktuella tillståndet för den angivna dedikerade kapaciteten.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
dedicatedCapacityName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Namnet på den dedikerade kapaciteten. Det måste vara minst 3 tecken och högst 63 tecken.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties.administration	DedicatedCapacityAdministrators	En samling dedikerade kapacitetsadministratörer
properties.mode	Mode	Anger genereringen av Power BI Embedded-kapaciteten. Om inget värde anges används standardvärdet "Gen2". Läs mer
sku	CapacitySku	SKU:n för den dedikerade kapacitetsresursen.
tags	object	Nyckel/värde-par med ytterligare etableringsegenskaper.

Svar

Name	Typ	Description
200 OK	DedicatedCapacity	Azure-åtgärden har slutförts.
202 Accepted	DedicatedCapacity	Begäran har godkänts för bearbetning, men bearbetningen har ännu inte slutförts. Sidhuvuden Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

DedicatedCapacity

Azure-åtgärden har slutförts.

202 Accepted

DedicatedCapacity

Begäran har godkänts för bearbetning, men bearbetningen har ännu inte slutförts.

Sidhuvuden

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Exempelbegäran

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

Exempelsvar

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

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

Exempelbegäran

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

Exempelsvar

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

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

Definitioner

Name	Description
CapacityProvisioningState	Det aktuella distributionstillståndet för den dedikerade PowerBI-resursen. ProvisioningState är att ange tillstånd för resursetablering.
CapacitySku	Representerar SKU-namnet och Azure-prisnivån för PowerBI Dedicated-kapacitetsresursen.
CapacitySkuTier	Namnet på den Azure-prisnivå som SKU:n gäller för.
createdByType	Den typ av identitet som skapade resursen.
DedicatedCapacity	Representerar en instans av en dedikerad kapacitetsresurs.
DedicatedCapacityAdministrators	En matris med administratörsanvändares identiteter
DedicatedCapacityUpdateParameters	Specifikation för etableringsbegäran
Error	Felobjektet.
ErrorResponse	Felobjektet
Mode	Anger genereringen av Power BI Embedded-kapaciteten. Om inget värde anges används standardvärdet "Gen2". Läs mer
State	Det aktuella tillståndet för den dedikerade PowerBI-resursen. Tillståndet är att ange fler tillstånd utanför resursetablering.
systemData	Metadata som rör skapande och senaste ändring av resursen.

CapacityProvisioningState

Uppräkning

Det aktuella distributionstillståndet för den dedikerade PowerBI-resursen. ProvisioningState är att ange tillstånd för resursetablering.

Värde	Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

CapacitySku

Objekt

Representerar SKU-namnet och Azure-prisnivån för PowerBI Dedicated-kapacitetsresursen.

Name	Typ	Description
capacity	integer (int32)	Kapaciteten för SKU:n.
name	string	Namnet på SKU-nivån.
tier	CapacitySkuTier	Namnet på den Azure-prisnivå som SKU:n gäller för.

CapacitySkuTier

Uppräkning

Namnet på den Azure-prisnivå som SKU:n gäller för.

Värde	Description
PBIE_Azure
Premium
AutoPremiumHost

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DedicatedCapacity

Objekt

Representerar en instans av en dedikerad kapacitetsresurs.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.administration	DedicatedCapacityAdministrators	En samling dedikerade kapacitetsadministratörer
properties.friendlyName	string	Kapacitetsnamn
properties.mode	Mode	Anger genereringen av Power BI Embedded-kapaciteten. Om inget värde anges används standardvärdet "Gen2". Läs mer
properties.provisioningState	CapacityProvisioningState	Det aktuella distributionstillståndet för den dedikerade PowerBI-resursen. ProvisioningState är att ange tillstånd för resursetablering.
properties.state	State	Det aktuella tillståndet för den dedikerade PowerBI-resursen. Tillståndet är att ange fler tillstånd utanför resursetablering.
properties.tenantId	string	Klientorganisations-ID för kapaciteten. Används för att skapa Pro Plus-kapacitet.
sku	CapacitySku	SKU:n för den dedikerade PowerBI-kapacitetsresursen.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

DedicatedCapacityAdministrators

Objekt

En matris med administratörsanvändares identiteter

Name	Typ	Description
members	string[]	En matris med administratörsanvändares identiteter.

DedicatedCapacityUpdateParameters

Objekt

Specifikation för etableringsbegäran

Name	Typ	Description
properties.administration	DedicatedCapacityAdministrators	En samling dedikerade kapacitetsadministratörer
properties.friendlyName	string	Kapacitetsnamn
properties.mode	Mode	Anger genereringen av Power BI Embedded-kapaciteten. Om inget värde anges används standardvärdet "Gen2". Läs mer
properties.tenantId	string	Klientorganisations-ID för kapaciteten. Används för att skapa Pro Plus-kapacitet.
sku	CapacitySku	SKU:n för den dedikerade kapacitetsresursen.
tags	object	Nyckel/värde-par med ytterligare etableringsegenskaper.

Error

Objekt

Felobjektet.

Name	Typ	Description
code	string	Felkod
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Objekt

Felobjektet

Name	Typ	Description
error	Error	Felobjektet.

Mode

Uppräkning

Anger genereringen av Power BI Embedded-kapaciteten. Om inget värde anges används standardvärdet "Gen2". Läs mer

Värde	Description
Gen1
Gen2

State

Uppräkning

Det aktuella tillståndet för den dedikerade PowerBI-resursen. Tillståndet är att ange fler tillstånd utanför resursetablering.

Värde	Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via

Capacities - Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Update capacity parameters

Exempelbegäran

Exempelsvar

Update capacity to Generation 2

Exempelbegäran

Exempelsvar

Definitioner

CapacityProvisioningState

CapacitySku

CapacitySkuTier

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

Mode

State

systemData