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

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

Códigos de estado

Código de estado	Descripción
200	OK

Códigos de error

Consulte Códigos de error.

Tema principal:Almacenes

Tema anterior: Consulta de la lista de almacén

Tema siguiente: Eliminación de un almacén

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.