Predictive Metric - Get
Abrufen von Zukünftigen Daten zur prädiktiven Automatischskalierung von Metriken
GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/autoscalesettings/{autoscaleSettingName}/predictiveMetrics?timespan={timespan}&interval={interval}&metricNamespace={metricNamespace}&metricName={metricName}&aggregation={aggregation}&api-version=2022-10-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
autoscale
|
path | True |
string |
Der Name der Einstellung für die automatische Skalierung |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
aggregation
|
query | True |
string |
Die Liste der abzurufenden Aggregationstypen (durch Kommas getrennt). |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
interval
|
query | True |
string duration |
Das Intervall (d. h. Zeitgrain) der Abfrage. |
metric
|
query | True |
string |
Die Namen der abzurufenden Metriken (kommastrennt). Sonderfall: Wenn ein Metrikname selbst ein Komma enthält, verwenden Sie %2, um ihn anzugeben. Beispiel: "Metrik,Name1" sollte "Metrik%2Name1" sein. |
metric
|
query | True |
string |
Metriknamespace zum Abfragen von Metrikdefinitionen. |
timespan
|
query | True |
string |
Die Zeitspanne der Abfrage. Es handelt sich um eine Zeichenfolge mit dem folgenden Format "startDateTime_ISO/endDateTime_ISO". |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreiche Anforderung zum Abrufen der Liste der Metrikwerte. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
Get Metric for data
Beispielanforderung
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myRG/providers/Microsoft.Insights/autoscalesettings/vmss1-Autoscale-775/predictiveMetrics?timespan=2021-10-14T22:00:00.000Z/2021-10-16T22:00:00.000Z&interval=PT1H&metricNamespace=Microsoft.Compute/virtualMachineScaleSets&metricName=PercentageCPU&aggregation=Total&api-version=2022-10-01
Beispiel für eine Antwort
{
"timespan": "2021-10-14T22:00:00.000Z/2021-10-16T22:00:00.000Z",
"interval": "PT1H",
"metricName": "PercentageCPU",
"targetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1",
"data": [
{
"timeStamp": "2021-10-14T22:00:00Z",
"value": 123
},
{
"timeStamp": "2021-10-14T22:02:00Z",
"value": 120
},
{
"timeStamp": "2021-10-14T22:02:00Z",
"value": 88
},
{
"timeStamp": "2021-10-14T22:03:00Z",
"value": 100
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Autoscale |
Beschreibt das Format der Fehlerantwort. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Das Fehlerobjekt. |
Predictive |
Die Antwort auf eine Metrikabfrage. |
Predictive |
Stellt einen prädiktiven Metrikwert im angegebenen Bucket dar. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
AutoscaleErrorResponse
Beschreibt das Format der Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
|
systemData |
Die Systemmetadaten im Zusammenhang mit der Antwort. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Error
Das Fehlerobjekt.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Einer der vom Server definierten Fehlercodes. |
details |
string |
Eine für Menschen lesbare Darstellung der Fehlerdetails. |
message |
string |
Eine für Menschen lesbare Darstellung des Fehlers. |
target |
string |
Das Ziel des jeweiligen Fehlers. |
PredictiveResponse
Die Antwort auf eine Metrikabfrage.
Name | Typ | Beschreibung |
---|---|---|
data |
der Wert der Auflistung. |
|
interval |
string |
Das Intervall (Fenstergröße), in dem die Metrikdaten zurückgegeben wurden. Dies kann in Zukunft angepasst und von dem, was ursprünglich angefordert wurde, zurückgegeben werden. Dies ist nicht vorhanden, wenn eine Metadatenanforderung gestellt wurde. |
metricName |
string |
Die metriken, die abgefragt werden |
targetResourceId |
string |
-Ressource der Vorhersagemetrik. |
timespan |
string |
Die Zeitspanne, für die die Daten abgerufen wurden. Sein Wert besteht aus zwei datetimes verkettet, getrennt durch "/". Dies kann in Zukunft angepasst und von dem, was ursprünglich angefordert wurde, zurückgegeben werden. |
PredictiveValue
Stellt einen prädiktiven Metrikwert im angegebenen Bucket dar.
Name | Typ | Beschreibung |
---|---|---|
timeStamp |
string |
der Zeitstempel für den Metrikwert im ISO 8601-Format. |
value |
number |
Prädiktiver Wert in diesem Zeit-Bucket. |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |