Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Cloud Backup and Recovery/ Referencia de la API/ APIs de CBR/ Almacenes/ Modificación de un almacén

Actualización más reciente 2023-02-03 GMT+08:00

Ver PDF

Modificación de un almacén

Función

Esta API se utiliza para modificar un almacén basado en su ID.

URI

PUT /v3/{project_id}/vaults/{vault_id}

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID de proyecto
vault_id	Sí	String	ID de almacén

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
vault	Sí	VaultUpdate object	Cuerpo de solicitud de modificación de un almacén

**Tabla 4** VaultUpdate
Parámetro	Obligatorio	Tipo	Descripción
billing	No	BillingUpdate object	Información de facturación
name	No	String	Nombre de almacén Mínimo: 1 Máximo: 64
auto_bind	No	Boolean	Si se admite la asociación automática
bind_rules	No	VaultBindRules object	Reglas de asociación
auto_expand	No	Boolean	Si se activa la ampliación automática de la capacidad para el almacén.
smn_notify	No	Boolean	Función de notificación de excepción Predeterminado: true
threshold	No	Integer	Umbral de capacidad del almacén. Si el uso de la capacidad del almacén supera este umbral y smn_notify es true, se envía una notificación de excepción. Mínimo: 1 Máximo: 100 Predeterminado: 80

**Tabla 5** BillingUpdate
Parámetro	Obligatorio	Tipo	Descripción
consistent_level	No	String	Especificaciones de Vault Valores de enumeración: app_consistent crash_consistent
size	No	Integer	Tamaño del almacén, en GB Mínimo: 1 Máximo: 10485760

**Tabla 6** VaultBindRules
Parámetro	Obligatorio	Tipo	Descripción
tags	No	Array of Tag objects	Filtra los recursos asociados automáticamente por etiqueta.

**Tabla 7** Tag
Parámetro	Obligatorio	Tipo	Descripción
key	Sí	String	Clave Puede contener un máximo de 36 caracteres. No puede ser una cadena vacía. Los espacios antes y después de una clave serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (\|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_).
value	No	String	Valor Es obligatorio cuando se agrega una etiqueta y opcional cuando se elimina una etiqueta. Puede contener un máximo de 43 caracteres. Puede ser una cadena vacía. Los espacios antes y después de un valor serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (\|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_).

Parámetros de respuesta

Código de estado: 200

**Tabla 8** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
vault	Vault object	Objetos devueltos después de la consulta por un almacén

**Tabla 9** Vault
Parámetro	Tipo	Descripción
billing	Billing object	Información de la operación
description	String	Descripción del almacén definido por el usuario Mínimo: 0 Máximo: 255
id	String	ID de almacén
name	String	Nombre de almacén Mínimo: 1 Máximo: 64
project_id	String	ID de proyecto
provider_id	String	ID del tipo de recurso de almacén
resources	Array of ResourceResp objects	Recursos de almacén
tags	Array of Tag objects	Etiquetas de almacén
enterprise_project_id	String	ID de proyecto de empresa. Su valor predeterminado es 0.
auto_bind	Boolean	Indica si está habilitada la asociación automática. Su valor predeterminado es false (no habilitado).
bind_rules	VaultBindRules object	Regla de asociación
user_id	String	ID de usuario
created_at	String	Tiempo de creación, por ejemplo, 2020-02-05T10:38:34.209782
auto_expand	Boolean	Si se activa la ampliación automática de la capacidad para el almacén.
smn_notify	Boolean	Función de notificación de excepción Predeterminado: true
threshold	Integer	Umbral de capacidad del almacén. Si el uso de la capacidad del almacén supera este umbral, se envía una notificación de excepción. Mínimo: 1 Máximo: 100 Predeterminado: 80

**Tabla 10** Billing
Parámetro	Tipo	Descripción
allocated	Integer	Capacidad asignada, en GB.
charging_mode	String	Modo de facturación, que es el post_paid
cloud_type	String	Tipo de nube, que es el public
consistent_level	String	Especificación de almacén, que es crash_consistent de forma predeterminada (crash consistent backup)
object_type	String	Tipo de objeto, que puede ser server, disk, o turbo
order_id	String	ID del pedido
product_id	String	ID del producto
protect_type	String	Tipo de protección, que es de backup
size	Integer	Capacidad, en GB Mínimo: 1 Máximo: 10485760
spec_code	String	Almacén de copia de respaldo del servidor: vault.backup.server.normal; Almacén de copia de respaldo del disco: vault.backup.volume.normal; Almacén de copia de respaldo del sistema de archivos: vault.backup.turbo.normal
status	String	Estado del almacén Valores de enumeración: available lock frozen deleting error
storage_unit	String	Nombre del bucket del almacén
used	Integer	Capacidad utilizada, en MB.
frozen_scene	String	Escenario cuando una cuenta está congelada

**Tabla 11** ResourceResp
Parámetro	Tipo	Descripción
extra_info	ResourceExtraInfo object	Información adicional del recurso
id	String	ID del recurso al que se va a realizar una copia de seguridad
name	String	Nombre del recurso al que se va a hacer una copia de seguridad Mínimo: 0 Máximo: 255
protect_status	String	Estado de protección Valores de enumeración: available error protecting restoring removing
size	Integer	Capacidad asignada para los recursos asociados, en GB
type	String	Tipo del recurso que se va a hacer una copia de seguridad, que puede ser OS::Nova::Server, OS::Cinder::Volume, o OS::Sfs::Turbo
backup_size	Integer	Tamaño de copia de respaldo
backup_count	Integer	Cantidad de copias de respaldo

**Tabla 12** ResourceExtraInfo
Parámetro	Tipo	Descripción
exclude_volumes	Array of strings	ID de los discos de los que no se realizará una copia de seguridad. Este parámetro se utiliza cuando se agregan servidores a un almacén, que incluye todos los discos de servidor. Pero algunos discos no necesitan ser respaldados. O en caso de que se haya agregado un servidor previamente y no sea necesario realizar copias de seguridad de algunos discos de este servidor.

**Tabla 13** VaultBindRules
Parámetro	Tipo	Descripción
tags	Array of Tag objects	Filtra los recursos asociados automáticamente por etiqueta.

**Tabla 14** Tag
Parámetro	Tipo	Descripción
key	String	Clave Puede contener un máximo de 36 caracteres. No puede ser una cadena vacía. Los espacios antes y después de una clave serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (\|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_).
value	String	Valor Es obligatorio cuando se agrega una etiqueta y opcional cuando se elimina una etiqueta. Puede contener un máximo de 43 caracteres. Puede ser una cadena vacía. Los espacios antes y después de un valor serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (\|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_).

Solicitudes de ejemplo

PUT https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/vaults/79bd9daa-884f-4f84-b8fe-235d58cd927d

{
  "vault" : {
    "billing" : {
      "size" : 200
    },
    "name" : "vault_name02"
  }
}

Ejemplo de respuestas

Código de estado: 200

{
  "vault" : {
    "name" : "vault_name02",
    "billing" : {
      "status" : "available",
      "used" : 0,
      "protect_type" : "backup",
      "order_id" : null,
      "object_type" : "server",
      "allocated" : 40,
      "spec_code" : "vault.backup.server.normal",
      "size" : 200,
      "cloud_type" : "public",
      "product_id" : null,
      "consistent_level" : "crash_consistent",
      "storage_unit" : null,
      "charging_mode" : "post_paid"
    },
    "tags" : [ {
      "value" : "value01",
      "key" : "key01"
    } ],
    "created_at" : "2019-05-08T09:31:21.840431",
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "enterprise_project_id" : "0",
    "id" : "2402058d-8373-4b0a-b848-d3c0dfdc71a8",
    "resources" : [ {
      "name" : "ecs-1f0f-0003",
      "protect_status" : "available",
      "extra_info" : {
        "exclude_volumes" : [ "bdef09bb-293f-446a-88a4-86e9f14408c4" ]
      },
      "type" : "OS::Nova::Server",
      "id" : "97595625-198e-4e4d-879b-9d53f68ba551",
      "size" : 40
    } ],
    "description" : "vault_description"
  }
}