Capacities - Update

Odwołanie

Service:: Power BI Embedded

API Version:: 2021-01-01

Aktualizacje bieżący stan określonej pojemności dedykowanej.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dedicatedCapacityName	path	True	string	Nazwa pojemności dedykowanej. Musi mieć długość co najmniej 3 znaków i nie więcej niż 63. Regex pattern: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	Nazwa grupy zasobów platformy Azure, której częścią jest dana pojemność powerBIDedicated. Ta nazwa musi mieć długość co najmniej 1 znaków i nie więcej niż 90 znaków. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Typ	Opis
properties.administration	DedicatedCapacityAdministrators	Kolekcja administratorów pojemności dedykowanej
properties.mode	Mode	Określa generację pojemności Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Więcej informacji
sku	CapacitySku	Jednostka SKU zasobu pojemności dedykowanej.
tags	object	Pary klucz-wartość dodatkowych właściwości aprowizacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DedicatedCapacity	OK
202 Accepted	DedicatedCapacity	Zaakceptowano
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Sample Request

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

Sample Response

Status code:: 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"
  }
}

Status code:: 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

Response Body

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

Sample Request

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

Sample Response

Status code:: 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"
  }
}

Status code:: 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

Response Body

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

Definicje

Nazwa	Opis
CapacityProvisioningState	Bieżący stan wdrożenia dedykowanego zasobu usługi Power BI. Stan provisioningState wskazuje stany aprowizacji zasobów.
CapacitySku	Reprezentuje nazwę jednostki SKU i warstwę cenową platformy Azure dla zasobu pojemności dedykowanej usługi Power BI.
CapacitySkuTier	Nazwa warstwy cenowej platformy Azure, do której ma zastosowanie jednostka SKU.
DedicatedCapacity	Reprezentuje wystąpienie zasobu pojemności dedykowanej.
DedicatedCapacityAdministrators	Tablica tożsamości użytkowników administratora
DedicatedCapacityUpdateParameters	Specyfikacja żądania aprowizacji
Error	Obiekt error
ErrorResponse	Opisuje format odpowiedzi Błąd.
IdentityType	Typ tożsamości, która utworzyła/zmodyfikowała zasób.
Mode	Określa generację pojemności Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Więcej informacji
State	Bieżący stan dedykowanego zasobu usługi Power BI. Stan to wskazanie większej liczby stanów poza aprowizowaniem zasobów.
SystemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

CapacityProvisioningState

Bieżący stan wdrożenia dedykowanego zasobu usługi Power BI. Stan provisioningState wskazuje stany aprowizacji zasobów.

Nazwa	Typ	Opis
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

Reprezentuje nazwę jednostki SKU i warstwę cenową platformy Azure dla zasobu pojemności dedykowanej usługi Power BI.

Nazwa	Typ	Opis
capacity	integer	Pojemność jednostki SKU.
name	string	Nazwa poziomu jednostki SKU.
tier	CapacitySkuTier	Nazwa warstwy cenowej platformy Azure, do której ma zastosowanie jednostka SKU.

CapacitySkuTier

Nazwa warstwy cenowej platformy Azure, do której ma zastosowanie jednostka SKU.

Nazwa	Typ	Opis
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Reprezentuje wystąpienie zasobu pojemności dedykowanej.

Nazwa	Typ	Opis
id	string	Identyfikator reprezentujący zasób usługi PowerBI Dedicated.
location	string	Lokalizacja dedykowanego zasobu usługi Power BI.
name	string	Nazwa dedykowanego zasobu usługi PowerBI.
properties.administration	DedicatedCapacityAdministrators	Kolekcja administratorów pojemności dedykowanej
properties.friendlyName	string	Nazwa pojemności
properties.mode	Mode	Określa generację pojemności Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Więcej informacji
properties.provisioningState	CapacityProvisioningState	Bieżący stan wdrożenia dedykowanego zasobu usługi Power BI. Stan provisioningState wskazuje stany aprowizacji zasobów.
properties.state	State	Bieżący stan dedykowanego zasobu usługi Power BI. Stan to wskazanie większej liczby stanów poza aprowizowaniem zasobów.
properties.tenantId	string	Identyfikator dzierżawy dla pojemności. Służy do tworzenia pojemności Pro Plus.
sku	CapacitySku	Jednostka SKU zasobu pojemności dedykowanej usługi Power BI.
systemData	SystemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
tags	object	Pary klucz-wartość dodatkowych właściwości aprowizacji zasobów.
type	string	Typ dedykowanego zasobu usługi PowerBI.

DedicatedCapacityAdministrators

Tablica tożsamości użytkowników administratora

Nazwa	Typ	Opis
members	string[]	Tablica tożsamości użytkowników administratora.

DedicatedCapacityUpdateParameters

Specyfikacja żądania aprowizacji

Nazwa	Typ	Opis
properties.administration	DedicatedCapacityAdministrators	Kolekcja administratorów pojemności dedykowanej
properties.friendlyName	string	Nazwa pojemności
properties.mode	Mode	Określa generację pojemności Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Więcej informacji
properties.tenantId	string	Identyfikator dzierżawy dla pojemności. Służy do tworzenia pojemności Pro Plus.
sku	CapacitySku	Jednostka SKU zasobu pojemności dedykowanej.
tags	object	Pary klucz-wartość dodatkowych właściwości aprowizacji.

Error

Obiekt error

Nazwa	Typ	Opis
code	string	Kod błędu
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ErrorResponse

Opisuje format odpowiedzi Błąd.

Nazwa	Typ	Opis
error	Error	Obiekt error

IdentityType

Typ tożsamości, która utworzyła/zmodyfikowała zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Określa generację pojemności Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Więcej informacji

Nazwa	Typ	Opis
Gen1	string
Gen2	string

State

Bieżący stan dedykowanego zasobu usługi Power BI. Stan to wskazanie większej liczby stanów poza aprowizowaniem zasobów.

Nazwa	Typ	Opis
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

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC)
createdBy	string	Identyfikator tożsamości, która utworzyła zasób
createdByType	IdentityType	Typ tożsamości, która utworzyła zasób
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Identyfikator tożsamości, która ostatnio zmodyfikowała zasób
lastModifiedByType	IdentityType	Typ tożsamości, która ostatnio zmodyfikowała zasób

Capacities - Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Scopes

Przykłady

Update capacity parameters

Sample Request

Sample Response

Update capacity to Generation 2

Sample Request

Sample Response

Definicje

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Dodatkowe zasoby