Set Storage Account - Set Storage Account

Referencia

Service:: Key Vault

API Version:: 7.4

Crea o actualiza una nueva cuenta de almacenamiento. Esta operación requiere el permiso storage/set.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description

Nombre	En	Requerido	Tipo	Description
storage-account-name	path	True	string	El nombre de la cuenta de almacenamiento. El valor que proporcione se puede copiar globalmente para ejecutar el servicio. El valor proporcionado no debe incluir información personal identificable o confidencial. Regex pattern: `^[0-9a-zA-Z]+$`
vaultBaseUrl	path	True	string	El nombre del almacén, por ejemplo https://myvault.vault.azure.net, .
api-version	query	True	string	Versión de API del cliente.

storage-account-name

path

True

string

El nombre de la cuenta de almacenamiento. El valor que proporcione se puede copiar globalmente para ejecutar el servicio. El valor proporcionado no debe incluir información personal identificable o confidencial.

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

vaultBaseUrl

path

True

string

El nombre del almacén, por ejemplo https://myvault.vault.azure.net, .

api-version

query

True

string

Versión de API del cliente.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
activeKeyName	True	string	Nombre actual de la clave de la cuenta de almacenamiento activa.
autoRegenerateKey	True	boolean	si keyvault debe administrar la cuenta de almacenamiento para el usuario.
resourceId	True	string	Identificador de recurso de la cuenta de almacenamiento.
attributes		StorageAccountAttributes	Atributos de la cuenta de almacenamiento.
regenerationPeriod		string	Duración del tiempo de regeneración de claves especificada en formato ISO-8601.
tags		object	Metadatos específicos de la aplicación en forma de pares clave-valor.

Respuestas

Nombre	Tipo	Description
200 OK	StorageBundle	La cuenta de almacenamiento creada.
Other Status Codes	KeyVaultError	Key Vault respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

Set Storage account

Sample Request

HTTP

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

Status code:: 200

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

Definiciones

Nombre	Description
DeletionRecoveryLevel	Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento en el almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.
Error	Error del servidor del almacén de claves.
KeyVaultError	Excepción de error del almacén de claves.
StorageAccountAttributes	Atributos de administración de cuentas de almacenamiento.
StorageAccountCreateParameters	Los parámetros de creación de la cuenta de almacenamiento.
StorageBundle	Una agrupación de cuentas de almacenamiento consta de detalles de la cuenta de almacenamiento del almacén de claves más sus atributos.

DeletionRecoveryLevel

Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento en el almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.

Nombre	Tipo	Description
CustomizedRecoverable	string	Indica un estado de almacén en el que la eliminación se puede recuperar sin la posibilidad de eliminación inmediata y permanente (es decir, purgar cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y mientras la suscripción sigue estando disponible.
CustomizedRecoverable+ProtectedSubscription	string	Indica un almacén y un estado de suscripción en el que la eliminación es recuperable, inmediata y permanente (es decir, purga) no está permitida y en la que la propia suscripción no se puede cancelar permanentemente cuando 7<= SoftDeleteRetentionInDays < 90. Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y también refleja el hecho de que no se puede cancelar la propia suscripción.
CustomizedRecoverable+Purgeable	string	Indica un estado de almacén en el que se puede recuperar la eliminación y que también permite la eliminación inmediata y permanente (es decir, purgar cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención, a menos que se solicite una operación de purga o se cancele la suscripción.
Purgeable	string	Indica un estado de almacén en el que la eliminación es una operación irreversible, sin la posibilidad de recuperación. Este nivel no corresponde a ninguna protección disponible en una operación de eliminación; Los datos se pierden irrecuperablemente al aceptar una operación de eliminación en el nivel de entidad o superior (almacén, grupo de recursos, suscripción, etc.).
Recoverable	string	Indica un estado de almacén en el que la eliminación se puede recuperar sin la posibilidad de eliminación inmediata y permanente (es decir, purgar). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días) y mientras la suscripción sigue estando disponible. El sistema lo eliminará permanentemente después de 90 días, si no se recupera
Recoverable+ProtectedSubscription	string	Indica un almacén y un estado de suscripción en el que la eliminación se puede recuperar dentro del intervalo de retención (90 días), no se permite la eliminación inmediata y permanente (es decir, purga) y en la que la propia suscripción no se puede cancelar permanentemente. El sistema lo eliminará permanentemente después de 90 días, si no se recupera
Recoverable+Purgeable	string	Indica un estado de almacén en el que se puede recuperar la eliminación y que también permite la eliminación inmediata y permanente (es decir, purgar). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días), a menos que se solicite una operación de purga o se cancele la suscripción. El sistema lo eliminará permanentemente después de 90 días, si no se recupera

Error

Error del servidor del almacén de claves.

Nombre	Tipo	Description
code	string	Código de error.
innererror	Error	Error del servidor del almacén de claves.
message	string	El mensaje de error.

KeyVaultError

Excepción de error del almacén de claves.

Nombre	Tipo	Description
error	Error	Error del servidor del almacén de claves.

StorageAccountAttributes

Atributos de administración de cuentas de almacenamiento.

Nombre	Tipo	Description
created	integer	Hora de creación en UTC.
enabled	boolean	el estado habilitado del objeto .
recoverableDays	integer	días de retención de datos softDelete. El valor debe ser >=7 y <=90 cuando softDelete está habilitado; en caso contrario, es 0.
recoveryLevel	DeletionRecoveryLevel	Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento en el almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.
updated	integer	Hora de la última actualización en UTC.

StorageAccountCreateParameters

Los parámetros de creación de la cuenta de almacenamiento.

Nombre	Tipo	Description
activeKeyName	string	Nombre actual de la clave de la cuenta de almacenamiento activa.
attributes	StorageAccountAttributes	Atributos de la cuenta de almacenamiento.
autoRegenerateKey	boolean	si keyvault debe administrar la cuenta de almacenamiento para el usuario.
regenerationPeriod	string	Duración del tiempo de regeneración de claves especificada en formato ISO-8601.
resourceId	string	Identificador de recurso de la cuenta de almacenamiento.
tags	object	Metadatos específicos de la aplicación en forma de pares clave-valor.

StorageBundle

Una agrupación de cuentas de almacenamiento consta de detalles de la cuenta de almacenamiento del almacén de claves más sus atributos.

Nombre	Tipo	Description
activeKeyName	string	Nombre de la clave de la cuenta de almacenamiento activa actual.
attributes	StorageAccountAttributes	Atributos de la cuenta de almacenamiento.
autoRegenerateKey	boolean	si keyvault debe administrar la cuenta de almacenamiento para el usuario.
id	string	Identificador de la cuenta de almacenamiento.
regenerationPeriod	string	Duración del tiempo de regeneración de claves especificada en formato ISO-8601.
resourceId	string	Identificador de recurso de la cuenta de almacenamiento.
tags	object	Metadatos específicos de la aplicación en forma de pares clave-valor

Compartir a través de

Set Storage Account - Set Storage Account

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Set Storage account

Sample Request

Sample Response

Definiciones

DeletionRecoveryLevel

Error

KeyVaultError

StorageAccountAttributes

StorageAccountCreateParameters

StorageBundle

Recursos adicionales