Changes - List

服務:: Resource Management

API 版本:: 2022-05-01

從目標資源的過去 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 格式的字串（例如 0000000000-0000-0000-0000-0000000000000000）
api-version	query	True	string	要與 HTTP 要求搭配使用的 API 版本。
$skipToken	query		string	（選擇性）頁面接續令牌
$top	query		integer (int64) minimum: 1 maximum: 100	（選擇性）設定每個回應的結果數目上限。

回應

名稱	類型	Description
200 OK	ChangeResourceListResult	還行。
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

範圍

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

範例

ListChanges

範例要求

HTTP

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

範例回覆

狀態碼:: 200

{
  "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

Object

變更資源的詳細數據

名稱	類型	Description
changesCount	integer (int64)	此資源擷取的變更數目
correlationId	string	變更資源的 ARM 相互關聯標識碼
newResourceSnapshotId	string	新快照集的 GUID
previousResourceSnapshotId	string	上一個快照集的 GUID
timestamp	string	目標資源變更的時間

ChangeBase

Object

目標資源的個別變更

名稱	類型	Description
changeCategory	ChangeCategory	進行變更的實體
newValue	string	變更之後的目標資源屬性值
previousValue	string	變更之前的目標資源屬性值
propertyChangeType	PropertyChangeType	發生的變更類型

ChangeCategory

列舉型別

進行變更的實體

值	Description
User	使用者起始的變更
System	系統起始的變更

ChangeProperties

Object

變更的屬性

名稱	類型	Description
changeAttributes	ChangeAttributes	變更資源的詳細數據
changeType	ChangeType	在資源中擷取的變更類型
changes	<string, ChangeBase>	具有已變更屬性名稱做為索引鍵的字典，並將變更詳細數據當做值
targetResourceId	string	已變更之目標資源的完整標識碼
targetResourceType	string	資源的命名空間和類型

ChangeResourceListResult

Object

資源清單

名稱	類型	Description
nextLink	string	用來取得變更資源下一頁的連結
value	ChangeResourceResult[]	資源清單

ChangeResourceResult

Object

變更資源

名稱	類型	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
Update	現有的資源發生變更
Delete	已刪除現有的資源
Create	新建立的資源

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

PropertyChangeType

列舉型別

發生的變更類型

值	Description
Insert	新建立的屬性
Update	現有屬性已進行變更
Remove	已刪除現有的屬性

共用方式為

Changes - List

URI 參數

回應

安全性

azure_auth

範圍

範例

ListChanges

範例要求

範例回覆

定義

ChangeAttributes

ChangeBase

ChangeCategory

ChangeProperties

ChangeResourceListResult

ChangeResourceResult

ChangeType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PropertyChangeType