你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Vaults - Create Or Update

服务:: Recovery Services

API 版本:: 2025-08-01

创建或更新恢复服务保管库。

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

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string minLength: 1	目标订阅的 ID。
vaultName	path	True	string	Vault 的名称
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

请求头

名称	必需	类型	说明
x-ms-authorization-auxiliary		string

请求正文

名称	必需	类型	说明
location	True	string	资源所在的地理位置
etag		string	etag 的资源。
identity		IdentityData	资源的标识。
properties		VaultProperties	保管库的属性。
sku		Sku	标识每个 Azure 资源的唯一系统标识符。
tags		object	资源标记。

响应

名称	类型	说明
200 OK	Vault	资源“Vault”更新作成功
201 Created	Vault	资源“Vault”创建作成功标头 Location: string Retry-After: integer
Other Status Codes	CloudError	意外错误响应。

名称

类型

说明

200 OK

Vault

资源“Vault”更新作成功

201 Created

Vault

资源“Vault”创建作成功

标头

Location: string
Retry-After: integer

Other Status Codes

CloudError

意外错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Create or Update Recovery Services vault

Create or Update Vault performing critical operation With MUA

Create or Update Vault with CustomerManagedKeys

Create or Update Vault With Monitoring Setting

Create or Update Vault With Redundancy Setting

Create or Update Vault with Source scan configuration

Create or Update Vault with User Assigned Identity

Create or Update Recovery Services vault

示例请求

PUT https://management.azure.com/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample?api-version=2025-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "West US",
  "properties": {
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservices import RecoveryServicesClient

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

    response = client.vaults.begin_create_or_update(
        resource_group_name="Default-RecoveryServices-ResourceGroup",
        vault_name="swaggerExample",
        vault={
            "identity": {"type": "SystemAssigned"},
            "location": "West US",
            "properties": {"publicNetworkAccess": "Enabled"},
            "sku": {"name": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/PUTVault.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

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

/**
 * This sample demonstrates how to creates or updates a Recovery Services vault.
 *
 * @summary creates or updates a Recovery Services vault.
 * x-ms-original-file: 2025-08-01/PUTVault.json
 */
async function createOrUpdateRecoveryServicesVault() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "77777777-b0c6-47a2-b37c-d8e65a629c18";
  const client = new RecoveryServicesClient(credential, subscriptionId);
  const result = await client.vaults.createOrUpdate(
    "Default-RecoveryServices-ResourceGroup",
    "swaggerExample",
    {
      identity: { type: "SystemAssigned" },
      location: "West US",
      properties: { publicNetworkAccess: "Enabled" },
      sku: { name: "Standard" },
    },
  );
  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": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "3137d6c7-5d6c-411c-b934-7a2a729ee247",
    "tenantId": "d676e86e-2206-4a7c-999c-ece52c144b5b"
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "RS0",
    "tier": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

状态代码:: 201

{
  "name": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "3137d6c7-5d6c-411c-b934-7a2a729ee247",
    "tenantId": "d676e86e-2206-4a7c-999c-ece52c144b5b"
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "RS0",
    "tier": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

Create or Update Vault performing critical operation With MUA

示例请求

PUT https://management.azure.com/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample?api-version=2025-08-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
    }
  },
  "location": "West US",
  "properties": {
    "encryption": {
      "infrastructureEncryption": "Enabled",
      "kekIdentity": {
        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
      },
      "keyVaultProperties": {
        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
      }
    },
    "publicNetworkAccess": "Enabled",
    "resourceGuardOperationRequests": [
      "/subscriptions/38304e13-357e-405e-9e9a-220351dcce8c/resourcegroups/ankurResourceGuard1/providers/Microsoft.DataProtection/resourceGuards/ResourceGuard38-1/modifyEncryptionSettings/default"
    ]
  },
  "sku": {
    "name": "Standard"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservices import RecoveryServicesClient

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

    response = client.vaults.begin_create_or_update(
        resource_group_name="Default-RecoveryServices-ResourceGroup",
        vault_name="swaggerExample",
        vault={
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
                },
            },
            "location": "West US",
            "properties": {
                "encryption": {
                    "infrastructureEncryption": "Enabled",
                    "kekIdentity": {
                        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
                    },
                    "keyVaultProperties": {
                        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
                    },
                },
                "publicNetworkAccess": "Enabled",
                "resourceGuardOperationRequests": [
                    "/subscriptions/38304e13-357e-405e-9e9a-220351dcce8c/resourcegroups/ankurResourceGuard1/providers/Microsoft.DataProtection/resourceGuards/ResourceGuard38-1/modifyEncryptionSettings/default"
                ],
            },
            "sku": {"name": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/PUTVault_ResourceGuardEnabled.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

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

/**
 * This sample demonstrates how to creates or updates a Recovery Services vault.
 *
 * @summary creates or updates a Recovery Services vault.
 * x-ms-original-file: 2025-08-01/PUTVault_ResourceGuardEnabled.json
 */
async function createOrUpdateVaultPerformingCriticalOperationWithMUA() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "77777777-b0c6-47a2-b37c-d8e65a629c18";
  const client = new RecoveryServicesClient(credential, subscriptionId);
  const result = await client.vaults.createOrUpdate(
    "Default-RecoveryServices-ResourceGroup",
    "swaggerExample",
    {
      identity: {
        type: "UserAssigned",
        userAssignedIdentities: {
          "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi":
            {},
        },
      },
      location: "West US",
      properties: {
        encryption: {
          infrastructureEncryption: "Enabled",
          kekIdentity: {
            userAssignedIdentity:
              "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi",
          },
          keyVaultProperties: {
            keyUri: "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3",
          },
        },
        publicNetworkAccess: "Enabled",
        resourceGuardOperationRequests: [
          "/subscriptions/38304e13-357e-405e-9e9a-220351dcce8c/resourcegroups/ankurResourceGuard1/providers/Microsoft.DataProtection/resourceGuards/ResourceGuard38-1/modifyEncryptionSettings/default",
        ],
      },
      sku: { name: "Standard" },
    },
  );
  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": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {
        "clientId": "fbe75b66-01c5-4f87-a220-233af3270436",
        "principalId": "075a0ca6-43f6-4434-9abf-c9b1b79f9219"
      }
    }
  },
  "location": "westus",
  "properties": {
    "encryption": {
      "infrastructureEncryption": "Enabled",
      "kekIdentity": {
        "useSystemAssignedIdentity": false,
        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
      },
      "keyVaultProperties": {
        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
      }
    },
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

状态代码:: 201

Azure-AsyncOperation: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2015-03-15
Retry-After: 10

{
  "name": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
    }
  },
  "location": "westus",
  "properties": {
    "encryption": {
      "infrastructureEncryption": "Enabled",
      "kekIdentity": {
        "useSystemAssignedIdentity": false,
        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
      },
      "keyVaultProperties": {
        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
      }
    },
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

Create or Update Vault with CustomerManagedKeys

示例请求

PUT https://management.azure.com/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample?api-version=2025-08-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
    }
  },
  "location": "West US",
  "properties": {
    "encryption": {
      "infrastructureEncryption": "Enabled",
      "kekIdentity": {
        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
      },
      "keyVaultProperties": {
        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
      }
    },
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservices import RecoveryServicesClient

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

    response = client.vaults.begin_create_or_update(
        resource_group_name="Default-RecoveryServices-ResourceGroup",
        vault_name="swaggerExample",
        vault={
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
                },
            },
            "location": "West US",
            "properties": {
                "encryption": {
                    "infrastructureEncryption": "Enabled",
                    "kekIdentity": {
                        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
                    },
                    "keyVaultProperties": {
                        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
                    },
                },
                "publicNetworkAccess": "Enabled",
            },
            "sku": {"name": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/PUTVault_WithCMK.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

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

/**
 * This sample demonstrates how to creates or updates a Recovery Services vault.
 *
 * @summary creates or updates a Recovery Services vault.
 * x-ms-original-file: 2025-08-01/PUTVault_WithCMK.json
 */
async function createOrUpdateVaultWithCustomerManagedKeys() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "77777777-b0c6-47a2-b37c-d8e65a629c18";
  const client = new RecoveryServicesClient(credential, subscriptionId);
  const result = await client.vaults.createOrUpdate(
    "Default-RecoveryServices-ResourceGroup",
    "swaggerExample",
    {
      identity: {
        type: "UserAssigned",
        userAssignedIdentities: {
          "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi":
            {},
        },
      },
      location: "West US",
      properties: {
        encryption: {
          infrastructureEncryption: "Enabled",
          kekIdentity: {
            userAssignedIdentity:
              "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi",
          },
          keyVaultProperties: {
            keyUri: "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3",
          },
        },
        publicNetworkAccess: "Enabled",
      },
      sku: { name: "Standard" },
    },
  );
  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": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {
        "clientId": "fbe75b66-01c5-4f87-a220-233af3270436",
        "principalId": "075a0ca6-43f6-4434-9abf-c9b1b79f9219"
      }
    }
  },
  "location": "westus",
  "properties": {
    "encryption": {
      "infrastructureEncryption": "Enabled",
      "kekIdentity": {
        "useSystemAssignedIdentity": false,
        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
      },
      "keyVaultProperties": {
        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
      }
    },
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

状态代码:: 201

Azure-AsyncOperation: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2015-03-15
Retry-After: 10

{
  "name": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
    }
  },
  "location": "westus",
  "properties": {
    "encryption": {
      "infrastructureEncryption": "Enabled",
      "kekIdentity": {
        "useSystemAssignedIdentity": false,
        "userAssignedIdentity": "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi"
      },
      "keyVaultProperties": {
        "keyUri": "https://cmk2xkv.vault.azure.net/keys/Key1/0767b348bb1a4c07baa6c4ec0055d2b3"
      }
    },
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

Create or Update Vault With Monitoring Setting

示例请求

PUT https://management.azure.com/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample?api-version=2025-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "West US",
  "properties": {
    "monitoringSettings": {
      "azureMonitorAlertSettings": {
        "alertsForAllFailoverIssues": "Disabled",
        "alertsForAllJobFailures": "Enabled",
        "alertsForAllReplicationIssues": "Enabled"
      },
      "classicAlertSettings": {
        "alertsForCriticalOperations": "Disabled",
        "emailNotificationsForSiteRecovery": "Enabled"
      }
    },
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservices import RecoveryServicesClient

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

    response = client.vaults.begin_create_or_update(
        resource_group_name="Default-RecoveryServices-ResourceGroup",
        vault_name="swaggerExample",
        vault={
            "identity": {"type": "SystemAssigned"},
            "location": "West US",
            "properties": {
                "monitoringSettings": {
                    "azureMonitorAlertSettings": {
                        "alertsForAllFailoverIssues": "Disabled",
                        "alertsForAllJobFailures": "Enabled",
                        "alertsForAllReplicationIssues": "Enabled",
                    },
                    "classicAlertSettings": {
                        "alertsForCriticalOperations": "Disabled",
                        "emailNotificationsForSiteRecovery": "Enabled",
                    },
                },
                "publicNetworkAccess": "Enabled",
            },
            "sku": {"name": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/PUTVault_WithMonitoringSettings.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

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

/**
 * This sample demonstrates how to creates or updates a Recovery Services vault.
 *
 * @summary creates or updates a Recovery Services vault.
 * x-ms-original-file: 2025-08-01/PUTVault_WithMonitoringSettings.json
 */
async function createOrUpdateVaultWithMonitoringSetting() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "77777777-b0c6-47a2-b37c-d8e65a629c18";
  const client = new RecoveryServicesClient(credential, subscriptionId);
  const result = await client.vaults.createOrUpdate(
    "Default-RecoveryServices-ResourceGroup",
    "swaggerExample",
    {
      identity: { type: "SystemAssigned" },
      location: "West US",
      properties: {
        monitoringSettings: {
          azureMonitorAlertSettings: {
            alertsForAllFailoverIssues: "Disabled",
            alertsForAllJobFailures: "Enabled",
            alertsForAllReplicationIssues: "Enabled",
          },
          classicAlertSettings: {
            alertsForCriticalOperations: "Disabled",
            emailNotificationsForSiteRecovery: "Enabled",
          },
        },
        publicNetworkAccess: "Enabled",
      },
      sku: { name: "Standard" },
    },
  );
  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": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "3137d6c7-5d6c-411c-b934-7a2a729ee247",
    "tenantId": "d676e86e-2206-4a7c-999c-ece52c144b5b"
  },
  "location": "westus",
  "properties": {
    "monitoringSettings": {
      "azureMonitorAlertSettings": {
        "alertsForAllFailoverIssues": "Disabled",
        "alertsForAllJobFailures": "Enabled",
        "alertsForAllReplicationIssues": "Enabled"
      },
      "classicAlertSettings": {
        "alertsForCriticalOperations": "Disabled",
        "emailNotificationsForSiteRecovery": "Enabled"
      }
    },
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "RS0",
    "tier": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

状态代码:: 201

{
  "name": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "3137d6c7-5d6c-411c-b934-7a2a729ee247",
    "tenantId": "d676e86e-2206-4a7c-999c-ece52c144b5b"
  },
  "location": "westus",
  "properties": {
    "monitoringSettings": {
      "azureMonitorAlertSettings": {
        "alertsForAllFailoverIssues": "Disabled",
        "alertsForAllJobFailures": "Enabled",
        "alertsForAllReplicationIssues": "Enabled"
      },
      "classicAlertSettings": {
        "alertsForCriticalOperations": "Disabled",
        "emailNotificationsForSiteRecovery": "Enabled"
      }
    },
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "RS0",
    "tier": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

Create or Update Vault With Redundancy Setting

示例请求

PUT https://management.azure.com/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample?api-version=2025-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "West US",
  "properties": {
    "publicNetworkAccess": "Enabled",
    "redundancySettings": {
      "crossRegionRestore": "Enabled",
      "standardTierStorageRedundancy": "GeoRedundant"
    }
  },
  "sku": {
    "name": "Standard"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservices import RecoveryServicesClient

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

    response = client.vaults.begin_create_or_update(
        resource_group_name="Default-RecoveryServices-ResourceGroup",
        vault_name="swaggerExample",
        vault={
            "identity": {"type": "SystemAssigned"},
            "location": "West US",
            "properties": {
                "publicNetworkAccess": "Enabled",
                "redundancySettings": {
                    "crossRegionRestore": "Enabled",
                    "standardTierStorageRedundancy": "GeoRedundant",
                },
            },
            "sku": {"name": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/PUTVault_WithRedundancySettings.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

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

/**
 * This sample demonstrates how to creates or updates a Recovery Services vault.
 *
 * @summary creates or updates a Recovery Services vault.
 * x-ms-original-file: 2025-08-01/PUTVault_WithRedundancySettings.json
 */
async function createOrUpdateVaultWithRedundancySetting() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "77777777-b0c6-47a2-b37c-d8e65a629c18";
  const client = new RecoveryServicesClient(credential, subscriptionId);
  const result = await client.vaults.createOrUpdate(
    "Default-RecoveryServices-ResourceGroup",
    "swaggerExample",
    {
      identity: { type: "SystemAssigned" },
      location: "West US",
      properties: {
        publicNetworkAccess: "Enabled",
        redundancySettings: {
          crossRegionRestore: "Enabled",
          standardTierStorageRedundancy: "GeoRedundant",
        },
      },
      sku: { name: "Standard" },
    },
  );
  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": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "3137d6c7-5d6c-411c-b934-7a2a729ee247",
    "tenantId": "d676e86e-2206-4a7c-999c-ece52c144b5b"
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled",
    "redundancySettings": {
      "crossRegionRestore": "Enabled",
      "standardTierStorageRedundancy": "GeoRedundant"
    }
  },
  "sku": {
    "name": "RS0",
    "tier": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

状态代码:: 201

{
  "name": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "3137d6c7-5d6c-411c-b934-7a2a729ee247",
    "tenantId": "d676e86e-2206-4a7c-999c-ece52c144b5b"
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled",
    "redundancySettings": {
      "crossRegionRestore": "Enabled",
      "standardTierStorageRedundancy": "GeoRedundant"
    }
  },
  "sku": {
    "name": "RS0",
    "tier": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

Create or Update Vault with Source scan configuration

示例请求

PUT https://management.azure.com/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample?api-version=2025-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "West US",
  "properties": {
    "publicNetworkAccess": "Enabled",
    "securitySettings": {
      "sourceScanConfiguration": {
        "sourceScanIdentity": {
          "operationIdentityType": "SystemAssigned"
        },
        "state": "Enabled"
      }
    }
  },
  "sku": {
    "name": "Standard"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservices import RecoveryServicesClient

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

    response = client.vaults.begin_create_or_update(
        resource_group_name="Default-RecoveryServices-ResourceGroup",
        vault_name="swaggerExample",
        vault={
            "identity": {"type": "SystemAssigned"},
            "location": "West US",
            "properties": {
                "publicNetworkAccess": "Enabled",
                "securitySettings": {
                    "sourceScanConfiguration": {
                        "sourceScanIdentity": {"operationIdentityType": "SystemAssigned"},
                        "state": "Enabled",
                    }
                },
            },
            "sku": {"name": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/PUTVault_WithSourceScanConfiguration.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

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

/**
 * This sample demonstrates how to creates or updates a Recovery Services vault.
 *
 * @summary creates or updates a Recovery Services vault.
 * x-ms-original-file: 2025-08-01/PUTVault_WithSourceScanConfiguration.json
 */
async function createOrUpdateVaultWithSourceScanConfiguration() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "77777777-b0c6-47a2-b37c-d8e65a629c18";
  const client = new RecoveryServicesClient(credential, subscriptionId);
  const result = await client.vaults.createOrUpdate(
    "Default-RecoveryServices-ResourceGroup",
    "swaggerExample",
    {
      identity: { type: "SystemAssigned" },
      location: "West US",
      properties: {
        publicNetworkAccess: "Enabled",
        securitySettings: {
          sourceScanConfiguration: {
            sourceScanIdentity: { operationIdentityType: "SystemAssigned" },
            state: "Enabled",
          },
        },
      },
      sku: { name: "Standard" },
    },
  );
  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": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2025-02-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "1be097b0-eb5e-4927-bac2-b24ee8716f64",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled",
    "securitySettings": {
      "sourceScanConfiguration": {
        "sourceScanIdentity": {
          "operationIdentityType": "SystemAssigned"
        },
        "state": "Enabled"
      }
    }
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

状态代码:: 201

Azure-AsyncOperation: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2015-03-15
Retry-After: 10

{
  "name": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "1be097b0-eb5e-4927-bac2-b24ee8716f64",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "Enabled",
    "securitySettings": {
      "sourceScanConfiguration": {
        "sourceScanIdentity": {
          "operationIdentityType": "SystemAssigned"
        },
        "state": "Enabled"
      }
    }
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

Create or Update Vault with User Assigned Identity

示例请求

PUT https://management.azure.com/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample?api-version=2025-08-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
    }
  },
  "location": "West US",
  "properties": {
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservices import RecoveryServicesClient

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

    response = client.vaults.begin_create_or_update(
        resource_group_name="Default-RecoveryServices-ResourceGroup",
        vault_name="swaggerExample",
        vault={
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
                },
            },
            "location": "West US",
            "properties": {"publicNetworkAccess": "Enabled"},
            "sku": {"name": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/PUTVault_WithUserAssignedIdentity.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

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

/**
 * This sample demonstrates how to creates or updates a Recovery Services vault.
 *
 * @summary creates or updates a Recovery Services vault.
 * x-ms-original-file: 2025-08-01/PUTVault_WithUserAssignedIdentity.json
 */
async function createOrUpdateVaultWithUserAssignedIdentity() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "77777777-b0c6-47a2-b37c-d8e65a629c18";
  const client = new RecoveryServicesClient(credential, subscriptionId);
  const result = await client.vaults.createOrUpdate(
    "Default-RecoveryServices-ResourceGroup",
    "swaggerExample",
    {
      identity: {
        type: "UserAssigned",
        userAssignedIdentities: {
          "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi":
            {},
        },
      },
      location: "West US",
      properties: { publicNetworkAccess: "Enabled" },
      sku: { name: "Standard" },
    },
  );
  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": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {
        "clientId": "fbe75b66-01c5-4f87-a220-233af3270436",
        "principalId": "075a0ca6-43f6-4434-9abf-c9b1b79f9219"
      }
    }
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

状态代码:: 201

Azure-AsyncOperation: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2015-03-15
Retry-After: 10

{
  "name": "swaggerExample",
  "type": "Microsoft.RecoveryServices/vaults",
  "etag": "W/\"datetime'2017-12-15T12%3A36%3A51.68Z'\"",
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/swaggerExample",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/85bf5e8c-3084-4f42-add2-746ebb7e97b2/resourcegroups/defaultrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplemsi": {}
    }
  },
  "location": "westus",
  "properties": {
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "TestUpdatedKey": "TestUpdatedValue"
  }
}

定义

名称	说明
AlertsState
AssociatedIdentity	要用于作的标识详细信息
AzureMonitorAlertSettings	基于 Azure Monitor 的警报的设置
BackupStorageVersion	备份存储版本
BCDRSecurityLevel	用于业务连续性和灾难恢复的恢复服务保管库的安全级别
ClassicAlertSettings	经典警报的设置
CloudError	Azure 备份的错误响应。
CmkKekIdentity	用于 CMK 的标识的详细信息
CmkKeyVaultProperties	托管 CMK 的 Key Vault 的属性
createdByType	创建资源的标识的类型。
CrossRegionRestore	在保管库上启用跨区域还原时显示的标志
CrossSubscriptionRestoreSettings	跨订阅还原设置的设置
CrossSubscriptionRestoreState
EnhancedSecurityState
Error	资源管理错误响应。
ErrorAdditionalInfo	资源管理错误附加信息。
IdentityData	资源的标识。
IdentityType	应用于作的标识类型。
ImmutabilitySettings	保管库的不可变性设置
ImmutabilityState
InfrastructureEncryptionState	启用/禁用双重加密状态
MonitoringSettings	保管库的监视设置
MultiUserAuthorization	保管库的 MUA 设置
PrivateEndpoint	链接到专用终结点连接的专用终结点网络资源。
PrivateEndpointConnection	专用终结点连接响应属性。
PrivateEndpointConnectionStatus	获取或设置状态。
PrivateEndpointConnectionVaultProperties	要作为 privateEndpointConnections 列表元素存储在保管库属性中的信息。
PrivateLinkServiceConnectionState	获取或设置专用链接服务连接状态。
ProvisioningState	获取或设置专用终结点连接的预配状态。
PublicNetworkAccess	属性，用于启用或禁用来自公共客户端的资源提供程序入站网络流量
ResourceIdentityType	使用的托管标识的类型。类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。类型“None”将删除任何标识。
ResourceMoveState	移动操作后的资源状态
RestoreSettings	还原保管库的设置
SecureScoreLevel	恢复服务保管库的安全分数
SecuritySettings	保管库的安全设置
Sku	标识每个 Azure 资源的唯一系统标识符。
SkuName	SKU 的名称为 RS0（恢复服务第 0 版），层为标准层。它们不会影响后端存储冗余或任何其他保管库设置。若要管理存储冗余，请使用 backupstorageconfig
SoftDeleteSettings	保管库的软删除设置
SoftDeleteState
SourceScanConfiguration	保管库的源扫描配置
StandardTierStorageRedundancy	保管库的存储冗余设置
State
systemData	与创建和上次修改资源相关的元数据。
TriggerType	触发保管库升级的方式。
UpgradeDetails	升级保管库的详细信息。
UserIdentity	由服务用户管理的资源标识。
Vault	资源信息，由资源提供程序返回。
VaultPrivateEndpointState	用于备份的专用终结点状态。
VaultProperties	保管库的属性。
VaultPropertiesEncryption	资源的客户托管密钥详细信息。
VaultPropertiesMoveDetails	对 Azure 资源执行的最新移动作的详细信息
VaultPropertiesRedundancySettings	保管库的冗余设置
VaultSubResourceType	保管库 AzureBackup、AzureBackup_secondary 或 AzureSiteRecovery 的子资源类型
VaultUpgradeState	保管库升级操作的状态。

AlertsState

枚举

值	说明
Enabled
Disabled

AssociatedIdentity

Object

要用于作的标识详细信息

名称	类型	说明
operationIdentityType	IdentityType	应用于作的标识类型。
userAssignedIdentity	string	如果 operationIdentityType 为 UserAssigned，则用于作的用户分配标识。

AzureMonitorAlertSettings

Object

基于 Azure Monitor 的警报的设置

名称	类型	说明
alertsForAllFailoverIssues	AlertsState
alertsForAllJobFailures	AlertsState
alertsForAllReplicationIssues	AlertsState

BackupStorageVersion

枚举

备份存储版本

值	说明
V1
V2
Unassigned

BCDRSecurityLevel

枚举

用于业务连续性和灾难恢复的恢复服务保管库的安全级别

值	说明
Poor
Fair
Good
Excellent

ClassicAlertSettings

Object

经典警报的设置

名称	类型	说明
alertsForCriticalOperations	AlertsState
emailNotificationsForSiteRecovery	AlertsState

CloudError

Object

Azure 备份的错误响应。

名称	类型	说明
error	Error	资源管理错误响应。

CmkKekIdentity

Object

用于 CMK 的标识的详细信息

名称	类型	说明
useSystemAssignedIdentity	boolean	指示应使用系统分配的标识。与“userAssignedIdentity”字段互斥
userAssignedIdentity	string	用户分配的标识用于授予权限，以防所使用的标识类型为 UserAssigned

CmkKeyVaultProperties

Object

托管 CMK 的 Key Vault 的属性

名称	类型	说明
keyUri	string	客户管理的密钥的密钥 URI

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

CrossRegionRestore

枚举

在保管库上启用跨区域还原时显示的标志

值	说明
Enabled
Disabled

CrossSubscriptionRestoreSettings

Object

跨订阅还原设置的设置

名称	类型	说明
crossSubscriptionRestoreState	CrossSubscriptionRestoreState

CrossSubscriptionRestoreState

枚举

值	说明
Enabled
Disabled
PermanentlyDisabled

EnhancedSecurityState

枚举

值	说明
Invalid
Enabled
Disabled
AlwaysON

Error

Object

资源管理错误响应。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	Error[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

IdentityData

Object

资源的标识。

名称	类型	说明
principalId	string	资源标识的主体 ID。
tenantId	string	资源的租户 ID。
type	ResourceIdentityType	使用的托管标识的类型。类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。类型“None”将删除任何标识。
userAssignedIdentities	<string, UserIdentity>	与资源关联的用户分配标识的列表。用户分配的标识字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

IdentityType

枚举

应用于作的标识类型。

值	说明
SystemAssigned
UserAssigned

ImmutabilitySettings

Object

保管库的不可变性设置

名称	类型	说明
state	ImmutabilityState

ImmutabilityState

枚举

值	说明
Disabled
Unlocked
Locked

InfrastructureEncryptionState

枚举

启用/禁用双重加密状态

值	说明
Enabled
Disabled

MonitoringSettings

Object

保管库的监视设置

名称	类型	说明
azureMonitorAlertSettings	AzureMonitorAlertSettings	基于 Azure Monitor 的警报的设置
classicAlertSettings	ClassicAlertSettings	经典警报的设置

MultiUserAuthorization

枚举

保管库的 MUA 设置

值	说明
Invalid
Enabled
Disabled

PrivateEndpoint

Object

链接到专用终结点连接的专用终结点网络资源。

名称	类型	说明
id	string	获取或设置 ID。

PrivateEndpointConnection

Object

专用终结点连接响应属性。

名称	类型	说明
groupIds	VaultSubResourceType[]	专用终结点的组 ID
privateEndpoint	PrivateEndpoint	链接到专用终结点连接的专用终结点网络资源。
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	获取或设置专用链接服务连接状态。
provisioningState	ProvisioningState	获取或设置专用终结点连接的预配状态。

PrivateEndpointConnectionStatus

枚举

获取或设置状态。

值	说明
Pending
Approved
Rejected
Disconnected

PrivateEndpointConnectionVaultProperties

Object

要作为 privateEndpointConnections 列表元素存储在保管库属性中的信息。

名称	类型	说明
id	string	ID 订阅/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft的格式。[Service]/{resource}/{resourceName}/privateEndpointConnections/{connectionName}。
location	string	专用终结点连接的位置
name	string	专用终结点连接的名称
properties	PrivateEndpointConnection	专用终结点连接响应属性。
type	string	类型，格式为 Microsoft.RecoveryServices/vaults/privateEndpointConnections

PrivateLinkServiceConnectionState

Object

获取或设置专用链接服务连接状态。

名称	类型	说明
actionsRequired	string	获取或设置所需的作。
description	string	获取或设置说明。
status	PrivateEndpointConnectionStatus	获取或设置状态。

ProvisioningState

枚举

获取或设置专用终结点连接的预配状态。

值	说明
Succeeded
Deleting
Failed
Pending

PublicNetworkAccess

枚举

属性，用于启用或禁用来自公共客户端的资源提供程序入站网络流量

值	说明
Enabled
Disabled

ResourceIdentityType

枚举

使用的托管标识的类型。类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。类型“None”将删除任何标识。

值	说明
SystemAssigned
None
UserAssigned
SystemAssigned, UserAssigned

ResourceMoveState

枚举

移动操作后的资源状态

值	说明
Unknown
InProgress
PrepareFailed
CommitFailed
PrepareTimedout
CommitTimedout
MoveSucceeded
Failure
CriticalFailure
PartialSuccess

RestoreSettings

Object

还原保管库的设置

名称	类型	说明
crossSubscriptionRestoreSettings	CrossSubscriptionRestoreSettings	CrossSubscriptionRestore 的设置

SecureScoreLevel

枚举

恢复服务保管库的安全分数

值	说明
None
Minimum
Adequate
Maximum

SecuritySettings

Object

保管库的安全设置

名称	类型	说明
immutabilitySettings	ImmutabilitySettings	保管库的不可变性设置
multiUserAuthorization	MultiUserAuthorization	保管库的 MUA 设置
softDeleteSettings	SoftDeleteSettings	保管库的软删除设置
sourceScanConfiguration	SourceScanConfiguration	保管库的源扫描配置

Sku

Object

标识每个 Azure 资源的唯一系统标识符。

名称	类型	说明
capacity	string	SKU 容量
family	string	SKU 系列
name	SkuName	SKU 的名称为 RS0（恢复服务第 0 版），层为标准层。它们不会影响后端存储冗余或任何其他保管库设置。若要管理存储冗余，请使用 backupstorageconfig
size	string	SKU 大小
tier	string	Sku 层。

SkuName

枚举

SKU 的名称为 RS0（恢复服务第 0 版），层为标准层。它们不会影响后端存储冗余或任何其他保管库设置。若要管理存储冗余，请使用 backupstorageconfig

值	说明
Standard
RS0

SoftDeleteSettings

Object

保管库的软删除设置

名称	类型	说明
enhancedSecurityState	EnhancedSecurityState
softDeleteRetentionPeriodInDays	integer (int32)	软删除保留期（以天为单位）
softDeleteState	SoftDeleteState

SoftDeleteState

枚举

值	说明
Invalid
Enabled
Disabled
AlwaysON

SourceScanConfiguration

Object

保管库的源扫描配置

名称	类型	说明
sourceScanIdentity	AssociatedIdentity	要用于作的标识详细信息
state	State

StandardTierStorageRedundancy

枚举

保管库的存储冗余设置

值	说明
Invalid
LocallyRedundant
GeoRedundant
ZoneRedundant

State

枚举

值	说明
Invalid
Enabled
Disabled

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

TriggerType

枚举

触发保管库升级的方式。

值	说明
UserTriggered
ForcedUpgrade

UpgradeDetails

Object

升级保管库的详细信息。

名称	类型	说明
endTimeUtc	string (date-time)	升级操作结束的 UTC 时间。
lastUpdatedTimeUtc	string (date-time)	上次更新升级操作状态的 UTC 时间。
message	string	向用户发送消息，其中包含有关升级操作的信息。
operationId	string	保管库升级操作的 ID。
previousResourceId	string	升级前保管库的资源 ID。
startTimeUtc	string (date-time)	升级操作已启动的 UTC 时间。
status	VaultUpgradeState	保管库升级操作的状态。
triggerType	TriggerType	触发保管库升级的方式。
upgradedResourceId	string	已升级保管库的资源 ID。

UserIdentity

Object

由服务用户管理的资源标识。

名称	类型	说明
clientId	string	用户分配标识的客户端 ID。
principalId	string	用户分配标识的主体 ID。

Vault

Object

资源信息，由资源提供程序返回。

名称	类型	说明
etag	string	etag 的资源。
id	string	资源的完全限定资源 ID。示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	IdentityData	资源的标识。
location	string	资源所在的地理位置
name	string	资源的名称
properties	VaultProperties	保管库的属性。
sku	Sku	标识每个 Azure 资源的唯一系统标识符。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

VaultPrivateEndpointState

枚举

用于备份的专用终结点状态。

值	说明
None
Enabled

VaultProperties

Object

保管库的属性。

名称	类型	说明
backupStorageVersion	BackupStorageVersion	备份存储版本
bcdrSecurityLevel	BCDRSecurityLevel	用于业务连续性和灾难恢复的恢复服务保管库的安全级别
encryption	VaultPropertiesEncryption	资源的客户托管密钥详细信息。
monitoringSettings	MonitoringSettings	保管库的监视设置
moveDetails	VaultPropertiesMoveDetails	对 Azure 资源执行的最新移动作的详细信息
moveState	ResourceMoveState	移动操作后的资源状态
privateEndpointConnections	PrivateEndpointConnectionVaultProperties[]	专用终结点连接列表。
privateEndpointStateForBackup	VaultPrivateEndpointState	用于备份的专用终结点状态。
privateEndpointStateForSiteRecovery	VaultPrivateEndpointState	站点恢复的专用终结点状态。
provisioningState	string	预配状态。
publicNetworkAccess	PublicNetworkAccess	属性，用于启用或禁用来自公共客户端的资源提供程序入站网络流量
redundancySettings	VaultPropertiesRedundancySettings	保管库的冗余设置
resourceGuardOperationRequests	string[]	将对其执行 LAC 检查的 ResourceGuardOperationRequests
restoreSettings	RestoreSettings	还原保管库的设置
secureScore	SecureScoreLevel	恢复服务保管库的安全分数
securitySettings	SecuritySettings	保管库的安全设置
upgradeDetails	UpgradeDetails	升级保管库的详细信息。

VaultPropertiesEncryption

Object

资源的客户托管密钥详细信息。

名称	类型	说明
infrastructureEncryption	InfrastructureEncryptionState	启用/禁用双重加密状态
kekIdentity	CmkKekIdentity	用于 CMK 的标识的详细信息
keyVaultProperties	CmkKeyVaultProperties	托管 CMK 的 Key Vault 的属性

VaultPropertiesMoveDetails

Object

对 Azure 资源执行的最新移动作的详细信息

名称	类型	说明
completionTimeUtc	string (date-time)	资源移动操作的结束时间
operationId	string	资源移动操作的 OperationId
sourceResourceId	string	资源移动操作的源资源
startTimeUtc	string (date-time)	资源移动操作的开始时间
targetResourceId	string	资源移动操作的目标资源

VaultPropertiesRedundancySettings

Object

保管库的冗余设置

名称	类型	说明
crossRegionRestore	CrossRegionRestore	在保管库上启用跨区域还原时显示的标志
standardTierStorageRedundancy	StandardTierStorageRedundancy	保管库的存储冗余设置

VaultSubResourceType

枚举

保管库 AzureBackup、AzureBackup_secondary 或 AzureSiteRecovery 的子资源类型

值	说明
AzureBackup
AzureBackup_secondary
AzureSiteRecovery

VaultUpgradeState

枚举

保管库升级操作的状态。

值	说明
Unknown
InProgress
Upgraded
Failed

通过

Vaults - Create Or Update

URI 参数

请求头

请求正文

响应

安全性

azure_auth

作用域

示例

Create or Update Recovery Services vault

示例请求

示例响应

Create or Update Vault performing critical operation With MUA

示例请求

示例响应

Create or Update Vault with CustomerManagedKeys

示例请求

示例响应

Create or Update Vault With Monitoring Setting

示例请求

示例响应

Create or Update Vault With Redundancy Setting

示例请求

示例响应

Create or Update Vault with Source scan configuration

示例请求

示例响应

Create or Update Vault with User Assigned Identity

示例请求

示例响应

定义

AlertsState

AssociatedIdentity

AzureMonitorAlertSettings

BackupStorageVersion

BCDRSecurityLevel

ClassicAlertSettings

CloudError

CmkKekIdentity

CmkKeyVaultProperties

createdByType

CrossRegionRestore

CrossSubscriptionRestoreSettings

CrossSubscriptionRestoreState

EnhancedSecurityState

Error

ErrorAdditionalInfo

IdentityData

IdentityType

ImmutabilitySettings

ImmutabilityState

InfrastructureEncryptionState

MonitoringSettings

MultiUserAuthorization

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionStatus

PrivateEndpointConnectionVaultProperties

PrivateLinkServiceConnectionState

ProvisioningState

PublicNetworkAccess

ResourceIdentityType

ResourceMoveState

RestoreSettings

SecureScoreLevel

SecuritySettings

Sku

SkuName

SoftDeleteSettings

SoftDeleteState

SourceScanConfiguration

StandardTierStorageRedundancy

State

systemData

TriggerType

UpgradeDetails

UserIdentity

Vault

VaultPrivateEndpointState