Usages - List By Location

Tjänst:

Storage Resource Provider

API-version:

2026-04-01

Hämtar det aktuella användningsantalet och gränsen för resurserna på platsen under prenumerationen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
location	path	True	string minLength: 1	Namnet på Azure-regionen.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	UsageListResult	Begäran har lyckats.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

UsageList

Exempelbegäran

HTTP

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

Go

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

Exempelsvar

Statuskod:

200

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

Definitioner

Name	Description
ErrorResponse	Ett felsvar från lagringsresursprovidern.
ErrorResponseBody	Brödtextkontrakt för felsvar.
Usage	Beskriver användning av lagringsresurser.
UsageListResult	Svaret från listanvändningsåtgärden.
UsageName	De användningsnamn som kan användas. för närvarande begränsat till StorageAccount.
UsageUnit	Hämtar måttenheten.

ErrorResponse

Objekt

Ett felsvar från lagringsresursprovidern.

Name	Typ	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Objekt

Brödtextkontrakt för felsvar.

Name	Typ	Description
code	string	En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
message	string	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.

Usage

Objekt

Beskriver användning av lagringsresurser.

Name	Typ	Description
currentValue	integer (int32)	Hämtar det aktuella antalet allokerade resurser i prenumerationen.
limit	integer (int32)	Hämtar det maximala antalet resurser som kan allokeras i prenumerationen.
name	UsageName	Hämtar namnet på typen av användning.
unit	UsageUnit	Hämtar måttenheten.

UsageListResult

Objekt

Svaret från listanvändningsåtgärden.

Name	Typ	Description
nextLink	string
value	Usage[]	Hämtar eller ställer in listan över användningsområden för lagringsresurser.

UsageName

Objekt

De användningsnamn som kan användas. för närvarande begränsat till StorageAccount.

Name	Typ	Description
localizedValue	string	Hämtar en lokaliserad sträng som beskriver resursnamnet.
value	string	Hämtar en sträng som beskriver resursnamnet.

UsageUnit

Uppräkning

Hämtar måttenheten.

Värde	Description
Count
Bytes
Seconds
Percent
CountsPerSecond
BytesPerSecond