Capacities - Create

Référence

Service:: Power BI Embedded

Version d'API:: 2021-01-01

Approvisionne la capacité dédiée spécifiée en fonction de la configuration spécifiée dans la demande.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
dedicatedCapacityName	path	True	string	Nom de la capacité dédiée. Il doit comporter au moins 3 caractères et un maximum de 63. Modèle d’expression régulière: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	Nom du groupe de ressources Azure dont fait partie une capacité PowerBIDedicated donnée. Ce nom doit comporter au moins 1 caractère et pas plus de 90. Modèle d’expression régulière: `^[-\w\._]+$`
subscriptionId	path	True	string	Identificateur unique pour un abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.
api-version	query	True	string	Version de l’API cliente.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement de la ressource PowerBI Dedicated.
sku	True	CapacitySku	Référence SKU de la ressource de capacité PowerBI Dedicated.
properties.administration		DedicatedCapacityAdministrators	Collection d’administrateurs de capacité dédiée
properties.mode		Mode	Spécifie la génération de la capacité Power BI Embedded. Si aucune valeur n’est spécifiée, la valeur par défaut « Gen2 » est utilisée. En savoir plus
systemData		SystemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
tags		object	Paires clé-valeur de propriétés d’approvisionnement de ressources supplémentaires.

Réponses

Nom	Type	Description
200 OK	DedicatedCapacity	OK. L’opération s’est terminée avec succès.
201 Created	DedicatedCapacity	InProgress. L'opération est encore en cours.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Create capacity

Exemple de requête

HTTP

PUT 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"
  },
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    }
  }
}

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: 201

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/servers/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"
  }
}

Définitions

Nom	Description
CapacityProvisioningState	État actuel du déploiement de la ressource PowerBI Dedicated. ProvisioningState indique les états pour l’approvisionnement des ressources.
CapacitySku	Représente le nom de la référence SKU et le niveau tarifaire Azure pour la ressource de capacité dédiée PowerBI.
CapacitySkuTier	Nom du niveau tarifaire Azure auquel la référence SKU s’applique.
DedicatedCapacity	Représente une instance d’une ressource De capacité dédiée.
DedicatedCapacityAdministrators	Tableau d’identités d’utilisateur administrateur
Error	Objet error
ErrorResponse	Décrit le format de réponse d’erreur.
IdentityType	Type d’identité qui a créé/modifié la ressource.
Mode	Spécifie la génération de la capacité Power BI Embedded. Si aucune valeur n’est spécifiée, la valeur par défaut « Gen2 » est utilisée. En savoir plus
State	État actuel de la ressource PowerBI Dedicated. L’état indique plus d’états en dehors de l’approvisionnement des ressources.
SystemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

CapacityProvisioningState

État actuel du déploiement de la ressource PowerBI Dedicated. ProvisioningState indique les états pour l’approvisionnement des ressources.

Nom	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

CapacitySku

Représente le nom de la référence SKU et le niveau tarifaire Azure pour la ressource de capacité dédiée PowerBI.

Nom	Type	Description
capacity	integer	Capacité de la référence SKU.
name	string	Nom du niveau de référence SKU.
tier	CapacitySkuTier	Nom du niveau tarifaire Azure auquel la référence SKU s’applique.

CapacitySkuTier

Nom du niveau tarifaire Azure auquel la référence SKU s’applique.

Nom	Type	Description
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Représente une instance d’une ressource De capacité dédiée.

Nom	Type	Description
id	string	Identificateur qui représente la ressource PowerBI Dedicated.
location	string	Emplacement de la ressource PowerBI Dedicated.
name	string	Nom de la ressource PowerBI Dedicated.
properties.administration	DedicatedCapacityAdministrators	Collection d’administrateurs de capacité dédiée
properties.friendlyName	string	Nom de capacité
properties.mode	Mode	Spécifie la génération de la capacité Power BI Embedded. Si aucune valeur n’est spécifiée, la valeur par défaut « Gen2 » est utilisée. En savoir plus
properties.provisioningState	CapacityProvisioningState	État actuel du déploiement de la ressource PowerBI Dedicated. ProvisioningState indique les états pour l’approvisionnement des ressources.
properties.state	State	État actuel de la ressource PowerBI Dedicated. L’état indique plus d’états en dehors de l’approvisionnement des ressources.
properties.tenantId	string	ID de locataire pour la capacité. Utilisé pour créer une capacité Pro Plus.
sku	CapacitySku	Référence SKU de la ressource de capacité PowerBI Dedicated.
systemData	SystemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
tags	object	Paires clé-valeur de propriétés d’approvisionnement de ressources supplémentaires.
type	string	Type de la ressource PowerBI Dedicated.

DedicatedCapacityAdministrators

Tableau d’identités d’utilisateur administrateur

Nom	Type	Description
members	string[]	Tableau d’identités d’utilisateur administrateur.

Error

Objet error

Nom	Type	Description
code	string	Code d'erreur
message	string	Message d’erreur indiquant la raison de l’échec de l’opération.

ErrorResponse

Décrit le format de réponse d’erreur.

Nom	Type	Description
error	Error	Objet error

IdentityType

Type d’identité qui a créé/modifié la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Spécifie la génération de la capacité Power BI Embedded. Si aucune valeur n’est spécifiée, la valeur par défaut « Gen2 » est utilisée. En savoir plus

Nom	Type	Description
Gen1	string
Gen2	string

State

État actuel de la ressource PowerBI Dedicated. L’état indique plus d’états en dehors de l’approvisionnement des ressources.

Nom	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

SystemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC)
createdBy	string	Identificateur de l’identité qui a créé la ressource
createdByType	IdentityType	Type d’identité qui a créé la ressource
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identificateur de l’identité qui a modifié la dernière ressource
lastModifiedByType	IdentityType	Type d’identité qui a modifié la dernière ressource

Partager via