共用方式為


Changes - List

取得目標資源的過去 14 天內的變更資源清單

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}/providers/Microsoft.Resources/changes?api-version=2022-05-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}/providers/Microsoft.Resources/changes?api-version=2022-05-01&$top={$top}&$skipToken={$skipToken}

URI 參數

名稱 位於 必要 類型 Description
resourceGroupName
path True

string

資源群組的名稱。

resourceName
path True

string

資源名稱。

resourceProviderNamespace
path True

string

資源提供者命名空間的名稱。

resourceType
path True

string

資源類型的名稱。

subscriptionId
path True

string

Azure 訂用帳戶識別碼。 這是 GUID 格式字串 (例如 000000000-0000-0000-0000-00000-000000000000)

api-version
query True

string

要與 HTTP 要求搭配使用的 API 版本。

$skipToken
query

string

(選擇性) 頁面接續令牌

$top
query

integer

int64

(選擇性) 設定每個響應的結果數目上限。

回應

名稱 類型 Description
200 OK

ChangeResourceListResult

正常。

Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

ListChanges

範例要求

GET https://management.azure.com/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1/providers/Microsoft.Resources/changes?api-version=2022-05-01

範例回覆

{
  "value": [
    {
      "id": "/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1/Microsoft.Resources/changes/a9f34285-13a2-e79c-f468-cfb71c7bd227",
      "name": "a9f34285-13a2-e79c-f468-cfb71c7bd227",
      "type": "Microsoft.Resources/changes",
      "properties": {
        "targetResourceId": "/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1",
        "targetResourceType": "resourceProvider1/resourceType1",
        "changeType": "Update",
        "changeAttributes": {
          "correlationId": "88420d5d-8d0e-471f-9115-10d34750c617",
          "timestamp": "2021-11-19T14:29:09.9210000Z",
          "changesCount": 2,
          "previousResourceSnapshotId": "ed90e35a-1661-42cc-a44c-e27f508005be",
          "newResourceSnapshotId": "6eac9d0f-63b4-4e7f-97a5-740c73757efb"
        },
        "changes": {
          "properties.provisioningState": {
            "propertyChangeType": "Update",
            "changeCategory": "System",
            "previousValue": "Updating",
            "newValue": "Succeeded"
          },
          "tags.key1": {
            "propertyChangeType": "Insert",
            "changeCategory": "User",
            "previousValue": "null",
            "newValue": "someValue"
          }
        }
      }
    },
    {
      "id": "/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1/Microsoft.Resources/changes/a9f34285-13a2-e79c-f468-cfb71c7bd227",
      "name": "a9f34285-13a2-e79c-f468-cfb71c7bd227",
      "type": "Microsoft.Resources/changes",
      "properties": {
        "targetResourceId": "/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1",
        "targetResourceType": "resourceProvider1/resourceType1",
        "changeType": "Create",
        "changeAttributes": {
          "changesCount": 0,
          "correlationId": "88420d5d-8d0e-471f-9115-10d34750c617",
          "timestamp": "2021-11-19T14:29:09.9210000Z",
          "previousResourceSnapshotId": "b09f5e52-0b46-4d13-84a9-08653d39fed6",
          "newResourceSnapshotId": "4db20fc0-de17-4cdd-92d8-fd6bf94b9fd9"
        },
        "changes": {}
      }
    }
  ]
}

定義

名稱 Description
ChangeAttributes

變更資源的詳細數據

ChangeBase

目標資源的個別變更

ChangeCategory

進行變更的實體

ChangeProperties

變更的屬性

ChangeResourceListResult

資源清單

ChangeResourceResult

變更資源

ChangeType

在資源中擷取的變更類型

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

PropertyChangeType

發生的變更類型

ChangeAttributes

變更資源的詳細數據

名稱 類型 Description
changesCount

integer

此資源擷取的變更數目

correlationId

string

變更資源的 ARM 相互關聯標識碼

newResourceSnapshotId

string

新快照集的 GUID

previousResourceSnapshotId

string

上一個快照集的 GUID

timestamp

string

目標資源上變更 () 的時間

ChangeBase

目標資源的個別變更

名稱 類型 Description
changeCategory

ChangeCategory

進行變更的實體

newValue

string

變更之後的目標資源屬性值

previousValue

string

變更之前的目標資源屬性值

propertyChangeType

PropertyChangeType

發生的變更類型

ChangeCategory

進行變更的實體

名稱 類型 Description
System

string

系統起始的變更

User

string

使用者起始的變更

ChangeProperties

變更的屬性

名稱 類型 Description
changeAttributes

ChangeAttributes

變更資源的詳細數據

changeType

ChangeType

在資源中擷取的變更類型

changes

<string,  ChangeBase>

具有已變更屬性名稱做為索引鍵的字典,以及變更詳細數據做為值

targetResourceId

string

已變更之目標資源的完整標識碼

targetResourceType

string

資源的命名空間和類型

ChangeResourceListResult

資源清單

名稱 類型 Description
nextLink

string

用來取得下一頁變更資源的連結

value

ChangeResourceResult[]

資源清單

ChangeResourceResult

變更資源

名稱 類型 Description
id

string

資源的完整資源識別碼。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

資源的名稱

properties

ChangeProperties

變更的屬性

type

string

資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

ChangeType

在資源中擷取的變更類型

名稱 類型 Description
Create

string

新建立的資源

Delete

string

已刪除現有的資源

Update

string

現有資源下移變更

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

PropertyChangeType

發生的變更類型

名稱 類型 Description
Insert

string

新建立的屬性

Remove

string

已刪除現有的屬性

Update

string

現有屬性在變更時發生變更