Admin - Get Capacities As Admin

Servicio:

Power BI REST APIs

Versión de la API:

v1.0

Devuelve una lista de capacidades para la organización.

Permisos

• El usuario debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.
• Se admiten permisos delegados.

Cuando se ejecuta en la autenticación prinicipal del servicio, una aplicación no debe tener las premisiones necesarias de consentimiento del administrador para Power BI establecidas en él en Azure Portal.

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Solo es relevante al autenticarse a través de un token de acceso de administrador delegado estándar. No debe estar presente cuando se usa la autenticación a través de una entidad de servicio.

Limitaciones

Máximo de 200 solicitudes por hora.

GET https://api.powerbi.com/v1.0/myorg/admin/capacities

Con parámetros opcionales:

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
$expand	query		string	Expande las entidades relacionadas insertadas

Respuestas

Nombre	Tipo	Description
200 OK	Capacities	De acuerdo

Ejemplos

Example

Example with expand on tenant key

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/admin/capacities

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7"
    }
  ]
}

Example with expand on tenant key

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "tenantKey": {
        "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
        "name": "Contoso Sales",
        "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
        "isDefault": true,
        "createdAt": "2019-04-30T21:35:15.867-07:00",
        "updatedAt": "2019-04-30T21:35:15.867-07:00"
      }
    }
  ]
}

Definiciones

Nombre	Description
Capacities	Contenedor de respuesta de OData para una lista de capacidad de Power BI
Capacity	Una capacidad de Power BI
CapacityState	Estado de capacidad
capacityUserAccessRight	Derecho de acceso que el usuario tiene en la capacidad
TenantKey	Información de clave de cifrado

Capacities

Contenedor de respuesta de OData para una lista de capacidad de Power BI

Nombre	Tipo	Description
odata.context	string
value	Capacity[]	Lista de capacidad

Capacity

Una capacidad de Power BI

Nombre	Tipo	Description
admins	string[]	Matriz de administradores de capacidad
capacityUserAccessRight	capacityUserAccessRight	El derecho de acceso que tiene un usuario en la capacidad
displayName	string	Nombre para mostrar de la capacidad
id	string	El identificador de capacidad
region	string	Región de Azure donde se aprovisionó la capacidad
sku	string	SKU de capacidad
state	CapacityState	Estado de capacidad
tenantKey	TenantKey	Información de clave de cifrado (solo se aplica a las rutas de administración)
tenantKeyId	string	Identificador de una clave de cifrado (solo aplicable a la ruta de administración)

CapacityState

Estado de capacidad

Nombre	Tipo	Description
Active	string	La capacidad está lista para usarse
Deleted	string	La capacidad se eliminó y no está disponible.
Deleting	string	La eliminación de la capacidad está en curso
Invalid	string	No se puede usar la capacidad.
NotActivated	string	Sin fundamento
PreSuspended	string	Sin fundamento
ProvisionFailed	string	Error en el aprovisionamiento de la capacidad
Provisioning	string	La activación de la capacidad está en curso
Suspended	string	Se suspende el uso de la capacidad
UpdatingSku	string	Hay un cambio de SKU de capacidad en curso

capacityUserAccessRight

Derecho de acceso que el usuario tiene en la capacidad

Nombre	Tipo	Description
Admin	string	El usuario tiene derechos de administrador sobre la capacidad
Assign	string	El usuario tiene derechos de colaborador y puede asignar áreas de trabajo a la capacidad.
None	string	El usuario no tiene acceso a la capacidad

TenantKey

Información de clave de cifrado

Nombre	Tipo	Description
createdAt	string	Fecha y hora de creación de la clave de cifrado
id	string	Identificador de la clave de cifrado
isDefault	boolean	Si la clave de cifrado es la clave predeterminada para todo el inquilino. Cualquier capacidad recién creada hereda la clave predeterminada.
keyVaultKeyIdentifier	string	Identificador URI que especifica de forma única la clave de cifrado en Azure Key Vault.
name	string	Nombre de la clave de cifrado
updatedAt	string	La última fecha y hora de actualización de la clave de cifrado