Changes - Get

참조

서비스:: Resource Management

API 버전:: 2022-05-01

대상 리소스에 대해 지정된 변경 리소스를 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
changeResourceId	path	True	string	변경 리소스의 ID
resourceGroupName	path	True	string	리소스 그룹의 이름.
resourceName	path	True	string	리소스의 이름입니다.
resourceProviderNamespace	path	True	string	리소스 공급자 네임스페이스의 이름입니다.
resourceType	path	True	string	리소스 형식의 이름입니다.
subscriptionId	path	True	string	Azure 구독 ID입니다. GUID 형식 문자열입니다(예: 000000000-0000-0000-0000-0000-000000000000).
api-version	query	True	string	HTTP 요청과 함께 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	ChangeResourceResult	OK.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

GetChange

샘플 요청

GET https://management.azure.com/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1/providers/Microsoft.Resources/changes/1d58d72f-0719-4a48-9228-b7ea682885bf?api-version=2022-05-01


/**
 * Samples for Changes Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/resources/resource-manager/Microsoft.Resources/stable/2022-05-01/examples/GetChange.json
     */
    /**
     * Sample code: GetChange.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getChange(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.genericResources().manager().resourceChangeClient().getChanges().getWithResponse("resourceGroup1",
            "resourceProvider1", "resourceType1", "resourceName1", "1d58d72f-0719-4a48-9228-b7ea682885bf",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource import ChangesClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource
# USAGE
    python get_change.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ChangesClient(
        credential=DefaultAzureCredential(),
        subscription_id="subscriptionId1",
    )

    response = client.changes.get(
        resource_group_name="resourceGroup1",
        resource_provider_namespace="resourceProvider1",
        resource_type="resourceType1",
        resource_name="resourceName1",
        change_resource_id="1d58d72f-0719-4a48-9228-b7ea682885bf",
    )
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2022-05-01/examples/GetChange.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armchanges_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armchanges"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/0cc5e2efd6ffccf30e80d1e150b488dd87198b94/specification/resources/resource-manager/Microsoft.Resources/stable/2022-05-01/examples/GetChange.json
func ExampleClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armchanges.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewClient().Get(ctx, "resourceGroup1", "resourceProvider1", "resourceType1", "resourceName1", "1d58d72f-0719-4a48-9228-b7ea682885bf", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ChangeResourceResult = armchanges.ChangeResourceResult{
	// 	Name: to.Ptr("1d58d72f-0719-4a48-9228-b7ea682885bf"),
	// 	Type: to.Ptr("Microsoft.Resources/changes"),
	// 	ID: to.Ptr("/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1/Microsoft.Resources/changes/1d58d72f-0719-4a48-9228-b7ea682885bf"),
	// 	Properties: &armchanges.ChangeProperties{
	// 		ChangeAttributes: &armchanges.ChangeAttributes{
	// 			ChangesCount: to.Ptr[int64](2),
	// 			CorrelationID: to.Ptr("88420d5d-8d0e-471f-9115-10d34750c617"),
	// 			NewResourceSnapshotID: to.Ptr("6eac9d0f-63b4-4e7f-97a5-740c73757efb"),
	// 			PreviousResourceSnapshotID: to.Ptr("ed90e35a-1661-42cc-a44c-e27f508005be"),
	// 			Timestamp: to.Ptr("2021-11-19T14:29:09.9210000Z"),
	// 		},
	// 		ChangeType: to.Ptr(armchanges.ChangeTypeUpdate),
	// 		Changes: map[string]*armchanges.ChangeBase{
	// 			"properties.provisioningState": &armchanges.ChangeBase{
	// 				ChangeCategory: to.Ptr(armchanges.ChangeCategorySystem),
	// 				NewValue: to.Ptr("Succeeded"),
	// 				PreviousValue: to.Ptr("Updating"),
	// 				PropertyChangeType: to.Ptr(armchanges.PropertyChangeTypeUpdate),
	// 			},
	// 			"tags.key1": &armchanges.ChangeBase{
	// 				ChangeCategory: to.Ptr(armchanges.ChangeCategoryUser),
	// 				NewValue: to.Ptr("someValue"),
	// 				PreviousValue: to.Ptr("null"),
	// 				PropertyChangeType: to.Ptr(armchanges.PropertyChangeTypeInsert),
	// 			},
	// 		},
	// 		TargetResourceID: to.Ptr("/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1"),
	// 		TargetResourceType: to.Ptr("resourceProvider1/resourceType1"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ChangesClient } = require("@azure/arm-changes");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Obtains the specified change resource for the target resource
 *
 * @summary Obtains the specified change resource for the target resource
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2022-05-01/examples/GetChange.json
 */
async function getChange() {
  const subscriptionId = "subscriptionId1";
  const resourceGroupName = "resourceGroup1";
  const resourceProviderNamespace = "resourceProvider1";
  const resourceType = "resourceType1";
  const resourceName = "resourceName1";
  const changeResourceId = "1d58d72f-0719-4a48-9228-b7ea682885bf";
  const credential = new DefaultAzureCredential();
  const client = new ChangesClient(credential, subscriptionId);
  const result = await client.changes.get(
    resourceGroupName,
    resourceProviderNamespace,
    resourceType,
    resourceName,
    changeResourceId
  );
  console.log(result);
}

getChange().catch(console.error);

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/subscriptionId1/resourceGroups/resourceGroup1/providers/resourceProvider1/resourceType1/resourceName1/Microsoft.Resources/changes/1d58d72f-0719-4a48-9228-b7ea682885bf",
  "name": "1d58d72f-0719-4a48-9228-b7ea682885bf",
  "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"
      }
    }
  }
}

정의

Name	Description
ChangeAttributes	변경 리소스에 대한 세부 정보
ChangeBase	대상 리소스에 대한 개별 변경
ChangeCategory	변경한 엔터티
ChangeProperties	변경의 속성
ChangeResourceResult	리소스 변경
ChangeType	리소스에서 캡처된 변경 유형
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
PropertyChangeType	발생한 변경 유형

ChangeAttributes

변경 리소스에 대한 세부 정보

Name	형식	Description
changesCount	integer	이 리소스가 캡처하는 변경 내용 수
correlationId	string	변경 리소스의 ARM 상관 관계 ID
newResourceSnapshotId	string	새 스냅샷 GUID
previousResourceSnapshotId	string	이전 스냅샷 GUID
timestamp	string	대상 리소스의 변경 내용이 발생된 시간입니다.

ChangeBase

대상 리소스에 대한 개별 변경

Name	형식	Description
changeCategory	ChangeCategory	변경한 엔터티
newValue	string	변경 후 대상 리소스 속성 값
previousValue	string	변경 전의 대상 리소스 속성 값
propertyChangeType	PropertyChangeType	발생한 변경 유형

ChangeCategory

변경한 엔터티

Name	형식	Description
System	string	시스템 시작 변경
User	string	사용자가 시작한 변경 내용

ChangeProperties

변경의 속성

Name	형식	Description
changeAttributes	ChangeAttributes	변경 리소스에 대한 세부 정보
changeType	ChangeType	리소스에서 캡처된 변경 유형
changes	<string, ChangeBase>	변경된 속성 이름을 키로 사용하고 변경 세부 정보를 값으로 사용하는 사전
targetResourceId	string	변경된 대상 리소스의 정규화된 ID
targetResourceType	string	리소스의 네임스페이스 및 형식

ChangeResourceResult

리소스 변경

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름입니다.
properties	ChangeProperties	변경의 속성
type	string	리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ChangeType

리소스에서 캡처된 변경 유형

Name	형식	Description
Create	string	새로 만든 리소스
Delete	string	기존 리소스가 삭제되었습니다.
Update	string	기존 리소스가 변경되었습니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

PropertyChangeType

발생한 변경 유형

Name	형식	Description
Insert	string	속성이 새로 만들어졌습니다.
Remove	string	기존 속성이 삭제되었습니다.
Update	string	기존 속성이 변경되었습니다.

다음을 통해 공유

Changes - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

GetChange

샘플 요청

샘플 응답

정의

ChangeAttributes

ChangeBase

ChangeCategory

ChangeProperties

ChangeResourceResult

ChangeType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PropertyChangeType

추가 리소스