Systeemfuncties voor Azure Backup
In dit artikel wordt beschreven hoe u aangepaste query's schrijft in Azure Monitor-logboeken met behulp van systeemfuncties.
Azure Backup biedt een set functies, systeemfuncties of oplossingsfuncties die standaard beschikbaar zijn in uw Log Analytics-werkruimten (LA).
Deze functies werken op gegevens in de onbewerkte Azure Backup-tabellen in LA en retourneren opgemaakte gegevens waarmee u eenvoudig informatie kunt ophalen van al uw back-upgerelateerde entiteiten, met behulp van eenvoudige query's. Gebruikers kunnen parameters doorgeven aan deze functies om de gegevens te filteren die door deze functies worden geretourneerd.
U wordt aangeraden systeemfuncties te gebruiken voor het opvragen van uw back-upgegevens in LA-werkruimten voor het maken van aangepaste rapporten, omdat ze een aantal voordelen bieden, zoals beschreven in de onderstaande sectie.
Voordelen van het gebruik van systeemfuncties
Eenvoudigere query's: Met behulp van functies kunt u het aantal joins verminderen dat nodig is in uw query's. De functies retourneren standaard 'platgemaakte' schema's die alle informatie bevatten die betrekking heeft op de entiteit (back-upexemplaar, taak, kluis enzovoort) die worden opgevraagd. Als u bijvoorbeeld een lijst met geslaagde back-uptaken wilt ophalen op basis van de naam van het back-upitem en de bijbehorende container, geeft een eenvoudige aanroep van de functie _AzureBackup_getJobs() u al deze informatie voor elke taak. Als u echter rechtstreeks query's uitvoert op de onbewerkte tabellen, moet u meerdere joins uitvoeren tussen addonAzureBackupJobs en CoreAzureBackup-tabellen .
Soepelere overgang van de verouderde diagnostische gebeurtenis: met behulp van systeemfuncties kunt u soepel overstappen van de verouderde diagnostische gebeurtenis (AzureBackupReport in de modus AzureDiagnostics) naar de resourcespecifieke gebeurtenissen. Met alle systeemfuncties van Azure Backup kunt u een parameter opgeven waarmee u kunt kiezen of de functie alleen query's moet uitvoeren op gegevens uit de resourcespecifieke tabellen of gegevens uit zowel de verouderde tabel als de resourcespecifieke tabellen (met ontdubbeling van records).
- Als u bent gemigreerd naar de resourcespecifieke tabellen, kunt u ervoor kiezen om de verouderde tabel uit te sluiten van query's door de functie.
- Als u momenteel bezig bent met migratie en bepaalde gegevens in de verouderde tabellen hebt die u nodig hebt voor analyse, kunt u ervoor kiezen om de verouderde tabel op te nemen. Wanneer de overgang is voltooid en u geen gegevens meer nodig hebt uit de verouderde tabel, kunt u de waarde van de parameter die is doorgegeven aan de functie in uw query's bijwerken om de verouderde tabel uit te sluiten.
- Als u nog steeds alleen de verouderde tabel gebruikt, werken de functies nog steeds als u ervoor kiest om de verouderde tabel op te nemen via dezelfde parameter. Het is echter raadzaam om op het eerste moment over te schakelen naar de resourcespecifieke tabellen .
Vermindert de mogelijkheid dat aangepaste query's fouten veroorzaken: als Azure Backup verbeteringen introduceert in het schema van de onderliggende LA-tabellen om toekomstige rapportagescenario's mogelijk te maken, wordt de definitie van de functies ook bijgewerkt om rekening te houden met de schemawijzigingen. Als u systeemfuncties gebruikt voor het maken van aangepaste query's, worden uw query's dus niet verbroken, zelfs niet als er wijzigingen zijn in het onderliggende schema van de tabellen.
Notitie
Systeemfuncties worden onderhouden door Microsoft en hun definities kunnen niet door gebruikers worden bewerkt. Als u bewerkbare functies nodig hebt, kunt u opgeslagen functies maken in LA.
Typen systeemfuncties die worden aangeboden door Azure Backup
Kernfuncties: dit zijn functies waarmee u query's kunt uitvoeren op een van de belangrijkste Azure Backup-entiteiten, zoals back-upexemplaren, kluizen, beleid, taken en factureringsentiteiten. De functie _AzureBackup_getBackupInstances retourneert bijvoorbeeld een lijst met alle back-upexemplaren die in uw omgeving bestaan vanaf de laatste voltooide dag (in UTC). De parameters en het geretourneerde schema voor elk van deze kernfuncties worden hieronder in dit artikel samengevat.
Trendfuncties: dit zijn functies die historische records retourneren voor uw back-upgerelateerde entiteiten (bijvoorbeeld back-upexemplaren, factureringsgroepen) en waarmee u dagelijkse, wekelijkse en maandelijkse trendinformatie kunt ophalen over belangrijke metrische gegevens (bijvoorbeeld Aantal, Verbruikte opslag) die betrekking hebben op deze entiteiten. De parameters en het geretourneerde schema voor elk van deze trendfuncties worden hieronder in dit artikel samengevat.
Notitie
Op dit moment retourneren systeemfuncties gegevens voor de laatste voltooide dag (in UTC). Gegevens voor de huidige gedeeltelijke dag worden niet geretourneerd. Dus als u records voor de huidige dag wilt ophalen, moet u de onbewerkte LA-tabellen gebruiken.
Lijst met systeemfuncties
Kernfuncties
_AzureBackup_GetVaults()
Deze functie retourneert de lijst met alle Recovery Services-kluizen in uw Azure-omgeving die zijn gekoppeld aan de LA-werkruimte.
Parameters
| Parameternaam | Beschrijving | Vereist?: | Voorbeeldwaarde | Gegevenstype |
|---|---|---|---|---|
| RangeStart | Gebruik deze parameter samen met de parameter RangeEnd alleen als u alle kluisgerelateerde records in de periode wilt ophalen van RangeStart naar RangeEnd. De waarde van RangeStart en RangeEnd is standaard null, waardoor de functie alleen de meest recente record voor elke kluis ophaalt. | N | "2021-03-03 00:00:00" | Datum en tijd |
| RangeEnd | Gebruik deze parameter samen met de parameter RangeStart alleen als u alle kluisgerelateerde records in de periode wilt ophalen van RangeStart naar RangeEnd. De waarde van RangeStart en RangeEnd is standaard null, waardoor de functie alleen de meest recente record voor elke kluis ophaalt. | N | "2021-03-10 00:00:00" | Datum en tijd |
| VaultSubscriptionList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set abonnementen waarin back-upgegevens bestaan. Als u een door komma's gescheiden lijst met abonnements-id's opgeeft als parameter voor deze functie, kunt u alleen de kluizen ophalen die zich in de opgegeven abonnementen bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle abonnementen zoekt. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set regio's waar back-upgegevens bestaan. Als u een door komma's gescheiden lijst met regio's opgeeft als parameter voor deze functie, kunt u alleen kluizen ophalen die zich in de opgegeven regio's bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle regio's zoekt. | N | eastus,westus |
String |
| VaultList | Gebruik deze parameter om de uitvoer van de functie voor een bepaalde set kluizen te filteren. Als u een door komma's gescheiden lijst met kluisnamen opgeeft als parameter voor deze functie, kunt u records ophalen die alleen betrekking hebben op de opgegeven kluizen. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle kluizen zoekt. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Gebruik deze parameter om de uitvoer van de functie te filteren op records die betrekking hebben op een bepaald kluistype. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar zowel Recovery Services-kluizen als Backup-kluizen. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Gebruik deze parameter om te kiezen of u een query wilt uitvoeren op gegevens in de verouderde AzureDiagnostics-tabel of niet. Als de waarde van deze parameter onwaar is, worden met de functie gegevens opgevraagd uit zowel de tabel AzureDiagnostics als de resourcespecifieke tabellen. Als de waarde van deze parameter waar is, vraagt de functie alleen gegevens uit de resourcespecifieke tabellen op. De standaardwaarde is true. | N | true | Booleaanse waarde |
Geretourneerde velden
| Veldnaam | Beschrijving | Gegevenstype |
|---|---|---|
| UniqueId | Primaire sleutel die een unieke id van de kluis aangeeft | String |
| ID | ARM-id (Azure Resource Manager) van de kluis | String |
| Naam | Naam van de kluis | String |
| SubscriptionId | Id van het abonnement waarin de kluis bestaat | String |
| Locatie | Locatie waarin de kluis bestaat | String |
| VaultStore_StorageReplicationType | Opslagreplicatietype dat is gekoppeld aan de kluis | String |
| Tags | Tags van de kluis | String |
| TimeGenerated | Tijdstempel van de record | Datum en tijd |
| Type | Type kluis, bijvoorbeeld 'Microsoft.RecoveryServices/vaults' of 'Microsoft.DataProtection/backupVaults' | String |
_AzureBackup_GetPolicies()
Deze functie retourneert de lijst met back-upbeleidsregels die worden gebruikt in uw Azure-omgeving, samen met gedetailleerde informatie over elk beleid, zoals het gegevensbrontype, het opslagreplicatietype, enzovoort.
Parameters
| Parameternaam | Beschrijving | Vereist?: | Voorbeeldwaarde | Gegevenstype |
|---|---|---|---|---|
| RangeStart | Gebruik deze parameter samen met de parameter RangeStart alleen als u alle beleidsgerelateerde records in de periode van RangeStart naar RangeEnd moet ophalen. Standaard is de waarde van RangeStart en RangeEnd null, waardoor de functie alleen de meest recente record voor elk beleid ophaalt. | N | "2021-03-03 00:00:00" | Datum en tijd |
| RangeEnd | Gebruik deze parameter samen met de parameter RangeStart alleen als u alle beleidsgerelateerde records in de periode van RangeStart naar RangeEnd wilt ophalen. Standaard is de waarde van RangeStart en RangeEnd null, waardoor de functie alleen de meest recente record voor elk beleid ophaalt. | N | "2021-03-10 00:00:00" | Datum en tijd |
| VaultSubscriptionList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set abonnementen waarin back-upgegevens bestaan. Als u een door komma's gescheiden lijst met abonnements-id's opgeeft als parameter voor deze functie, kunt u alleen beleidsregels ophalen die zich in de opgegeven abonnementen bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle abonnementen zoekt. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set regio's waar back-upgegevens bestaan. Als u een door komma's gescheiden lijst met regio's opgeeft als parameter voor deze functie, kunt u alleen beleidsregels ophalen die zich in de opgegeven regio's bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle regio's zoekt. | N | eastus,westus |
String |
| VaultList | Gebruik deze parameter om de uitvoer van de functie voor een bepaalde set kluizen te filteren. Als u een door komma's gescheiden lijst met kluisnamen opgeeft als parameter voor deze functie, kunt u records van beleidsregels ophalen die alleen betrekking hebben op de opgegeven kluizen. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar records van beleidsregels in alle kluizen. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Gebruik deze parameter om de uitvoer van de functie te filteren op records die betrekking hebben op een bepaald kluistype. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar zowel Recovery Services-kluizen als Backup-kluizen. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Gebruik deze parameter om te kiezen of u een query wilt uitvoeren op gegevens in de verouderde AzureDiagnostics-tabel of niet. Als de waarde van deze parameter onwaar is, worden met de functie gegevens opgevraagd uit zowel de tabel AzureDiagnostics als de resourcespecifieke tabellen. Als de waarde van deze parameter waar is, vraagt de functie alleen gegevens uit de resourcespecifieke tabellen op. De standaardwaarde is true. | N | true | Booleaanse waarde |
| BackupSolutionList | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde set back-upoplossingen die worden gebruikt in uw Azure-omgeving. Als u bijvoorbeeld opgeeft als de waarde van deze parameter, retourneert Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM de functie alleen records die zijn gerelateerd aan items waarvan een back-up is gemaakt met behulp van back-ups van virtuele Azure-machines, SQL in Azure VM-back-up of DPM naar Azure Backup. De waarde van deze parameter is standaard *, waardoor de functie records retourneert die betrekking hebben op alle back-upoplossingen die worden ondersteund door Back-uprapporten (ondersteunde waarden zijn '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' of een door komma's gescheiden combinatie van een van deze waarden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
Geretourneerde velden
| Veldnaam | Beschrijving | **Gegevenstype ** |
|---|---|---|
| UniqueId | Primaire sleutel die een unieke id van het beleid aangeeft | String |
| ID | ARM-id (Azure Resource Manager) van het beleid | String |
| Naam | Naam van het beleid | String |
| TimeZone | Tijdzone waarin het beleid is gedefinieerd | String |
| Back-upoplossing | Back-upoplossing waaraan het beleid is gekoppeld. Bijvoorbeeld Azure VM Backup, SQL in Azure VM Backup, enzovoort. | String |
| TimeGenerated | Tijdstempel van de record | Datum/tijd |
| VaultUniqueId | Refererende sleutel die verwijst naar de kluis die is gekoppeld aan het beleid | String |
| VaultResourceId | ARM-id (Azure Resource Manager) van de kluis die is gekoppeld aan het beleid | String |
| VaultName | Naam van de kluis die is gekoppeld aan het beleid | String |
| VaultTags | Tags van de kluis die is gekoppeld aan het beleid | String |
| VaultLocation | Locatie van de kluis die is gekoppeld aan het beleid | String |
| VaultSubscriptionId | Abonnements-id van de kluis die is gekoppeld aan het beleid | String |
| VaultStore_StorageReplicationType | Opslagreplicatietype van de kluis die is gekoppeld aan het beleid | String |
| VaultType | Type kluis, bijvoorbeeld 'Microsoft.RecoveryServices/vaults' of 'Microsoft.DataProtection/backupVaults' | String |
| ExtendedProperties | Aanvullende eigenschappen van het beleid | Dynamisch |
_AzureBackup_GetJobs()
Deze functie retourneert een lijst met alle gerelateerde back-up- en hersteltaken die zijn geactiveerd in een opgegeven tijdsbereik, samen met gedetailleerde informatie over elke taak, zoals taakstatus, taakduur, overgedragen gegevens, enzovoort.
Parameters
| Parameternaam | Beschrijving | Vereist?: | Voorbeeldwaarde | **Gegevenstype ** |
|---|---|---|---|---|
| RangeStart | Gebruik deze parameter samen met de parameter RangeEnd om de lijst met alle taken op te halen die in de periode zijn gestart van RangeStart naar RangeEnd. | J | "2021-03-03 00:00:00" | Datum en tijd |
| RangeEnd | Gebruik deze parameter samen met de parameter RangeStart om de lijst met alle taken op te halen die in de periode zijn gestart van RangeStart naar RangeEnd. | J | "2021-03-10 00:00:00" | Datum en tijd |
| VaultSubscriptionList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set abonnementen waarin back-upgegevens bestaan. Als u een door komma's gescheiden lijst met abonnements-id's opgeeft als parameter voor deze functie, kunt u alleen taken ophalen die zijn gekoppeld aan kluizen in de opgegeven abonnementen. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle abonnementen zoekt. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set regio's waar back-upgegevens bestaan. Als u een door komma's gescheiden lijst met regio's opgeeft als parameter voor deze functie, kunt u alleen taken ophalen die zijn gekoppeld aan kluizen in de opgegeven regio's. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle regio's zoekt. | N | eastus,westus |
String |
| VaultList | Gebruik deze parameter om de uitvoer van de functie voor een bepaalde set kluizen te filteren. Door een door komma's gescheiden lijst met kluisnamen op te geven als parameter voor deze functie, kunt u taken ophalen die alleen betrekking hebben op de opgegeven kluizen. De waarde van deze parameter is standaard '*', waardoor de functie in alle kluizen naar taken zoekt. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Gebruik deze parameter om de uitvoer van de functie te filteren op records die betrekking hebben op een bepaald kluistype. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar zowel Recovery Services-kluizen als Backup-kluizen. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Gebruik deze parameter om te kiezen of u een query wilt uitvoeren op gegevens in de verouderde AzureDiagnostics-tabel of niet. Als de waarde van deze parameter onwaar is, worden met de functie gegevens opgevraagd uit zowel de tabel AzureDiagnostics als de resourcespecifieke tabellen. Als de waarde van deze parameter waar is, vraagt de functie alleen gegevens uit de resourcespecifieke tabellen op. De standaardwaarde is true. | N | true | Booleaanse waarde |
| BackupSolutionList | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde set back-upoplossingen die worden gebruikt in uw Azure-omgeving. Als u bijvoorbeeld opgeeft als de waarde van deze parameter, retourneert Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM de functie alleen records die zijn gerelateerd aan items waarvan een back-up is gemaakt met behulp van back-ups van virtuele Azure-machines, SQL in Azure VM-back-up of DPM naar Azure Backup. De waarde van deze parameter is standaard *, waardoor de functie records retourneert die betrekking hebben op alle back-upoplossingen die worden ondersteund door Back-uprapporten (ondersteunde waarden zijn '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' of een door komma's gescheiden combinatie van een van deze waarden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| JobOperationList | Gebruik deze parameter om de uitvoer van de functie voor een specifiek type taak te filteren. Bijvoorbeeld de back-up- of herstelbewerkingen. Standaard is de waarde van deze parameter '*', waardoor de functie zowel back-up- als hersteltaken zoekt. | N | "Back-up" | String |
| JobStatusList | Gebruik deze parameter om de uitvoer van de functie te filteren op een specifieke taakstatus. Bijvoorbeeld Voltooid, Mislukt, enzovoort. Standaard is de waarde van deze parameter '*', waardoor de functie naar alle taken zoekt, ongeacht de status. | N | Failed,CompletedWithWarnings |
String |
| JobFailureCodeList | Gebruik deze parameter om de uitvoer van de functie te filteren op een specifieke foutcode. Standaard is de waarde van deze parameter '*', waardoor de functie naar alle taken zoekt, ongeacht foutcode. | N | "Geslaagd" | String |
| DatasourceSetName | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde bovenliggende resource. Als u bijvoorbeeld SQL wilt retourneren in Azure VM-back-upexemplaren die behoren tot de virtuele machine 'testvm', geeft u testvm op als de waarde van deze parameter. Standaard is de waarde '*', waardoor de functie naar records zoekt in alle back-upexemplaren. | N | "testvm" | String |
| BackupInstanceName | Gebruik deze parameter om op naam te zoeken naar taken op een bepaald back-upexemplaren. Standaard is de waarde '*', waardoor de functie naar records zoekt in alle back-upexemplaren. | N | "testvm" | String |
| ExcludeLog | Gebruik deze parameter om logboektaken uit te sluiten van de functie (helpt bij queryprestaties). De waarde van deze parameter is standaard waar, waardoor de functie logboektaken uitsluit. | N | true | Booleaanse waarde |
Geretourneerde velden
| Veldnaam | Beschrijving | **Gegevenstype ** |
|---|---|---|
| UniqueId | Primaire sleutel die een unieke id van de taak aangeeft | String |
| OperationCategory | Categorie van de bewerking die wordt uitgevoerd. Bijvoorbeeld back-up, herstellen | String |
| Operation | Details van de bewerking die wordt uitgevoerd. Bijvoorbeeld Logboek (voor logboekback-up) | String |
| Status | Status van de taak. Bijvoorbeeld Voltooid, Mislukt, CompletedWithWarnings | String |
| ErrorTitle | Foutcode van de taak | String |
| StartTime | Datum en tijd waarop de taak is gestart | Datum en tijd |
| DurationInSecs | Duur van de taak in seconden | Dubbel |
| DataTransferredInMBs | Gegevens die door de taak in MB's worden overgedragen. Dit veld wordt momenteel alleen ondersteund voor Recovery Services-kluisworkloads | Dubbel |
| RestoreJobRPDateTime | De datum en tijd waarop het herstelpunt dat wordt hersteld, is gemaakt. Dit veld wordt momenteel alleen ondersteund voor Recovery Services-kluisworkloads | Datum en tijd |
| RestoreJobRPLocation | De locatie waar het herstelpunt dat wordt hersteld, is opgeslagen | String |
| BackupInstanceUniqueId | Refererende sleutel die verwijst naar het back-upexemplaar dat is gekoppeld aan de taak | String |
| BackupInstanceId | Arm-id (Azure Resource Manager) van het back-upexemplaar dat is gekoppeld aan de taak | String |
| BackupInstanceFriendlyName | Naam van het back-upexemplaar dat is gekoppeld aan de taak | String |
| DatasourceResourceId | Arm-id (Azure Resource Manager) van de onderliggende gegevensbron die aan de taak is gekoppeld. Bijvoorbeeld de ARM-id (Azure Resource Manager) van de VIRTUELE machine | String |
| DatasourceFriendlyName | Beschrijvende naam van de onderliggende gegevensbron die aan de taak is gekoppeld | String |
| DatasourceType | Type van de gegevensbron die aan de taak is gekoppeld. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' | String |
| BackupSolution | Back-upoplossing waaraan de taak is gekoppeld. Bijvoorbeeld Azure VM Backup, SQL in Azure VM Backup, enzovoort. | String |
| DatasourceSetResourceId | Arm-id (Azure Resource Manager) van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SQL in azure VM-gegevensbron bevat dit veld bijvoorbeeld de ARM-id (Azure Resource Manager) van de VIRTUELE machine waarin de SQL Database bestaat | String |
| DatasourceSetType | Type van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SAP HANA in Azure VM-gegevensbron is dit veld bijvoorbeeld Microsoft.Compute/virtualMachines omdat de bovenliggende resource een Azure-VM is | String |
| VaultResourceId | ARM-id (Azure Resource Manager) van de kluis die is gekoppeld aan de taak | String |
| VaultUniqueId | Refererende sleutel die verwijst naar de kluis die is gekoppeld aan de taak | String |
| VaultName | Naam van de kluis die is gekoppeld aan de taak | String |
| VaultTags | Tags van de kluis die aan de taak is gekoppeld | String |
| VaultSubscriptionId | Abonnements-id van de kluis die is gekoppeld aan de taak | String |
| VaultLocation | Locatie van de kluis die is gekoppeld aan de taak | String |
| VaultStore_StorageReplicationType | Opslagreplicatietype van de kluis die is gekoppeld aan de taak | String |
| VaultType | Type kluis, bijvoorbeeld 'Microsoft.RecoveryServices/vaults' of 'Microsoft.DataProtection/backupVaults' | String |
| TimeGenerated | Tijdstempel van de record | Datum en tijd |
_AzureBackup_GetBackupInstances()
Deze functie retourneert de lijst met back-upexemplaren die zijn gekoppeld aan uw Recovery Services-kluizen, samen met gedetailleerde informatie over elk back-upexemplaar, zoals verbruik van cloudopslag, gekoppeld beleid, enzovoort.
Parameters
| Parameternaam | Beschrijving | Vereist?: | Voorbeeldwaarde | **Gegevenstype ** |
|---|---|---|---|---|
| RangeStart | Gebruik deze parameter samen met de parameter RangeEnd alleen als u alle records met betrekking tot het back-upexemplaren in de periode van RangeStart naar RangeEnd moet ophalen. De waarde van RangeStart en RangeEnd is standaard null, waardoor de functie alleen de meest recente record voor elk back-upexemplaren ophaalt. | N | "2021-03-03 00:00:00" | DataTime |
| RangeEnd | Gebruik deze parameter samen met de parameter RangeStart alleen als u alle records met betrekking tot het back-upexemplaren in de periode van RangeStart naar RangeEnd moet ophalen. De waarde van RangeStart en RangeEnd is standaard null, waardoor de functie alleen de meest recente record voor elk back-upexemplaren ophaalt. | N | "2021-03-10 00:00:00" | Datum en tijd |
| VaultSubscriptionList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set abonnementen waarin back-upgegevens bestaan. Als u een door komma's gescheiden lijst met abonnements-id's opgeeft als parameter voor deze functie, kunt u alleen de back-upexemplaren ophalen die zich in de opgegeven abonnementen bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle abonnementen zoekt. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set regio's waar back-upgegevens bestaan. Als u een door komma's gescheiden lijst met regio's opgeeft als parameter voor deze functie, kunt u alleen de back-upexemplaren ophalen die zich in de opgegeven regio's bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle regio's zoekt. | N | eastus,westus |
String |
| VaultList | Gebruik deze parameter om de uitvoer van de functie voor een bepaalde set kluizen te filteren. Als u een door komma's gescheiden lijst met kluisnamen opgeeft als parameter voor deze functie, kunt u records van back-upexemplaren ophalen die alleen betrekking hebben op de opgegeven kluizen. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar records van back-upexemplaren in alle kluizen. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Gebruik deze parameter om de uitvoer van de functie te filteren op records die betrekking hebben op een bepaald kluistype. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar zowel Recovery Services-kluizen als Backup-kluizen. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Gebruik deze parameter om te kiezen of u een query wilt uitvoeren op gegevens in de verouderde AzureDiagnostics-tabel of niet. Als de waarde van deze parameter onwaar is, worden met de functie gegevens opgevraagd uit zowel de tabel AzureDiagnostics als de resourcespecifieke tabellen. Als de waarde van deze parameter waar is, vraagt de functie alleen gegevens uit de resourcespecifieke tabellen op. De standaardwaarde is true. | N | true | Booleaanse waarde |
| BackupSolutionList | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde set back-upoplossingen die worden gebruikt in uw Azure-omgeving. Als u bijvoorbeeld opgeeft als de waarde van deze parameter, retourneert Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM de functie alleen records die zijn gerelateerd aan items waarvan een back-up is gemaakt met behulp van back-ups van virtuele Azure-machines, SQL in Azure VM-back-up of DPM naar Azure Backup. De waarde van deze parameter is standaard *, waardoor de functie records retourneert die betrekking hebben op alle back-upoplossingen die worden ondersteund door Back-uprapporten (ondersteunde waarden zijn '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' of een door komma's gescheiden combinatie van een van deze waarden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Gebruik deze parameter om te kiezen of alleen de back-upexemplaren moeten worden opgenomen die actief zijn beveiligd of om ook die exemplaren op te nemen waarvoor de beveiliging is gestopt en exemplaren waarvoor de eerste back-up in behandeling is. Voor Recovery Services-kluisworkloads zijn ondersteunde waarden 'Beveiligd', 'ProtectionStopped', 'InitialBackupPending' of een door komma's gescheiden combinatie van een van deze waarden. Voor Workloads van Back-upkluis zijn ondersteunde waarden 'Beveiligd', 'ConfiguringProtection', 'ConfiguringProtectionFailed', 'UpdatingProtection', 'ProtectionError', 'ProtectionStopped' of een door komma's gescheiden combinatie van een van deze waarden. Standaard is de waarde '*', waardoor de functie zoekt naar alle back-upexemplaren, ongeacht de beveiligingsdetails. | N | "Beveiligd" | String |
| DatasourceSetName | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde bovenliggende resource. Als u bijvoorbeeld SQL wilt retourneren in Azure VM-back-upexemplaren die behoren tot de virtuele machine 'testvm', geeft u testvm op als de waarde van deze parameter. Standaard is de waarde '*', waardoor de functie naar records zoekt in alle back-upexemplaren. | N | "testvm" | String |
| BackupInstanceName | Gebruik deze parameter om te zoeken naar een bepaald back-upexemplaren op naam. Standaard is de waarde '*', waardoor de functie naar alle back-upexemplaren zoekt. | N | "testvm" | String |
| DisplayAllFields | Gebruik deze parameter om te kiezen of u alleen een subset wilt ophalen van de velden die door de functie worden geretourneerd. Als de waarde van deze parameter onwaar is, elimineert de functie informatie over opslag- en retentiepunten uit de uitvoer van de functie. Dit is handig als u deze functie gebruikt als een tussenliggende stap in een grotere query en de prestaties van de query moet optimaliseren door kolommen te elimineren die u niet nodig hebt voor analyse. De waarde van deze parameter is standaard waar, waardoor de functie alle velden retourneert die betrekking hebben op het back-upexemplaren. | N | true | Booleaanse waarde |
Geretourneerde velden
| Veldnaam | Beschrijving | Gegevenstype |
|---|---|---|
| UniqueId | Primaire sleutel die een unieke id van het back-upexemplaren aangeeft | String |
| ID | ARM-id (Azure Resource Manager) van het back-upexemplaren | String |
| FriendlyName | Beschrijvende naam van het back-upexemplaren | String |
| ProtectionInfo | Informatie over de beveiligingsinstellingen van het back-upexemplaren. Beveiliging is bijvoorbeeld geconfigureerd, beveiliging gestopt, eerste back-up in behandeling | String |
| LatestRecoveryPoint | Datum en tijd van het meest recente herstelpunt dat is gekoppeld aan het back-upexemplaar. Dit veld wordt momenteel alleen ondersteund voor Recovery Services-kluisworkloads. | Datum en tijd |
| OudsteRecoveryPoint | Datum en tijd van het oudste herstelpunt dat is gekoppeld aan het back-upexemplaar. Dit veld wordt momenteel alleen ondersteund voor Recovery Services-kluisworkloads. | Datum en tijd |
| SourceSizeInMBs | Front-endgrootte van het back-upexemplaren in MB's | Dubbel |
| VaultStore_StorageConsumptionInMBs | Totale cloudopslag die wordt verbruikt door het back-upexemplement in de kluisstandaardlaag | Dubbel |
| DataSourceFriendlyName | Beschrijvende naam van de gegevensbron die overeenkomt met het back-upexemplaren | String |
| BackupSolution | Back-upoplossing waaraan het back-upexemplaar is gekoppeld. Bijvoorbeeld Azure VM Backup, SQL in Azure VM Backup, enzovoort. | String |
| DatasourceType | Type van de gegevensbron die overeenkomt met het back-upexemplaren. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' | String |
| DatasourceResourceId | Arm-id (Azure Resource Manager) van de onderliggende gegevensbron die overeenkomt met het back-upexemplaren. Bijvoorbeeld de ARM-id (Azure Resource Manager) van de VIRTUELE machine | String |
| DatasourceSetFriendlyName | Beschrijvende naam van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SQL in Azure VM-gegevensbron bevat dit veld bijvoorbeeld de naam van de VIRTUELE machine waarin de SQL Database bestaat | String |
| DatasourceSetFriendlyName | Beschrijvende naam van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SQL in Azure VM-gegevensbron bevat dit veld bijvoorbeeld de naam van de VIRTUELE machine waarin de SQL Database bestaat | String |
| DatasourceSetResourceId | Arm-id (Azure Resource Manager) van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SQL in azure VM-gegevensbron bevat dit veld bijvoorbeeld de ARM-id (Azure Resource Manager) van de VIRTUELE machine waarin de SQL Database bestaat | String |
| DatasourceSetType | Type van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SAP HANA in Azure VM-gegevensbron is dit veld bijvoorbeeld Microsoft.Compute/virtualMachines omdat de bovenliggende resource een Azure-VM is | String |
| PolicyName | Naam van het beleid dat is gekoppeld aan het back-upexemplaar | String |
| PolicyUniqueId | Refererende sleutel die verwijst naar het beleid dat is gekoppeld aan het back-upexemplaar | String |
| PolicyId | Arm-id (Azure Resource Manager) van het beleid dat is gekoppeld aan het back-upexemplaar | String |
| VaultResourceId | ARM-id (Azure Resource Manager) van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultUniqueId | Refererende sleutel die verwijst naar de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultName | Naam van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultTags | Tags van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultSubscriptionId | Abonnements-id van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultLocation | Locatie van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultStore_StorageReplicationType | Type opslagreplicatie van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultType | Type kluis, dat 'Microsoft.RecoveryServices/vaults' of 'Microsoft.DataProtection/backupVaults' is | String |
| TimeGenerated | Tijdstempel van de record | Datum en tijd |
_AzureBackup_GetBillingGroups()
Deze functie retourneert een lijst met alle back-upgerelateerde factureringsentiteiten (factureringsgroepen) samen met informatie over belangrijke factureringsonderdelen, zoals de grootte van de front-end en de totale cloudopslag.
Parameters
| Parameternaam | Beschrijving | Vereist?: | Voorbeeldwaarde | Datumtype |
|---|---|---|---|---|
| RangeStart | Gebruik deze parameter samen met de parameter RangeEnd alleen als u alle gerelateerde records van de factureringsgroep in de periode van RangeStart naar RangeEnd moet ophalen. De waarde van RangeStart en RangeEnd is standaard null, waardoor de functie alleen de meest recente record voor elke factureringsgroep ophaalt. | N | "2021-03-03 00:00:00" | Datum en tijd |
| RangeEnd | Gebruik deze parameter samen met de parameter RangeStart alleen als u alle gerelateerde records voor factureringsgroepen in de periode van RangeStart naar RangeEnd wilt ophalen. De waarde van RangeStart en RangeEnd is standaard null, waardoor de functie alleen de meest recente record voor elke factureringsgroep ophaalt. | N | "2021-03-10 00:00:00" | Datum en tijd |
| VaultSubscriptionList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set abonnementen waarin back-upgegevens bestaan. Als u een door komma's gescheiden lijst met abonnements-id's opgeeft als parameter voor deze functie, kunt u alleen de factureringsgroepen ophalen die zich in de opgegeven abonnementen bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle abonnementen zoekt. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set regio's waar back-upgegevens bestaan. Als u een door komma's gescheiden lijst met regio's opgeeft als parameter voor deze functie, kunt u alleen de factureringsgroepen ophalen die zich in de opgegeven regio's bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle regio's zoekt. | N | eastus,westus |
String |
| VaultList | Gebruik deze parameter om de uitvoer van de functie voor een bepaalde set kluizen te filteren. Als u een door komma's gescheiden lijst met kluisnamen opgeeft als parameter voor deze functie, kunt u records van back-upexemplaren ophalen die alleen betrekking hebben op de opgegeven kluizen. Standaard is de waarde van deze parameter '*', waardoor de functie zoekt naar records van factureringsgroepen in alle kluizen. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Gebruik deze parameter om de uitvoer van de functie te filteren op records die betrekking hebben op een bepaald kluistype. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar zowel Recovery Services-kluizen als Backup-kluizen. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Gebruik deze parameter om te kiezen of u een query wilt uitvoeren op gegevens in de verouderde AzureDiagnostics-tabel of niet. Als de waarde van deze parameter onwaar is, worden met de functie gegevens opgevraagd uit zowel de tabel AzureDiagnostics als de resourcespecifieke tabellen. Als de waarde van deze parameter waar is, vraagt de functie alleen gegevens uit de resourcespecifieke tabellen op. De standaardwaarde is true. | N | true | Booleaanse waarde |
| BackupSolutionList | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde set back-upoplossingen die worden gebruikt in uw Azure-omgeving. Als u bijvoorbeeld opgeeft als de waarde van deze parameter, retourneert Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM de functie alleen records die zijn gerelateerd aan items waarvan een back-up is gemaakt met behulp van back-ups van virtuele Azure-machines, SQL in Azure VM-back-up of DPM naar Azure Backup. De waarde van deze parameter is standaard *, waardoor de functie records retourneert die betrekking hebben op alle back-upoplossingen die worden ondersteund door Back-uprapporten (ondersteunde waarden zijn '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' of een door komma's gescheiden combinatie van een van deze waarden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Gebruik deze parameter om te zoeken naar een bepaalde factureringsgroep op naam. Standaard is de waarde '*', waardoor de functie naar alle factureringsgroepen zoekt. | N | "testvm" | String |
Geretourneerde velden
| Veldnaam | Beschrijving | Gegevenstype |
|---|---|---|
| UniqueId | Primaire sleutel die een unieke id van de factureringsgroep aangeeft | String |
| FriendlyName | Beschrijvende naam van de factureringsgroep | String |
| Naam | Naam van de factureringsgroep | String |
| Type | Type factureringsgroep. Bijvoorbeeld ProtectedContainer of BackupItem | String |
| SourceSizeInMBs | Front-endgrootte van de factureringsgroep in MB's | Dubbel |
| VaultStore_StorageConsumptionInMBs | Totale cloudopslag die wordt verbruikt door de factureringsgroep in de vault-standard-laag | Dubbel |
| BackupSolution | Back-upoplossing waaraan de factureringsgroep is gekoppeld. Bijvoorbeeld Azure VM Backup, SQL in Azure VM Backup, enzovoort. | String |
| VaultResourceId | Arm-id (Azure Resource Manager) van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultUniqueId | Refererende sleutel die verwijst naar de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultName | Naam van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultTags | Tags van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultSubscriptionId | Abonnements-id van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultLocation | Locatie van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultStore_StorageReplicationType | Type opslagreplicatie van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultType | Type kluis, bijvoorbeeld 'Microsoft.RecoveryServices/vaults' of 'Microsoft.DataProtection/backupVaults' | String |
| TimeGenerated | Tijdstempel van de record | Datum en tijd |
| ExtendedProperties | Aanvullende eigenschappen van de factureringsgroep | Dynamisch |
Trendfuncties
_AzureBackup_GetBackupInstancesTrends()
Deze functie retourneert historische records voor elk back-upexemplaren, zodat u belangrijke dagelijkse, wekelijkse en maandelijkse trends met betrekking tot het aantal back-upexemplaren en opslagverbruik op meerdere granulariteitsniveaus kunt bekijken.
Parameters
| Parameternaam | Beschrijving | Vereist?: | Voorbeeldwaarde | Gegevenstype |
|---|---|---|---|---|
| RangeStart | Gebruik deze parameter samen met de parameter RangeEnd om alle records met betrekking tot het back-upexemplaren op te halen in de periode van RangeStart naar RangeEnd. | J | "2021-03-03 00:00:00" | Datum en tijd |
| RangeEnd | Gebruik deze parameter samen met de parameter RangeStart om alle records met betrekking tot het back-upexemplaren in de periode op te halen van RangeStart naar RangeEnd. | J | "2021-03-10 00:00:00" | Datum en tijd |
| VaultSubscriptionList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set abonnementen waarin back-upgegevens bestaan. Als u een door komma's gescheiden lijst met abonnements-id's opgeeft als parameter voor deze functie, kunt u alleen de back-upexemplaren ophalen die zich in de opgegeven abonnementen bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle abonnementen zoekt. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set regio's waar back-upgegevens bestaan. Als u een door komma's gescheiden lijst met regio's opgeeft als parameter voor deze functie, kunt u alleen de back-upexemplaren ophalen die zich in de opgegeven regio's bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle regio's zoekt. | N | eastus,westus |
String |
| VaultList | Gebruik deze parameter om de uitvoer van de functie voor een bepaalde set kluizen te filteren. Als u een door komma's gescheiden lijst met kluisnamen opgeeft als parameter voor deze functie, kunt u records van back-upexemplaren ophalen die alleen betrekking hebben op de opgegeven kluizen. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar records van back-upexemplaren in alle kluizen. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Gebruik deze parameter om de uitvoer van de functie te filteren op records die betrekking hebben op een bepaald kluistype. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar zowel Recovery Services-kluizen als Backup-kluizen. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Gebruik deze parameter om te kiezen of u een query wilt uitvoeren op gegevens in de verouderde AzureDiagnostics-tabel of niet. Als de waarde van deze parameter onwaar is, worden met de functie gegevens opgevraagd uit zowel de tabel AzureDiagnostics als de resourcespecifieke tabellen. Als de waarde van deze parameter waar is, vraagt de functie alleen gegevens uit de resourcespecifieke tabellen op. De standaardwaarde is true. | N | true | Booleaanse waarde |
| BackupSolutionList | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde set back-upoplossingen die worden gebruikt in uw Azure-omgeving. Als u bijvoorbeeld opgeeft als de waarde van deze parameter, retourneert Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM de functie alleen records die zijn gerelateerd aan items waarvan een back-up is gemaakt met behulp van back-ups van virtuele Azure-machines, SQL in Azure VM-back-up of DPM naar Azure Backup. De waarde van deze parameter is standaard *, waardoor de functie records retourneert die betrekking hebben op alle back-upoplossingen die worden ondersteund door Back-uprapporten (ondersteunde waarden zijn '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' of een door komma's gescheiden combinatie van een van deze waarden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| ProtectionInfoList | Gebruik deze parameter om te kiezen of alleen de back-upexemplaren moeten worden opgenomen die actief zijn beveiligd of om ook die exemplaren op te nemen waarvoor de beveiliging is gestopt en exemplaren waarvoor de eerste back-up in behandeling is. Voor Recovery Services-kluisworkloads zijn ondersteunde waarden 'Beveiligd', 'ProtectionStopped', 'InitialBackupPending' of een door komma's gescheiden combinatie van een van deze waarden. Voor Workloads van Back-upkluis zijn ondersteunde waarden 'Beveiligd', 'ConfiguringProtection', 'ConfiguringProtectionFailed', 'UpdatingProtection', 'ProtectionError', 'ProtectionStopped' of een door komma's gescheiden combinatie van een van deze waarden. Standaard is de waarde '*', waardoor de functie zoekt naar alle back-upexemplaren, ongeacht de beveiligingsdetails. | N | "Beveiligd" | String |
| DatasourceSetName | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde bovenliggende resource. Als u bijvoorbeeld SQL wilt retourneren in Azure VM-back-upexemplaren die behoren tot de virtuele machine 'testvm', geeft u testvm op als de waarde van deze parameter. Standaard is de waarde '*', waardoor de functie naar records zoekt in alle back-upexemplaren. | N | "testvm" | String |
| BackupInstanceName | Gebruik deze parameter om te zoeken naar een bepaald back-upexemplaren op naam. Standaard is de waarde '*', waardoor de functie naar alle back-upexemplaren zoekt. | N | "testvm" | String |
| DisplayAllFields | Gebruik deze parameter om te kiezen of u alleen een subset wilt ophalen van de velden die door de functie worden geretourneerd. Als de waarde van deze parameter onwaar is, elimineert de functie informatie over opslag- en retentiepunten uit de uitvoer van de functie. Dit is handig als u deze functie gebruikt als een tussenliggende stap in een grotere query en de prestaties van de query moet optimaliseren door kolommen te elimineren die u niet nodig hebt voor analyse. De waarde van deze parameter is standaard waar, waardoor de functie alle velden retourneert die betrekking hebben op het back-upexemplaren. | N | true | Booleaanse waarde |
| AggregationType | Gebruik deze parameter om de tijdgranulariteit op te geven waarop gegevens moeten worden opgehaald. Als de waarde van deze parameter Dagelijks is, retourneert de functie een record per back-upexemplaren per dag, zodat u dagelijkse trends van het opslagverbruik en het aantal back-upexemplaren kunt analyseren. Als de waarde van deze parameter 'Wekelijks' is, retourneert de functie een record per back-upexemplaren per week, zodat u wekelijkse trends kunt analyseren. Op dezelfde manier kunt u Maandelijks opgeven om maandelijkse trends te analyseren. De standaardwaarde is Dagelijks. Als u gegevens bekijkt in grotere tijdsbereiken, is het raadzaam om Wekelijks of Maandelijks te gebruiken voor betere queryprestaties en het gemak van trendanalyse. | N | "Wekelijks" | String |
Geretourneerde velden
| Veldnaam | Beschrijving | Gegevenstype |
|---|---|---|
| UniqueId | Primaire sleutel die een unieke id van het back-upexemplaren aangeeft | String |
| ID | ARM-id (Azure Resource Manager) van het back-upexemplaren | String |
| FriendlyName | Beschrijvende naam van het back-upexemplaren | String |
| ProtectionInfo | Informatie over de beveiligingsinstellingen van het back-upexemplaren. Beveiliging is bijvoorbeeld geconfigureerd, beveiliging gestopt, eerste back-up in behandeling | String |
| LatestRecoveryPoint | Datum en tijd van het meest recente herstelpunt dat is gekoppeld aan het back-upexemplaar. Dit veld wordt momenteel alleen ondersteund voor Recovery Services-kluisworkloads | Datum en tijd |
| OudsteRecoveryPoint | Datum en tijd van het oudste herstelpunt dat is gekoppeld aan het back-upexemplaar | Dit veld wordt momenteel alleen ondersteund voor Recovery Services-kluisworkloads |
| SourceSizeInMBs | Front-endgrootte van het back-upexemplaren in MB's | Dubbel |
| VaultStore_StorageConsumptionInMBs | Totale cloudopslag die wordt verbruikt door het back-upexemplement in de kluisstandaardlaag | Dubbel |
| DataSourceFriendlyName | Beschrijvende naam van de gegevensbron die overeenkomt met het back-upexemplaren | String |
| BackupSolution | Back-upoplossing waaraan het back-upexemplaar is gekoppeld. Bijvoorbeeld Azure VM Backup, SQL in Azure VM Backup, enzovoort. | String |
| DatasourceType | Type van de gegevensbron die overeenkomt met het back-upexemplaren. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' | String |
| DatasourceResourceId | Arm-id (Azure Resource Manager) van de onderliggende gegevensbron die overeenkomt met het back-upexemplaren. Bijvoorbeeld de ARM-id (Azure Resource Manager) van de VIRTUELE machine | String |
| DatasourceSetFriendlyName | Beschrijvende naam van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SQL in Azure VM-gegevensbron bevat dit veld bijvoorbeeld de naam van de VIRTUELE machine waarin de SQL Database bestaat | String |
| DatasourceSetResourceId | Arm-id (Azure Resource Manager) van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SQL in azure VM-gegevensbron bevat dit veld bijvoorbeeld de ARM-id (Azure Resource Manager) van de VIRTUELE machine waarin de SQL Database bestaat | String |
| DatasourceSetType | Type van de bovenliggende resource van de gegevensbron (waar van toepassing). Voor een SAP HANA in Azure VM-gegevensbron is dit veld bijvoorbeeld Microsoft.Compute/virtualMachines omdat de bovenliggende resource een Azure-VM is | String |
| PolicyName | Naam van het beleid dat is gekoppeld aan het back-upexemplaar | String |
| PolicyUniqueId | Refererende sleutel die verwijst naar het beleid dat is gekoppeld aan het back-upexemplaar | String |
| PolicyId | Arm-id (Azure Resource Manager) van het beleid dat is gekoppeld aan het back-upexemplaar | String |
| VaultResourceId | ARM-id (Azure Resource Manager) van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultUniqueId | Refererende sleutel die verwijst naar de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultName | Naam van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultTags | Tags van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultSubscriptionId | Abonnements-id van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultLocation | Locatie van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultStore_StorageReplicationType | Type opslagreplicatie van de kluis die is gekoppeld aan het back-upexemplaar | String |
| VaultType | Type kluis, bijvoorbeeld 'Microsoft.RecoveryServices/vaults' of 'Microsoft.DataProtection/backupVaults' | String |
| TimeGenerated | Tijdstempel van de record | Datum en tijd |
_AzureBackup_GetBillingGroupsTrends()
Deze functie retourneert historische records voor elke factureringsentiteit, zodat u belangrijke dagelijkse, wekelijkse en maandelijkse trends met betrekking tot front-endgrootte en opslagverbruik op meerdere granulariteitsniveaus kunt bekijken.
Parameters
| Parameternaam | Beschrijving | Vereist?: | Voorbeeldwaarde | Gegevenstype |
|---|---|---|---|---|
| RangeStart | Gebruik deze parameter samen met de parameter RangeEnd om alle gerelateerde records voor factureringsgroepen in de periode op te halen van RangeStart naar RangeEnd. | J | "2021-03-03 00:00:00" | Datum en tijd |
| RangeEnd | Gebruik deze parameter samen met de parameter RangeStart om alle gerelateerde records voor factureringsgroepen in de periode op te halen van RangeStart naar RangeEnd. | J | "2021-03-10 00:00:00" | Datum en tijd |
| VaultSubscriptionList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set abonnementen waarin back-upgegevens bestaan. Als u een door komma's gescheiden lijst met abonnements-id's opgeeft als parameter voor deze functie, kunt u alleen de factureringsgroepen ophalen die zich in de opgegeven abonnementen bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle abonnementen zoekt. | N | "00000000-0000-0000-0000-000000000000,11111111-1111-1111-1111-111111111111" | String |
| VaultLocationList | Gebruik deze parameter om de uitvoer van de functie te filteren voor een bepaalde set regio's waar back-upgegevens bestaan. Als u een door komma's gescheiden lijst met regio's opgeeft als parameter voor deze functie, kunt u alleen de factureringsgroepen ophalen die zich in de opgegeven regio's bevinden. De waarde van deze parameter is standaard '*', waardoor de functie naar records in alle regio's zoekt. | N | eastus,westus |
String |
| VaultList | Gebruik deze parameter om de uitvoer van de functie voor een bepaalde set kluizen te filteren. Als u een door komma's gescheiden lijst met kluisnamen opgeeft als parameter voor deze functie, kunt u records van back-upexemplaren ophalen die alleen betrekking hebben op de opgegeven kluizen. Standaard is de waarde van deze parameter '*', waardoor de functie zoekt naar records van factureringsgroepen in alle kluizen. | N | vault1,vault2,vault3 |
String |
| VaultTypeList | Gebruik deze parameter om de uitvoer van de functie te filteren op records die betrekking hebben op een bepaald kluistype. De waarde van deze parameter is standaard '*', waardoor de functie zoekt naar zowel Recovery Services-kluizen als Backup-kluizen. | N | "Microsoft.RecoveryServices/vaults" | String |
| ExcludeLegacyEvent | Gebruik deze parameter om te kiezen of u een query wilt uitvoeren op gegevens in de verouderde AzureDiagnostics-tabel of niet. Als de waarde van deze parameter onwaar is, worden met de functie gegevens opgevraagd uit zowel de tabel AzureDiagnostics als de resourcespecifieke tabellen. Als de waarde van deze parameter waar is, vraagt de functie alleen gegevens uit de resourcespecifieke tabellen op. De standaardwaarde is true. | N | true | Booleaanse waarde |
| BackupSolutionList | Gebruik deze parameter om de uitvoer van de functie te filteren op een bepaalde set back-upoplossingen die worden gebruikt in uw Azure-omgeving. Als u bijvoorbeeld opgeeft als de waarde van deze parameter, retourneert Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM de functie alleen records die zijn gerelateerd aan items waarvan een back-up is gemaakt met behulp van back-ups van virtuele Azure-machines, SQL in Azure VM-back-up of DPM naar Azure Backup. De waarde van deze parameter is standaard *, waardoor de functie records retourneert die betrekking hebben op alle back-upoplossingen die worden ondersteund door Back-uprapporten (ondersteunde waarden zijn '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' of een door komma's gescheiden combinatie van een van deze waarden). |
N | Azure Virtual Machine Backup,SQL in Azure VM Backup,DPM,Azure Backup Agent |
String |
| BillingGroupName | Gebruik deze parameter om te zoeken naar een bepaalde factureringsgroep op naam. Standaard is de waarde '*', waardoor de functie naar alle factureringsgroepen zoekt. | N | "testvm" | String |
| AggregationType | Gebruik deze parameter om de tijdgranulariteit op te geven waarop gegevens moeten worden opgehaald. Als de waarde van deze parameter 'Dagelijks' is, retourneert de functie een record per factureringsgroep per dag, zodat u dagelijkse trends van opslagverbruik en front-endgrootte kunt analyseren. Als de waarde van deze parameter 'Wekelijks' is, retourneert de functie een record per back-upexemplaren per week, zodat u wekelijkse trends kunt analyseren. Op dezelfde manier kunt u Maandelijks opgeven om maandelijkse trends te analyseren. De standaardwaarde is Dagelijks. Als u gegevens bekijkt in grotere tijdsbereiken, is het raadzaam om Wekelijks of Maandelijks te gebruiken voor betere queryprestaties en het gemak van trendanalyse. | N | "Wekelijks" | String |
Geretourneerde velden
| Veldnaam | Beschrijving | Gegevenstype |
|---|---|---|
| UniqueId | Primaire sleutel die een unieke id van de factureringsgroep aangeeft | String |
| FriendlyName | Beschrijvende naam van de factureringsgroep | String |
| Naam | Naam van de factureringsgroep | String |
| Type | Type factureringsgroep. Bijvoorbeeld ProtectedContainer of BackupItem | String |
| SourceSizeInMBs | Front-endgrootte van de factureringsgroep in MB's | Dubbel |
| VaultStore_StorageConsumptionInMBs | Totale cloudopslag die wordt verbruikt door de factureringsgroep in de vault-standard-laag | Dubbel |
| BackupSolution | Back-upoplossing waaraan de factureringsgroep is gekoppeld. Bijvoorbeeld Azure VM Backup, SQL in Azure VM Backup, enzovoort. | String |
| VaultResourceId | Arm-id (Azure Resource Manager) van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultUniqueId | Refererende sleutel die verwijst naar de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultName | Naam van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultTags | Tags van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultSubscriptionId | Abonnements-id van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultLocation | Locatie van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultStore_StorageReplicationType | Type opslagreplicatie van de kluis die is gekoppeld aan de factureringsgroep | String |
| VaultType | Type kluis, bijvoorbeeld 'Microsoft.RecoveryServices/vaults' of 'Microsoft.DataProtection/backupVaults' | String |
| TimeGenerated | Tijdstempel van de record | Datum en tijd |
| ExtendedProperties | Aanvullende eigenschappen van de factureringsgroep | Dynamisch |
Voorbeeldquery's
Hieronder vindt u enkele voorbeeldquery's om u te helpen aan de slag te gaan met het gebruik van systeemfuncties.
Alle mislukte Back-uptaken van Azure-VM's in een bepaald tijdsbereik
_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=DataTransferredInMBsAlle back-uptaken voor SQL-logboeken in een bepaald tijdsbereik
_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=DataTransferredInMBsWekelijkse trend van back-upopslag die wordt gebruikt voor VM '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