Alerts - Dismiss

Referens

Tjänst:: Cost Management

API-version:: 2024-08-01

Stänger den angivna aviseringen

PATCH https://management.azure.com/{scope}/providers/Microsoft.CostManagement/alerts/{alertId}?api-version=2024-08-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
alertId	path	True	string	Aviserings-ID
scope	path	True	string	Omfånget som är associerat med aviseringsåtgärder. Detta inkluderar '/subscriptions/{subscriptionId}/' för prenumerationsomfånget, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' för resourceGroup-omfånget, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' för faktureringskontoomfång och "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}" för avdelningsomfång, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId} för EnrollmentAccount-omfånget "/providers/Microsoft.Management/managementGroups/{managementGroupId} för hanteringsgruppsomfånget, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' för billingProfile scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' för invoiceSection scope och '/providers/Microsoft. Fakturering/faktureringKonton/{billingAccountId}/customers/{customerId} specifika för partner.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties.closeTime	string	dateTime där aviseringen stängdes
properties.costEntityId	string	relaterad budget
properties.creationTime	string	dateTime där aviseringen skapades
properties.definition	Definition	definierar typen av avisering
properties.description	string	Aviseringsbeskrivning
properties.details	Details	Aviseringsinformation
properties.modificationTime	string	dateTime där aviseringen senast ändrades
properties.source	AlertSource	Källa till avisering
properties.status	AlertStatus	aviseringsstatus
properties.statusModificationTime	string	dateTime där aviseringsstatus senast ändrades
properties.statusModificationUserName	string	Användare som senast ändrade aviseringen

Svar

Name	Typ	Description
200 OK	Alert	OKEJ. Begäran har slutförts.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

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

PatchResourceGroupAlerts

PatchSubscriptionAlerts

PatchResourceGroupAlerts

Exempelbegäran

HTTP

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

{
  "properties": {
    "status": "Dismissed"
  }
}

Exempelsvar

Statuskod:: 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": "Dismissed",
    "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"
  }
}

PatchSubscriptionAlerts

Exempelbegäran

HTTP

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

{
  "properties": {
    "status": "Dismissed"
  }
}

Exempelsvar

Statuskod:: 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": "Dismissed",
    "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"
  }
}

Definitioner

Name	Description
Alert	En enskild avisering.
AlertCategory	Aviseringskategori
AlertCriteria	Villkor som utlöste aviseringen
AlertOperator	operator som används för att jämföra currentSpend med belopp
AlertSource	Källa till avisering
AlertStatus	aviseringsstatus
AlertTimeGrainType	Typ av timegrain-kadens
AlertType	typ av avisering
Definition	definierar typen av avisering
Details	Aviseringsinformation
DismissAlertPayload	Begärandenyttolasten för att uppdatera en avisering
ErrorDetails	Information om felet.
ErrorResponse	Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. Några felsvar: 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".
TagFilter	taggar att filtrera efter

Alert

Objekt

En enskild avisering.

Name	Typ	Description
eTag	string	eTag för resursen. För att hantera samtidiga uppdateringsscenarion används det här fältet för att avgöra om användaren uppdaterar den senaste versionen eller inte.
id	string	Resurs-ID.
name	string	Resursnamn.
properties.closeTime	string	dateTime där aviseringen stängdes
properties.costEntityId	string	relaterad budget
properties.creationTime	string	dateTime där aviseringen skapades
properties.definition	Definition	definierar typen av avisering
properties.description	string	Aviseringsbeskrivning
properties.details	Details	Aviseringsinformation
properties.modificationTime	string	dateTime där aviseringen senast ändrades
properties.source	AlertSource	Källa till avisering
properties.status	AlertStatus	aviseringsstatus
properties.statusModificationTime	string	dateTime där aviseringsstatus senast ändrades
properties.statusModificationUserName	string	Användare som senast ändrade aviseringen
type	string	Resurstyp.

AlertCategory

Uppräkning

Aviseringskategori

Värde	Description
Billing
Cost
System
Usage

AlertCriteria

Uppräkning

Villkor som utlöste aviseringen

Värde	Description
CostThresholdExceeded
CreditThresholdApproaching
CreditThresholdReached
CrossCloudCollectionError
CrossCloudNewDataAvailable
ForecastCostThresholdExceeded
ForecastUsageThresholdExceeded
GeneralThresholdError
InvoiceDueDateApproaching
InvoiceDueDateReached
MultiCurrency
QuotaThresholdApproaching
QuotaThresholdReached
UsageThresholdExceeded

AlertOperator

Uppräkning

operator som används för att jämföra currentSpend med belopp

Värde	Description
EqualTo
GreaterThan
GreaterThanOrEqualTo
LessThan
LessThanOrEqualTo
None

AlertSource

Uppräkning

Källa till avisering

Värde	Description
Preset
User

AlertStatus

Uppräkning

aviseringsstatus

Värde	Description
Active
Dismissed
None
Overridden
Resolved

AlertTimeGrainType

Uppräkning

Typ av timegrain-kadens

Värde	Description
Annually
BillingAnnual
BillingMonth
BillingQuarter
Monthly
None
Quarterly

AlertType

Uppräkning

typ av avisering

Värde	Description
Budget
BudgetForecast
Credit
General
Invoice
Quota
xCloud

Definition

Objekt

definierar typen av avisering

Name	Typ	Description
category	AlertCategory	Aviseringskategori
criteria	AlertCriteria	Villkor som utlöste aviseringen
type	AlertType	typ av avisering

Details

Objekt

Aviseringsinformation

Name	Typ	Description
amount	number (decimal)	budgettröskelbelopp
companyName	string	företagsnamn
contactEmails	string[]	lista över e-postmeddelanden att kontakta
contactGroups	string[]	lista över åtgärdsgrupper som ska sändas till
contactRoles	string[]	lista över kontaktroller
currentSpend	number (decimal)	aktuella utgifter
departmentName	string	avdelningsnamn
enrollmentEndDate	string	datetime för registreringEndDate
enrollmentNumber	string	registreringsnummer
enrollmentStartDate	string	datetime för registreringStartDate
invoicingThreshold	number (decimal)	tröskelvärde för fakturering
meterFilter	AlertProperties.details.MeterFilter[]	matris med mätare som ska filtreras efter
operator	AlertOperator	operator som används för att jämföra currentSpend med belopp
overridingAlert	string	åsidosättande avisering
periodStartDate	string	datetime of periodStartDate
resourceFilter	AlertProperties.details.ResourceFilter[]	matris med resurser som ska filtreras efter
resourceGroupFilter	AlertProperties.details.ResourceGroupFilter[]	matris med resourceGroups som ska filtreras efter
tagFilter	TagFilter	taggar att filtrera efter
threshold	number (decimal)	meddelandetröskelprocent som en decimal som aktiverade den här aviseringen
timeGrainType	AlertTimeGrainType	Typ av timegrain-kadens
triggeredBy	string	notificationId som utlöste den här aviseringen
unit	string	valutaenhet som används

DismissAlertPayload

Objekt

Begärandenyttolasten för att uppdatera en avisering

Name	Typ	Description
properties.closeTime	string	dateTime där aviseringen stängdes
properties.costEntityId	string	relaterad budget
properties.creationTime	string	dateTime där aviseringen skapades
properties.definition	Definition	definierar typen av avisering
properties.description	string	Aviseringsbeskrivning
properties.details	Details	Aviseringsinformation
properties.modificationTime	string	dateTime där aviseringen senast ändrades
properties.source	AlertSource	Källa till avisering
properties.status	AlertStatus	aviseringsstatus
properties.statusModificationTime	string	dateTime där aviseringsstatus senast ändrades
properties.statusModificationUserName	string	Användare som senast ändrade aviseringen

ErrorDetails

Objekt

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Objekt

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

Name	Typ	Description
error	ErrorDetails	Information om felet.

TagFilter

Objekt

taggar att filtrera efter

Dela via

Alerts - Dismiss

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

PatchResourceGroupAlerts

Exempelbegäran

Exempelsvar

PatchSubscriptionAlerts

Exempelbegäran

Exempelsvar

Definitioner

Alert

AlertCategory

AlertCriteria

AlertOperator

AlertSource

AlertStatus

AlertTimeGrainType

AlertType

Definition

Details

DismissAlertPayload

ErrorDetails

ErrorResponse

TagFilter

Ytterligare resurser