다음을 통해 공유


Quota By Counter Keys - List By Service

지정된 서비스 instance 정책에 구성된 카운터 키와 연결된 현재 할당량 카운터 기간의 컬렉션을 나열합니다. api는 아직 페이징을 지원하지 않습니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}?api-version=2022-08-01

URI 매개 변수

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

string

할당량 카운터 키 식별자입니다. 이는 할당량 기준 정책의 카운터 키 특성에 정의된 식의 결과입니다. 예를 들어 정책에 counter-key="boo"를 지정하면 "boo" 카운터 키로 액세스할 수 있습니다. 그러나 counter-key="@("b"+"a")"로 정의된 경우 "ba" 키로 액세스할 수 있습니다.

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

serviceName
path True

string

API Management 서비스의 이름입니다.

regex 패턴: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

QuotaCounterCollection

할당량 카운터 값의 컬렉션을 나열합니다.

Other Status Codes

ErrorResponse

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

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

범위

Name Description
user_impersonation 사용자 계정 가장

예제

ApiManagementGetQuotaCounterKeys

샘플 요청

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/quotas/ba?api-version=2022-08-01

샘플 응답

{
  "value": [
    {
      "counterKey": "ba",
      "periodKey": "0_P3Y6M4DT12H30M5S",
      "periodStartTime": "2014-08-04T04:24:35Z",
      "periodEndTime": "2018-02-08T16:54:40Z",
      "value": {
        "callsCount": 5,
        "kbTransferred": 2.5830078125
      }
    }
  ],
  "nextLink": ""
}

정의

Name Description
ErrorFieldContract

오류 필드 계약입니다.

ErrorResponse

오류 응답.

QuotaCounterCollection

페이징된 할당량 카운터 목록 표현입니다.

QuotaCounterContract

할당량 카운터 세부 정보입니다.

QuotaCounterValueContractProperties

할당량 카운터 값 세부 정보입니다.

ErrorFieldContract

오류 필드 계약입니다.

Name 형식 Description
code

string

속성 수준 오류 코드입니다.

message

string

사람이 읽을 수 있는 속성 수준 오류 표현입니다.

target

string

속성 이름입니다.

ErrorResponse

오류 응답.

Name 형식 Description
error.code

string

서비스에서 정의한 오류 코드입니다. 이 코드는 응답에 지정된 HTTP 오류 코드의 하위 상태로 사용됩니다.

error.details

ErrorFieldContract[]

유효성 검사 오류가 발생할 경우 잘못된 필드 목록이 요청에 전송됩니다.

error.message

string

사람이 읽을 수 있는 오류 표현입니다.

QuotaCounterCollection

페이징된 할당량 카운터 목록 표현입니다.

Name 형식 Description
count

integer

모든 페이지의 총 레코드 개수입니다.

nextLink

string

다음 페이지 링크(있는 경우).

value

QuotaCounterContract[]

할당량 카운터 값입니다.

QuotaCounterContract

할당량 카운터 세부 정보입니다.

Name 형식 Description
counterKey

string

카운터의 키 값입니다. 비어 있지 않아야 합니다.

periodEndTime

string

카운터 기간 종료 날짜입니다. 날짜는 ISO 8601 표준에 지정된 형식 yyyy-MM-ddTHH:mm:ssZ 을 따릅니다.

periodKey

string

카운터가 수집된 기간의 식별자입니다. 비어 있지 않아야 합니다.

periodStartTime

string

카운터 기간 시작 날짜입니다. 날짜는 ISO 8601 표준에 지정된 형식 yyyy-MM-ddTHH:mm:ssZ 을 따릅니다.

value

QuotaCounterValueContractProperties

할당량 값 속성

QuotaCounterValueContractProperties

할당량 카운터 값 세부 정보입니다.

Name 형식 Description
callsCount

integer

Counter가 호출된 횟수입니다.

kbTransferred

number

KBytes로 전송된 데이터입니다.