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

Имя	В	Обязательно	Тип	Описание
changeResourceId	path	True	string	Идентификатор ресурса изменения
resourceGroupName	path	True	string	Имя группы ресурсов.
resourceName	path	True	string	Имя ресурса.
resourceProviderNamespace	path	True	string	Имя пространства имен поставщика ресурсов.
resourceType	path	True	string	Имя типа ресурса.
subscriptionId	path	True	string	Идентификатор подписки Azure. Это строка в формате GUID (например, 0000000-0000-0000-0000-0000-000000000000000).
api-version	query	True	string	Версия API, используемая с HTTP-запросом.

Ответы

Имя	Тип	Описание
200 OK	ChangeResourceResult	Все в порядке.
Other Status Codes	ErrorResponse	Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
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"
      }
    }
  }
}

Определения

Имя	Описание
ChangeAttributes	Сведения об изменении ресурса
ChangeBase	Отдельное изменение целевого ресурса
ChangeCategory	Сущность, которая внесла изменения
ChangeProperties	Свойства изменения
ChangeResourceResult	Изменение ресурса
ChangeType	Тип изменений, зафиксированных в ресурсе
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
PropertyChangeType	Тип изменения, которое произошло.

ChangeAttributes

Сведения об изменении ресурса

Имя	Тип	Описание
changesCount	integer	Количество изменений, фиксируемых этим ресурсом
correlationId	string	Идентификатор корреляции ARM для ресурса изменений
newResourceSnapshotId	string	GUID нового snapshot
previousResourceSnapshotId	string	GUID предыдущего snapshot
timestamp	string	Время изменения в целевом ресурсе

ChangeBase

Отдельное изменение целевого ресурса

Имя	Тип	Описание
changeCategory	ChangeCategory	Сущность, которая внесла изменения
newValue	string	Значение свойства целевого ресурса после изменения
previousValue	string	Значение свойства целевого ресурса перед изменением
propertyChangeType	PropertyChangeType	Тип изменения, которое произошло.

ChangeCategory

Сущность, которая внесла изменения

Имя	Тип	Описание
System	string	Инициированное системой изменение
User	string	Инициированное пользователем изменение

ChangeProperties

Свойства изменения

Имя	Тип	Описание
changeAttributes	ChangeAttributes	Сведения об изменении ресурса
changeType	ChangeType	Тип изменений, зафиксированных в ресурсе
changes	<string, ChangeBase>	Словарь с измененным именем свойства в качестве ключа и сведениями об изменении в качестве значения
targetResourceId	string	Полный идентификатор целевого ресурса, который был изменен
targetResourceType	string	Пространство имен и тип ресурса

ChangeResourceResult

Изменение ресурса

Имя	Тип	Описание
id	string	Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Имя ресурса.
properties	ChangeProperties	Свойства изменения
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ChangeType

Тип изменений, зафиксированных в ресурсе

Имя	Тип	Описание
Create	string	Только что созданный ресурс
Delete	string	Существующий ресурс удален
Update	string	Существующий ресурс подвергся изменению

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

PropertyChangeType

Тип изменения, которое произошло.

Имя	Тип	Описание
Insert	string	Свойство было создано недавно.
Remove	string	Существующее свойство удалено
Update	string	Существующее свойство подверглось изменению

Поделиться через

Changes - Get

Параметры URI

Ответы

Безопасность

azure_auth

Области

Примеры

GetChange

Образец запроса

Пример ответа

Определения

ChangeAttributes

ChangeBase

ChangeCategory

ChangeProperties

ChangeResourceResult

ChangeType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PropertyChangeType

Дополнительные ресурсы