---
title: "PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric/capacities/{capacityName}"
method: PUT
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric/capacities/{capacityName}"
tags: ["FabricCapacities"]
---

# PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric/capacities/{capacityName}

`PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric/capacities/{capacityName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric/capacities/{capacityName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Create a FabricCapacity

## Path parameters

- `subscriptionId` string, uuid, required
- `resourceGroupName` string, required
- `capacityName` string, required

## Query parameters

- `api-version` string, required

## Request body

- FabricCapacity: Fabric Capacity resource
  - `id` string, arm-id: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
  - `name` string: The name of the resource
  - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
  - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
    - `createdBy` string: The identity that created the resource.
    - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
    - `createdAt` string, date-time: The timestamp of resource creation (UTC).
    - `lastModifiedBy` string: The identity that last modified the resource.
    - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
    - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
  - `tags` object: Resource tags.
  - `location` string, required: The geo-location where the resource lives
  - `properties` FabricCapacityProperties, required: The Microsoft Fabric capacity properties.
    - `provisioningState` 'Succeeded' | 'Failed' | 'Canceled' | 'Deleting' | 'Provisioning' | 'Updating': The provisioning state of the Fabric capacity resource.
    - `state` 'Active' | 'Provisioning' | 'Failed' | 'Updating' | 'Deleting' | 'Suspending' | 'Suspended' | 'Pausing' | 'Paused' | 'Resuming' | 'Scaling' | 'Preparing': The state of the Fabric capacity resource.
    - `administration` CapacityAdministration, required: The administration properties of the Fabric capacity resource
      - `members` string[], required: An array of administrator user identities.
  - `sku` RpSku, required: Represents the SKU name and Azure pricing tier for Microsoft Fabric capacity resource.
    - `name` string, required: The name of the SKU level.
    - `tier` 'Fabric', required: The name of the Azure pricing tier to which the SKU applies.

## Response `200`

Resource 'FabricCapacity' update operation succeeded

- FabricCapacity: Fabric Capacity resource
  - `id` string, arm-id: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
  - `name` string: The name of the resource
  - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
  - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
    - `createdBy` string: The identity that created the resource.
    - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
    - `createdAt` string, date-time: The timestamp of resource creation (UTC).
    - `lastModifiedBy` string: The identity that last modified the resource.
    - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
    - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
  - `tags` object: Resource tags.
  - `location` string, required: The geo-location where the resource lives
  - `properties` FabricCapacityProperties, required: The Microsoft Fabric capacity properties.
    - `provisioningState` 'Succeeded' | 'Failed' | 'Canceled' | 'Deleting' | 'Provisioning' | 'Updating': The provisioning state of the Fabric capacity resource.
    - `state` 'Active' | 'Provisioning' | 'Failed' | 'Updating' | 'Deleting' | 'Suspending' | 'Suspended' | 'Pausing' | 'Paused' | 'Resuming' | 'Scaling' | 'Preparing': The state of the Fabric capacity resource.
    - `administration` CapacityAdministration, required: The administration properties of the Fabric capacity resource
      - `members` string[], required: An array of administrator user identities.
  - `sku` RpSku, required: Represents the SKU name and Azure pricing tier for Microsoft Fabric capacity resource.
    - `name` string, required: The name of the SKU level.
    - `tier` 'Fabric', required: The name of the Azure pricing tier to which the SKU applies.

## Other responses

- `201`: Resource 'FabricCapacity' create operation succeeded
- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2023-11-01) `1d503785f4e3`: 3 breaking
  - added the new path request parameter `resourceGroupName`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`

[Operation history](https://skmtc.dev/azure/apis/fabric-microsoft-fabric-fabric/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Fabric/capacities/:capacityName/put.md)

---

[API](https://skmtc.dev/azure/apis/fabric-microsoft-fabric-fabric.md) - [All operations](https://skmtc.dev/azure/apis/fabric-microsoft-fabric-fabric/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/fabric-microsoft-fabric-fabric/revisions/1d503785f4e3?raw)
