Alerts - Get

서비스:: Cost Management

API 버전:: 2025-03-01

경고 ID를 사용하여 범위에 대한 경고를 가져옵니다.

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/alerts/{alertId}?api-version=2025-03-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
alertId	path	True	string	경고 ID
scope	path	True	string	경고 작업과 연결된 범위입니다. 여기에는 구독 범위에 대한 '/subscriptions/{subscriptionId}/', resourceGroup 범위에 대한 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'이 포함됩니다. '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope and '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccount 범위에 대한 enrollmentAccountId}', 관리 그룹 범위의 경우 '/providers/Microsoft.Management/managementGroups/{managementGroupId}, billingProfile 범위의 경우 '/providers/Microsoft.Billing/billingAccountId}/{billingAccountId}/{billingProfileId}' invoiceSection 범위에 대한 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' 및 '/providers/Microsoft. 파트너에 대한 청구/billingAccounts/{billingAccountId}/customers/{customerId}'
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	Alert	그래. 요청이 성공했습니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

SingleResourceGroupAlerts

SingleSubscriptionAlerts

SingleResourceGroupAlerts

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ScreenSharingTest-peer/providers/Microsoft.CostManagement/alerts/22222222-2222-2222-2222-222222222222?api-version=2025-03-01

샘플 응답

상태 코드:: 200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ScreenSharingTest-peer/providers/Microsoft.CostManagement/alerts/22222222-2222-2222-2222-222222222222",
  "name": "22222222-2222-2222-2222-222222222222",
  "type": "Microsoft.CostManagement/alerts",
  "properties": {
    "definition": {
      "type": "Budget",
      "category": "Cost",
      "criteria": "CostThresholdExceeded"
    },
    "description": "",
    "source": "Preset",
    "details": {
      "timeGrainType": "Quarterly",
      "periodStartDate": "2020-03-01T00:00:00Z",
      "triggeredBy": "22222222-2222-2222-2222-222222222222_1_01",
      "resourceGroupFilter": [],
      "resourceFilter": [],
      "meterFilter": [],
      "tagFilter": {},
      "threshold": 0.8,
      "operator": "GreaterThan",
      "amount": 200000,
      "unit": "USD",
      "currentSpend": 161000.12,
      "contactEmails": [
        "1234@contoso.com"
      ],
      "contactGroups": [],
      "contactRoles": [],
      "overridingAlert": null
    },
    "costEntityId": "budget1",
    "status": "Active",
    "creationTime": "2020-04-27T11:07:52.7143901Z",
    "closeTime": "0001-01-01T00:00:00",
    "modificationTime": "2020-04-28T11:06:02.8999373Z",
    "statusModificationUserName": null,
    "statusModificationTime": "0001-01-01T00:00:00"
  }
}

SingleSubscriptionAlerts

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/alerts/22222222-2222-2222-2222-222222222222?api-version=2025-03-01

샘플 응답

상태 코드:: 200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/alerts/22222222-2222-2222-2222-222222222222",
  "name": "22222222-2222-2222-2222-222222222222",
  "type": "Microsoft.CostManagement/alerts",
  "properties": {
    "definition": {
      "type": "Budget",
      "category": "Cost",
      "criteria": "CostThresholdExceeded"
    },
    "description": "",
    "source": "Preset",
    "details": {
      "timeGrainType": "Quarterly",
      "periodStartDate": "2020-03-01T00:00:00Z",
      "triggeredBy": "22222222-2222-2222-2222-222222222222_1_01",
      "resourceGroupFilter": [],
      "resourceFilter": [],
      "meterFilter": [],
      "tagFilter": {},
      "threshold": 0.8,
      "operator": "GreaterThan",
      "amount": 200000,
      "unit": "USD",
      "currentSpend": 161000.12,
      "contactEmails": [
        "1234@contoso.com"
      ],
      "contactGroups": [],
      "contactRoles": [],
      "overridingAlert": null
    },
    "costEntityId": "budget1",
    "status": "Active",
    "creationTime": "2020-04-27T11:07:52.7143901Z",
    "closeTime": "0001-01-01T00:00:00",
    "modificationTime": "2020-04-28T11:06:02.8999373Z",
    "statusModificationUserName": null,
    "statusModificationTime": "0001-01-01T00:00:00"
  }
}

정의

Name	Description
Alert	개별 경고입니다.
AlertCategory	경고 범주
AlertCriteria	경고를 트리거한 조건
AlertOperator	currentSpend를 양과 비교하는 데 사용되는 연산자
AlertSource	경고 원본
AlertStatus	경고 상태
AlertTimeGrainType	시간 배수 주기의 유형
AlertType	경고 유형
Definition	경고 유형을 정의합니다.
Details	경고 세부 정보
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
TagFilter	필터링 기준 태그

Alert

Object

개별 경고입니다.

Name	형식	Description
eTag	string	리소스의 eTag입니다. 동시 업데이트 시나리오를 처리하기 위해 이 필드는 사용자가 최신 버전을 업데이트하는지 여부를 확인하는 데 사용됩니다.
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.closeTime	string	경고가 닫힌 dateTime
properties.costEntityId	string	관련 예산
properties.creationTime	string	경고가 만들어진 dateTime
properties.definition	Definition	경고 유형을 정의합니다.
properties.description	string	경고 설명
properties.details	Details	경고 세부 정보
properties.modificationTime	string	경고가 마지막으로 수정된 dateTime
properties.source	AlertSource	경고 원본
properties.status	AlertStatus	경고 상태
properties.statusModificationTime	string	경고 상태가 마지막으로 수정된 dateTime
properties.statusModificationUserName	string	경고를 마지막으로 수정한 사용자
type	string	리소스 종류입니다.

AlertCategory

열거형

경고 범주

값	Description
Cost
Usage
Billing
System

AlertCriteria

열거형

경고를 트리거한 조건

값	Description
CostThresholdExceeded
UsageThresholdExceeded
CreditThresholdApproaching
CreditThresholdReached
QuotaThresholdApproaching
QuotaThresholdReached
MultiCurrency
ForecastCostThresholdExceeded
ForecastUsageThresholdExceeded
InvoiceDueDateApproaching
InvoiceDueDateReached
CrossCloudNewDataAvailable
CrossCloudCollectionError
GeneralThresholdError

AlertOperator

열거형

currentSpend를 양과 비교하는 데 사용되는 연산자

값	Description
None
EqualTo
GreaterThan
GreaterThanOrEqualTo
LessThan
LessThanOrEqualTo

AlertSource

열거형

경고 원본

값	Description
Preset
User

AlertStatus

열거형

경고 상태

값	Description
None
Active
Overridden
Resolved
Dismissed

AlertTimeGrainType

열거형

시간 배수 주기의 유형

값	Description
None
Monthly
Quarterly
Annually
BillingMonth
BillingQuarter
BillingAnnual

AlertType

열거형

경고 유형

값	Description
Budget
Invoice
Credit
Quota
General
xCloud
BudgetForecast

Definition

Object

경고 유형을 정의합니다.

Name	형식	Description
category	AlertCategory	경고 범주
criteria	AlertCriteria	경고를 트리거한 조건
type	AlertType	경고 유형

Details

Object

경고 세부 정보

Name	형식	Description
amount	number (decimal)	예산 임계값
companyName	string	회사 이름
contactEmails	string[]	연락할 전자 메일 목록
contactGroups	string[]	브로드캐스트할 작업 그룹 목록
contactRoles	string[]	연락처 역할 목록
currentSpend	number (decimal)	현재 지출
departmentName	string	부서 이름
enrollmentEndDate	string	enrollmentEndDate의 datetime
enrollmentNumber	string	등록 번호
enrollmentStartDate	string	enrollmentStartDate의 datetime
invoicingThreshold	number (decimal)	청구서 임계값
meterFilter	AlertProperties.details.MeterFilter[]	필터링 기준이 될 미터의 배열
operator	AlertOperator	currentSpend를 양과 비교하는 데 사용되는 연산자
overridingAlert	string	경고 재정의
periodStartDate	string	periodStartDate의 날짜/시간
resourceFilter	AlertProperties.details.ResourceFilter[]	필터링할 리소스 배열
resourceGroupFilter	AlertProperties.details.ResourceGroupFilter[]	필터링할 resourceGroup의 배열
tagFilter	TagFilter	필터링 기준 태그
threshold	number (decimal)	이 경고를 활성화한 10진수로 알림 임계값 백분율
timeGrainType	AlertTimeGrainType	시간 배수 주기의 유형
triggeredBy	string	이 경고를 트리거한 notificationId
unit	string	사용 중인 통화 단위

ErrorDetails

Object

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

Object

오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

TagFilter

Object

필터링 기준 태그

다음을 통해 공유

Alerts - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

SingleResourceGroupAlerts

샘플 요청

샘플 응답

SingleSubscriptionAlerts

샘플 요청

샘플 응답

정의

Alert

AlertCategory

AlertCriteria

AlertOperator

AlertSource

AlertStatus

AlertTimeGrainType

AlertType

Definition

Details

ErrorDetails

ErrorResponse

TagFilter