Capacities - Update

Servicio:: Power BI Embedded

Versión de la API:: 2021-01-01

Actualiza 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 minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Nombre de la capacidad dedicada. Debe tener un mínimo de 3 caracteres y un máximo de 63.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

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	La operación de Azure se completó correctamente.
202 Accepted	DedicatedCapacity	La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado. Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

DedicatedCapacity

La operación de Azure se completó correctamente.

202 Accepted

DedicatedCapacity

La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado.

Encabezados

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de 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	suplantar la cuenta de usuario

Ejemplos

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

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

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

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

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

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

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

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

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.
createdByType	Tipo de identidad que creó el recurso.
DedicatedCapacity	Representa una instancia de un recurso de capacidad dedicada.
DedicatedCapacityAdministrators	Matriz de identidades de usuario administrador
DedicatedCapacityUpdateParameters	Especificación de solicitud de aprovisionamiento
Error	Objeto de error.
ErrorResponse	Objeto de error
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 relativos a la creación y última modificación del recurso.

CapacityProvisioningState

Enumeración

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

Valor	Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

CapacitySku

Object

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 (int32)	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

Enumeración

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

Valor	Description
PBIE_Azure
Premium
AutoPremiumHost

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DedicatedCapacity

Object

Representa una instancia de un recurso de capacidad dedicada.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.administration	DedicatedCapacityAdministrators	Colección de administradores de capacidad dedicados
properties.friendlyName	string	Nombre de la 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 de la capacidad. Se usa para crear capacidad Pro Plus.
sku	CapacitySku	SKU del recurso de capacidad dedicada de PowerBI.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DedicatedCapacityAdministrators

Object

Matriz de identidades de usuario administrador

Nombre	Tipo	Description
members	string[]	Matriz de identidades de usuario de administrador.

DedicatedCapacityUpdateParameters

Object

Especificación de solicitud de aprovisionamiento

Nombre	Tipo	Description
properties.administration	DedicatedCapacityAdministrators	Colección de administradores de capacidad dedicados
properties.friendlyName	string	Nombre de la 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 de 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

Object

Objeto de 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

Object

Objeto de error

Nombre	Tipo	Description
error	Error	Objeto de error.

Mode

Enumeración

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

Valor	Description
Gen1
Gen2

State

Enumeración

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

Valor	Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Capacities - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Update capacity parameters

Solicitud de ejemplo

Respuesta de muestra

Update capacity to Generation 2

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CapacityProvisioningState

CapacitySku

CapacitySkuTier

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

Mode

State

systemData