Skip to main content

changes

Creates, updates, deletes, gets or lists a changes resource.

Overview

Namechanges
TypeResource
Idazure.change_analysis.changes

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
namestringThe name of the resource.
changeTypestringThe type of the change. Known values are: "Add", "Remove", and "Update".
initiatedByListarrayThe list of identities who might initiated the change. The identity could be user name (email address) or the object ID of the Service Principal.
propertyChangesarrayThe list of detailed changes at json property level.
resourceIdstringThe resource id that the change is attached to.
timeStampstring (date-time)The time when the change is detected.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_changes_by_resource_groupselectresource_group_name, subscription_id, $startTime, $endTime$skipTokenList the changes of a resource group within the specified time range. Customer data will always be masked. List the changes of a resource group within the specified time range. Customer data will always be masked.
list_changes_by_subscriptionselectsubscription_id, $startTime, $endTime$skipTokenList the changes of a subscription within the specified time range. Customer data will always be masked. List the changes of a subscription within the specified time range. Customer data will always be masked.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
$endTimestring (date-time)Specifies the end time of the changes request. Required.
$startTimestring (date-time)Specifies the start time of the changes request. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring
$skipTokenstringA skip token is used to continue retrieving items after an operation returns a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls. Default value is None.

SELECT examples

List the changes of a resource group within the specified time range. Customer data will always be masked. List the changes of a resource group within the specified time range. Customer data will always be masked.

SELECT
id,
name,
changeType,
initiatedByList,
propertyChanges,
resourceId,
timeStamp,
type
FROM azure.change_analysis.changes
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $startTime = '{{ $startTime }}' -- required
AND $endTime = '{{ $endTime }}' -- required
AND $skipToken = '{{ $skipToken }}'
;