Backup Resource Vault Configs - Update

Служба:

Recovery Services - Backup

Версия API:

2026-08-01

Обновляет конфигурацию безопасности хранилища.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2026-08-01

Параметры URI

Имя.	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя нечувствительно к регистру.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
vaultName	path	True	string	Имя ресурса VaultResource
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Заголовок запроса

Имя.	Обязательно	Тип	Описание
x-ms-authorization-auxiliary		string

Текст запроса

Имя.	Тип	Описание
eTag	string	Необязательный ETag.
location	string	Географическое расположение, в котором находится ресурс
properties	BackupResourceVaultConfig	Свойства BackupResourceVaultConfigResource
tags	object	Теги ресурсов.

Ответы

Имя.	Тип	Описание
200 OK	BackupResourceVaultConfigResource	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

Имя.	Описание
user_impersonation	выдать себя за учетную запись пользователя

Примеры

Update Vault Security Config

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

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/SwaggerTest/backupconfig/vaultconfig?api-version=2026-08-01

{
  "properties": {
    "enhancedSecurityState": "Enabled"
  }
}

Java

import com.azure.resourcemanager.recoveryservicesbackup.fluent.models.BackupResourceVaultConfigResourceInner;
import com.azure.resourcemanager.recoveryservicesbackup.models.BackupResourceVaultConfig;
import com.azure.resourcemanager.recoveryservicesbackup.models.EnhancedSecurityState;

/**
 * Samples for BackupResourceVaultConfigs Update.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-08-01/Common/BackupResourceVaultConfigs_Patch.json
     */
    /**
     * Sample code: Update Vault Security Config.
     * 
     * @param manager Entry point to RecoveryServicesBackupManager.
     */
    public static void updateVaultSecurityConfig(
        com.azure.resourcemanager.recoveryservicesbackup.RecoveryServicesBackupManager manager) {
        manager.backupResourceVaultConfigs().updateWithResponse("SwaggerTest", "SwaggerTestRg",
            new BackupResourceVaultConfigResourceInner().withProperties(
                new BackupResourceVaultConfig().withEnhancedSecurityState(EnhancedSecurityState.ENABLED)),
            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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservicesbackup import RecoveryServicesBackupClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-recoveryservicesbackup
# USAGE
    python backup_resource_vault_configs_patch.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 = RecoveryServicesBackupClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.backup_resource_vault_configs.update(
        vault_name="SwaggerTest",
        resource_group_name="SwaggerTestRg",
        parameters={"properties": {"enhancedSecurityState": "Enabled"}},
    )
    print(response)


# x-ms-original-file: 2026-08-01/Common/BackupResourceVaultConfigs_Patch.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

Go

package armrecoveryservicesbackup_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/recoveryservices/armrecoveryservicesbackup/v5"
)

// Generated from example definition: 2026-08-01/Common/BackupResourceVaultConfigs_Patch.json
func ExampleBackupResourceVaultConfigsClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicesbackup.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewBackupResourceVaultConfigsClient().Update(ctx, "SwaggerTest", "SwaggerTestRg", armrecoveryservicesbackup.BackupResourceVaultConfigResource{
		Properties: &armrecoveryservicesbackup.BackupResourceVaultConfig{
			EnhancedSecurityState: to.Ptr(armrecoveryservicesbackup.EnhancedSecurityStateEnabled),
		},
	}, 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 = armrecoveryservicesbackup.BackupResourceVaultConfigsClientUpdateResponse{
	// 	BackupResourceVaultConfigResource: armrecoveryservicesbackup.BackupResourceVaultConfigResource{
	// 		Name: to.Ptr("vaultconfig"),
	// 		Type: to.Ptr("Microsoft.RecoveryServices/vaults/backupconfig"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/SwaggerTest/backupconfig/vaultconfig"),
	// 		Properties: &armrecoveryservicesbackup.BackupResourceVaultConfig{
	// 			EnhancedSecurityState: to.Ptr(armrecoveryservicesbackup.EnhancedSecurityStateEnabled),
	// 		},
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to updates vault security config.
 *
 * @summary updates vault security config.
 * x-ms-original-file: 2026-08-01/Common/BackupResourceVaultConfigs_Patch.json
 */
async function updateVaultSecurityConfig() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new RecoveryServicesBackupClient(credential, subscriptionId);
  const result = await client.backupResourceVaultConfigs.update("SwaggerTest", "SwaggerTestRg", {
    properties: { enhancedSecurityState: "Enabled" },
  });
  console.log(result);
}

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

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

Код состояния:

200

{
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/SwaggerTest/backupconfig/vaultconfig",
  "properties": {
    "enhancedSecurityState": "Enabled"
  }
}

Определения

Имя.	Описание
BackupResourceVaultConfig	Сведения о конфигурации хранилища ресурсов резервного копирования.
BackupResourceVaultConfigResource	Сведения о конфигурации хранилища ресурсов резервного копирования.
createdByType	Тип учётной записи, создавшей ресурс.
EnhancedSecurityState	Включен или отключен.
ErrorDetail	Класс Сведений об ошибках, который инкапсулирует код, сообщение и рекомендации.
ErrorResponse	Ответ на ошибку
SoftDeleteFeatureState	Состояние функции обратимого удаления
StorageType	Тип хранилища
StorageTypeState	Заблокирован или разблокирован. После регистрации компьютера в ресурсе хранилищеTypeState всегда блокируется.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

BackupResourceVaultConfig

Объект

Сведения о конфигурации хранилища ресурсов резервного копирования.

Имя.	Тип	Описание
enhancedSecurityState	EnhancedSecurityState	Включен или отключен.
isSoftDeleteFeatureStateEditable	boolean	Этот флаг больше не используется. Используйте softDeleteFeatureState, чтобы задать состояние обратимого удаления для хранилища.
resourceGuardOperationRequests	string[]	Запросы операций ResourceGuard
softDeleteFeatureState	SoftDeleteFeatureState	Состояние функции обратимого удаления
softDeleteRetentionPeriodInDays	integer (int32)	Период хранения обратимого удаления в днях
storageModelType	StorageType	Тип хранилища.
storageType	StorageType	Тип хранилища.
storageTypeState	StorageTypeState	Заблокирован или разблокирован. После регистрации компьютера в ресурсе хранилищеTypeState всегда блокируется.

BackupResourceVaultConfigResource

Объект

Сведения о конфигурации хранилища ресурсов резервного копирования.

Имя.	Тип	Описание
eTag	string	Необязательный ETag.
id	string	Полный идентификатор ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса.
properties	BackupResourceVaultConfig	Свойства BackupResourceVaultConfigResource
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

createdByType

Перечисление

Тип учётной записи, создавшей ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

EnhancedSecurityState

Перечисление

Включен или отключен.

Значение	Описание
Invalid
Enabled
Disabled

ErrorDetail

Объект

Класс Сведений об ошибках, который инкапсулирует код, сообщение и рекомендации.

Имя.	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, связанное с кодом.
recommendations	string[]	Список строк рекомендаций.

ErrorResponse

Объект

Ответ на ошибку

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

SoftDeleteFeatureState

Перечисление

Состояние функции обратимого удаления

Значение	Описание
Invalid
Enabled
Disabled
AlwaysON

StorageType

Перечисление

Тип хранилища

Значение	Описание
Invalid
GeoRedundant
LocallyRedundant
ZoneRedundant
ReadAccessGeoZoneRedundant

StorageTypeState

Перечисление

Заблокирован или разблокирован. После регистрации компьютера в ресурсе хранилищеTypeState всегда блокируется.

Значение	Описание
Invalid
Locked
Unlocked

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя.	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Идентификатор, создавший ресурс.
createdByType	createdByType	Тип учётной записи, создавшей ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, которое последним изменило ресурс.