Partager via


Set Storage Account - Set Storage Account

Crée ou met à jour un compte de stockage. Cette opération nécessite l’autorisation stockage/set.

PUT {vaultBaseUrl}/storage/{storage-account-name}?api-version=7.4

Paramètres URI

Nom Dans Obligatoire Type Description
storage-account-name
path True

string

Nom du compte de stockage. La valeur que vous fournissez peut être copiée globalement dans le but d’exécuter le service. La valeur fournie ne doit pas inclure d’informations d’identification personnelle ou sensibles.

Regex pattern: ^[0-9a-zA-Z]+$

vaultBaseUrl
path True

string

Nom du coffre, par exemple https://myvault.vault.azure.net.

api-version
query True

string

Version d’API client.

Corps de la demande

Nom Obligatoire Type Description
activeKeyName True

string

Nom de clé du compte de stockage actif actuel.

autoRegenerateKey True

boolean

si le coffre de clés doit gérer le compte de stockage de l’utilisateur.

resourceId True

string

ID de ressource du compte de stockage.

attributes

StorageAccountAttributes

Attributs du compte de stockage.

regenerationPeriod

string

Durée du temps de régénération de clé spécifiée au format ISO-8601.

tags

object

Métadonnées spécifiques d’application sous la forme de paires clé/valeur.

Réponses

Nom Type Description
200 OK

StorageBundle

Compte de stockage créé.

Other Status Codes

KeyVaultError

Key Vault réponse d’erreur décrivant la raison de l’échec de l’opération.

Exemples

Set Storage account

Sample Request

PUT https://myvault.vault.azure.net//storage/setStrg01?api-version=7.4

{
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key2",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P15D",
  "attributes": {
    "enabled": true
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Sample Response

{
  "id": "https://myvault.vault.azure.net/storage/setStrg01",
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key2",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P15D",
  "attributes": {
    "enabled": true,
    "created": 1490738386,
    "updated": 1490738386,
    "recoveryLevel": "Recoverable+Purgeable"
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Définitions

Nom Description
DeletionRecoveryLevel

Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre actuel. S’il contient « Purgeable », le compte de stockage peut être supprimé définitivement par un utilisateur privilégié ; sinon, seul le système peut vider le compte de stockage, à la fin de l’intervalle de rétention.

Error

Erreur du serveur du coffre de clés.

KeyVaultError

Exception d’erreur du coffre de clés.

StorageAccountAttributes

Attributs de gestion des comptes de stockage.

StorageAccountCreateParameters

Le compte de stockage crée des paramètres.

StorageBundle

Une offre groupée de comptes de stockage se compose des détails du compte de stockage du coffre de clés ainsi que de ses attributs.

DeletionRecoveryLevel

Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre actuel. S’il contient « Purgeable », le compte de stockage peut être supprimé définitivement par un utilisateur privilégié ; sinon, seul le système peut vider le compte de stockage, à la fin de l’intervalle de rétention.

Nom Type Description
CustomizedRecoverable

string

Désigne un état de coffre dans lequel la suppression est récupérable sans possibilité de suppression immédiate et définitive (par exemple, purger quand 7<= SoftDeleteRetentionInDays < 90). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention et tant que l’abonnement est toujours disponible.

CustomizedRecoverable+ProtectedSubscription

string

Indique un état de coffre et d’abonnement dans lequel la suppression est récupérable, la suppression immédiate et permanente (c’est-à-dire la purge) n’est pas autorisée et dans laquelle l’abonnement lui-même ne peut pas être annulé définitivement lorsque 7<= SoftDeleteRetentionInDays < 90. Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention et reflète également le fait que l’abonnement lui-même ne peut pas être annulé.

CustomizedRecoverable+Purgeable

string

Désigne un état de coffre dans lequel la suppression est récupérable, et qui permet également une suppression immédiate et définitive (par exemple, purge lorsque 7<= SoftDeleteRetentionInDays < 90). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention, sauf si une opération de purge est demandée ou si l’abonnement est annulé.

Purgeable

string

Désigne un état de coffre dans lequel la suppression est une opération irréversible, sans possibilité de récupération. Ce niveau correspond à l’absence de protection disponible contre une opération de suppression ; les données sont irrémédiablement perdues lors de l’acceptation d’une opération de suppression au niveau de l’entité ou au niveau supérieur (coffre, groupe de ressources, abonnement, etc.)

Recoverable

string

Désigne un état de coffre dans lequel la suppression est récupérable sans possibilité de suppression immédiate et définitive (c’est-à-dire une purge). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention (90 jours) et tant que l’abonnement est toujours disponible. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré

Recoverable+ProtectedSubscription

string

Désigne un état de coffre et d’abonnement dans lequel la suppression est récupérable dans l’intervalle de rétention (90 jours), la suppression immédiate et définitive (c’est-à-dire la purge) n’est pas autorisée et dans lequel l’abonnement lui-même ne peut pas être annulé définitivement. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré

Recoverable+Purgeable

string

Désigne un état de coffre dans lequel la suppression est récupérable et qui permet également une suppression immédiate et définitive (c’est-à-dire une purge). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention (90 jours), sauf si une opération de purge est demandée ou si l’abonnement est annulé. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré

Error

Erreur du serveur du coffre de clés.

Nom Type Description
code

string

Code d'erreur.

innererror

Error

Erreur du serveur du coffre de clés.

message

string

Message d’erreur.

KeyVaultError

Exception d’erreur du coffre de clés.

Nom Type Description
error

Error

Erreur du serveur du coffre de clés.

StorageAccountAttributes

Attributs de gestion des comptes de stockage.

Nom Type Description
created

integer

Heure de création en UTC.

enabled

boolean

état activé de l’objet.

recoverableDays

integer

softDelete data retention days. La valeur doit être >=7 et <=90 lorsque softDelete est activé, sinon 0.

recoveryLevel

DeletionRecoveryLevel

Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre actuel. S’il contient « Purgeable », le compte de stockage peut être supprimé définitivement par un utilisateur privilégié ; sinon, seul le système peut vider le compte de stockage, à la fin de l’intervalle de rétention.

updated

integer

Heure de la dernière mise à jour en UTC.

StorageAccountCreateParameters

Le compte de stockage crée des paramètres.

Nom Type Description
activeKeyName

string

Nom de clé du compte de stockage actif actuel.

attributes

StorageAccountAttributes

Attributs du compte de stockage.

autoRegenerateKey

boolean

si le coffre de clés doit gérer le compte de stockage de l’utilisateur.

regenerationPeriod

string

Durée du temps de régénération de clé spécifiée au format ISO-8601.

resourceId

string

ID de ressource du compte de stockage.

tags

object

Métadonnées spécifiques d’application sous la forme de paires clé/valeur.

StorageBundle

Une offre groupée de comptes de stockage se compose des détails du compte de stockage du coffre de clés ainsi que de ses attributs.

Nom Type Description
activeKeyName

string

Nom de clé du compte de stockage actif actuel.

attributes

StorageAccountAttributes

Attributs du compte de stockage.

autoRegenerateKey

boolean

si le coffre de clés doit gérer le compte de stockage de l’utilisateur.

id

string

ID de compte de stockage.

regenerationPeriod

string

Durée du temps de régénération de clé spécifiée au format ISO-8601.

resourceId

string

ID de ressource du compte de stockage.

tags

object

Métadonnées spécifiques à l’application sous la forme de paires clé-valeur