Backup Resource Vault Configs - Update

Služba:

Recovery Services - Backup

Verze rozhraní API:

2026-08-01

Aktualizuje konfiguraci zabezpečení trezoru.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
vaultName	path	True	string	Název prostředku úložiště
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-authorization-auxiliary		string

Text požadavku

Name	Typ	Description
eTag	string	Volitelná značka ETag.
location	string	Geografické umístění, ve kterém se nachází zdroj
properties	BackupResourceVaultConfig	Vlastnosti BackupResourceVaultConfigResource
tags	object	Štítky prostředků

Odpovědi

Name	Typ	Description
200 OK	BackupResourceVaultConfigResource	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 služby Azure Active Directory.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	vydávat se za svůj uživatelský účet

Příklady

Update Vault Security Config

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
BackupResourceVaultConfig	Podrobnosti konfigurace trezoru prostředků zálohování
BackupResourceVaultConfigResource	Podrobnosti konfigurace trezoru prostředků zálohování
createdByType	Typ identity, která prostředek vytvořila.
EnhancedSecurityState	Povoleno nebo zakázáno.
ErrorDetail	Třída podrobností o chybě, která zapouzdřuje kód, zprávu a doporučení.
ErrorResponse	Chybová odpověď
SoftDeleteFeatureState	Stav funkce obnovitelného odstranění
StorageType	Typ úložiště
StorageTypeState	Uzamčeno nebo odemknuté Jakmile je počítač zaregistrovaný vůči prostředku, hodnota storageTypeState je vždy uzamčena.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

BackupResourceVaultConfig

Objekt

Podrobnosti konfigurace trezoru prostředků zálohování

Name	Typ	Description
enhancedSecurityState	EnhancedSecurityState	Povoleno nebo zakázáno.
isSoftDeleteFeatureStateEditable	boolean	Tento příznak se už nepoužívá. K nastavení stavu obnovitelného odstranění trezoru použijte softDeleteFeatureState.
resourceGuardOperationRequests	string[]	Žádosti o operaci ResourceGuard
softDeleteFeatureState	SoftDeleteFeatureState	Stav funkce obnovitelného odstranění
softDeleteRetentionPeriodInDays	integer (int32)	Doba uchovávání obnovitelného odstranění ve dnech
storageModelType	StorageType	Typ úložiště.
storageType	StorageType	Typ úložiště.
storageTypeState	StorageTypeState	Uzamčeno nebo odemknuté Jakmile je počítač zaregistrovaný vůči prostředku, hodnota storageTypeState je vždy uzamčena.

BackupResourceVaultConfigResource

Objekt

Podrobnosti konfigurace trezoru prostředků zálohování

Name	Typ	Description
eTag	string	Volitelná značka ETag.
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties	BackupResourceVaultConfig	Vlastnosti BackupResourceVaultConfigResource
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Štítky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

EnhancedSecurityState

Výčet

Povoleno nebo zakázáno.

Hodnota	Description
Invalid
Enabled
Disabled

ErrorDetail

Objekt

Třída podrobností o chybě, která zapouzdřuje kód, zprávu a doporučení.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva související s kódem
recommendations	string[]	Seznam řetězců doporučení

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

SoftDeleteFeatureState

Výčet

Stav funkce obnovitelného odstranění

Hodnota	Description
Invalid
Enabled
Disabled
AlwaysON

StorageType

Výčet

Typ úložiště

Hodnota	Description
Invalid
GeoRedundant
LocallyRedundant
ZoneRedundant
ReadAccessGeoZoneRedundant

StorageTypeState

Výčet

Uzamčeno nebo odemknuté Jakmile je počítač zaregistrovaný vůči prostředku, hodnota storageTypeState je vždy uzamčena.

Hodnota	Description
Invalid
Locked
Unlocked

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, který naposledy změnil prostředek.