Systemfunktioner i Azure Monitor-loggar
Den här artikeln beskriver hur du skriver anpassade frågor i Azure Monitor-loggar med hjälp av systemfunktioner.
Azure Backup tillhandahåller en uppsättning funktioner som kallas systemfunktioner eller lösningsfunktioner som är tillgängliga som standard på dina Log Analytics-arbetsytor (LA).
Dessa funktioner fungerar på data i de råa Azure Backup-tabellerna i LA och returnerar formaterade data som hjälper dig att enkelt hämta information om alla dina säkerhetskopieringsrelaterade entiteter med hjälp av enkla frågor. Användare kan skicka parametrar till dessa funktioner för att filtrera de data som returneras av dessa funktioner.
Vi rekommenderar att du använder systemfunktioner för att fråga dina säkerhetskopierade data på LA-arbetsytor för att skapa anpassade rapporter, eftersom de ger ett antal fördelar, enligt beskrivningen i avsnittet nedan.
Fördelar med att använda systemfunktioner
Enklare frågor: Med hjälp av funktioner kan du minska antalet kopplingar som behövs i dina frågor. Som standard returnerar funktionerna "utplattade" scheman som innehåller all information som rör entiteten (säkerhetskopieringsinstans, jobb, valv och så vidare) som efterfrågas. Om du till exempel behöver hämta en lista över lyckade säkerhetskopieringsjobb efter namnet på säkerhetskopieringsobjektet och dess associerade container, ger ett enkelt anrop till funktionen _AzureBackup_getJobs() all den här informationen för varje jobb. Å andra sidan skulle du behöva utföra flera kopplingar mellan Tabellerna AddonAzureBackupJobs och CoreAzureBackup när du kör frågor direkt mot raw-tabellerna.
Smidigare övergång från den äldre diagnostikhändelsen: Genom att använda systemfunktioner kan du smidigt övergå från den äldre diagnostikhändelsen (AzureBackupReport i AzureDiagnostics-läge) till resursspecifika händelser. Med alla systemfunktioner som tillhandahålls av Azure Backup kan du ange en parameter som gör att du kan välja om funktionen endast ska köra frågor mot data från de resursspecifika tabellerna eller fråga efter data från både den äldre tabellen och de resursspecifika tabellerna (med deduplicering av poster).
- Om du har migrerat till de resursspecifika tabellerna kan du välja att undanta den äldre tabellen från att frågas av funktionen.
- Om du för närvarande håller på att migrera och har vissa data i de äldre tabeller som du behöver för analys kan du välja att inkludera den äldre tabellen. När övergången är klar och du inte längre behöver data från den äldre tabellen kan du uppdatera värdet för parametern som skickas till funktionen i dina frågor för att undanta den äldre tabellen.
- Om du fortfarande bara använder den äldre tabellen fungerar funktionerna fortfarande om du väljer att inkludera den äldre tabellen via samma parameter. Vi rekommenderar dock att du växlar till de resursspecifika tabellerna tidigast.
Minskar risken för att anpassade frågor bryts: Om Azure Backup introducerar förbättringar av schemat för de underliggande LA-tabellerna för att hantera framtida rapporteringsscenarier uppdateras även definitionen av funktionerna för att ta hänsyn till schemaändringarna. Om du använder systemfunktioner för att skapa anpassade frågor bryts därför inte dina frågor, även om det finns ändringar i tabellernas underliggande schema.
Kommentar
Systemfunktioner underhålls av Microsoft och deras definitioner kan inte redigeras av användare. Om du behöver redigerbara funktioner kan du skapa sparade funktioner i LA.
Typer av systemfunktioner som erbjuds av Azure Backup
Kärnfunktioner: Det här är funktioner som hjälper dig att fråga någon av de viktigaste Azure Backup-entiteterna, till exempel säkerhetskopieringsinstanser, valv, principer, jobb och faktureringsentiteter. Funktionen _AzureBackup_getBackupInstances returnerar till exempel en lista över alla säkerhetskopieringsinstanser som finns i din miljö från och med den senaste slutförda dagen (i UTC). Parametrarna och det returnerade schemat för var och en av dessa kärnfunktioner sammanfattas nedan i den här artikeln.
Trendfunktioner: Det här är funktioner som returnerar historiska poster för dina säkerhetskopieringsrelaterade entiteter (till exempel säkerhetskopieringsinstanser, faktureringsgrupper) och gör att du kan få trendinformation varje dag, vecka och månad om viktiga mått (till exempel Antal, Förbrukad lagring) som hör till dessa entiteter. Parametrarna och det returnerade schemat för var och en av dessa trendfunktioner sammanfattas nedan i den här artikeln.
Kommentar
För närvarande returnerar systemfunktioner data för upp till den senaste slutförda dagen (i UTC). Data för den aktuella deldagen returneras inte. Så om du vill hämta poster för den aktuella dagen måste du använda la-tabellerna för råa.
Lista över systemfunktioner
Kärnfunktioner
_AzureBackup_GetVaults()
Den här funktionen returnerar listan över alla Recovery Services-valv i din Azure-miljö som är associerade med LA-arbetsytan.
Parameters
| Parameternamn | Beskrivning | Krävs? | Exempelvärde | Datatyp |
|---|---|---|---|---|
| RangeStart | Använd den här parametern tillsammans med Parametern RangeEnd endast om du behöver hämta alla valvrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje valv. | N | "2021-03-03 00:00:00" | Datum/tid |
| RangeEnd | Använd den här parametern tillsammans med RangeStart-parametern endast om du behöver hämta alla valvrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje valv. | N | "2021-03-10 00:00:00" | Datum/tid |
| VaultSubscriptionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning prenumerationer där säkerhetskopieringsdata finns. Om du anger en kommaavgränsad lista över prenumerations-ID:t som en parameter för den här funktionen kan du bara hämta de valv som finns i de angivna prenumerationerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla prenumerationer. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning regioner där säkerhetskopierade data finns. Om du anger en kommaavgränsad lista över regioner som en parameter för den här funktionen kan du bara hämta de valv som finns i de angivna regionerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla regioner. | N | eastus,westus |
String |
| VaultList | Använd den här parametern för att filtrera funktionens utdata för en viss uppsättning valv. Om du anger en kommaavgränsad lista över valvnamn som en parameter för den här funktionen kan du hämta poster som endast gäller de angivna valven. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla valv. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Använd den här parametern för att filtrera utdata från funktionen till poster som rör en viss valvtyp. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter både Recovery Services-valv och Backup-valv. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Använd den här parametern för att välja om du vill fråga efter data i den äldre AzureDiagnostics-tabellen eller inte. Om värdet för den här parametern är falskt frågar funktionen data från både tabellen AzureDiagnostics och de resursspecifika tabellerna. Om värdet för den här parametern är sant frågar funktionen bara efter data från de resursspecifika tabellerna. Standardvärdet är sant. | N | true | Booleskt |
Returnerade fält
| Fältnamn | Beskrivning | Datatyp |
|---|---|---|
| UniqueId | Primärnyckel som anger unikt ID för valvet | String |
| Id | Azure Resource Manager (ARM) ID för valvet | String |
| Name | Namn på valvet | String |
| SubscriptionId | ID för prenumerationen där valvet finns | String |
| Plats | Plats där valvet finns | String |
| VaultStore_StorageReplicationType | Lagringsreplikeringstyp som är associerad med valvet | String |
| Taggar | Taggar för valvet | String |
| TimeGenerated | Tidsstämpel för posten | Datum/tid |
| Typ | Typ av valv, till exempel "Microsoft.RecoveryServices/vaults" eller "Microsoft.DataProtection/backupVaults" | String |
_AzureBackup_GetPolicies()
Den här funktionen returnerar listan över säkerhetskopieringsprinciper som används i Din Azure-miljö tillsammans med detaljerad information om varje princip, till exempel datakällans typ, lagringsreplikeringstyp och så vidare.
Parameters
| Parameternamn | Beskrivning | Krävs? | Exempelvärde | Datatyp |
|---|---|---|---|---|
| RangeStart | Använd den här parametern tillsammans med parametern RangeStart endast om du behöver hämta alla principrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje princip. | N | "2021-03-03 00:00:00" | Datum/tid |
| RangeEnd | Använd den här parametern tillsammans med RangeStart-parametern endast om du behöver hämta alla principrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje princip. | N | "2021-03-10 00:00:00" | Datum/tid |
| VaultSubscriptionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning prenumerationer där säkerhetskopieringsdata finns. Om du anger en kommaavgränsad lista över prenumerations-ID:t som en parameter för den här funktionen kan du bara hämta de principer som finns i de angivna prenumerationerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla prenumerationer. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning regioner där säkerhetskopierade data finns. Om du anger en kommaavgränsad lista över regioner som en parameter för den här funktionen kan du bara hämta de principer som finns i de angivna regionerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla regioner. | N | eastus,westus |
String |
| VaultList | Använd den här parametern för att filtrera funktionens utdata för en viss uppsättning valv. Om du anger en kommaavgränsad lista över valvnamn som en parameter för den här funktionen kan du hämta poster med principer som endast gäller de angivna valven. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster med principer i alla valv. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Använd den här parametern för att filtrera utdata från funktionen till poster som rör en viss valvtyp. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter både Recovery Services-valv och Backup-valv. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Använd den här parametern för att välja om du vill fråga efter data i den äldre AzureDiagnostics-tabellen eller inte. Om värdet för den här parametern är falskt frågar funktionen data från både tabellen AzureDiagnostics och de resursspecifika tabellerna. Om värdet för den här parametern är sant frågar funktionen bara efter data från de resursspecifika tabellerna. Standardvärdet är sant. | N | true | Booleskt |
| BackupSolutionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning säkerhetskopieringslösningar som används i Din Azure-miljö. Om du till exempel anger Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM som värde för den här parametern returnerar funktionen endast poster som är relaterade till objekt som säkerhetskopieras med azure virtual machine-säkerhetskopiering, SQL i säkerhetskopiering av virtuella Azure-datorer eller DPM till Azure-säkerhetskopiering. Som standard är värdet för den här parametern *, vilket gör att funktionen returnerar poster som hör till alla säkerhetskopieringslösningar som stöds av säkerhetskopieringsrapporter (värden som stöds är "Azure Virtual Machine Backup", "SQL in Azure VM Backup", "SAP HANA in Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup" "Azure Blob Backup", "Azure Disk Backup" eller en kommaavgränsad kombination av något av dessa värden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
Returnerade fält
| Fältnamn | Beskrivning | **Datatyp** |
|---|---|---|
| UniqueId | Primärnyckel som anger unikt ID för principen | String |
| Id | Azure Resource Manager (ARM) ID för principen | String |
| Name | Namnet på principen | String |
| Tidszon | Tidszon där principen definieras | String |
| Säkerhetskopieringslösning | Säkerhetskopieringslösning som principen är associerad med. Till exempel Säkerhetskopiering av virtuella Azure-datorer, SQL i Säkerhetskopiering av virtuella Azure-datorer och så vidare. | String |
| TimeGenerated | Tidsstämpel för posten | Datetime |
| VaultUniqueId | Sekundärnyckel som refererar till valvet som är associerat med principen | String |
| VaultResourceId | Arm-ID (Azure Resource Manager) för valvet som är associerat med principen | String |
| VaultName | Namnet på valvet som är associerat med principen | String |
| VaultTags | Taggar för valvet som är associerat med principen | String |
| VaultLocation | Plats för valvet som är associerat med principen | String |
| VaultSubscriptionId | Prenumerations-ID för valvet som är associerat med principen | String |
| VaultStore_StorageReplicationType | Lagringsreplikeringstyp för valvet som är associerat med principen | String |
| VaultType | Typ av valv, till exempel "Microsoft.RecoveryServices/vaults" eller "Microsoft.DataProtection/backupVaults" | String |
| ExtendedProperties | Ytterligare egenskaper för principen | Dynamisk |
_AzureBackup_GetJobs()
Den här funktionen returnerar en lista över alla säkerhetskopierings- och återställningsrelaterade jobb som utlöstes inom ett angivet tidsintervall, tillsammans med detaljerad information om varje jobb, till exempel jobbstatus, jobbvaraktighet, överförda data och så vidare.
Parameters
| Parameternamn | Beskrivning | Krävs? | Exempelvärde | **Datatyp** |
|---|---|---|---|---|
| RangeStart | Använd den här parametern tillsammans med parametern RangeEnd för att hämta listan över alla jobb som startade under tidsperioden från RangeStart till RangeEnd. | Y | "2021-03-03 00:00:00" | Datum/tid |
| RangeEnd | Använd den här parametern tillsammans med RangeStart-parametern för att hämta listan över alla jobb som startade under tidsperioden från RangeStart till RangeEnd. | Y | "2021-03-10 00:00:00" | Datum/tid |
| VaultSubscriptionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning prenumerationer där säkerhetskopieringsdata finns. Om du anger en kommaavgränsad lista över prenumerations-ID:t som en parameter för den här funktionen kan du bara hämta de jobb som är associerade med valv i de angivna prenumerationerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla prenumerationer. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning regioner där säkerhetskopierade data finns. Om du anger en kommaavgränsad lista över regioner som en parameter för den här funktionen kan du bara hämta de jobb som är associerade med valv i de angivna regionerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla regioner. | N | eastus,westus |
String |
| VaultList | Använd den här parametern för att filtrera funktionens utdata för en viss uppsättning valv. Om du anger en kommaavgränsad lista över valvnamn som en parameter för den här funktionen kan du hämta jobb som endast gäller de angivna valven. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter jobb i alla valv. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Använd den här parametern för att filtrera utdata från funktionen till poster som rör en viss valvtyp. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter både Recovery Services-valv och Backup-valv. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Använd den här parametern för att välja om du vill fråga efter data i den äldre AzureDiagnostics-tabellen eller inte. Om värdet för den här parametern är falskt frågar funktionen data från både tabellen AzureDiagnostics och de resursspecifika tabellerna. Om värdet för den här parametern är sant frågar funktionen bara efter data från de resursspecifika tabellerna. Standardvärdet är sant. | N | true | Booleskt |
| BackupSolutionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning säkerhetskopieringslösningar som används i Din Azure-miljö. Om du till exempel anger Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM som värde för den här parametern returnerar funktionen endast poster som är relaterade till objekt som säkerhetskopieras med azure virtual machine-säkerhetskopiering, SQL i säkerhetskopiering av virtuella Azure-datorer eller DPM till Azure-säkerhetskopiering. Som standard är värdet för den här parametern *, vilket gör att funktionen returnerar poster som hör till alla säkerhetskopieringslösningar som stöds av säkerhetskopieringsrapporter (värden som stöds är "Azure Virtual Machine Backup", "SQL in Azure VM Backup", "SAP HANA in Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup" "Azure Blob Backup", "Azure Disk Backup" eller en kommaavgränsad kombination av något av dessa värden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| JobOperationList | Använd den här parametern för att filtrera funktionens utdata för en viss typ av jobb. Till exempel säkerhetskopierings- eller återställningsåtgärderna. Som standard är värdet för den här parametern "*", vilket gör att funktionen söker efter både säkerhetskopierings- och återställningsjobb. | N | "Säkerhetskopiering" | String |
| JobStatusList | Använd den här parametern för att filtrera utdata från funktionen för en specifik jobbstatus. Till exempel Slutförd, Misslyckad och så vidare. Som standard är värdet för den här parametern "*", vilket gör att funktionen söker efter alla jobb oavsett status. | N | Failed,CompletedWithWarnings |
String |
| JobFailureCodeList | Använd den här parametern för att filtrera utdata från funktionen för en specifik felkod. Som standard är värdet för den här parametern "*", vilket gör att funktionen söker efter alla jobb oavsett felkod. | N | "Lyckades" | String |
| DatasourceSetName | Använd den här parametern för att filtrera funktionens utdata till en viss överordnad resurs. Om du till exempel vill returnera SQL i säkerhetskopieringsinstanser för virtuella Azure-datorer som tillhör den virtuella datorn "testvm" anger du testvm som värde för den här parametern. Som standard är värdet "*", vilket gör att funktionen söker efter poster i alla säkerhetskopieringsinstanser. | N | "testvm" | String |
| BackupInstanceName | Använd den här parametern för att söka efter jobb på en viss säkerhetskopieringsinstans efter namn. Som standard är värdet "*", vilket gör att funktionen söker efter poster i alla säkerhetskopieringsinstanser. | N | "testvm" | String |
| ExcludeLog | Använd den här parametern för att undanta loggjobb från att returneras av funktionen (hjälper till med frågeprestanda). Som standard är värdet för den här parametern sant, vilket gör att funktionen exkluderar loggjobb. | N | true | Booleskt |
Returnerade fält
| Fältnamn | Beskrivning | **Datatyp** |
|---|---|---|
| UniqueId | Primärnyckel som anger unikt ID för jobbet | String |
| OperationCategory | Kategori för den åtgärd som utförs. Till exempel Säkerhetskopiering, Återställning | String |
| Åtgärd | Information om den åtgärd som utförs. Till exempel Logg (för loggsäkerhetskopiering) | String |
| Status | Status för jobbet. Till exempel Completed, Failed, CompletedWithWarnings | String |
| ErrorTitle | Felkod för jobbet | String |
| StartTime | Datum och tid då jobbet startade | Datum/tid |
| DurationInSecs | Varaktighet för jobbet i sekunder | Dubbel |
| DataTransferredInMBs | Data som överförs av jobbet i MBs. För närvarande stöds det här fältet endast för Recovery Services-valvarbetsbelastningar | Dubbel |
| RestoreJobRPDateTime | Datum och tid då återställningspunkten som återställs skapades. För närvarande stöds det här fältet endast för Recovery Services-valvarbetsbelastningar | Datum/tid |
| RestoreJobRPLocation | Platsen där återställningspunkten som återställs lagrades | String |
| BackupInstanceUniqueId | Sekundärnyckel som refererar till den säkerhetskopieringsinstans som är associerad med jobbet | String |
| BackupInstanceId | Azure Resource Manager -ID (ARM) för säkerhetskopieringsinstansen som är associerad med jobbet | String |
| BackupInstanceFriendlyName | Namnet på den säkerhetskopieringsinstans som är associerad med jobbet | String |
| DatasourceResourceId | Azure Resource Manager -ID (ARM) för den underliggande datakälla som är associerad med jobbet. Till exempel Azure Resource Manager -ID (ARM) för den virtuella datorn | String |
| DatasourceFriendlyName | Eget namn på den underliggande datakälla som är associerad med jobbet | String |
| DatasourceType | Typ av datakälla som är associerad med jobbet. Till exempel "Microsoft.Compute/virtualMachines" | String |
| BackupSolution | Säkerhetskopieringslösning som jobbet är associerat med. Till exempel Säkerhetskopiering av virtuella Azure-datorer, SQL i Säkerhetskopiering av virtuella Azure-datorer och så vidare. | String |
| DatasourceSetResourceId | Azure Resource Manager -ID (ARM) för den överordnade resursen för datakällan (i förekommande fall). För en SQL i Azure VM-datakälla innehåller det här fältet till exempel ARM-ID (Azure Resource Manager) för den virtuella dator där SQL Database finns | String |
| DatasourceSetType | Typ av den överordnade resursen för datakällan (i förekommande fall). För en SAP HANA i Azure VM-datakälla blir det här fältet till exempel Microsoft.Compute/virtualMachines eftersom den överordnade resursen är en virtuell Azure-dator | String |
| VaultResourceId | Azure Resource Manager -ID (ARM) för valvet som är associerat med jobbet | String |
| VaultUniqueId | Sekundärnyckel som refererar till valvet som är associerat med jobbet | String |
| VaultName | Namnet på valvet som är associerat med jobbet | String |
| VaultTags | Taggar för valvet som är associerat med jobbet | String |
| VaultSubscriptionId | Prenumerations-ID för valvet som är associerat med jobbet | String |
| VaultLocation | Plats för valvet som är associerat med jobbet | String |
| VaultStore_StorageReplicationType | Lagringsreplikeringstyp för valvet som är associerat med jobbet | String |
| VaultType | Typ av valv, till exempel "Microsoft.RecoveryServices/vaults" eller "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Tidsstämpel för posten | Datum/tid |
_AzureBackup_GetBackupInstances()
Den här funktionen returnerar listan över säkerhetskopieringsinstanser som är associerade med dina Recovery Services-valv, tillsammans med detaljerad information om varje säkerhetskopieringsinstans, till exempel förbrukning av molnlagring, tillhörande princip och så vidare.
Parameters
| Parameternamn | Beskrivning | Krävs? | Exempelvärde | **Datatyp** |
|---|---|---|---|---|
| RangeStart | Använd den här parametern tillsammans med Parametern RangeEnd endast om du behöver hämta alla säkerhetskopierade instansrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje säkerhetskopieringsinstans. | N | "2021-03-03 00:00:00" | DataTime |
| RangeEnd | Använd den här parametern tillsammans med RangeStart-parametern endast om du behöver hämta alla säkerhetskopierade instansrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje säkerhetskopieringsinstans. | N | "2021-03-10 00:00:00" | Datum/tid |
| VaultSubscriptionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning prenumerationer där säkerhetskopieringsdata finns. Om du anger en kommaavgränsad lista över prenumerations-ID:t som en parameter för den här funktionen kan du bara hämta de säkerhetskopieringsinstanser som finns i de angivna prenumerationerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla prenumerationer. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning regioner där säkerhetskopierade data finns. Om du anger en kommaavgränsad lista över regioner som en parameter för den här funktionen kan du bara hämta de säkerhetskopieringsinstanser som finns i de angivna regionerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla regioner. | N | eastus,westus |
String |
| VaultList | Använd den här parametern för att filtrera funktionens utdata för en viss uppsättning valv. Om du anger en kommaavgränsad lista över valvnamn som en parameter för den här funktionen kan du hämta poster för säkerhetskopieringsinstanser som endast gäller de angivna valven. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster för säkerhetskopieringsinstanser i alla valv. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Använd den här parametern för att filtrera utdata från funktionen till poster som rör en viss valvtyp. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter både Recovery Services-valv och Backup-valv. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Använd den här parametern för att välja om du vill fråga efter data i den äldre AzureDiagnostics-tabellen eller inte. Om värdet för den här parametern är falskt frågar funktionen data från både tabellen AzureDiagnostics och de resursspecifika tabellerna. Om värdet för den här parametern är sant frågar funktionen bara efter data från de resursspecifika tabellerna. Standardvärdet är sant. | N | true | Booleskt |
| BackupSolutionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning säkerhetskopieringslösningar som används i Din Azure-miljö. Om du till exempel anger Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM som värde för den här parametern returnerar funktionen endast poster som är relaterade till objekt som säkerhetskopieras med azure virtual machine-säkerhetskopiering, SQL i säkerhetskopiering av virtuella Azure-datorer eller DPM till Azure-säkerhetskopiering. Som standard är värdet för den här parametern *, vilket gör att funktionen returnerar poster som hör till alla säkerhetskopieringslösningar som stöds av säkerhetskopieringsrapporter (värden som stöds är "Azure Virtual Machine Backup", "SQL in Azure VM Backup", "SAP HANA in Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup" "Azure Blob Backup", "Azure Disk Backup" eller en kommaavgränsad kombination av något av dessa värden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Använd den här parametern för att välja om du bara vill inkludera de säkerhetskopieringsinstanser som är aktivt skyddade, eller inkludera de instanser för vilka skyddet har stoppats och instanser som den inledande säkerhetskopieringen väntar på. För Recovery Services-valvarbetsbelastningar är värden som stöds "Protected", "ProtectionStopped", "InitialBackupPending" eller en kommaavgränsad kombination av något av dessa värden. För Säkerhetskopieringsvalvsarbetsbelastningar är värden som stöds "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" eller en kommaavgränsad kombination av något av dessa värden. Som standard är värdet "*", vilket gör att funktionen söker efter alla säkerhetskopieringsinstanser oavsett skyddsinformation. | N | "Skyddad" | String |
| DatasourceSetName | Använd den här parametern för att filtrera funktionens utdata till en viss överordnad resurs. Om du till exempel vill returnera SQL i säkerhetskopieringsinstanser för virtuella Azure-datorer som tillhör den virtuella datorn "testvm" anger du testvm som värde för den här parametern. Som standard är värdet "*", vilket gör att funktionen söker efter poster i alla säkerhetskopieringsinstanser. | N | "testvm" | String |
| BackupInstanceName | Använd den här parametern för att söka efter en viss säkerhetskopieringsinstans efter namn. Som standard är värdet "*", vilket gör att funktionen söker efter alla säkerhetskopieringsinstanser. | N | "testvm" | String |
| DisplayAllFields | Använd den här parametern om du bara vill hämta en delmängd av fälten som returneras av funktionen. Om värdet för den här parametern är falskt eliminerar funktionen lagrings- och kvarhållningsplatsrelaterad information från funktionens utdata. Det här är användbart om du använder den här funktionen som ett mellanliggande steg i en större fråga och behöver optimera frågans prestanda genom att eliminera kolumner som du inte behöver för analys. Som standard är värdet för den här parametern sant, vilket gör att funktionen returnerar alla fält som hör till säkerhetskopieringsinstansen. | N | true | Booleskt |
Returnerade fält
| Fältnamn | Beskrivning | Datatyp |
|---|---|---|
| UniqueId | Primärnyckel som anger unikt ID för säkerhetskopieringsinstansen | String |
| Id | Azure Resource Manager (ARM) ID för säkerhetskopieringsinstansen | String |
| FriendlyName | Eget namn på säkerhetskopieringsinstansen | String |
| ProtectionInfo | Information om skyddsinställningarna för säkerhetskopieringsinstansen. Till exempel konfigureras skydd, skydd stoppas, inledande säkerhetskopiering väntar | String |
| LatestRecoveryPoint | Datum och tid för den senaste återställningspunkten som är associerad med säkerhetskopieringsinstansen. För närvarande stöds det här fältet endast för Recovery Services-valvarbetsbelastningar. | Datum/tid |
| OldestRecoveryPoint | Datum och tid för den äldsta återställningspunkten som är associerad med säkerhetskopieringsinstansen. För närvarande stöds det här fältet endast för Recovery Services-valvarbetsbelastningar. | Datum/tid |
| SourceSizeInMBs | Klientdelsstorlek för säkerhetskopieringsinstansen i MBs | Dubbel |
| VaultStore_StorageConsumptionInMBs | Total molnlagring som förbrukas av säkerhetskopieringsinstansen på valvstandardnivån | Dubbel |
| DataSourceFriendlyName | Eget namn på den datakälla som motsvarar säkerhetskopieringsinstansen | String |
| BackupSolution | Säkerhetskopieringslösning som säkerhetskopieringsinstansen är associerad med. Till exempel Säkerhetskopiering av virtuella Azure-datorer, SQL i Säkerhetskopiering av virtuella Azure-datorer och så vidare. | String |
| DatasourceType | Typ av datakälla som motsvarar säkerhetskopieringsinstansen. Till exempel "Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | Azure Resource Manager -ID (ARM) för den underliggande datakälla som motsvarar säkerhetskopieringsinstansen. Till exempel Azure Resource Manager -ID (ARM) för den virtuella datorn | String |
| DatasourceSetFriendlyName | Eget namn på den överordnade resursen för datakällan (i tillämpliga fall). För en SQL i Azure VM-datakälla innehåller det här fältet till exempel namnet på den virtuella dator där SQL Database finns | String |
| DatasourceSetFriendlyName | Eget namn på den överordnade resursen för datakällan (i tillämpliga fall). För en SQL i Azure VM-datakälla innehåller det här fältet till exempel namnet på den virtuella dator där SQL Database finns | String |
| DatasourceSetResourceId | Azure Resource Manager -ID (ARM) för den överordnade resursen för datakällan (i förekommande fall). För en SQL i Azure VM-datakälla innehåller det här fältet till exempel ARM-ID (Azure Resource Manager) för den virtuella dator där SQL Database finns | String |
| DatasourceSetType | Typ av den överordnade resursen för datakällan (i förekommande fall). För en SAP HANA i Azure VM-datakälla blir det här fältet till exempel Microsoft.Compute/virtualMachines eftersom den överordnade resursen är en virtuell Azure-dator | String |
| PolicyName | Namnet på principen som är associerad med säkerhetskopieringsinstansen | String |
| PolicyUniqueId | Sekundärnyckel som refererar till principen som är associerad med säkerhetskopieringsinstansen | String |
| PolicyId | Azure Resource Manager (ARM) ID för principen som är associerad med säkerhetskopieringsinstansen | String |
| VaultResourceId | Azure Resource Manager -ID (ARM) för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultUniqueId | Sekundärnyckel som refererar till valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultName | Namnet på valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultTags | Taggar för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultSubscriptionId | Prenumerations-ID för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultLocation | Plats för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultStore_StorageReplicationType | Lagringsreplikeringstyp för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultType | Typ av valv, som är "Microsoft.RecoveryServices/vaults" eller "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Tidsstämpel för posten | Datum/tid |
_AzureBackup_GetBillingGroups()
Den här funktionen returnerar en lista över alla säkerhetskopieringsrelaterade faktureringsentiteter (faktureringsgrupper) tillsammans med information om viktiga faktureringskomponenter som klientdelsstorlek och total molnlagring.
Parameters
| Parameternamn | Beskrivning | Krävs? | Exempelvärde | Datumtyp |
|---|---|---|---|---|
| RangeStart | Använd den här parametern tillsammans med RangeEnd-parametern endast om du behöver hämta alla faktureringsgruppsrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje faktureringsgrupp. | N | "2021-03-03 00:00:00" | Datum/tid |
| RangeEnd | Använd den här parametern tillsammans med RangeStart-parametern endast om du behöver hämta alla faktureringsgruppsrelaterade poster under tidsperioden från RangeStart till RangeEnd. Som standard är värdet för RangeStart och RangeEnd null, vilket gör att funktionen endast hämtar den senaste posten för varje faktureringsgrupp. | N | "2021-03-10 00:00:00" | Datum/tid |
| VaultSubscriptionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning prenumerationer där säkerhetskopieringsdata finns. Om du anger en kommaavgränsad lista över prenumerations-ID:t som en parameter för den här funktionen kan du bara hämta de faktureringsgrupper som finns i de angivna prenumerationerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla prenumerationer. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning regioner där säkerhetskopierade data finns. Om du anger en kommaavgränsad lista över regioner som en parameter för den här funktionen kan du bara hämta de faktureringsgrupper som finns i de angivna regionerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla regioner. | N | eastus,westus |
String |
| VaultList | Använd den här parametern för att filtrera funktionens utdata för en viss uppsättning valv. Om du anger en kommaavgränsad lista över valvnamn som en parameter för den här funktionen kan du hämta poster för säkerhetskopieringsinstanser som endast gäller de angivna valven. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster för faktureringsgrupper i alla valv. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Använd den här parametern för att filtrera utdata från funktionen till poster som rör en viss valvtyp. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter både Recovery Services-valv och Backup-valv. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Använd den här parametern för att välja om du vill fråga efter data i den äldre AzureDiagnostics-tabellen eller inte. Om värdet för den här parametern är falskt frågar funktionen data från både tabellen AzureDiagnostics och de resursspecifika tabellerna. Om värdet för den här parametern är sant frågar funktionen bara efter data från de resursspecifika tabellerna. Standardvärdet är sant. | N | true | Booleskt |
| BackupSolutionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning säkerhetskopieringslösningar som används i Din Azure-miljö. Om du till exempel anger Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM som värde för den här parametern returnerar funktionen endast poster som är relaterade till objekt som säkerhetskopieras med azure virtual machine-säkerhetskopiering, SQL i säkerhetskopiering av virtuella Azure-datorer eller DPM till Azure-säkerhetskopiering. Som standard är värdet för den här parametern *, vilket gör att funktionen returnerar poster som hör till alla säkerhetskopieringslösningar som stöds av säkerhetskopieringsrapporter (värden som stöds är "Azure Virtual Machine Backup", "SQL in Azure VM Backup", "SAP HANA in Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup" "Azure Blob Backup", "Azure Disk Backup" eller en kommaavgränsad kombination av något av dessa värden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Använd den här parametern för att söka efter en viss faktureringsgrupp efter namn. Som standard är värdet "*", vilket gör att funktionen söker efter alla faktureringsgrupper. | N | "testvm" | String |
Returnerade fält
| Fältnamn | Beskrivning | Datatyp |
|---|---|---|
| UniqueId | Primärnyckel som anger unikt ID för faktureringsgruppen | String |
| FriendlyName | Eget namn på faktureringsgruppen | String |
| Name | Namnet på faktureringsgruppen | String |
| Typ | Typ av faktureringsgrupp. Till exempel ProtectedContainer eller BackupItem | String |
| SourceSizeInMBs | Klientdelsstorlek för faktureringsgruppen i MBs | Dubbel |
| VaultStore_StorageConsumptionInMBs | Totalt molnlagring som förbrukas av faktureringsgruppen på valvstandardnivån | Dubbel |
| BackupSolution | Säkerhetskopieringslösning som faktureringsgruppen är associerad med. Till exempel Säkerhetskopiering av virtuella Azure-datorer, SQL i Säkerhetskopiering av virtuella Azure-datorer och så vidare. | String |
| VaultResourceId | Azure Resource Manager -ID (ARM) för valvet som är associerat med faktureringsgruppen | String |
| VaultUniqueId | Sekundärnyckel som refererar till valvet som är associerat med faktureringsgruppen | String |
| VaultName | Namnet på valvet som är associerat med faktureringsgruppen | String |
| VaultTags | Taggar för valvet som är associerat med faktureringsgruppen | String |
| VaultSubscriptionId | Prenumerations-ID för valvet som är associerat med faktureringsgruppen | String |
| VaultLocation | Plats för valvet som är associerat med faktureringsgruppen | String |
| VaultStore_StorageReplicationType | Lagringsreplikeringstyp för valvet som är associerat med faktureringsgruppen | String |
| VaultType | Typ av valv, till exempel "Microsoft.RecoveryServices/vaults" eller "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Tidsstämpel för posten | Datum/tid |
| ExtendedProperties | Ytterligare egenskaper för faktureringsgruppen | Dynamisk |
Trendfunktioner
_AzureBackup_GetBackupInstancesTrends()
Den här funktionen returnerar historiska poster för varje säkerhetskopieringsinstans, så att du kan visa viktiga trender varje dag, varje vecka och månad som är relaterade till antalet säkerhetskopieringsinstanser och lagringsförbrukningen på flera detaljnivåer.
Parameters
| Parameternamn | Beskrivning | Krävs? | Exempelvärde | Datatyp |
|---|---|---|---|---|
| RangeStart | Använd den här parametern tillsammans med parametern RangeEnd för att hämta alla poster relaterade till säkerhetskopieringsinstanser under tidsperioden från RangeStart till RangeEnd. | Y | "2021-03-03 00:00:00" | Datum/tid |
| RangeEnd | Använd den här parametern tillsammans med Parametern RangeStart för att hämta alla poster relaterade till säkerhetskopieringsinstanser under tidsperioden från RangeStart till RangeEnd. | Y | "2021-03-10 00:00:00" | Datum/tid |
| VaultSubscriptionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning prenumerationer där säkerhetskopieringsdata finns. Om du anger en kommaavgränsad lista över prenumerations-ID:t som en parameter för den här funktionen kan du bara hämta de säkerhetskopieringsinstanser som finns i de angivna prenumerationerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla prenumerationer. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning regioner där säkerhetskopierade data finns. Om du anger en kommaavgränsad lista över regioner som en parameter för den här funktionen kan du bara hämta de säkerhetskopieringsinstanser som finns i de angivna regionerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla regioner. | N | eastus,westus |
String |
| VaultList | Använd den här parametern för att filtrera funktionens utdata för en viss uppsättning valv. Om du anger en kommaavgränsad lista över valvnamn som en parameter för den här funktionen kan du hämta poster för säkerhetskopieringsinstanser som endast gäller de angivna valven. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster för säkerhetskopieringsinstanser i alla valv. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Använd den här parametern för att filtrera utdata från funktionen till poster som rör en viss valvtyp. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter både Recovery Services-valv och Backup-valv. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Använd den här parametern för att välja om du vill fråga efter data i den äldre AzureDiagnostics-tabellen eller inte. Om värdet för den här parametern är falskt frågar funktionen data från både tabellen AzureDiagnostics och de resursspecifika tabellerna. Om värdet för den här parametern är sant frågar funktionen bara efter data från de resursspecifika tabellerna. Standardvärdet är sant. | N | true | Booleskt |
| BackupSolutionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning säkerhetskopieringslösningar som används i Din Azure-miljö. Om du till exempel anger Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM som värde för den här parametern returnerar funktionen endast poster som är relaterade till objekt som säkerhetskopieras med azure virtual machine-säkerhetskopiering, SQL i säkerhetskopiering av virtuella Azure-datorer eller DPM till Azure-säkerhetskopiering. Som standard är värdet för den här parametern *, vilket gör att funktionen returnerar poster som hör till alla säkerhetskopieringslösningar som stöds av säkerhetskopieringsrapporter (värden som stöds är "Azure Virtual Machine Backup", "SQL in Azure VM Backup", "SAP HANA in Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup" "Azure Blob Backup", "Azure Disk Backup" eller en kommaavgränsad kombination av något av dessa värden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Använd den här parametern för att välja om du bara vill inkludera de säkerhetskopieringsinstanser som är aktivt skyddade, eller inkludera de instanser för vilka skyddet har stoppats och instanser som den inledande säkerhetskopieringen väntar på. För Recovery Services-valvarbetsbelastningar är värden som stöds "Protected", "ProtectionStopped", "InitialBackupPending" eller en kommaavgränsad kombination av något av dessa värden. För Säkerhetskopieringsvalvsarbetsbelastningar är värden som stöds "Protected", "ConfiguringProtection", "ConfiguringProtectionFailed", "UpdatingProtection", "ProtectionError", "ProtectionStopped" eller en kommaavgränsad kombination av något av dessa värden. Som standard är värdet "*", vilket gör att funktionen söker efter alla säkerhetskopieringsinstanser oavsett skyddsinformation. | N | "Skyddad" | String |
| DatasourceSetName | Använd den här parametern för att filtrera funktionens utdata till en viss överordnad resurs. Om du till exempel vill returnera SQL i säkerhetskopieringsinstanser för virtuella Azure-datorer som tillhör den virtuella datorn "testvm" anger du testvm som värde för den här parametern. Som standard är värdet "*", vilket gör att funktionen söker efter poster i alla säkerhetskopieringsinstanser. | N | "testvm" | String |
| BackupInstanceName | Använd den här parametern för att söka efter en viss säkerhetskopieringsinstans efter namn. Som standard är värdet "*", vilket gör att funktionen söker efter alla säkerhetskopieringsinstanser. | N | "testvm" | String |
| DisplayAllFields | Använd den här parametern om du bara vill hämta en delmängd av fälten som returneras av funktionen. Om värdet för den här parametern är falskt eliminerar funktionen lagrings- och kvarhållningsplatsrelaterad information från funktionens utdata. Det här är användbart om du använder den här funktionen som ett mellanliggande steg i en större fråga och behöver optimera frågans prestanda genom att eliminera kolumner som du inte behöver för analys. Som standard är värdet för den här parametern sant, vilket gör att funktionen returnerar alla fält som hör till säkerhetskopieringsinstansen. | N | true | Booleskt |
| AggregationType | Använd den här parametern för att ange den tidskornighet då data ska hämtas. Om värdet för den här parametern är "Daily" returnerar funktionen en post per säkerhetskopieringsinstans per dag, så att du kan analysera dagliga trender för lagringsförbrukning och antal säkerhetskopierade instanser. Om värdet för den här parametern är "Weekly" returnerar funktionen en post per säkerhetskopieringsinstans per vecka, så att du kan analysera trender varje vecka. På samma sätt kan du ange "Månadsvis" för att analysera månatliga trender. Standardvärdet är "Daily". Om du visar data över större tidsintervall rekommenderar vi att du använder "Weekly" eller "Monthly" för bättre frågeprestanda och enkel trendanalys. | N | "Varje vecka" | String |
Returnerade fält
| Fältnamn | Beskrivning | Datatyp |
|---|---|---|
| UniqueId | Primärnyckel som anger unikt ID för säkerhetskopieringsinstansen | String |
| Id | Azure Resource Manager (ARM) ID för säkerhetskopieringsinstansen | String |
| FriendlyName | Eget namn på säkerhetskopieringsinstansen | String |
| ProtectionInfo | Information om skyddsinställningarna för säkerhetskopieringsinstansen. Till exempel konfigureras skydd, skydd stoppas, inledande säkerhetskopiering väntar | String |
| LatestRecoveryPoint | Datum och tid för den senaste återställningspunkten som är associerad med säkerhetskopieringsinstansen. För närvarande stöds det här fältet endast för Recovery Services-valvarbetsbelastningar | Datum/tid |
| OldestRecoveryPoint | Datum och tid för den äldsta återställningspunkten som är associerad med säkerhetskopieringsinstansen | För närvarande stöds det här fältet endast för Recovery Services-valvarbetsbelastningar |
| SourceSizeInMBs | Klientdelsstorlek för säkerhetskopieringsinstansen i MBs | Dubbel |
| VaultStore_StorageConsumptionInMBs | Total molnlagring som förbrukas av säkerhetskopieringsinstansen på valvstandardnivån | Dubbel |
| DataSourceFriendlyName | Eget namn på den datakälla som motsvarar säkerhetskopieringsinstansen | String |
| BackupSolution | Säkerhetskopieringslösning som säkerhetskopieringsinstansen är associerad med. Till exempel Säkerhetskopiering av virtuella Azure-datorer, SQL i Säkerhetskopiering av virtuella Azure-datorer och så vidare. | String |
| DatasourceType | Typ av datakälla som motsvarar säkerhetskopieringsinstansen. Till exempel "Microsoft.Compute/virtualMachines" | String |
| DatasourceResourceId | Azure Resource Manager -ID (ARM) för den underliggande datakälla som motsvarar säkerhetskopieringsinstansen. Till exempel Azure Resource Manager -ID (ARM) för den virtuella datorn | String |
| DatasourceSetFriendlyName | Eget namn på den överordnade resursen för datakällan (i tillämpliga fall). För en SQL i Azure VM-datakälla innehåller det här fältet till exempel namnet på den virtuella dator där SQL Database finns | String |
| DatasourceSetResourceId | Azure Resource Manager -ID (ARM) för den överordnade resursen för datakällan (i förekommande fall). För en SQL i Azure VM-datakälla innehåller det här fältet till exempel ARM-ID (Azure Resource Manager) för den virtuella dator där SQL Database finns | String |
| DatasourceSetType | Typ av den överordnade resursen för datakällan (i förekommande fall). För en SAP HANA i Azure VM-datakälla blir det här fältet till exempel Microsoft.Compute/virtualMachines eftersom den överordnade resursen är en virtuell Azure-dator | String |
| PolicyName | Namnet på principen som är associerad med säkerhetskopieringsinstansen | String |
| PolicyUniqueId | Sekundärnyckel som refererar till principen som är associerad med säkerhetskopieringsinstansen | String |
| PolicyId | Azure Resource Manager (ARM) ID för principen som är associerad med säkerhetskopieringsinstansen | String |
| VaultResourceId | Azure Resource Manager -ID (ARM) för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultUniqueId | Sekundärnyckel som refererar till valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultName | Namnet på valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultTags | Taggar för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultSubscriptionId | Prenumerations-ID för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultLocation | Plats för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultStore_StorageReplicationType | Lagringsreplikeringstyp för valvet som är associerat med säkerhetskopieringsinstansen | String |
| VaultType | Typ av valv, till exempel "Microsoft.RecoveryServices/vaults" eller "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Tidsstämpel för posten | Datum/tid |
_AzureBackup_GetBillingGroupsTrends()
Den här funktionen returnerar historiska poster för varje faktureringsentitet, så att du kan visa viktiga trender varje dag, varje vecka och varje månad som är relaterade till klientdelsstorlek och lagringsförbrukning, på flera detaljnivåer.
Parameters
| Parameternamn | Beskrivning | Krävs? | Exempelvärde | Datatyp |
|---|---|---|---|---|
| RangeStart | Använd den här parametern tillsammans med parametern RangeEnd för att hämta alla faktureringsgruppsrelaterade poster under tidsperioden från RangeStart till RangeEnd. | Y | "2021-03-03 00:00:00" | Datum/tid |
| RangeEnd | Använd den här parametern tillsammans med RangeStart-parametern för att hämta alla faktureringsgruppsrelaterade poster under tidsperioden från RangeStart till RangeEnd. | Y | "2021-03-10 00:00:00" | Datum/tid |
| VaultSubscriptionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning prenumerationer där säkerhetskopieringsdata finns. Om du anger en kommaavgränsad lista över prenumerations-ID:t som en parameter för den här funktionen kan du bara hämta de faktureringsgrupper som finns i de angivna prenumerationerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla prenumerationer. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning regioner där säkerhetskopierade data finns. Om du anger en kommaavgränsad lista över regioner som en parameter för den här funktionen kan du bara hämta de faktureringsgrupper som finns i de angivna regionerna. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster i alla regioner. | N | eastus,westus |
String |
| VaultList | Använd den här parametern för att filtrera funktionens utdata för en viss uppsättning valv. Om du anger en kommaavgränsad lista över valvnamn som en parameter för den här funktionen kan du hämta poster för säkerhetskopieringsinstanser som endast gäller de angivna valven. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter poster för faktureringsgrupper i alla valv. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Använd den här parametern för att filtrera utdata från funktionen till poster som rör en viss valvtyp. Som standard är värdet för den här parametern *, vilket gör att funktionen söker efter både Recovery Services-valv och Backup-valv. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Använd den här parametern för att välja om du vill fråga efter data i den äldre AzureDiagnostics-tabellen eller inte. Om värdet för den här parametern är falskt frågar funktionen data från både tabellen AzureDiagnostics och de resursspecifika tabellerna. Om värdet för den här parametern är sant frågar funktionen bara efter data från de resursspecifika tabellerna. Standardvärdet är sant. | N | true | Booleskt |
| BackupSolutionList | Använd den här parametern för att filtrera utdata från funktionen för en viss uppsättning säkerhetskopieringslösningar som används i Din Azure-miljö. Om du till exempel anger Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM som värde för den här parametern returnerar funktionen endast poster som är relaterade till objekt som säkerhetskopieras med azure virtual machine-säkerhetskopiering, SQL i säkerhetskopiering av virtuella Azure-datorer eller DPM till Azure-säkerhetskopiering. Som standard är värdet för den här parametern *, vilket gör att funktionen returnerar poster som hör till alla säkerhetskopieringslösningar som stöds av säkerhetskopieringsrapporter (värden som stöds är "Azure Virtual Machine Backup", "SQL in Azure VM Backup", "SAP HANA in Azure VM Backup", "Azure Storage (Azure Files) Backup", "Azure Backup Agent", "DPM", "Azure Backup Server", "Azure Database for PostgreSQL Server Backup" "Azure Blob Backup", "Azure Disk Backup" eller en kommaavgränsad kombination av något av dessa värden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Använd den här parametern för att söka efter en viss faktureringsgrupp efter namn. Som standard är värdet "*", vilket gör att funktionen söker efter alla faktureringsgrupper. | N | "testvm" | String |
| AggregationType | Använd den här parametern för att ange den tidskornighet då data ska hämtas. Om värdet för den här parametern är "Daily" returnerar funktionen en post per faktureringsgrupp per dag, så att du kan analysera dagliga trender för lagringsförbrukning och klientdelsstorlek. Om värdet för den här parametern är "Weekly" returnerar funktionen en post per säkerhetskopieringsinstans per vecka, så att du kan analysera trender varje vecka. På samma sätt kan du ange "Månadsvis" för att analysera månatliga trender. Standardvärdet är "Daily". Om du visar data över större tidsintervall rekommenderar vi att du använder "Weekly" eller "Monthly" för bättre frågeprestanda och enkel trendanalys. | N | "Varje vecka" | String |
Returnerade fält
| Fältnamn | Beskrivning | Datatyp |
|---|---|---|
| UniqueId | Primärnyckel som anger unikt ID för faktureringsgruppen | String |
| FriendlyName | Eget namn på faktureringsgruppen | String |
| Name | Namnet på faktureringsgruppen | String |
| Typ | Typ av faktureringsgrupp. Till exempel ProtectedContainer eller BackupItem | String |
| SourceSizeInMBs | Klientdelsstorlek för faktureringsgruppen i MBs | Dubbel |
| VaultStore_StorageConsumptionInMBs | Totalt molnlagring som förbrukas av faktureringsgruppen på valvstandardnivån | Dubbel |
| BackupSolution | Säkerhetskopieringslösning som faktureringsgruppen är associerad med. Till exempel Säkerhetskopiering av virtuella Azure-datorer, SQL i Säkerhetskopiering av virtuella Azure-datorer och så vidare. | String |
| VaultResourceId | Azure Resource Manager -ID (ARM) för valvet som är associerat med faktureringsgruppen | String |
| VaultUniqueId | Sekundärnyckel som refererar till valvet som är associerat med faktureringsgruppen | String |
| VaultName | Namnet på valvet som är associerat med faktureringsgruppen | String |
| VaultTags | Taggar för valvet som är associerat med faktureringsgruppen | String |
| VaultSubscriptionId | Prenumerations-ID för valvet som är associerat med faktureringsgruppen | String |
| VaultLocation | Plats för valvet som är associerat med faktureringsgruppen | String |
| VaultStore_StorageReplicationType | Lagringsreplikeringstyp för valvet som är associerat med faktureringsgruppen | String |
| VaultType | Typ av valv, till exempel "Microsoft.RecoveryServices/vaults" eller "Microsoft.DataProtection/backupVaults" | String |
| TimeGenerated | Tidsstämpel för posten | Datum/tid |
| ExtendedProperties | Ytterligare egenskaper för faktureringsgruppen | Dynamisk |
Exempelfrågor
Nedan visas några exempelfrågor som hjälper dig att komma igång med att använda systemfunktioner.
Alla misslyckade säkerhetskopieringsjobb för virtuella Azure-datorer inom ett angivet tidsintervall
_AzureBackup_GetJobs("2021-03-05", "2021-03-06") //call function with RangeStart and RangeEnd parameters set, and other parameters with default value | where BackupSolution=="Azure Virtual Machine Backup" and Status=="Failed" | project BackupInstanceFriendlyName, BackupInstanceId, OperationCategory, Status, JobStartDateTime=StartTime, JobDuration=DurationInSecs/3600, ErrorTitle, DataTransferred=DataTransferredInMBsAlla SQL-loggsäkerhetskopieringsjobb inom ett angivet tidsintervall
_AzureBackup_GetJobs("2021-03-05", "2021-03-06","*","*","*","*",true,"*","*","*","*","*","*",false) //call function with RangeStart and RangeEnd parameters set, ExcludeLog parameter as false, and other parameters with default value | where BackupSolution=="SQL in Azure VM Backup" and Operation=="Log" | project BackupInstanceFriendlyName, BackupInstanceId, OperationCategory, Status, JobStartDateTime=StartTime, JobDuration=DurationInSecs/3600, ErrorTitle, DataTransferred=DataTransferredInMBsVeckotrend för säkerhetskopieringslagring som förbrukas för den virtuella datorn "testvm"
_AzureBackup_GetBackupInstancesTrends("2021-01-01", "2021-03-06","*","*","*","*",false,"*","*","*","*",true, "Weekly") //call function with RangeStart and RangeEnd parameters set, AggregationType parameter as Weekly, and other parameters with default value | where BackupSolution == "Azure Virtual Machine Backup" | where FriendlyName == "testvm" | project TimeGenerated, VaultStore_StorageConsumptionInMBs | render timechart