Capacities - Update

Referencia

Service:: Power BI Embedded

API Version:: 2021-01-01

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. Regex pattern: `^[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. Regex pattern: `^[-\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

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Sample Request

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

Sample Response

Status code:: 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"
  }
}

Status code:: 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

Response Body

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

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

Sample Response

Status code:: 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"
  }
}

Status code:: 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

Response Body

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

Capacities - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Scopes

Ejemplos

Update capacity parameters

Sample Request

Sample Response

Update capacity to Generation 2

Sample Request

Sample Response

Definiciones

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Recursos adicionales