Capacities - Update

Usługa:: Power BI Embedded

Wersja interfejsu API:: 2021-01-01

Aktualizuje 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 minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Nazwa pojemności dedykowanej. Musi to być co najmniej 3 znaki i maksymalnie 63.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string minLength: 1	Identyfikator subskrypcji docelowej.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
properties.administration	DedicatedCapacityAdministrators	Kolekcja administratorów pojemności dedykowanej
properties.mode	Mode	Określa generację pojemności usługi Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Dowiedz się więcej
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	Operacja platformy Azure została ukończona pomyślnie.
202 Accepted	DedicatedCapacity	Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone. Nagłówki Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Nazwa

Typ

Opis

200 OK

DedicatedCapacity

Operacja platformy Azure została ukończona pomyślnie.

202 Accepted

DedicatedCapacity

Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.

Nagłówki

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Przykładowe żądanie

HTTP

PATCH https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest?api-version=2021-01-01

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

Przykładowa odpowiedź

Kod stanu:: 200

{
  "name": "azsdktest",
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "systemData": {
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "createdBy": "user1",
    "createdByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Kod stanu:: 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

{
  "name": "azsdktest",
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "systemData": {
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "createdBy": "user1",
    "createdByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Update capacity to Generation 2

Przykładowe żądanie

HTTP

PATCH https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest?api-version=2021-01-01

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

Przykładowa odpowiedź

Kod stanu:: 200

{
  "name": "azsdktest",
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "mode": "Gen2",
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "systemData": {
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "createdBy": "user1",
    "createdByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Kod stanu:: 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

{
  "name": "azsdktest",
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "mode": "Gen2",
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "systemData": {
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "createdBy": "user1",
    "createdByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Definicje

Nazwa	Opis
CapacityProvisioningState	Bieżący stan wdrożenia dedykowanego zasobu usługi PowerBI. 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.
createdByType	Typ tożsamości, która utworzyła zasób.
DedicatedCapacity	Reprezentuje wystąpienie zasobu pojemności dedykowanej.
DedicatedCapacityAdministrators	Tablica tożsamości użytkowników administratora
DedicatedCapacityUpdateParameters	Specyfikacja żądania aprowizacji
Error	Obiekt błędu.
ErrorResponse	Obiekt error
Mode	Określa generację pojemności usługi Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Dowiedz się więcej
State	Bieżący stan dedykowanego zasobu usługi PowerBI. Stanem jest wskazanie większej liczby stanów poza aprowizowaniem zasobów.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

CapacityProvisioningState

Wyliczanie

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

Wartość	Opis
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

CapacitySku

Objekt

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

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

CapacitySkuTier

Wyliczanie

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

Wartość	Opis
PBIE_Azure
Premium
AutoPremiumHost

createdByType

Wyliczanie

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

Wartość	Opis
User
Application
ManagedIdentity
Key

DedicatedCapacity

Objekt

Reprezentuje wystąpienie zasobu pojemności dedykowanej.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.administration	DedicatedCapacityAdministrators	Kolekcja administratorów pojemności dedykowanej
properties.friendlyName	string	Nazwa pojemności
properties.mode	Mode	Określa generację pojemności usługi Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Dowiedz się więcej
properties.provisioningState	CapacityProvisioningState	Bieżący stan wdrożenia dedykowanego zasobu usługi PowerBI. Stan provisioningState wskazuje stany aprowizacji zasobów.
properties.state	State	Bieżący stan dedykowanego zasobu usługi PowerBI. Stanem jest 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 PowerBI.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

DedicatedCapacityAdministrators

Objekt

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

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

DedicatedCapacityUpdateParameters

Objekt

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 usługi Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Dowiedz się więcej
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

Objekt

Obiekt błędu.

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

ErrorResponse

Objekt

Obiekt error

Nazwa	Typ	Opis
error	Error	Obiekt błędu.

Mode

Wyliczanie

Określa generację pojemności usługi Power BI Embedded. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna "Gen2". Dowiedz się więcej

Wartość	Opis
Gen1
Gen2

State

Wyliczanie

Bieżący stan dedykowanego zasobu usługi PowerBI. Stanem jest wskazanie większej liczby stanów poza aprowizowaniem zasobów.

Wartość	Opis
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij przez

Capacities - Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Update capacity parameters

Przykładowe żądanie

Przykładowa odpowiedź

Update capacity to Generation 2

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

CapacityProvisioningState

CapacitySku

CapacitySkuTier

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

Mode

State

systemData