Capacities - Create

Referens

Tjänst:: Power BI Embedded

API-version:: 2021-01-01

Etablerar den angivna dedikerade kapaciteten baserat på den konfiguration som anges i begäran.

PUT 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 måste vara 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	Obligatorisk	Typ	Description
location	True	string	Platsen för den dedikerade PowerBI-resursen.
sku	True	CapacitySku	SKU:n för den dedikerade PowerBI-kapacitetsresursen.
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
systemData		SystemData	Metadata som rör skapande och senaste ändring av resursen.
tags		object	Nyckel/värde-par med ytterligare resursetableringsegenskaper.

Svar

Name	Typ	Description
200 OK	DedicatedCapacity	OK. Åtgärden har slutförts.
201 Created	DedicatedCapacity	InProgress. Åtgärden pågår fortfarande.
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

Create capacity

Exempelbegäran

HTTP

PUT 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"
  },
  "location": "West US",
  "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:: 201

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/servers/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"
  }
}

Definitioner

Name	Description
CapacityProvisioningState	Det aktuella distributionstillståndet för den dedikerade PowerBI-resursen. ProvisioningState är för att ange tillstånd för resursetablering.
CapacitySku	Representerar SKU-namnet och Azure-prisnivån för powerbi-dedikerad kapacitetsresurs.
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 användaridentiteter för administratörer
Error	Felobjektet
ErrorResponse	Beskriver formatet för 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 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

Det aktuella distributionstillståndet för den dedikerade PowerBI-resursen. ProvisioningState är fö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-dedikerad kapacitetsresurs.

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 den dedikerade PowerBI-resursen. ProvisioningState är fö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 resursetableringsegenskaper.
type	string	Typ av dedikerad PowerBI-resurs.

DedicatedCapacityAdministrators

En matris med användaridentiteter för administratörer

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

Error

Felobjektet

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

ErrorResponse

Beskriver formatet för 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 den dedikerade PowerBI-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 identiteten som skapade resursen
createdByType	IdentityType	Den typ 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