Capacities - Update

Referens

Tjänst:: Power BI Embedded

API-version:: 2021-01-01

Uppdateringar 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	Namnet på den dedikerade kapaciteten. Det får innehålla minst 3 tecken och högst 63 tecken. Reguljärt uttrycksmönster: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	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. Reguljärt uttrycksmönster: `^[-\w\._]+$`
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 kapacitet. 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 PowerBI Dedicated-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 felsvar.
IdentityType	Den typ av identitet som skapade/ändrade resursen.
Mode	Anger genereringen av Power BI Embedded kapacitet. Om inget värde anges används standardvärdet "Gen2". Läs mer
State	Det aktuella tillståndet för PowerBI Dedicated-resursen. Tillståndet är att ange fler tillstånd utanför resursetablering.
SystemData	Metadata som rör skapande och senaste ändring av resursen.

CapacityProvisioningState

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

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

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

Name	Typ	Description
capacity	integer	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

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

Name	Typ	Description
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Representerar en instans av en dedikerad kapacitetsresurs.

Name	Typ	Description
id	string	En identifierare som representerar den dedikerade PowerBI-resursen.
location	string	Platsen 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 kapacitet. Om inget värde anges används standardvärdet "Gen2". Läs mer
properties.provisioningState	CapacityProvisioningState	Det aktuella distributionstillståndet för PowerBI Dedicated-resursen. ProvisioningState är att ange tillstånd för resursetablering.
properties.state	State	Det aktuella tillståndet för PowerBI Dedicated-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 resursetableringsegenskaper.
type	string	Typ av PowerBI Dedicated-resurs.

DedicatedCapacityAdministrators

En matris med administratörsanvändares identiteter

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

DedicatedCapacityUpdateParameters

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 kapacitet. 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

Felobjektet

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

ErrorResponse

Beskriver formatet felsvar.

Name	Typ	Description
error	Error	Felobjektet

IdentityType

Den typ av identitet som skapade/ändrade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

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

Name	Typ	Description
Gen1	string
Gen2	string

State

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

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

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

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC)
createdBy	string	En identifierare för den identitet som skapade resursen
createdByType	IdentityType	Typen av identitet som skapade resursen
lastModifiedAt	string	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