Partager via


Vaults - Create Or Update

Crée ou met à jour un coffre Recovery Services.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string

minLength: 1

ID de l’abonnement cible.

vaultName
path True

string

Le nom de l’Abri

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom Obligatoire Type Description
x-ms-authorization-auxiliary

string

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource

etag

string

etag pour la ressource.

identity

IdentityData

Identité de la ressource.

properties

VaultProperties

Propriétés du coffre.

sku

Sku

Identifie l’identificateur système unique pour chaque ressource Azure.

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

Vault

Réussite de l’opération de mise à jour de la ressource « Coffre-fort »

201 Created

Vault

Réussite de l’opération de création de la ressource 'Vault'

En-têtes

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

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

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
AlertsState
AssociatedIdentity

Détails de l’identité à utiliser pour une opération

AzureMonitorAlertSettings

Paramètres des alertes basées sur Azure Monitor

BackupStorageVersion

Version du stockage de sauvegarde

BCDRSecurityLevel

Niveaux de sécurité du coffre Recovery Services pour la continuité d’activité et la récupération d’urgence

ClassicAlertSettings

Paramètres des alertes classiques

CloudError

Réponse d’erreur de Sauvegarde Azure.

CmkKekIdentity

Détails de l’identité utilisée pour CMK

CmkKeyVaultProperties

Propriétés du coffre de clés qui héberge CMK

createdByType

Type d’identité qui a créé la ressource.

CrossRegionRestore

Indicateur pour indiquer si la restauration interrégion est activée sur le coffre ou non

CrossSubscriptionRestoreSettings

Paramètres pour les paramètres de restauration entre abonnements

CrossSubscriptionRestoreState
EnhancedSecurityState
Error

Réponse d’erreur de gestion des ressources.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

IdentityData

Identité de la ressource.

IdentityType

Type d’identité qui doit être utilisé pour une opération.

ImmutabilitySettings

Paramètres d’immuabilité du coffre

ImmutabilityState
InfrastructureEncryptionState

Activation/désactivation de l’état double chiffrement

MonitoringSettings

Paramètres de surveillance du coffre

MultiUserAuthorization

Paramètres MUA du coffre

PrivateEndpoint

Ressource réseau de point de terminaison privé liée à la connexion de point de terminaison privé.

PrivateEndpointConnection

Propriétés de la réponse de connexion de point de terminaison privé.

PrivateEndpointConnectionStatus

Obtient ou définit l’état.

PrivateEndpointConnectionVaultProperties

Informations à stocker dans les propriétés du coffre en tant qu’élément de privateEndpointConnections List.

PrivateLinkServiceConnectionState

Obtient ou définit l’état de connexion du service de liaison privée.

ProvisioningState

Obtient ou définit l’état d’approvisionnement de la connexion de point de terminaison privé.

PublicNetworkAccess

pour activer ou désactiver le trafic réseau entrant du fournisseur de ressources à partir de clients publics

ResourceIdentityType

Type d’identité managée utilisée. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités.

ResourceMoveState

État de la ressource après l’opération de déplacement

RestoreSettings

Restaurer les paramètres du coffre

SecureScoreLevel

Degré de sécurisation du coffre Recovery Services

SecuritySettings

Paramètres de sécurité du coffre

Sku

Identifie l’identificateur système unique pour chaque ressource Azure.

SkuName

Le nom de la référence SKU est RS0 (recovery Services 0e version) et le niveau est de niveau standard. Ils n’ont aucune incidence sur la redondance du stockage back-end ou sur d’autres paramètres de coffre. Pour gérer la redondance du stockage, utilisez backupstorageconfig

SoftDeleteSettings

Paramètres de suppression réversible du coffre

SoftDeleteState
SourceScanConfiguration

Configuration de l’analyse source du coffre

StandardTierStorageRedundancy

Paramètre de redondance de stockage d’un coffre

State
systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

TriggerType

La façon dont la mise à niveau du coffre a été déclenchée.

UpgradeDetails

Détails de la mise à niveau du coffre.

UserIdentity

Identité de ressource gérée par l’utilisateur du service.

Vault

Informations sur les ressources, telles qu’retournées par le fournisseur de ressources.

VaultPrivateEndpointState

État du point de terminaison privé pour la sauvegarde.

VaultProperties

Propriétés du coffre.

VaultPropertiesEncryption

Détails de la clé gérée par le client de la ressource.

VaultPropertiesMoveDetails

Détails de la dernière opération de déplacement effectuée sur la ressource Azure

VaultPropertiesRedundancySettings

Paramètres de redondance d’un coffre

VaultSubResourceType

Type de sous-ressource pour le coffre AzureBackup, AzureBackup_secondary ou AzureSiteRecovery

VaultUpgradeState

État de l’opération de mise à niveau du coffre.

AlertsState

Valeur Description
Enabled
Disabled

AssociatedIdentity

Détails de l’identité à utiliser pour une opération

Nom Type Description
operationIdentityType

IdentityType

Type d’identité qui doit être utilisé pour une opération.

userAssignedIdentity

string

L’identité affectée par l’utilisateur doit être utilisée pour une opération si operationIdentityType est UserAssigned.

AzureMonitorAlertSettings

Paramètres des alertes basées sur Azure Monitor

Nom Type Description
alertsForAllFailoverIssues

AlertsState

alertsForAllJobFailures

AlertsState

alertsForAllReplicationIssues

AlertsState

BackupStorageVersion

Version du stockage de sauvegarde

Valeur Description
V1
V2
Unassigned

BCDRSecurityLevel

Niveaux de sécurité du coffre Recovery Services pour la continuité d’activité et la récupération d’urgence

Valeur Description
Poor
Fair
Good
Excellent

ClassicAlertSettings

Paramètres des alertes classiques

Nom Type Description
alertsForCriticalOperations

AlertsState

emailNotificationsForSiteRecovery

AlertsState

CloudError

Réponse d’erreur de Sauvegarde Azure.

Nom Type Description
error

Error

Réponse d’erreur de gestion des ressources.

CmkKekIdentity

Détails de l’identité utilisée pour CMK

Nom Type Description
useSystemAssignedIdentity

boolean

Indiquez que l’identité affectée par le système doit être utilisée. Mutuellement exclusif avec le champ « userAssignedIdentity »

userAssignedIdentity

string

Identité affectée par l’utilisateur à utiliser pour accorder des autorisations au cas où le type d’identité utilisé est UserAssigned

CmkKeyVaultProperties

Propriétés du coffre de clés qui héberge CMK

Nom Type Description
keyUri

string

URI de clé de la clé gérée par le client

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

CrossRegionRestore

Indicateur pour indiquer si la restauration interrégion est activée sur le coffre ou non

Valeur Description
Enabled
Disabled

CrossSubscriptionRestoreSettings

Paramètres pour les paramètres de restauration entre abonnements

Nom Type Description
crossSubscriptionRestoreState

CrossSubscriptionRestoreState

CrossSubscriptionRestoreState

Valeur Description
Enabled
Disabled
PermanentlyDisabled

EnhancedSecurityState

Valeur Description
Invalid
Enabled
Disabled
AlwaysON

Error

Réponse d’erreur de gestion des ressources.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

Error[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

IdentityData

Identité de la ressource.

Nom Type Description
principalId

string

ID principal de l’identité de ressource.

tenantId

string

ID de locataire de la ressource.

type

ResourceIdentityType

Type d’identité managée utilisée. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités.

userAssignedIdentities

<string,  UserIdentity>

Liste des identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire d’identité attribuées par l’utilisateur seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

IdentityType

Type d’identité qui doit être utilisé pour une opération.

Valeur Description
SystemAssigned
UserAssigned

ImmutabilitySettings

Paramètres d’immuabilité du coffre

Nom Type Description
state

ImmutabilityState

ImmutabilityState

Valeur Description
Disabled
Unlocked
Locked

InfrastructureEncryptionState

Activation/désactivation de l’état double chiffrement

Valeur Description
Enabled
Disabled

MonitoringSettings

Paramètres de surveillance du coffre

Nom Type Description
azureMonitorAlertSettings

AzureMonitorAlertSettings

Paramètres des alertes basées sur Azure Monitor

classicAlertSettings

ClassicAlertSettings

Paramètres des alertes classiques

MultiUserAuthorization

Paramètres MUA du coffre

Valeur Description
Invalid
Enabled
Disabled

PrivateEndpoint

Ressource réseau de point de terminaison privé liée à la connexion de point de terminaison privé.

Nom Type Description
id

string

Obtient ou définit l’ID.

PrivateEndpointConnection

Propriétés de la réponse de connexion de point de terminaison privé.

Nom Type Description
groupIds

VaultSubResourceType[]

ID de groupe pour le point de terminaison privé

privateEndpoint

PrivateEndpoint

Ressource réseau de point de terminaison privé liée à la connexion de point de terminaison privé.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Obtient ou définit l’état de connexion du service de liaison privée.

provisioningState

ProvisioningState

Obtient ou définit l’état d’approvisionnement de la connexion de point de terminaison privé.

PrivateEndpointConnectionStatus

Obtient ou définit l’état.

Valeur Description
Pending
Approved
Rejected
Disconnected

PrivateEndpointConnectionVaultProperties

Informations à stocker dans les propriétés du coffre en tant qu’élément de privateEndpointConnections List.

Nom Type Description
id

string

Format des abonnements id/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. [Service]/{resource}/{resourceName}/privateEndpointConnections/{connectionName}.

location

string

Emplacement de la connexion de point de terminaison privé

name

string

Nom de la connexion de point de terminaison privé

properties

PrivateEndpointConnection

Propriétés de la réponse de connexion de point de terminaison privé.

type

string

Type, qui sera au format, Microsoft.RecoveryServices/vaults/privateEndpointConnections

PrivateLinkServiceConnectionState

Obtient ou définit l’état de connexion du service de liaison privée.

Nom Type Description
actionsRequired

string

Obtient ou définit les actions requises.

description

string

Obtient ou définit la description.

status

PrivateEndpointConnectionStatus

Obtient ou définit l’état.

ProvisioningState

Obtient ou définit l’état d’approvisionnement de la connexion de point de terminaison privé.

Valeur Description
Succeeded
Deleting
Failed
Pending

PublicNetworkAccess

pour activer ou désactiver le trafic réseau entrant du fournisseur de ressources à partir de clients publics

Valeur Description
Enabled
Disabled

ResourceIdentityType

Type d’identité managée utilisée. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités.

Valeur Description
SystemAssigned
None
UserAssigned
SystemAssigned, UserAssigned

ResourceMoveState

État de la ressource après l’opération de déplacement

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

RestoreSettings

Restaurer les paramètres du coffre

Nom Type Description
crossSubscriptionRestoreSettings

CrossSubscriptionRestoreSettings

Paramètres de CrossSubscriptionRestore

SecureScoreLevel

Degré de sécurisation du coffre Recovery Services

Valeur Description
None
Minimum
Adequate
Maximum

SecuritySettings

Paramètres de sécurité du coffre

Nom Type Description
immutabilitySettings

ImmutabilitySettings

Paramètres d’immuabilité d’un coffre

multiUserAuthorization

MultiUserAuthorization

Paramètres MUA d’un coffre

softDeleteSettings

SoftDeleteSettings

Paramètres de suppression réversible d’un coffre

sourceScanConfiguration

SourceScanConfiguration

Configuration de l’analyse source du coffre

Sku

Identifie l’identificateur système unique pour chaque ressource Azure.

Nom Type Description
capacity

string

Capacité de référence SKU

family

string

Famille de références SKU

name

SkuName

Le nom de la référence SKU est RS0 (recovery Services 0e version) et le niveau est de niveau standard. Ils n’ont aucune incidence sur la redondance du stockage back-end ou sur d’autres paramètres de coffre. Pour gérer la redondance du stockage, utilisez backupstorageconfig

size

string

Taille de la référence SKU

tier

string

Niveau de référence SKU.

SkuName

Le nom de la référence SKU est RS0 (recovery Services 0e version) et le niveau est de niveau standard. Ils n’ont aucune incidence sur la redondance du stockage back-end ou sur d’autres paramètres de coffre. Pour gérer la redondance du stockage, utilisez backupstorageconfig

Valeur Description
Standard
RS0

SoftDeleteSettings

Paramètres de suppression réversible du coffre

Nom Type Description
enhancedSecurityState

EnhancedSecurityState

softDeleteRetentionPeriodInDays

integer (int32)

Période de rétention de suppression réversible en jours

softDeleteState

SoftDeleteState

SoftDeleteState

Valeur Description
Invalid
Enabled
Disabled
AlwaysON

SourceScanConfiguration

Configuration de l’analyse source du coffre

Nom Type Description
sourceScanIdentity

AssociatedIdentity

Détails de l’identité à utiliser pour une opération

state

State

StandardTierStorageRedundancy

Paramètre de redondance de stockage d’un coffre

Valeur Description
Invalid
LocallyRedundant
GeoRedundant
ZoneRedundant

State

Valeur Description
Invalid
Enabled
Disabled

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

TriggerType

La façon dont la mise à niveau du coffre a été déclenchée.

Valeur Description
UserTriggered
ForcedUpgrade

UpgradeDetails

Détails de la mise à niveau du coffre.

Nom Type Description
endTimeUtc

string (date-time)

Heure UTC à laquelle l’opération de mise à niveau a pris fin.

lastUpdatedTimeUtc

string (date-time)

Heure UTC à laquelle l’état de l’opération de mise à niveau a été mis à jour pour la dernière fois.

message

string

Message à l’utilisateur contenant des informations sur l’opération de mise à niveau.

operationId

string

ID de l’opération de mise à niveau du coffre.

previousResourceId

string

ID de ressource du coffre avant la mise à niveau.

startTimeUtc

string (date-time)

Heure UTC à laquelle l’opération de mise à niveau a démarré.

status

VaultUpgradeState

État de l’opération de mise à niveau du coffre.

triggerType

TriggerType

La façon dont la mise à niveau du coffre a été déclenchée.

upgradedResourceId

string

ID de ressource du coffre mis à niveau.

UserIdentity

Identité de ressource gérée par l’utilisateur du service.

Nom Type Description
clientId

string

ID client de l’identité affectée par l’utilisateur.

principalId

string

ID principal de l’identité affectée par l’utilisateur.

Vault

Informations sur les ressources, telles qu’retournées par le fournisseur de ressources.

Nom Type Description
etag

string

etag pour la ressource.

id

string

ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

IdentityData

Identité de la ressource.

location

string

Emplacement géographique où réside la ressource

name

string

Nom de la ressource

properties

VaultProperties

Propriétés du coffre.

sku

Sku

Identifie l’identificateur système unique pour chaque ressource Azure.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

VaultPrivateEndpointState

État du point de terminaison privé pour la sauvegarde.

Valeur Description
None
Enabled

VaultProperties

Propriétés du coffre.

Nom Type Description
backupStorageVersion

BackupStorageVersion

Version du stockage de sauvegarde

bcdrSecurityLevel

BCDRSecurityLevel

Niveaux de sécurité du coffre Recovery Services pour la continuité d’activité et la récupération d’urgence

encryption

VaultPropertiesEncryption

Détails de la clé gérée par le client de la ressource.

monitoringSettings

MonitoringSettings

Paramètres de surveillance du coffre

moveDetails

VaultPropertiesMoveDetails

Détails de la dernière opération de déplacement effectuée sur la ressource Azure

moveState

ResourceMoveState

État de la ressource après l’opération de déplacement

privateEndpointConnections

PrivateEndpointConnectionVaultProperties[]

Liste des connexions de point de terminaison privé.

privateEndpointStateForBackup

VaultPrivateEndpointState

État du point de terminaison privé pour la sauvegarde.

privateEndpointStateForSiteRecovery

VaultPrivateEndpointState

État du point de terminaison privé pour site recovery.

provisioningState

string

État d’approvisionnement.

publicNetworkAccess

PublicNetworkAccess

pour activer ou désactiver le trafic réseau entrant du fournisseur de ressources à partir de clients publics

redundancySettings

VaultPropertiesRedundancySettings

Paramètres de redondance d’un coffre

resourceGuardOperationRequests

string[]

ResourceGuardOperationRequests sur laquelle la vérification LAC sera effectuée

restoreSettings

RestoreSettings

Restaurer les paramètres du coffre

secureScore

SecureScoreLevel

Degré de sécurisation du coffre Recovery Services

securitySettings

SecuritySettings

Paramètres de sécurité du coffre

upgradeDetails

UpgradeDetails

Détails de la mise à niveau du coffre.

VaultPropertiesEncryption

Détails de la clé gérée par le client de la ressource.

Nom Type Description
infrastructureEncryption

InfrastructureEncryptionState

Activation/désactivation de l’état double chiffrement

kekIdentity

CmkKekIdentity

Détails de l’identité utilisée pour CMK

keyVaultProperties

CmkKeyVaultProperties

Propriétés du coffre de clés qui héberge CMK

VaultPropertiesMoveDetails

Détails de la dernière opération de déplacement effectuée sur la ressource Azure

Nom Type Description
completionTimeUtc

string (date-time)

Heure de fin de l’opération de déplacement de ressources

operationId

string

OperationId de l’opération de déplacement de ressources

sourceResourceId

string

Ressource source de l’opération de déplacement de ressources

startTimeUtc

string (date-time)

Heure de début de l’opération de déplacement de ressources

targetResourceId

string

Ressource cible de l’opération de déplacement de ressources

VaultPropertiesRedundancySettings

Paramètres de redondance d’un coffre

Nom Type Description
crossRegionRestore

CrossRegionRestore

Indicateur pour indiquer si la restauration interrégion est activée sur le coffre ou non

standardTierStorageRedundancy

StandardTierStorageRedundancy

Paramètre de redondance de stockage d’un coffre

VaultSubResourceType

Type de sous-ressource pour le coffre AzureBackup, AzureBackup_secondary ou AzureSiteRecovery

Valeur Description
AzureBackup
AzureBackup_secondary
AzureSiteRecovery

VaultUpgradeState

État de l’opération de mise à niveau du coffre.

Valeur Description
Unknown
InProgress
Upgraded
Failed