Capacities - Update

Referencia

Szolgáltatás:: Power BI Embedded

API-verzió:: 2021-01-01

Frissítések a megadott dedikált kapacitás aktuális állapotát.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
dedicatedCapacityName	path	True	string	A dedikált kapacitás neve. Legalább 3 karakter hosszúságúnak kell lennie, és legfeljebb 63 karakter hosszúságúnak kell lennie. Reguláris kifejezési minta: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	Annak az Azure-erőforráscsoportnak a neve, amelynek egy adott PowerBIDedikált kapacitás része. Ennek a névnek legalább 1 karakter hosszúságúnak és legfeljebb 90 karakternek kell lennie. Reguláris kifejezési minta: `^[-\w\._]+$`
subscriptionId	path	True	string	Egy Microsoft Azure-előfizetés egyedi azonosítója. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz.
api-version	query	True	string	Az ügyfél API-verziója.

Kérelem törzse

Name	Típus	Description
properties.administration	DedicatedCapacityAdministrators	Dedikált kapacitásgazdák gyűjteménye
properties.mode	Mode	A Power BI Embedded kapacitás generációját adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ
sku	CapacitySku	A dedikált kapacitás erőforrásának termékváltozata.
tags	object	Kulcs-érték párok további kiépítési tulajdonságokhoz.

Válaszok

Name	Típus	Description
200 OK	DedicatedCapacity	OK
202 Accepted	DedicatedCapacity	Elfogadva
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
  }
}

Állapotkód:: 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

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
  }
}

Állapotkód:: 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"
  }
}

Definíciók

Name	Description
CapacityProvisioningState	A dedikált PowerBI-erőforrás aktuális üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotát jelzi.
CapacitySku	A dedikált PowerBI-kapacitás erőforrás termékváltozatának nevét és Azure-tarifacsomagját jelöli.
CapacitySkuTier	Annak az Azure-tarifacsomagnak a neve, amelyre a termékváltozat vonatkozik.
DedicatedCapacity	Egy dedikált kapacitású erőforrás egy példányát jelöli.
DedicatedCapacityAdministrators	Rendszergazdai felhasználói identitások tömbje
DedicatedCapacityUpdateParameters	Kiépítési kérelem specifikációja
Error	A hibaobjektum
ErrorResponse	A hibaválasz formátumát ismerteti.
IdentityType	Az erőforrást létrehozó/módosító identitás típusa.
Mode	A Power BI Embedded kapacitás generációját adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ
State	A dedikált PowerBI-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez.
SystemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

CapacityProvisioningState

A dedikált PowerBI-erőforrás aktuális üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotát jelzi.

Name	Típus	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

A dedikált PowerBI-kapacitás erőforrás termékváltozatának nevét és Azure-tarifacsomagját jelöli.

Name	Típus	Description
capacity	integer	A termékváltozat kapacitása.
name	string	A termékváltozat-szint neve.
tier	CapacitySkuTier	Annak az Azure-tarifacsomagnak a neve, amelyre a termékváltozat vonatkozik.

CapacitySkuTier

Annak az Azure-tarifacsomagnak a neve, amelyre a termékváltozat vonatkozik.

Name	Típus	Description
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Egy dedikált kapacitású erőforrás egy példányát jelöli.

Name	Típus	Description
id	string	A dedikált PowerBI-erőforrást jelképező azonosító.
location	string	A dedikált PowerBI-erőforrás helye.
name	string	A dedikált PowerBI-erőforrás neve.
properties.administration	DedicatedCapacityAdministrators	Dedikált kapacitásgazdák gyűjteménye
properties.friendlyName	string	Kapacitás neve
properties.mode	Mode	A Power BI Embedded kapacitás generációját adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ
properties.provisioningState	CapacityProvisioningState	A dedikált PowerBI-erőforrás aktuális üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotát jelzi.
properties.state	State	A dedikált PowerBI-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez.
properties.tenantId	string	A kapacitás bérlőazonosítója. Pro Plus-kapacitás létrehozásához használatos.
sku	CapacitySku	A Dedikált PowerBI-kapacitás erőforrás termékváltozata.
systemData	SystemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
tags	object	Kulcs-érték párok további erőforrás-kiépítési tulajdonságokhoz.
type	string	A dedikált PowerBI-erőforrás típusa.

DedicatedCapacityAdministrators

Rendszergazdai felhasználói identitások tömbje

Name	Típus	Description
members	string[]	Rendszergazdai felhasználói identitások tömbje.

DedicatedCapacityUpdateParameters

Kiépítési kérelem specifikációja

Name	Típus	Description
properties.administration	DedicatedCapacityAdministrators	Dedikált kapacitásgazdák gyűjteménye
properties.friendlyName	string	Kapacitás neve
properties.mode	Mode	A Power BI Embedded kapacitás generációját adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ
properties.tenantId	string	A kapacitás bérlőazonosítója. Pro Plus-kapacitás létrehozásához használatos.
sku	CapacitySku	A dedikált kapacitás erőforrásának termékváltozata.
tags	object	Kulcs-érték párok további kiépítési tulajdonságokhoz.

Error

A hibaobjektum

Name	Típus	Description
code	string	Hibakód
message	string	Hibaüzenet, amely jelzi, hogy a művelet miért hiúsult meg.

ErrorResponse

A hibaválasz formátumát ismerteti.

Name	Típus	Description
error	Error	A hibaobjektum

IdentityType

Az erőforrást létrehozó/módosító identitás típusa.

Name	Típus	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

A Power BI Embedded kapacitás generációját adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ

Name	Típus	Description
Gen1	string
Gen2	string

State

A dedikált PowerBI-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez.

Name	Típus	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

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string	Az erőforrás-létrehozás időbélyege (UTC)
createdBy	string	Az erőforrást létrehozó identitás azonosítója
createdByType	IdentityType	Az erőforrást létrehozó identitás típusa
lastModifiedAt	string	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást utoljára módosító identitás azonosítója
lastModifiedByType	IdentityType	Az erőforrást legutóbb módosító identitás típusa

Megosztás a következőn keresztül:

Capacities - Update

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Update capacity parameters

Mintakérelem

Mintaválasz

Update capacity to Generation 2

Mintakérelem

Mintaválasz

Definíciók

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

További források