Alerts - Get
Ottiene l'avviso per l'ambito in base all'ID avviso.
GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/alerts/{alertId}?api-version=2024-08-01
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
alert
|
path | True |
string |
ID avviso |
scope
|
path | True |
string |
Ambito associato alle operazioni di avvisi. Sono inclusi '/subscriptions/{subscriptionId}/' per l'ambito della sottoscrizione, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' per ambito resourceGroup, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' per ambito account di fatturazione e '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' per ambito reparto, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' per ambito EnrollmentAccount, '/providers/Microsoft.Management/managementGroups/{managementGroupId} per ambito gruppo di gestione, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' per ambito billingProfile, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' per l'ambito invoiceSection e '/providers/Microsoft. Fatturazione/billingAccounts/{billingAccountId}/customers/{customerId}' specifici per i partner. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK. La richiesta ha avuto esito positivo. |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio di richiesta
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=2024-08-01
Risposta di esempio
{
"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"
}
}
Esempio di richiesta
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/alerts/22222222-2222-2222-2222-222222222222?api-version=2024-08-01
Risposta di esempio
{
"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"
}
}
Nome | Descrizione |
---|---|
Alert |
Un singolo avviso. |
Alert |
Categoria avviso |
Alert |
Criteri che hanno attivato l'avviso |
Alert |
operatore utilizzato per confrontare currentSpend con quantità |
Alert |
Origine dell'avviso |
Alert |
stato avviso |
Alert |
Tipo di cadenza cronologica |
Alert |
tipo di avviso |
Definition |
definisce il tipo di avviso |
Details |
Dettagli avviso |
Error |
Dettagli dell'errore. |
Error |
La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. Alcune risposte di errore:
|
Tag |
tag da filtrare in base |
Un singolo avviso.
Nome | Tipo | Descrizione |
---|---|---|
eTag |
string |
eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente. |
id |
string |
ID risorsa. |
name |
string |
Nome risorsa. |
properties.closeTime |
string |
dateTime in cui è stato chiuso l'avviso |
properties.costEntityId |
string |
budget correlato |
properties.creationTime |
string |
dateTime in cui è stato creato l'avviso |
properties.definition |
definisce il tipo di avviso |
|
properties.description |
string |
Descrizione dell'avviso |
properties.details |
Dettagli avviso |
|
properties.modificationTime |
string |
dateTime in cui l'avviso è stato modificato per l'ultima volta |
properties.source |
Origine dell'avviso |
|
properties.status |
stato avviso |
|
properties.statusModificationTime |
string |
dateTime in cui lo stato dell'avviso è stato modificato per l'ultima volta |
properties.statusModificationUserName |
string |
Utente che ha modificato l'ultimo avviso |
type |
string |
Tipo di risorsa. |
Categoria avviso
Nome | Tipo | Descrizione |
---|---|---|
Billing |
string |
|
Cost |
string |
|
System |
string |
|
Usage |
string |
Criteri che hanno attivato l'avviso
Nome | Tipo | Descrizione |
---|---|---|
CostThresholdExceeded |
string |
|
CreditThresholdApproaching |
string |
|
CreditThresholdReached |
string |
|
CrossCloudCollectionError |
string |
|
CrossCloudNewDataAvailable |
string |
|
ForecastCostThresholdExceeded |
string |
|
ForecastUsageThresholdExceeded |
string |
|
GeneralThresholdError |
string |
|
InvoiceDueDateApproaching |
string |
|
InvoiceDueDateReached |
string |
|
MultiCurrency |
string |
|
QuotaThresholdApproaching |
string |
|
QuotaThresholdReached |
string |
|
UsageThresholdExceeded |
string |
operatore utilizzato per confrontare currentSpend con quantità
Nome | Tipo | Descrizione |
---|---|---|
EqualTo |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqualTo |
string |
|
LessThan |
string |
|
LessThanOrEqualTo |
string |
|
None |
string |
Origine dell'avviso
Nome | Tipo | Descrizione |
---|---|---|
Preset |
string |
|
User |
string |
stato avviso
Nome | Tipo | Descrizione |
---|---|---|
Active |
string |
|
Dismissed |
string |
|
None |
string |
|
Overridden |
string |
|
Resolved |
string |
Tipo di cadenza cronologica
Nome | Tipo | Descrizione |
---|---|---|
Annually |
string |
|
BillingAnnual |
string |
|
BillingMonth |
string |
|
BillingQuarter |
string |
|
Monthly |
string |
|
None |
string |
|
Quarterly |
string |
tipo di avviso
Nome | Tipo | Descrizione |
---|---|---|
Budget |
string |
|
BudgetForecast |
string |
|
Credit |
string |
|
General |
string |
|
Invoice |
string |
|
Quota |
string |
|
xCloud |
string |
definisce il tipo di avviso
Nome | Tipo | Descrizione |
---|---|---|
category |
Categoria avviso |
|
criteria |
Criteri che hanno attivato l'avviso |
|
type |
tipo di avviso |
Dettagli avviso
Nome | Tipo | Descrizione |
---|---|---|
amount |
number |
importo soglia budget |
companyName |
string |
nome società |
contactEmails |
string[] |
elenco di messaggi di posta elettronica da contattare |
contactGroups |
string[] |
elenco di gruppi di azioni da trasmettere a |
contactRoles |
string[] |
elenco dei ruoli di contatto |
currentSpend |
number |
spesa corrente |
departmentName |
string |
nome reparto |
enrollmentEndDate |
string |
datetime of enrollmentEndDate |
enrollmentNumber |
string |
numero di registrazione |
enrollmentStartDate |
string |
datetime of enrollmentStartDate |
invoicingThreshold |
number |
soglia di fatturazione |
meterFilter |
Alert |
matrice di contatori da filtrare in base |
operator |
operatore utilizzato per confrontare currentSpend con quantità |
|
overridingAlert |
string |
override dell'avviso |
periodStartDate |
string |
datetime di periodStartDate |
resourceFilter |
Alert |
matrice di risorse da filtrare in base |
resourceGroupFilter |
Alert |
matrice di resourceGroups da filtrare in base |
tagFilter |
tag da filtrare in base |
|
threshold |
number |
percentuale di soglia di notifica come decimale che ha attivato l'avviso |
timeGrainType |
Tipo di cadenza cronologica |
|
triggeredBy |
string |
notificationId che ha attivato questo avviso |
unit |
string |
unità di valuta utilizzata |
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
message |
string |
Messaggio di errore che indica il motivo per cui l'operazione non è riuscita. |
La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.
Alcune risposte di errore:
429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
Nome | Tipo | Descrizione |
---|---|---|
error |
Dettagli dell'errore. |
tag da filtrare in base