Capacities - Update
Обновляет текущее состояние указанной выделенной емкости.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
dedicated
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-z][a-z0-9]*$ |
Имя выделенной емкости. Оно должно быть не менее 3 символов и не более 63. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя не зависит от регистра. |
|
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Текст запроса
| Имя | Тип | Описание |
|---|---|---|
| properties.administration |
Коллекция администраторов выделенной емкости |
|
| properties.mode |
Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения |
|
| sku |
Номер SKU ресурса выделенной емкости. |
|
| tags |
object |
Пары "ключ-значение" дополнительных свойств подготовки. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция Azure успешно завершена. |
|
| 202 Accepted |
Запрос был принят для обработки, но обработка еще не завершена. Заголовки
|
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
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
Образец запроса
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"
}
}
Пример ответа
{
"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"
}
}
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
Образец запроса
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"
}
}
Пример ответа
{
"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"
}
}
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"
}
}
Определения
| Имя | Описание |
|---|---|
|
Capacity |
Текущее состояние развертывания выделенного ресурса PowerBI. Параметр provisioningState — это указание состояний для подготовки ресурсов. |
|
Capacity |
Представляет имя SKU и ценовую категорию Azure для ресурса выделенной емкости PowerBI. |
|
Capacity |
Имя ценовой категории Azure, к которой применяется номер SKU. |
|
created |
Тип удостоверения, создавшего ресурс. |
|
Dedicated |
Представляет экземпляр ресурса выделенной емкости. |
|
Dedicated |
Массив удостоверений пользователей администратора |
|
Dedicated |
Спецификация запроса подготовки |
| Error |
Объект ошибки. |
|
Error |
Объект ошибки |
| Mode |
Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения |
| State |
Текущее состояние выделенного ресурса PowerBI. Состояние заключается в том, чтобы указать больше состояний за пределами подготовки ресурсов. |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
CapacityProvisioningState
Текущее состояние развертывания выделенного ресурса PowerBI. Параметр provisioningState — это указание состояний для подготовки ресурсов.
| Значение | Описание |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
CapacitySku
Представляет имя SKU и ценовую категорию Azure для ресурса выделенной емкости PowerBI.
| Имя | Тип | Описание |
|---|---|---|
| capacity |
integer (int32) |
Емкость номера SKU. |
| name |
string |
Имя уровня SKU. |
| tier |
Имя ценовой категории Azure, к которой применяется номер SKU. |
CapacitySkuTier
Имя ценовой категории Azure, к которой применяется номер SKU.
| Значение | Описание |
|---|---|
| PBIE_Azure | |
| Premium | |
| AutoPremiumHost |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DedicatedCapacity
Представляет экземпляр ресурса выделенной емкости.
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Географическое расположение, в котором находится ресурс |
| name |
string |
Имя ресурса |
| properties.administration |
Коллекция администраторов выделенной емкости |
|
| properties.friendlyName |
string |
Имя емкости |
| properties.mode |
Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения |
|
| properties.provisioningState |
Текущее состояние развертывания выделенного ресурса PowerBI. Параметр provisioningState — это указание состояний для подготовки ресурсов. |
|
| properties.state |
Текущее состояние выделенного ресурса PowerBI. Состояние заключается в том, чтобы указать больше состояний за пределами подготовки ресурсов. |
|
| properties.tenantId |
string |
Идентификатор клиента для емкости. Используется для создания емкости Pro Plus. |
| sku |
Номер SKU ресурса выделенной емкости PowerBI. |
|
| systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
| tags |
object |
Теги ресурсов. |
| type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
DedicatedCapacityAdministrators
Массив удостоверений пользователей администратора
| Имя | Тип | Описание |
|---|---|---|
| members |
string[] |
Массив удостоверений пользователей администратора. |
DedicatedCapacityUpdateParameters
Спецификация запроса подготовки
| Имя | Тип | Описание |
|---|---|---|
| properties.administration |
Коллекция администраторов выделенной емкости |
|
| properties.friendlyName |
string |
Имя емкости |
| properties.mode |
Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения |
|
| properties.tenantId |
string |
Идентификатор клиента для емкости. Используется для создания емкости Pro Plus. |
| sku |
Номер SKU ресурса выделенной емкости. |
|
| tags |
object |
Пары "ключ-значение" дополнительных свойств подготовки. |
Error
Объект ошибки.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки |
| message |
string |
Сообщение об ошибке, указывающее, почему операция завершилась ошибкой. |
ErrorResponse
Объект ошибки
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
Mode
Указывает создание емкости Power BI Embedded. Если значение не указано, используется значение по умолчанию "2-го поколения". дополнительные сведения
| Значение | Описание |
|---|---|
| Gen1 | |
| Gen2 |
State
Текущее состояние выделенного ресурса PowerBI. Состояние заключается в том, чтобы указать больше состояний за пределами подготовки ресурсов.
| Значение | Описание |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Удостоверение, создающее ресурс. |
| createdByType |
Тип удостоверения, создавшего ресурс. |
|
| lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |