Azure Storage Accounts File Service Usage Operation Group API

The FileServiceUsageOperationGroup API from Azure Storage Accounts — 2 operation(s) for fileserviceusageoperationgroup.

GitHub OpenAPI

Operations 2

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/usages File services list service usages #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/usages/default File services get service usage #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/azure-storage-accounts:azure-storage-accounts-fileserviceusageoperationgroup-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-storage-accounts-fileserviceusageoperationgroup-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: StorageManagementClient File Service Usage Operation Group…
  version: '2026-09-01'
  description: The Azure Storage Management API.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: FileServiceUsageOperationGroup
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/usages
  : get:
      operationId: FileServices_ListServiceUsages
      tags:
      - FileServiceUsageOperationGroup
      description: Gets the usages of file service in storage account.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: accountName
        in: path
        description: The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
        required: true
        schema:
          type: string
          maxLength: 24
          minLength: 3
          pattern: ^[a-z0-9]+$
      - name: $maxpagesize
        in: query
        description: Optional, specifies the maximum number of file service usages to be included in the list response.
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileServiceUsages'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: File services list service usages
      x-summary-source: derived
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/usages/default
  : get:
      operationId: FileServices_GetServiceUsage
      tags:
      - FileServiceUsageOperationGroup
      description: Gets the usage of file service in storage account including account limits, file share limits and constants used in recommendations and bursting formula.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: accountName
        in: path
        description: The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
        required: true
        schema:
          type: string
          maxLength: 24
          minLength: 3
          pattern: ^[a-z0-9]+$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileServiceUsage'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      summary: File services get service usage
      x-summary-source: derived
components:
  parameters:
    ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      schema:
        type: string
        minLength: 1
    ResourceGroupNameParameter:
      name: resourceGroupName
      in: path
      description: The name of the resource group. The name is case insensitive.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
        maxLength: 90
        minLength: 1
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      description: The ID of the target subscription. The value must be an UUID.
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    FileServiceUsages:
      type: object
      description: List file service usages schema.
      properties:
        value:
          type: array
          description: The FileServiceUsage items on this page
          items:
            $ref: '#/components/schemas/FileServiceUsage'
          readOnly: true
        nextLink:
          type: string
          format: uri
          description: The link to the next page of items
      required:
      - value
    AccountUsage:
      type: object
      description: Usage of provisioned storage, IOPS, bandwidth and number of file shares across all live shares and soft-deleted shares in the account.
      properties:
        liveShares:
          $ref: '#/components/schemas/AccountUsageElements'
          description: Usage of provisioned storage, IOPS, bandwidth and number of file shares across all live shares or soft-deleted shares in the account.
        softDeletedShares:
          $ref: '#/components/schemas/AccountUsageElements'
          description: Usage of provisioned storage, IOPS, bandwidth and number of file shares across all live shares or soft-deleted shares in the account.
    FileServiceUsageProperties:
      type: object
      description: File service usage in storage account including account limits, file share limits and constants used in recommendations and bursting formula.
      properties:
        storageAccountLimits:
          $ref: '#/components/schemas/AccountLimits'
          description: Maximum provisioned storage, IOPS, bandwidth and number of file shares limits for the storage account.
          readOnly: true
        fileShareLimits:
          $ref: '#/components/schemas/FileShareLimits'
          description: Minimum and maximum provisioned storage, IOPS and bandwidth limits for a file share in the storage account.
          readOnly: true
        fileShareRecommendations:
          $ref: '#/components/schemas/FileShareRecommendations'
          description: Constants used for calculating recommended provisioned IOPS and bandwidth for a file share in the storage account.
          readOnly: true
        burstingConstants:
          $ref: '#/components/schemas/BurstingConstants'
          description: Constants used for calculating included burst IOPS and maximum burst credits for IOPS for a file share in the storage account.
          readOnly: true
        storageAccountUsage:
          $ref: '#/components/schemas/AccountUsage'
          description: Usage of provisioned storage, IOPS, bandwidth and number of file shares across all live shares and soft-deleted shares in the account.
          readOnly: true
    AccountLimits:
      type: object
      description: Maximum provisioned storage, IOPS, bandwidth and number of file shares limits for the storage account.
      properties:
        maxFileShares:
          type: integer
          format: int32
          description: The maximum number of file shares limit for the storage account.
          readOnly: true
        maxProvisionedStorageGiB:
          type: integer
          format: int32
          description: The maximum provisioned storage quota limit in gibibytes for the storage account.
          readOnly: true
        maxProvisionedIOPS:
          type: integer
          format: int32
          description: The maximum provisioned IOPS limit for the storage account.
          readOnly: true
        maxProvisionedBandwidthMiBPerSec:
          type: integer
          format: int32
          description: The maximum provisioned bandwidth limit in mebibytes per second for the storage account.
          readOnly: true
    FileShareRecommendations:
      type: object
      description: Constants used for calculating recommended provisioned IOPS and bandwidth for a file share in the storage account.
      properties:
        baseIOPS:
          type: integer
          format: int32
          description: The base IOPS in the file share provisioned IOPS recommendation formula.
          readOnly: true
        ioScalar:
          type: number
          format: double
          description: The scalar for IO in the file share provisioned IOPS recommendation formula.
          readOnly: true
        baseBandwidthMiBPerSec:
          type: integer
          format: int32
          description: The base bandwidth in the file share provisioned bandwidth recommendation formula.
          readOnly: true
        bandwidthScalar:
          type: number
          format: double
          description: The scalar for bandwidth in the file share provisioned bandwidth recommendation formula.
          readOnly: true
    CloudError:
      type: object
      description: An error response from the Storage service.
      properties:
        error:
          $ref: '#/components/schemas/CloudErrorBody'
          description: An error response from the Storage service.
      x-ms-external: true
    CloudErrorBody:
      type: object
      description: An error response from the Storage service.
      properties:
        code:
          type: string
          description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically.
        message:
          type: string
          description: A message describing the error, intended to be suitable for display in a user interface.
        target:
          type: string
          description: The target of the particular error. For example, the name of the property in error.
        details:
          type: array
          description: A list of additional details about the error.
          items:
            $ref: '#/components/schemas/CloudErrorBody'
          x-ms-identifiers: []
      x-ms-external: true
    FileShareLimits:
      type: object
      description: Minimum and maximum provisioned storage, IOPS and bandwidth limits for a file share in the storage account.
      properties:
        minProvisionedStorageGiB:
          type: integer
          format: int32
          description: The minimum provisioned storage quota limit in gibibytes for a file share in the storage account.
          readOnly: true
        maxProvisionedStorageGiB:
          type: integer
          format: int32
          description: The maximum provisioned storage quota limit in gibibytes for a file share in the storage account.
          readOnly: true
        minProvisionedIOPS:
          type: integer
          format: int32
          description: The minimum provisioned IOPS limit for a file share in the storage account.
          readOnly: true
        maxProvisionedIOPS:
          type: integer
          format: int32
          description: The maximum provisioned IOPS limit for a file share in the storage account.
          readOnly: true
        minProvisionedBandwidthMiBPerSec:
          type: integer
          format: int32
          description: The minimum provisioned bandwidth limit in mebibytes per second for a file share in the storage account.
          readOnly: true
        maxProvisionedBandwidthMiBPerSec:
          type: integer
          format: int32
          description: The maximum provisioned bandwidth limit in mebibytes per second for a file share in the storage account.
          readOnly: true
        guardrailIOScalar:
          type: number
          format: double
          description: The IO scalar used for guardrail calculations for a file share in the storage account.
          readOnly: true
        guardrailBandwidthScalar:
          type: number
          format: double
          description: The bandwidth scalar used for guardrail calculations for a file share in the storage account.
          readOnly: true
    FileServiceUsage:
      type: object
      description: The usage of file service in storage account.
      properties:
        properties:
          $ref: '#/components/schemas/FileServiceUsageProperties'
          description: File service usage in storage account including account limits, file share limits and constants used in recommendations and bursting formula.
      allOf:
      - $ref: '#/components/schemas/ProxyResource'
    AccountUsageElements:
      type: object
      description: Usage of provisioned storage, IOPS, bandwidth and number of file shares across all live shares or soft-deleted shares in the account.
      properties:
        fileShareCount:
          type: integer
          format: int32
          description: The total number of file shares.
          readOnly: true
        provisionedStorageGiB:
          type: integer
          format: int32
          description: The total provisioned storage quota in gibibytes.
          readOnly: true
        provisionedIOPS:
          type: integer
          format: int32
          description: The total provisioned IOPS.
          readOnly: true
        provisionedBandwidthMiBPerSec:
          type: integer
          format: int32
          description: The total provisioned bandwidth in mebibytes per second.
          readOnly: true
    ProxyResource:
      type: object
      title: Proxy Resource
      description: The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location
      allOf:
      - $ref: '#/components/schemas/Resource'
    BurstingConstants:
      type: object
      description: Constants used for calculating included burst IOPS and maximum burst credits for IOPS for a file share in the storage account.
      properties:
        burstFloorIOPS:
          type: integer
          format: int32
          description: The guaranteed floor of burst IOPS for small file shares.
          readOnly: true
        burstIOScalar:
          type: number
          format: double
          description: The scalar against provisioned IOPS in the file share included burst IOPS formula.
          readOnly: true
        burstTimeframeSeconds:
          type: integer
          format: int32
          description: The time frame for bursting in seconds in the file share maximum burst credits for IOPS formula.
          readOnly: true
    Resource:
      type: object
      title: Resource
      description: Common fields that are returned in the response for all Azure Resource Manager resources
      properties:
        id:
          type: string
          format: arm-id
          description: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
          readOnly: true
        name:
          type: string
          description: The name of the resource
          readOnly: true
        type:
          type: string
          description: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
          readOnly: true
        systemData:
          $ref: '#/components/schemas/systemData'
          description: Azure Resource Manager metadata containing createdBy and modifiedBy information.
          readOnly: true
      x-ms-azure-resource: true
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.