Compartir a través de


Capacities - Update

Novedades el estado actual de la capacidad dedicada especificada.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
dedicatedCapacityName
path True

string

Nombre de la capacidad dedicada. Debe tener al menos 3 caracteres de longitud y no más de 63.

Patrón de Regex: ^[a-z][a-z0-9]*$

resourceGroupName
path True

string

Nombre del grupo de recursos de Azure del que forma parte una determinada capacidad PowerBIDedicated. Este nombre debe tener al menos 1 carácter de longitud y no más de 90.

Patrón de Regex: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Identificador único de una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.

api-version
query True

string

La versión de la API de cliente.

Cuerpo de la solicitud

Nombre Tipo Description
properties.administration

DedicatedCapacityAdministrators

Colección de administradores de capacidad dedicados

properties.mode

Mode

Especifica la generación de la capacidad de Power BI Embedded. Si no se especifica ningún valor, se usa el valor predeterminado "Gen2". Más información

sku

CapacitySku

SKU del recurso de capacidad dedicado.

tags

object

Pares clave-valor de propiedades de aprovisionamiento adicionales.

Respuestas

Nombre Tipo Description
200 OK

DedicatedCapacity

Aceptar

202 Accepted

DedicatedCapacity

Aceptado

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Update capacity parameters
Update capacity to Generation 2

Update capacity parameters

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
CapacityProvisioningState

Estado de implementación actual del recurso dedicado de PowerBI. ProvisioningState es indicar los estados para el aprovisionamiento de recursos.

CapacitySku

Representa el nombre de la SKU y el plan de tarifa de Azure para el recurso de capacidad dedicada de PowerBI.

CapacitySkuTier

Nombre del plan de tarifa de Azure al que se aplica la SKU.

DedicatedCapacity

Representa una instancia de un recurso de capacidad dedicada.

DedicatedCapacityAdministrators

Matriz de identidades de usuario de administrador

DedicatedCapacityUpdateParameters

Especificación de solicitud de aprovisionamiento

Error

El objeto error

ErrorResponse

Describe el formato de respuesta de error.

IdentityType

Tipo de identidad que creó o modificó el recurso.

Mode

Especifica la generación de la capacidad de Power BI Embedded. Si no se especifica ningún valor, se usa el valor predeterminado "Gen2". Más información

State

Estado actual del recurso dedicado de PowerBI. El estado es indicar más estados fuera del aprovisionamiento de recursos.

SystemData

Metadatos relacionados con la creación y la última modificación del recurso.

CapacityProvisioningState

Estado de implementación actual del recurso dedicado de PowerBI. ProvisioningState es indicar los estados para el aprovisionamiento de recursos.

Nombre Tipo 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

Representa el nombre de la SKU y el plan de tarifa de Azure para el recurso de capacidad dedicada de PowerBI.

Nombre Tipo Description
capacity

integer

Capacidad de la SKU.

name

string

Nombre del nivel de SKU.

tier

CapacitySkuTier

Nombre del plan de tarifa de Azure al que se aplica la SKU.

CapacitySkuTier

Nombre del plan de tarifa de Azure al que se aplica la SKU.

Nombre Tipo Description
AutoPremiumHost

string

PBIE_Azure

string

Premium

string

DedicatedCapacity

Representa una instancia de un recurso de capacidad dedicada.

Nombre Tipo Description
id

string

Identificador que representa el recurso dedicado de PowerBI.

location

string

Ubicación del recurso dedicado de PowerBI.

name

string

Nombre del recurso dedicado de PowerBI.

properties.administration

DedicatedCapacityAdministrators

Colección de administradores de capacidad dedicados

properties.friendlyName

string

Nombre de capacidad

properties.mode

Mode

Especifica la generación de la capacidad de Power BI Embedded. Si no se especifica ningún valor, se usa el valor predeterminado "Gen2". Más información

properties.provisioningState

CapacityProvisioningState

Estado de implementación actual del recurso dedicado de PowerBI. ProvisioningState es indicar los estados para el aprovisionamiento de recursos.

properties.state

State

Estado actual del recurso dedicado de PowerBI. El estado es indicar más estados fuera del aprovisionamiento de recursos.

properties.tenantId

string

Identificador de inquilino para la capacidad. Se usa para crear capacidad Pro Plus.

sku

CapacitySku

SKU del recurso de capacidad dedicada de PowerBI.

systemData

SystemData

Metadatos relacionados con la creación y la última modificación del recurso.

tags

object

Pares clave-valor de propiedades de aprovisionamiento de recursos adicionales.

type

string

Tipo del recurso Dedicado de PowerBI.

DedicatedCapacityAdministrators

Matriz de identidades de usuario de administrador

Nombre Tipo Description
members

string[]

Matriz de identidades de usuario de administrador.

DedicatedCapacityUpdateParameters

Especificación de solicitud de aprovisionamiento

Nombre Tipo Description
properties.administration

DedicatedCapacityAdministrators

Colección de administradores de capacidad dedicados

properties.friendlyName

string

Nombre de capacidad

properties.mode

Mode

Especifica la generación de la capacidad de Power BI Embedded. Si no se especifica ningún valor, se usa el valor predeterminado "Gen2". Más información

properties.tenantId

string

Identificador de inquilino para la capacidad. Se usa para crear capacidad Pro Plus.

sku

CapacitySku

SKU del recurso de capacidad dedicado.

tags

object

Pares clave-valor de propiedades de aprovisionamiento adicionales.

Error

El objeto error

Nombre Tipo Description
code

string

Código de error

message

string

Mensaje de error que indica por qué se produjo un error en la operación.

ErrorResponse

Describe el formato de respuesta de error.

Nombre Tipo Description
error

Error

El objeto error

IdentityType

Tipo de identidad que creó o modificó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

Mode

Especifica la generación de la capacidad de Power BI Embedded. Si no se especifica ningún valor, se usa el valor predeterminado "Gen2". Más información

Nombre Tipo Description
Gen1

string

Gen2

string

State

Estado actual del recurso dedicado de PowerBI. El estado es indicar más estados fuera del aprovisionamiento de recursos.

Nombre Tipo 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

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC)

createdBy

string

Identificador de la identidad que creó el recurso.

createdByType

IdentityType

Tipo de identidad que creó el recurso

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identificador de la identidad que modificó por última vez el recurso.

lastModifiedByType

IdentityType

Tipo de identidad que modificó por última vez el recurso.