Capacities - Update

Referens

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 långt och högst 63 tecken.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Namnet på den Azure-resursgrupp som en viss PowerBIDedicated-kapacitet ingår i. Det här namnet måste vara minst 1 tecken långt och högst 90.
subscriptionId	path	True	string	En unik identifierare för en Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Klient-API-versionen.

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	OK
202 Accepted	DedicatedCapacity	Har godkänts
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

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

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

Exempelsvar

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

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

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

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

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

Exempelsvar

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

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

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

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.
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	Beskriver formatet för Felsvar.
IdentityType	Den typ av identitet som skapade/ändrade resursen.
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
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

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
AutoPremiumHost
PBIE_Azure
Premium

DedicatedCapacity

Objekt

Representerar en instans av en dedikerad kapacitetsresurs.

Name	Typ	Description
id	string	En identifierare som representerar den dedikerade PowerBI-resursen.
location	string	Plats för den dedikerade PowerBI-resursen.
name	string	Namnet på den dedikerade PowerBI-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	Metadata som rör skapande och senaste ändring av resursen.
tags	object	Nyckel/värde-par med ytterligare egenskaper för resursetablering.
type	string	Typen av den dedikerade PowerBI-resursen.

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

Beskriver formatet för Felsvar.

Name	Typ	Description
error	Error	Felobjektet

IdentityType

Uppräkning

Den typ av identitet som skapade/ändrade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

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
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

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	En identifierare för den identitet som skapade resursen
createdByType	IdentityType	Den typ av identitet som skapade resursen
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	En identifierare för den identitet som senast ändrade resursen
lastModifiedByType	IdentityType	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

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Ytterligare resurser