Usages - List By Location

Servicio:: Storage Resource Provider

Versión de la API:: 2026-04-01

Obtiene el recuento de uso actual y el límite de los recursos de la ubicación en la suscripción.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Storage/locations/{location}/usages?api-version=2026-04-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
location	path	True	string minLength: 1	El nombre de la región de Azure.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	UsageListResult	La solicitud se ha realizado correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

UsageList

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Storage/locations/eastus2(stage)/usages?api-version=2026-04-01

package armstorage_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/storage/armstorage/v4"
)

// Generated from example definition: 2026-04-01/StorageAccountListLocationUsage.json
func ExampleUsagesClient_NewListByLocationPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armstorage.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewUsagesClient().NewListByLocationPager("eastus2(stage)", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page = armstorage.UsagesClientListByLocationResponse{
		// 	UsageListResult: armstorage.UsageListResult{
		// 		Value: []*armstorage.Usage{
		// 			{
		// 				Name: &armstorage.UsageName{
		// 					LocalizedValue: to.Ptr("Storage Accounts"),
		// 					Value: to.Ptr("StorageAccounts"),
		// 				},
		// 				CurrentValue: to.Ptr[int32](55),
		// 				Limit: to.Ptr[int32](250),
		// 				Unit: to.Ptr(armstorage.UsageUnitCount),
		// 			},
		// 		},
		// 	},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "name": {
        "localizedValue": "Storage Accounts",
        "value": "StorageAccounts"
      },
      "currentValue": 55,
      "limit": 250,
      "unit": "Count"
    }
  ]
}

Definiciones

Nombre	Description
ErrorResponse	Respuesta de error del proveedor de recursos de almacenamiento.
ErrorResponseBody	Contrato del cuerpo de respuesta de error.
Usage	Describe el uso de recursos de almacenamiento.
UsageListResult	Respuesta de la operación Enumerar usos.
UsageName	Los nombres de uso que se pueden usar; actualmente limitado a StorageAccount.
UsageUnit	Obtiene la unidad de medida.

ErrorResponse

Objeto

Respuesta de error del proveedor de recursos de almacenamiento.

Nombre	Tipo	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Objeto

Contrato del cuerpo de respuesta de error.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

Usage

Objeto

Describe el uso de recursos de almacenamiento.

Nombre	Tipo	Description
currentValue	integer (int32)	Obtiene el recuento actual de los recursos asignados en la suscripción.
limit	integer (int32)	Obtiene el recuento máximo de los recursos que se pueden asignar en la suscripción.
name	UsageName	Obtiene el nombre del tipo de uso.
unit	UsageUnit	Obtiene la unidad de medida.

UsageListResult

Objeto

Respuesta de la operación Enumerar usos.

Nombre	Tipo	Description
nextLink	string
value	Usage[]	Obtiene o establece la lista de usos de recursos de almacenamiento.

UsageName

Objeto

Los nombres de uso que se pueden usar; actualmente limitado a StorageAccount.

Nombre	Tipo	Description
localizedValue	string	Obtiene una cadena localizada que describe el nombre del recurso.
value	string	Obtiene una cadena que describe el nombre del recurso.

UsageUnit

Enumeración

Obtiene la unidad de medida.

Valor	Description
Count
Bytes
Seconds
Percent
CountsPerSecond
BytesPerSecond