Capacities - Create

Служба:: Power BI Embedded

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

Подготавливает указанную выделенную емкость на основе конфигурации, указанной в запросе.

PUT 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	Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

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

Ответы

Имя	Тип	Описание
200 OK	DedicatedCapacity	Операция обновления ресурса 'DedicatedCapacity' выполнена успешно
201 Created	DedicatedCapacity	Операция по созданию ресурса 'DedicatedCapacity' выполнена успешно Заголовки Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

DedicatedCapacity

Операция обновления ресурса 'DedicatedCapacity' выполнена успешно

201 Created

DedicatedCapacity

Операция по созданию ресурса 'DedicatedCapacity' выполнена успешно

Заголовки

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

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

azure_auth

Поток OAuth2 Azure Active Directory.

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

Области

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

Примеры

Create capacity

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

HTTP

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

{
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "[email protected]",
        "[email protected]"
      ]
    }
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  }
}

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

Код состояния:: 200

{
  "name": "azsdktest",
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "[email protected]",
        "[email protected]"
      ]
    },
    "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"
  }
}

Код состояния:: 201

{
  "name": "azsdktest",
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/servers/azsdktest",
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "[email protected]",
        "[email protected]"
      ]
    },
    "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"
  }
}

Определения

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

CapacityProvisioningState

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

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

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

CapacitySku

Object

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

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

CapacitySkuTier

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

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

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

createdByType

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

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

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

DedicatedCapacity

Object

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

Имя	Тип	Описание
id	string	Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
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	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

DedicatedCapacityAdministrators

Object

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

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

Error

Object

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

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

ErrorResponse

Object

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

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

Mode

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

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

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

State

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

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

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

systemData

Object

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

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

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

Capacities - Create

Параметры URI

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

Ответы

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

azure_auth

Области

Примеры

Create capacity

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

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

Определения

CapacityProvisioningState

CapacitySku

CapacitySkuTier

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

Error

ErrorResponse

Mode

State

systemData