Capacities - Update

Referencia

Service:: Power BI Embedded

API Version:: 2017-10-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=2017-10-01

Parámetros de identificador URI

Name	In	Required	Type	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 capacidad determinada de 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 Microsoft Azure suscripción. 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

Name	Type	Description
properties.administration	DedicatedCapacityAdministrators	Colección de administradores de capacidad dedicada
sku	ResourceSku	SKU del recurso de capacidad dedicada.
tags	object	Pares clave-valor de propiedades de aprovisionamiento adicionales.

Respuestas

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

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

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=2017-10-01

Request Body

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

Status code:: 202

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

Definiciones

DedicatedCapacity	Representa una instancia de un recurso de capacidad dedicada.
DedicatedCapacityAdministrators	Matriz de identidades de usuario de administrador
DedicatedCapacityUpdateParameters	Especificación de la solicitud de aprovisionamiento
Error	El objeto de error
ErrorResponse	Describe el formato de respuesta de error.
ProvisioningState	Estado de implementación actual del recurso dedicado de PowerBI. provisioningState es para indicar los estados para el aprovisionamiento de recursos.
ResourceSku	Representa el nombre de SKU y el plan de tarifa de Azure para el recurso dedicado de PowerBI.
SkuTier	Nombre del plan de tarifa de Azure al que se aplica la SKU.
State	Estado actual del recurso dedicado de PowerBI. El estado es indicar más estados fuera del aprovisionamiento de recursos.

DedicatedCapacity

Representa una instancia de un recurso de capacidad dedicada.

Name	Type	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 dedicada
properties.mode	string	Modo de capacidad.
properties.provisioningState	ProvisioningState	Estado de implementación actual del recurso dedicado de PowerBI. provisioningState es para 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.
sku	ResourceSku	SKU del recurso dedicado de PowerBI.
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

Name	Type	Description
members	string[]	Matriz de identidades de usuario de administrador.

DedicatedCapacityUpdateParameters

Especificación de la solicitud de aprovisionamiento

Name	Type	Description
properties.administration	DedicatedCapacityAdministrators	Colección de administradores de capacidad dedicada
properties.mode	string	Modo de capacidad.
sku	ResourceSku	SKU del recurso de capacidad dedicada.
tags	object	Pares clave-valor de propiedades de aprovisionamiento adicionales.

Error

El objeto de error

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

Name	Type	Description
error	Error	El objeto de error

ProvisioningState

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

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

ResourceSku

Representa el nombre de SKU y el plan de tarifa de Azure para el recurso dedicado de PowerBI.

Name	Type	Description
name	string	Nombre del nivel de SKU.
tier	SkuTier	Nombre del plan de tarifa de Azure al que se aplica la SKU.

SkuTier

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

Name	Type	Description
PBIE_Azure	string

State

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

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