Capacities - Update

Ссылка

Служба:: Power BI Embedded

Версия API:: 2021-01-01

Обновляет текущее состояние указанной выделенной емкости.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
dedicatedCapacityName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Имя выделенной емкости. Длина не менее 3 символов и не более 63.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Имя группы ресурсов Azure, в которую входит определенная емкость PowerBIDedicated. Это имя должно быть не менее 1 символа длиной, а не более 90.
subscriptionId	path	True	string	Уникальный идентификатор подписки Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.
api-version	query	True	string	Версия клиентского API.

Текст запроса

Имя	Тип	Описание
properties.administration	DedicatedCapacityAdministrators	Коллекция администраторов выделенной емкости
properties.mode	Mode	Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения
sku	CapacitySku	Номер SKU ресурса выделенной емкости.
tags	object	Пары "ключ-значение" дополнительных свойств подготовки.

Ответы

Имя	Тип	Описание
200 OK	DedicatedCapacity	ХОРОШО
202 Accepted	DedicatedCapacity	Принято
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Образец запроса

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

Пример ответа

Код состояния:: 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"
  }
}

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
  }
}

Код состояния:: 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"
  }
}

Определения

Имя	Описание
CapacityProvisioningState	Текущее состояние развертывания выделенного ресурса PowerBI. Параметр provisioningState — это указание состояний для подготовки ресурсов.
CapacitySku	Представляет имя SKU и ценовую категорию Azure для ресурса выделенной емкости PowerBI.
CapacitySkuTier	Имя ценовой категории Azure, к которой применяется номер SKU.
DedicatedCapacity	Представляет экземпляр ресурса выделенной емкости.
DedicatedCapacityAdministrators	Массив удостоверений пользователей администратора
DedicatedCapacityUpdateParameters	Спецификация запроса подготовки
Error	Объект ошибки
ErrorResponse	Описывает формат ответа на ошибку.
IdentityType	Тип удостоверения, создавшего или изменившего ресурс.
Mode	Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения
State	Текущее состояние выделенного ресурса PowerBI. Состояние заключается в том, чтобы указать больше состояний за пределами подготовки ресурсов.
SystemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

CapacityProvisioningState

Перечисление

Текущее состояние развертывания выделенного ресурса PowerBI. Параметр provisioningState — это указание состояний для подготовки ресурсов.

Значение	Описание
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

CapacitySku

Object

Представляет имя SKU и ценовую категорию Azure для ресурса выделенной емкости PowerBI.

Имя	Тип	Описание
capacity	integer (int32)	Емкость номера SKU.
name	string	Имя уровня SKU.
tier	CapacitySkuTier	Имя ценовой категории Azure, к которой применяется номер SKU.

CapacitySkuTier

Перечисление

Имя ценовой категории Azure, к которой применяется номер SKU.

Значение	Описание
AutoPremiumHost
PBIE_Azure
Premium

DedicatedCapacity

Object

Представляет экземпляр ресурса выделенной емкости.

Имя	Тип	Описание
id	string	Идентификатор, представляющий выделенный ресурс PowerBI.
location	string	Расположение выделенного ресурса PowerBI.
name	string	Имя выделенного ресурса PowerBI.
properties.administration	DedicatedCapacityAdministrators	Коллекция администраторов выделенной емкости
properties.friendlyName	string	Имя емкости
properties.mode	Mode	Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения
properties.provisioningState	CapacityProvisioningState	Текущее состояние развертывания выделенного ресурса PowerBI. Параметр provisioningState — это указание состояний для подготовки ресурсов.
properties.state	State	Текущее состояние выделенного ресурса PowerBI. Состояние заключается в том, чтобы указать больше состояний за пределами подготовки ресурсов.
properties.tenantId	string	Идентификатор клиента для емкости. Используется для создания емкости Pro Plus.
sku	CapacitySku	Номер SKU ресурса выделенной емкости PowerBI.
systemData	SystemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
tags	object	Пары "ключ-значение" дополнительных свойств подготовки ресурсов.
type	string	Тип выделенного ресурса PowerBI.

DedicatedCapacityAdministrators

Object

Массив удостоверений пользователей администратора

Имя	Тип	Описание
members	string[]	Массив удостоверений пользователей администратора.

DedicatedCapacityUpdateParameters

Object

Спецификация запроса подготовки

Имя	Тип	Описание
properties.administration	DedicatedCapacityAdministrators	Коллекция администраторов выделенной емкости
properties.friendlyName	string	Имя емкости
properties.mode	Mode	Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения
properties.tenantId	string	Идентификатор клиента для емкости. Используется для создания емкости Pro Plus.
sku	CapacitySku	Номер SKU ресурса выделенной емкости.
tags	object	Пары "ключ-значение" дополнительных свойств подготовки.

Error

Object

Объект ошибки

Имя	Тип	Описание
code	string	Код ошибки
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ErrorResponse

Object

Описывает формат ответа на ошибку.

Имя	Тип	Описание
error	Error	Объект ошибки

IdentityType

Перечисление

Тип удостоверения, создавшего или изменившего ресурс.

Значение	Описание
Application
Key
ManagedIdentity
User

Mode

Перечисление

Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения

Значение	Описание
Gen1
Gen2

State

Перечисление

Текущее состояние выделенного ресурса PowerBI. Состояние заключается в том, чтобы указать больше состояний за пределами подготовки ресурсов.

Значение	Описание
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

SystemData

Object

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC)
createdBy	string	Идентификатор удостоверения, создавшего ресурс
createdByType	IdentityType	Тип удостоверения, создавшего ресурс
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор удостоверения, который последний раз изменил ресурс
lastModifiedByType	IdentityType	Тип удостоверения, который последний раз изменил ресурс

Поделиться через

Capacities - Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Update capacity parameters

Образец запроса

Пример ответа

Update capacity to Generation 2

Образец запроса

Пример ответа

Определения

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Дополнительные ресурсы