Compartilhar via


Vaults - Create Or Update

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 de URI

Nome Em Obrigató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 ser usada para esta operação.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
x-ms-authorization-auxiliary

string

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

A localização geográfica onde o recurso reside

etag

string

etag para o recurso.

identity

IdentityData

Identidade do recurso.

properties

VaultProperties

Propriedades do cofre.

sku

Sku

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

tags

object

Tags de recursos.

Respostas

Nome 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 do OAuth2 do Azure Active Directory.

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Nome Description
AlertsState
AssociatedIdentity

Detalhes de identidade a serem usados para uma 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 Cofre dos Serviços de Recuperação para continuidade dos negócios e recuperação de desastre

ClassicAlertSettings

Configurações para alertas clássicos

CloudError

Uma resposta de erro do Backup do Azure.

CmkKekIdentity

Os detalhes da identidade usada para o CMK

CmkKeyVaultProperties

As propriedades do Key Vault que hospeda o CMK

createdByType

O tipo de identidade que criou o recurso.

CrossRegionRestore

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

CrossSubscriptionRestoreSettings

Configurações para configurações de restauração entre assinaturas

CrossSubscriptionRestoreState
EnhancedSecurityState
Error

A resposta de erro de gerenciamento de recursos.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

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

Habilitando/desabilitando o estado de Criptografia Dupla

MonitoringSettings

Configurações de monitoramento do cofre

MultiUserAuthorization

Configurações de MUA do cofre

PrivateEndpoint

O recurso de rede de ponto de extremidade privado que está vinculado à conexão de ponto de extremidade privado.

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 Cofre como um elemento da lista privateEndpointConnections.

PrivateLinkServiceConnectionState

Obtém ou define o estado de 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 'None' removerá as identidades.

ResourceMoveState

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

RestoreSettings

Restaurar configurações do cofre

SecureScoreLevel

Classificação segura do Cofre dos Serviços de Recuperação

SecuritySettings

Configurações de segurança do cofre

Sku

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

SkuName

O nome da SKU é RS0 (0ª versão dos Serviços de Recuperação) e a camada é padrão. Eles não têm efeito na redundância de armazenamento de back-end ou em nenhuma outra configuração do cofre. Para gerenciar a redundância de armazenamento, use o backupstorageconfig

SoftDeleteSettings

Configurações de exclusão reversível do cofre

SoftDeleteState
SourceScanConfiguration

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

StandardTierStorageRedundancy

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

State
systemData

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

TriggerType

A maneira como a atualização do cofre foi disparada.

UpgradeDetails

Detalhes para atualizar o cofre.

UserIdentity

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

Vault

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

VaultPrivateEndpointState

Estado do ponto de extremidade privado para backup.

VaultProperties

Propriedades do cofre.

VaultPropertiesEncryption

Detalhes da Chave Gerenciada do Cliente 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 sub-fonte para cofre AzureBackup, AzureBackup_secondary ou AzureSiteRecovery

VaultUpgradeState

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

AlertsState

Valor Description
Enabled
Disabled

AssociatedIdentity

Detalhes de identidade a serem usados para uma operação

Nome Tipo Description
operationIdentityType

IdentityType

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

userAssignedIdentity

string

Identidade atribuída pelo usuário a ser usada para uma operação se operationIdentityType for UserAssigned.

AzureMonitorAlertSettings

Configurações para alertas baseados no Azure Monitor

Nome Tipo Description
alertsForAllFailoverIssues

AlertsState

alertsForAllJobFailures

AlertsState

alertsForAllReplicationIssues

AlertsState

BackupStorageVersion

Versão de armazenamento de backup

Valor Description
V1
V2
Unassigned

BCDRSecurityLevel

Níveis de segurança do Cofre dos Serviços de Recuperação para continuidade dos negócios e recuperação de desastre

Valor Description
Poor
Fair
Good
Excellent

ClassicAlertSettings

Configurações para alertas clássicos

Nome Tipo Description
alertsForCriticalOperations

AlertsState

emailNotificationsForSiteRecovery

AlertsState

CloudError

Uma resposta de erro do Backup do Azure.

Nome Tipo Description
error

Error

A resposta de erro de gerenciamento de recursos.

CmkKekIdentity

Os detalhes da identidade usada para o CMK

Nome Tipo Description
useSystemAssignedIdentity

boolean

Indique que a identidade atribuída pelo sistema deve ser usada. Mutuamente exclusivo com o campo 'userAssignedIdentity'

userAssignedIdentity

string

A identidade atribuída pelo usuário a ser usada para conceder permissões caso o tipo de identidade usada seja UserAssigned

CmkKeyVaultProperties

As propriedades do Key Vault que hospeda o CMK

Nome Tipo Description
keyUri

string

O uri de chave da chave gerenciada pelo cliente

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

CrossRegionRestore

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

Valor Description
Enabled
Disabled

CrossSubscriptionRestoreSettings

Configurações para configurações de restauração entre assinaturas

Nome Tipo Description
crossSubscriptionRestoreState

CrossSubscriptionRestoreState

CrossSubscriptionRestoreState

Valor Description
Enabled
Disabled
PermanentlyDisabled

EnhancedSecurityState

Valor Description
Invalid
Enabled
Disabled
AlwaysON

Error

A resposta de erro de gerenciamento de recursos.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

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

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

IdentityData

Identidade do recurso.

Nome 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 'None' removerá 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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

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

Valor Description
SystemAssigned
UserAssigned

ImmutabilitySettings

Configurações de Imutabilidade do cofre

Nome Tipo Description
state

ImmutabilityState

ImmutabilityState

Valor Description
Disabled
Unlocked
Locked

InfrastructureEncryptionState

Habilitando/desabilitando o estado de Criptografia Dupla

Valor Description
Enabled
Disabled

MonitoringSettings

Configurações de monitoramento do cofre

Nome Tipo Description
azureMonitorAlertSettings

AzureMonitorAlertSettings

Configurações para alertas baseados no Azure Monitor

classicAlertSettings

ClassicAlertSettings

Configurações para alertas clássicos

MultiUserAuthorization

Configurações de MUA do cofre

Valor Description
Invalid
Enabled
Disabled

PrivateEndpoint

O recurso de rede de ponto de extremidade privado que está vinculado à conexão de ponto de extremidade privado.

Nome Tipo Description
id

string

Obtém ou define a ID.

PrivateEndpointConnection

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

Nome Tipo Description
groupIds

VaultSubResourceType[]

IDs de grupo para o ponto de extremidade privado

privateEndpoint

PrivateEndpoint

O recurso de rede de ponto de extremidade privado que está vinculado à conexão de ponto de extremidade privado.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Obtém ou define o estado de 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

Obtém ou define o status.

Valor Description
Pending
Approved
Rejected
Disconnected

PrivateEndpointConnectionVaultProperties

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

Nome Tipo Description
id

string

Formato de assinaturas de ID/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. [Serviço]/{resource}/{resourceName}/privateEndpointConnections/{connectionName}.

location

string

O local da conexão de ponto de extremidade privado

name

string

O nome da conexão de ponto de extremidade privado

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

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

Nome 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

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

Valor Description
Succeeded
Deleting
Failed
Pending

PublicNetworkAccess

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

Valor Description
Enabled
Disabled

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 'None' removerá as identidades.

Valor Description
SystemAssigned
None
UserAssigned
SystemAssigned, UserAssigned

ResourceMoveState

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

Restaurar configurações do cofre

Nome Tipo Description
crossSubscriptionRestoreSettings

CrossSubscriptionRestoreSettings

Configurações para CrossSubscriptionRestore

SecureScoreLevel

Classificação segura do Cofre dos Serviços de Recuperação

Valor Description
None
Minimum
Adequate
Maximum

SecuritySettings

Configurações de segurança do cofre

Nome Tipo Description
immutabilitySettings

ImmutabilitySettings

Configurações de Imutabilidade de um cofre

multiUserAuthorization

MultiUserAuthorization

Configurações de MUA de um cofre

softDeleteSettings

SoftDeleteSettings

Configurações de exclusão reversível de um cofre

sourceScanConfiguration

SourceScanConfiguration

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

Sku

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

Nome Tipo Description
capacity

string

A capacidade de sku

family

string

A família sku

name

SkuName

O nome da SKU é RS0 (0ª versão dos Serviços de Recuperação) e a camada é padrão. Eles não têm efeito na redundância de armazenamento de back-end ou em nenhuma outra configuração do cofre. Para gerenciar a redundância de armazenamento, use o backupstorageconfig

size

string

O tamanho do sku

tier

string

A camada de Sku.

SkuName

O nome da SKU é RS0 (0ª versão dos Serviços de Recuperação) e a camada é padrão. Eles não têm efeito na redundância de armazenamento de back-end ou em nenhuma outra configuração do cofre. Para gerenciar a redundância de armazenamento, use o backupstorageconfig

Valor Description
Standard
RS0

SoftDeleteSettings

Configurações de exclusão reversível do cofre

Nome Tipo Description
enhancedSecurityState

EnhancedSecurityState

softDeleteRetentionPeriodInDays

integer (int32)

Período de retenção de exclusão reversível em dias

softDeleteState

SoftDeleteState

SoftDeleteState

Valor Description
Invalid
Enabled
Disabled
AlwaysON

SourceScanConfiguration

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

Nome Tipo Description
sourceScanIdentity

AssociatedIdentity

Detalhes de identidade a serem usados para uma operação

state

State

StandardTierStorageRedundancy

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

Valor Description
Invalid
LocallyRedundant
GeoRedundant
ZoneRedundant

State

Valor Description
Invalid
Enabled
Disabled

systemData

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

Nome 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

A maneira como a atualização do cofre foi disparada.

Valor Description
UserTriggered
ForcedUpgrade

UpgradeDetails

Detalhes para atualizar o cofre.

Nome 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 que contém 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 na qual a operação de atualização foi iniciada.

status

VaultUpgradeState

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

triggerType

TriggerType

A maneira como a atualização do cofre foi disparada.

upgradedResourceId

string

ID do recurso do cofre atualizado.

UserIdentity

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

Nome Tipo Description
clientId

string

A ID do cliente da identidade atribuída pelo usuário.

principalId

string

A ID principal da identidade atribuída pelo usuário.

Vault

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

Nome Tipo Description
etag

string

etag para o recurso.

id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

IdentityData

Identidade do recurso.

location

string

A localização geográfica onde o recurso reside

name

string

O nome do recurso

properties

VaultProperties

Propriedades do cofre.

sku

Sku

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

systemData

systemData

Metadados do Azure Resource Manager que contêm 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

Estado do ponto de extremidade privado para backup.

Valor Description
None
Enabled

VaultProperties

Propriedades do cofre.

Nome Tipo Description
backupStorageVersion

BackupStorageVersion

Versão de armazenamento de backup

bcdrSecurityLevel

BCDRSecurityLevel

Níveis de segurança do Cofre dos Serviços de Recuperação para continuidade dos negócios e recuperação de desastre

encryption

VaultPropertiesEncryption

Detalhes da Chave Gerenciada do Cliente 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 de extremidade privado.

privateEndpointStateForBackup

VaultPrivateEndpointState

Estado do ponto de extremidade privado para backup.

privateEndpointStateForSiteRecovery

VaultPrivateEndpointState

Estado do ponto de extremidade privado para recuperação de 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 no qual a verificação LAC será executada

restoreSettings

RestoreSettings

Restaurar configurações do cofre

secureScore

SecureScoreLevel

Classificaçã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

Detalhes da Chave Gerenciada do Cliente do recurso.

Nome Tipo Description
infrastructureEncryption

InfrastructureEncryptionState

Habilitando/desabilitando o estado de Criptografia Dupla

kekIdentity

CmkKekIdentity

Os detalhes da identidade usada para o CMK

keyVaultProperties

CmkKeyVaultProperties

As propriedades do Key Vault que hospeda o CMK

VaultPropertiesMoveDetails

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

Nome 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

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

Nome Tipo Description
crossRegionRestore

CrossRegionRestore

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

standardTierStorageRedundancy

StandardTierStorageRedundancy

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

VaultSubResourceType

Tipo de sub-fonte para cofre AzureBackup, AzureBackup_secondary ou AzureSiteRecovery

Valor Description
AzureBackup
AzureBackup_secondary
AzureSiteRecovery

VaultUpgradeState

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

Valor Description
Unknown
InProgress
Upgraded
Failed