你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Capacities - Update

更新指定专用容量的当前状态。

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

URI 参数

Name In Required Type Description
dedicatedCapacityName
path True
  • string

专用容量的名称。 长度必须至少为 3 个字符,且长度不能超过 63 个字符。

Regex pattern: ^[a-z][a-z0-9]*$

resourceGroupName
path True
  • string

给定 PowerBIDedicated 容量属于的 Azure 资源组的名称。 此名称的长度必须至少为 1 个字符,且不超过 90 个字符。

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

订阅的唯一Microsoft Azure标识符。 此订阅 ID 是每个服务调用的 URI 的一部分。

api-version
query True
  • string

客户端 API 版本。

请求正文

Name Type Description
properties.administration

专用容量管理员的集合

properties.mode

指定生成Power BI Embedded容量。 如果未指定值,则使用默认值"Gen2"。 了解详细信息

sku

专用容量资源的 SKU。

tags
  • object

其他预配属性的键值对。

响应

Name Type Description
200 OK

“确定”

202 Accepted

已接受

Other Status Codes

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

Update capacity parameters
Update capacity to Generation 2

Update capacity parameters

Sample Request

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

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

Sample Request

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

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

表示 PowerBI 专用容量资源的 SKU 名称和 Azure 定价层。

CapacitySkuTier

SKU 应用到的 Azure 定价层的名称。

DedicatedCapacity

表示专用容量资源的实例。

DedicatedCapacityAdministrators

管理员用户标识数组

DedicatedCapacityUpdateParameters

预配请求规范

Error

错误对象

ErrorResponse

描述错误响应的格式。

IdentityType

创建/修改资源的标识类型。

Mode

指定生成Power BI Embedded容量。 如果未指定值,则使用默认值"Gen2"。 了解详细信息

State

PowerBI 专用资源的当前状态。 状态是指示资源预配之外的更多状态。

SystemData

与资源的创建和上次修改相关的元数据。

CapacityProvisioningState

PowerBI 专用资源的当前部署状态。 provisioningState 用于指示资源预配状态。

Name Type Description
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

表示 PowerBI 专用容量资源的 SKU 名称和 Azure 定价层。

Name Type Description
capacity
  • integer

SKU 的容量。

name
  • string

SKU 级别的名称。

tier

SKU 应用到的 Azure 定价层的名称。

CapacitySkuTier

SKU 应用到的 Azure 定价层的名称。

Name Type Description
AutoPremiumHost
  • string
PBIE_Azure
  • string
Premium
  • string

DedicatedCapacity

表示专用容量资源的实例。

Name Type Description
id
  • string

表示 PowerBI 专用资源的标识符。

location
  • string

PowerBI 专用资源的位置。

name
  • string

PowerBI 专用资源的名称。

properties.administration

专用容量管理员的集合

properties.friendlyName
  • string

容量名称

properties.mode

指定生成Power BI Embedded容量。 如果未指定值,则使用默认值"Gen2"。 了解详细信息

properties.provisioningState

PowerBI 专用资源的当前部署状态。 provisioningState 用于指示资源预配状态。

properties.state

PowerBI 专用资源的当前状态。 状态是指示资源预配之外的更多状态。

properties.tenantId
  • string

容量的租户 ID。 用于创建 Pro Plus 容量。

sku

PowerBI 专用容量资源的 SKU。

systemData

与资源的创建和上次修改相关的元数据。

tags
  • object

附加资源预配属性的键值对。

type
  • string

PowerBI 专用资源的类型。

DedicatedCapacityAdministrators

管理员用户标识数组

Name Type Description
members
  • string[]

管理员用户标识的数组。

DedicatedCapacityUpdateParameters

预配请求规范

Name Type Description
properties.administration

专用容量管理员的集合

properties.friendlyName
  • string

容量名称

properties.mode

指定生成Power BI Embedded容量。 如果未指定值,则使用默认值"Gen2"。 了解详细信息

properties.tenantId
  • string

容量的租户 ID。 用于创建 Pro Plus 容量。

sku

专用容量资源的 SKU。

tags
  • object

其他预配属性的键值对。

Error

错误对象

Name Type Description
code
  • string

错误代码

message
  • string

指示操作失败原因的错误消息。

ErrorResponse

描述错误响应的格式。

Name Type Description
error

错误对象

IdentityType

创建/修改资源的标识类型。

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

Mode

指定生成Power BI Embedded容量。 如果未指定值,则使用默认值"Gen2"。 了解详细信息

Name Type Description
Gen1
  • string
Gen2
  • string

State

PowerBI 专用资源的当前状态。 状态是指示资源预配之外的更多状态。

Name Type Description
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

与资源的创建和上次修改相关的元数据。

Name Type Description
createdAt
  • string

UTC 格式的资源创建 (时间戳)

createdBy
  • string

创建资源的标识的标识符

createdByType

创建资源的标识类型

lastModifiedAt
  • string

上次修改资源的时间时间戳 (UTC)

lastModifiedBy
  • string

上次修改资源的标识的标识符

lastModifiedByType

上次修改资源的标识类型