다음을 통해 공유


Usage - List

지정된 위치에 대해 현재 컴퓨팅 리소스 사용량 정보와 구독의 컴퓨팅 리소스에 대한 제한을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/usages?api-version=2024-07-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
location
path True

string

pattern: ^[-\w\._]+$

리소스 사용량을 쿼리할 위치입니다.

subscriptionId
path True

string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.

api-version
query True

string

클라이언트 API 버전입니다.

응답

Name 형식 Description
200 OK

ListUsagesResult

그래

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Usage_List_MaximumSet_Gen
Usage_List_MinimumSet_Gen

Usage_List_MaximumSet_Gen

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/4_./usages?api-version=2024-07-01

샘플 응답

{
  "value": [
    {
      "unit": "Count",
      "currentValue": 17,
      "limit": 19,
      "name": {
        "value": "aaaaaaaaaaaaaaaaaa",
        "localizedValue": "aaaaaaaaaaaaaa"
      }
    }
  ],
  "nextLink": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

Usage_List_MinimumSet_Gen

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/_--/usages?api-version=2024-07-01

샘플 응답

{
  "value": [
    {
      "unit": "Count",
      "currentValue": 17,
      "limit": 19,
      "name": {}
    }
  ]
}

정의

Name Description
ApiError

API 오류입니다.

ApiErrorBase

API 오류 기준입니다.

CloudError

Compute 서비스의 오류 응답입니다.

InnerError

내부 오류 세부 정보입니다.

ListUsagesResult

사용량 목록 작업 응답입니다.

Usage

컴퓨팅 리소스 사용량을 설명합니다.

UsageName

사용 이름입니다.

UsageUnit

사용량 측정 단위를 설명하는 열거형입니다.

ApiError

API 오류입니다.

Name 형식 Description
code

string

오류 코드입니다.

details

ApiErrorBase[]

API 오류 세부 정보

innererror

InnerError

API 내부 오류

message

string

오류 메시지입니다.

target

string

특정 오류의 대상입니다.

ApiErrorBase

API 오류 기준입니다.

Name 형식 Description
code

string

오류 코드입니다.

message

string

오류 메시지입니다.

target

string

특정 오류의 대상입니다.

CloudError

Compute 서비스의 오류 응답입니다.

Name 형식 Description
error

ApiError

API 오류입니다.

InnerError

내부 오류 세부 정보입니다.

Name 형식 Description
errordetail

string

내부 오류 메시지 또는 예외 덤프입니다.

exceptiontype

string

예외 형식입니다.

ListUsagesResult

사용량 목록 작업 응답입니다.

Name 형식 Description
nextLink

string

컴퓨팅 리소스 사용량 정보의 다음 페이지를 가져올 URI입니다. ListNext()를 호출하여 컴퓨팅 리소스 사용량 정보의 다음 페이지를 가져옵니다.

value

Usage[]

컴퓨팅 리소스 사용량 목록입니다.

Usage

컴퓨팅 리소스 사용량을 설명합니다.

Name 형식 Description
currentValue

integer (int32)

리소스의 현재 사용량입니다.

limit

integer (int64)

리소스의 허용되는 최대 사용량입니다.

name

UsageName

사용 유형 이름입니다.

unit

UsageUnit

사용량 측정 단위를 설명하는 열거형입니다.

UsageName

사용 이름입니다.

Name 형식 Description
localizedValue

string

리소스의 지역화된 이름입니다.

value

string

리소스의 이름입니다.

UsageUnit

사용량 측정 단위를 설명하는 열거형입니다.

Description
Count