Vaults - Create Or Update

Serviço:: Recovery Services

Versão da API:: 2025-08-01

Cria ou atualiza um cofre dos Serviços de Recuperação.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
vaultName	path	True	string	O nome do Vault
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
x-ms-authorization-auxiliary		string

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A geolocalização onde o recurso vive
etag		string	etag para o recurso.
identity		IdentityData	Identidade do recurso.
properties		VaultProperties	Propriedades do cofre.
sku		Sku	Identifica o identificador de sistema exclusivo para cada recurso do Azure.
tags		object	Tags de recursos.

Respostas

Name	Tipo	Description
200 OK	Vault	Operação de atualização do recurso 'Vault' bem-sucedida
201 Created	Vault	Operação de criação do recurso 'Vault' bem-sucedida Cabeçalhos Location: string Retry-After: integer
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Name

Tipo

Description

200 OK

Vault

Operação de atualização do recurso 'Vault' bem-sucedida

201 Created

Vault

Operação de criação do recurso 'Vault' bem-sucedida

Cabeçalhos

Location: string
Retry-After: integer

Other Status Codes

CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Definições

Name	Description
AlertsState
AssociatedIdentity	Dados de identificação a utilizar numa operação
AzureMonitorAlertSettings	Configurações para alertas baseados no Azure Monitor
BackupStorageVersion	Versão de armazenamento de backup
BCDRSecurityLevel	Níveis de segurança do Recovery Services Vault para continuidade de negócios e recuperação de desastres
ClassicAlertSettings	Configurações para alertas clássicos
CloudError	Uma resposta de erro do Backup do Azure.
CmkKekIdentity	Os detalhes da identidade usada para CMK
CmkKeyVaultProperties	As propriedades do Cofre da Chave que hospeda CMK
createdByType	O tipo de identidade que criou o recurso.
CrossRegionRestore	Sinalizador para mostrar se a Restauração entre regiões está habilitada no Vault ou não
CrossSubscriptionRestoreSettings	Configurações para configurações de restauração de assinatura cruzada
CrossSubscriptionRestoreState
EnhancedSecurityState
Error	A resposta de erro de gerenciamento de recursos.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
IdentityData	Identidade do recurso.
IdentityType	Tipo de identidade que deve ser usado para uma operação.
ImmutabilitySettings	Configurações de imutabilidade do cofre
ImmutabilityState
InfrastructureEncryptionState	Ativando/Desativando o estado de Criptografia Dupla
MonitoringSettings	Configurações de monitoramento do cofre
MultiUserAuthorization	Configurações MUA do cofre
PrivateEndpoint	O recurso de rede Private Endpoint vinculado à conexão Private Endpoint.
PrivateEndpointConnection	Propriedades de resposta de conexão de ponto de extremidade privado.
PrivateEndpointConnectionStatus	Obtém ou define o status.
PrivateEndpointConnectionVaultProperties	Informações a serem armazenadas nas propriedades do Vault como um elemento da lista privateEndpointConnections.
PrivateLinkServiceConnectionState	Obtém ou define o estado da conexão do serviço de link privado.
ProvisioningState	Obtém ou define o estado de provisionamento da conexão de ponto de extremidade privado.
PublicNetworkAccess	para habilitar ou desabilitar o tráfego de rede de entrada do provedor de recursos de clientes públicos
ResourceIdentityType	O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'Nenhum' removerá todas as identidades.
ResourceMoveState	O estado do recurso após a operação de movimentação
RestoreSettings	Restaurar configurações do cofre
SecureScoreLevel	Pontuação segura do cofre dos serviços de recuperação
SecuritySettings	Configurações de segurança do cofre
Sku	Identifica o identificador de sistema exclusivo para cada recurso do Azure.
SkuName	O nome da SKU é RS0 (Recovery Services 0ª versão) e a camada é a camada padrão. Eles não afetam a redundância de armazenamento de back-end ou quaisquer outras configurações do cofre. Para gerenciar a redundância de armazenamento, use o backupstorageconfig
SoftDeleteSettings	Configurações de exclusão suave do cofre
SoftDeleteState
SourceScanConfiguration	Configuração de verificação de origem do vault
StandardTierStorageRedundancy	A configuração de redundância de armazenamento de um cofre
State
systemData	Metadados referentes à criação e última modificação do recurso.
TriggerType	A forma como a atualização do cofre foi acionada.
UpgradeDetails	Detalhes para atualizar o cofre.
UserIdentity	Uma identidade de recurso que é gerenciada pelo usuário do serviço.
Vault	Informações do recurso, conforme retornadas pelo provedor de recursos.
VaultPrivateEndpointState	Estado do ponto de extremidade privado para backup.
VaultProperties	Propriedades do cofre.
VaultPropertiesEncryption	Gerenciados pelo cliente Principais detalhes do recurso.
VaultPropertiesMoveDetails	Os detalhes da operação de movimentação mais recente executada no Recurso do Azure
VaultPropertiesRedundancySettings	As configurações de redundância de um cofre
VaultSubResourceType	Tipo de subrecurso para vault AzureBackup, AzureBackup_secondary ou AzureSiteRecovery
VaultUpgradeState	Status da operação de atualização do cofre.

AlertsState

Enumeração

Valor	Description
Enabled
Disabled

AssociatedIdentity

Object

Dados de identificação a utilizar numa operação

Name	Tipo	Description
operationIdentityType	IdentityType	Tipo de identidade que deve ser usado para uma operação.
userAssignedIdentity	string	Identidade atribuída ao usuário a ser usada para uma operação se operationIdentityType for UserAssigned.

AzureMonitorAlertSettings

Object

Configurações para alertas baseados no Azure Monitor

Name	Tipo	Description
alertsForAllFailoverIssues	AlertsState
alertsForAllJobFailures	AlertsState
alertsForAllReplicationIssues	AlertsState

BackupStorageVersion

Enumeração

Versão de armazenamento de backup

Valor	Description
V1
V2
Unassigned

BCDRSecurityLevel

Enumeração

Níveis de segurança do Recovery Services Vault para continuidade de negócios e recuperação de desastres

Valor	Description
Poor
Fair
Good
Excellent

ClassicAlertSettings

Object

Configurações para alertas clássicos

Name	Tipo	Description
alertsForCriticalOperations	AlertsState
emailNotificationsForSiteRecovery	AlertsState

CloudError

Object

Uma resposta de erro do Backup do Azure.

Name	Tipo	Description
error	Error	A resposta de erro de gerenciamento de recursos.

CmkKekIdentity

Object

Os detalhes da identidade usada para CMK

Name	Tipo	Description
useSystemAssignedIdentity	boolean	Indique que a identidade atribuída ao sistema deve ser usada. Mutuamente exclusivo com o campo 'userAssignedIdentity'
userAssignedIdentity	string	A identidade atribuída ao usuário a ser usada para conceder permissões caso o tipo de identidade usado seja UserAssigned

CmkKeyVaultProperties

Object

As propriedades do Cofre da Chave que hospeda CMK

Name	Tipo	Description
keyUri	string	O uri de chave da chave gerenciada pelo cliente

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

CrossRegionRestore

Enumeração

Sinalizador para mostrar se a Restauração entre regiões está habilitada no Vault ou não

Valor	Description
Enabled
Disabled

CrossSubscriptionRestoreSettings

Object

Configurações para configurações de restauração de assinatura cruzada

Name	Tipo	Description
crossSubscriptionRestoreState	CrossSubscriptionRestoreState

CrossSubscriptionRestoreState

Enumeração

Valor	Description
Enabled
Disabled
PermanentlyDisabled

EnhancedSecurityState

Enumeração

Valor	Description
Invalid
Enabled
Disabled
AlwaysON

Error

Object

A resposta de erro de gerenciamento de recursos.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	Error[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

IdentityData

Object

Identidade do recurso.

Name	Tipo	Description
principalId	string	A ID principal da identidade do recurso.
tenantId	string	A ID do locatário do recurso.
type	ResourceIdentityType	O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'Nenhum' removerá todas as identidades.
userAssignedIdentities	<string, UserIdentity>	A lista de identidades atribuídas pelo usuário associadas ao recurso. As chaves de dicionário de identidade atribuídas pelo usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Enumeração

Tipo de identidade que deve ser usado para uma operação.

Valor	Description
SystemAssigned
UserAssigned

ImmutabilitySettings

Object

Configurações de imutabilidade do cofre

Name	Tipo	Description
state	ImmutabilityState

ImmutabilityState

Enumeração

Valor	Description
Disabled
Unlocked
Locked

InfrastructureEncryptionState

Enumeração

Ativando/Desativando o estado de Criptografia Dupla

Valor	Description
Enabled
Disabled

MonitoringSettings

Object

Configurações de monitoramento do cofre

Name	Tipo	Description
azureMonitorAlertSettings	AzureMonitorAlertSettings	Configurações para alertas baseados no Azure Monitor
classicAlertSettings	ClassicAlertSettings	Configurações para alertas clássicos

MultiUserAuthorization

Enumeração

Configurações MUA do cofre

Valor	Description
Invalid
Enabled
Disabled

PrivateEndpoint

Object

O recurso de rede Private Endpoint vinculado à conexão Private Endpoint.

Name	Tipo	Description
id	string	Obtém ou define id.

PrivateEndpointConnection

Object

Propriedades de resposta de conexão de ponto de extremidade privado.

Name	Tipo	Description
groupIds	VaultSubResourceType[]	IDs de grupo para o ponto de extremidade privado
privateEndpoint	PrivateEndpoint	O recurso de rede Private Endpoint vinculado à conexão Private Endpoint.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Obtém ou define o estado da conexão do serviço de link privado.
provisioningState	ProvisioningState	Obtém ou define o estado de provisionamento da conexão de ponto de extremidade privado.

PrivateEndpointConnectionStatus

Enumeração

Obtém ou define o status.

Valor	Description
Pending
Approved
Rejected
Disconnected

PrivateEndpointConnectionVaultProperties

Object

Informações a serem armazenadas nas propriedades do Vault como um elemento da lista privateEndpointConnections.

Name	Tipo	Description
id	string	Formato de id subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. [Serviço]/{resource}/{resourceName}/privateEndpointConnections/{connectionName}.
location	string	O local da conexão privada do Endpoint
name	string	O nome da Conexão de Ponto Final privada
properties	PrivateEndpointConnection	Propriedades de resposta de conexão de ponto de extremidade privado.
type	string	O tipo, que será do formato, Microsoft.RecoveryServices/vaults/privateEndpointConnections

PrivateLinkServiceConnectionState

Object

Obtém ou define o estado da conexão do serviço de link privado.

Name	Tipo	Description
actionsRequired	string	Obtém ou define as ações necessárias.
description	string	Obtém ou define a descrição.
status	PrivateEndpointConnectionStatus	Obtém ou define o status.

ProvisioningState

Enumeração

Obtém ou define o estado de provisionamento da conexão de ponto de extremidade privado.

Valor	Description
Succeeded
Deleting
Failed
Pending

PublicNetworkAccess

Enumeração

para habilitar ou desabilitar o tráfego de rede de entrada do provedor de recursos de clientes públicos

Valor	Description
Enabled
Disabled

ResourceIdentityType

Enumeração

O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'Nenhum' removerá todas as identidades.

Valor	Description
SystemAssigned
None
UserAssigned
SystemAssigned, UserAssigned

ResourceMoveState

Enumeração

O estado do recurso após a operação de movimentação

Valor	Description
Unknown
InProgress
PrepareFailed
CommitFailed
PrepareTimedout
CommitTimedout
MoveSucceeded
Failure
CriticalFailure
PartialSuccess

RestoreSettings

Object

Restaurar configurações do cofre

Name	Tipo	Description
crossSubscriptionRestoreSettings	CrossSubscriptionRestoreSettings	Configurações para CrossSubscriptionRestore

SecureScoreLevel

Enumeração

Pontuação segura do cofre dos serviços de recuperação

Valor	Description
None
Minimum
Adequate
Maximum

SecuritySettings

Object

Configurações de segurança do cofre

Name	Tipo	Description
immutabilitySettings	ImmutabilitySettings	Configurações de imutabilidade de um cofre
multiUserAuthorization	MultiUserAuthorization	Configurações MUA de um cofre
softDeleteSettings	SoftDeleteSettings	Configurações de exclusão suave de um cofre
sourceScanConfiguration	SourceScanConfiguration	Configuração de verificação de origem do vault

Sku

Object

Identifica o identificador de sistema exclusivo para cada recurso do Azure.

Name	Tipo	Description
capacity	string	A capacidade de sku
family	string	A família sku
name	SkuName	O nome da SKU é RS0 (Recovery Services 0ª versão) e a camada é a camada padrão. Eles não afetam a redundância de armazenamento de back-end ou quaisquer outras configurações do cofre. Para gerenciar a redundância de armazenamento, use o backupstorageconfig
size	string	O tamanho do sku
tier	string	O nível Sku.

SkuName

Enumeração

O nome da SKU é RS0 (Recovery Services 0ª versão) e a camada é a camada padrão. Eles não afetam a redundância de armazenamento de back-end ou quaisquer outras configurações do cofre. Para gerenciar a redundância de armazenamento, use o backupstorageconfig

Valor	Description
Standard
RS0

SoftDeleteSettings

Object

Configurações de exclusão suave do cofre

Name	Tipo	Description
enhancedSecurityState	EnhancedSecurityState
softDeleteRetentionPeriodInDays	integer (int32)	Período de retenção de exclusão suave em dias
softDeleteState	SoftDeleteState

SoftDeleteState

Enumeração

Valor	Description
Invalid
Enabled
Disabled
AlwaysON

SourceScanConfiguration

Object

Configuração de verificação de origem do vault

Name	Tipo	Description
sourceScanIdentity	AssociatedIdentity	Dados de identificação a utilizar numa operação
state	State

StandardTierStorageRedundancy

Enumeração

A configuração de redundância de armazenamento de um cofre

Valor	Description
Invalid
LocallyRedundant
GeoRedundant
ZoneRedundant

State

Enumeração

Valor	Description
Invalid
Enabled
Disabled

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TriggerType

Enumeração

A forma como a atualização do cofre foi acionada.

Valor	Description
UserTriggered
ForcedUpgrade

UpgradeDetails

Object

Detalhes para atualizar o cofre.

Name	Tipo	Description
endTimeUtc	string (date-time)	Hora UTC em que a operação de atualização terminou.
lastUpdatedTimeUtc	string (date-time)	Hora UTC em que o status da operação de atualização foi atualizado pela última vez.
message	string	Mensagem para o usuário contendo informações sobre a operação de atualização.
operationId	string	ID da operação de atualização do cofre.
previousResourceId	string	ID do recurso do cofre antes da atualização.
startTimeUtc	string (date-time)	Hora UTC em que a operação de atualização foi iniciada.
status	VaultUpgradeState	Status da operação de atualização do cofre.
triggerType	TriggerType	A forma como a atualização do cofre foi acionada.
upgradedResourceId	string	ID do recurso do cofre atualizado.

UserIdentity

Object

Uma identidade de recurso que é gerenciada pelo usuário do serviço.

Name	Tipo	Description
clientId	string	O ID do cliente da identidade atribuída pelo usuário.
principalId	string	O ID principal da identidade atribuída pelo usuário.

Vault

Object

Informações do recurso, conforme retornadas pelo provedor de recursos.

Name	Tipo	Description
etag	string	etag para o recurso.
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	IdentityData	Identidade do recurso.
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties	VaultProperties	Propriedades do cofre.
sku	Sku	Identifica o identificador de sistema exclusivo para cada recurso do Azure.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

VaultPrivateEndpointState

Enumeração

Estado do ponto de extremidade privado para backup.

Valor	Description
None
Enabled

VaultProperties

Object

Propriedades do cofre.

Name	Tipo	Description
backupStorageVersion	BackupStorageVersion	Versão de armazenamento de backup
bcdrSecurityLevel	BCDRSecurityLevel	Níveis de segurança do Recovery Services Vault para continuidade de negócios e recuperação de desastres
encryption	VaultPropertiesEncryption	Gerenciados pelo cliente Principais detalhes do recurso.
monitoringSettings	MonitoringSettings	Configurações de monitoramento do cofre
moveDetails	VaultPropertiesMoveDetails	Os detalhes da operação de movimentação mais recente executada no Recurso do Azure
moveState	ResourceMoveState	O estado do recurso após a operação de movimentação
privateEndpointConnections	PrivateEndpointConnectionVaultProperties[]	Lista de conexão de ponto final privado.
privateEndpointStateForBackup	VaultPrivateEndpointState	Estado do ponto de extremidade privado para backup.
privateEndpointStateForSiteRecovery	VaultPrivateEndpointState	Estado do ponto de extremidade privado para recuperação do site.
provisioningState	string	Estado de provisionamento.
publicNetworkAccess	PublicNetworkAccess	para habilitar ou desabilitar o tráfego de rede de entrada do provedor de recursos de clientes públicos
redundancySettings	VaultPropertiesRedundancySettings	As configurações de redundância de um cofre
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests em que a verificação LAC será executada
restoreSettings	RestoreSettings	Restaurar configurações do cofre
secureScore	SecureScoreLevel	Pontuação segura do cofre dos serviços de recuperação
securitySettings	SecuritySettings	Configurações de segurança do cofre
upgradeDetails	UpgradeDetails	Detalhes para atualizar o cofre.

VaultPropertiesEncryption

Object

Gerenciados pelo cliente Principais detalhes do recurso.

Name	Tipo	Description
infrastructureEncryption	InfrastructureEncryptionState	Ativando/Desativando o estado de Criptografia Dupla
kekIdentity	CmkKekIdentity	Os detalhes da identidade usada para CMK
keyVaultProperties	CmkKeyVaultProperties	As propriedades do Cofre da Chave que hospeda CMK

VaultPropertiesMoveDetails

Object

Os detalhes da operação de movimentação mais recente executada no Recurso do Azure

Name	Tipo	Description
completionTimeUtc	string (date-time)	Hora de término da operação de movimentação de recursos
operationId	string	OperationId da operação de movimentação de recursos
sourceResourceId	string	Recurso de origem da operação de movimentação de recursos
startTimeUtc	string (date-time)	Hora de início da operação de movimentação de recursos
targetResourceId	string	Recurso de destino da operação de movimentação de recursos

VaultPropertiesRedundancySettings

Object

As configurações de redundância de um cofre

Name	Tipo	Description
crossRegionRestore	CrossRegionRestore	Sinalizador para mostrar se a Restauração entre regiões está habilitada no Vault ou não
standardTierStorageRedundancy	StandardTierStorageRedundancy	A configuração de redundância de armazenamento de um cofre

VaultSubResourceType

Enumeração

Tipo de subrecurso para vault AzureBackup, AzureBackup_secondary ou AzureSiteRecovery

Valor	Description
AzureBackup
AzureBackup_secondary
AzureSiteRecovery

VaultUpgradeState

Enumeração

Status da operação de atualização do cofre.

Valor	Description
Unknown
InProgress
Upgraded
Failed

Partilhar via

Vaults - Create Or Update

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create or Update Recovery Services vault

Pedido de amostra

Resposta da amostra

Create or Update Vault performing critical operation With MUA

Pedido de amostra

Resposta da amostra

Create or Update Vault with CustomerManagedKeys

Pedido de amostra

Resposta da amostra

Create or Update Vault With Monitoring Setting

Pedido de amostra

Resposta da amostra

Create or Update Vault With Redundancy Setting

Pedido de amostra

Resposta da amostra

Create or Update Vault with Source scan configuration

Pedido de amostra

Resposta da amostra

Create or Update Vault with User Assigned Identity

Pedido de amostra

Resposta da amostra

Definições

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