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/ Protección/ Consulta de un recurso protegible especificado
Actualización más reciente 2023-02-03 GMT+08:00

Consulta de un recurso protegible especificado

Función

Esta API se utiliza para consultar un recurso especificado que puede ser protegido por su ID.

URI

GET /v3/{project_id}/protectables/{protectable_type}/instances/{instance_id}

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

instance_id

String

ID de recurso

project_id

String

ID de proyecto

protectable_type

String

Tipo de protección

Valores de enumeración:

  • server
  • disk

Parámetros de solicitud

Ninguna

Parámetros de respuesta

Código de estado: 200

Tabla 2 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

instance

ProtectablesResp object

Recursos que pueden ser protegidos

Tabla 3 ProtectablesResp

Parámetro

Tipo

Descripción

children

Array of objects

Recursos de niños

detail

Object

Detalles del recurso

id

String

id

name

String

Nombre de recurso

protectable

ProtectableResult object

Si se admite la copia de respaldo

size

Integer

Tamaño del recurso, en GB

status

String

Estado del recurso

Valores de enumeración:

  • active
  • deleted
  • error

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

Tabla 4 ProtectableResult

Parámetro

Tipo

Descripción

code

String

Código de error devuelto que indica que la copia de respaldo no es compatible

reason

String

Razón por la que no se admite la copia de respaldo

result

Boolean

Si se admite la copia de respaldo

vault

VaultGet object

Almacén asociado

message

String

Razón por la que no se puede realizar una copia de seguridad del recurso. Este campo sólo se devuelve si se produce un error en la comprobación de protección del recurso.

Tabla 5 VaultGet

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

Recurso

tags

Array of TagsResp objects

Etiqueta

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

updated_at

String

Tiempo de actualización, por ejemplo, 2020-02-05T10:38:34.209782

version

String

Versión

Tabla 6 Facturación

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 7 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 8 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 9 TagsResp

Parámetro

Tipo

Descripción

key

String

Clave

Consta de hasta 36 caracteres.

No puede ser una cadena vacía.

Puede contener solo letras, dígitos, guiones y guiones bajos.

values

String

Lista de valores

Consta de hasta 43 caracteres.

Puede ser una cadena vacía.

Puede contener solo letras, dígitos, guiones y guiones bajos.

Tabla 10 VaultBindRules

Parámetro

Tipo

Descripción

tags

Array of Tag objects

Filtra los recursos asociados automáticamente por etiqueta.

Tabla 11 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

GET  https://{endpoint}/v3/{project_id}/protectables/{protectable_type}/instances/{instance_id}

Ejemplo de respuestas

Código de estado: 200

OK

{
  "instance" : {
    "status" : "ACTIVE",
    "children" : [ {
      "status" : "in-use",
      "name" : "volume-f926-0001",
      "detail" : {
        "attachments" : [ {
          "server_id" : "55ecd8b8-1457-4a2a-a9df-53756a690082",
          "attachment_id" : "3b32cb75-bd96-493b-8fb2-13f063c876d5",
          "volume_id" : "8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99",
          "host_name" : null,
          "attached_at" : "2019-05-08T06:56:25.891730",
          "device" : "/dev/vdb",
          "id" : "8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99"
        } ],
        "links" : [ {
          "href" : "https://volume.region1.com/v2/3aec9116a6a5487ca14987121d2818fe/volumes/8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99",
          "rel" : "self"
        }, {
          "href" : "https://volume.region1.com/3aec9116a6a5487ca14987121d2818fe/volumes/8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99",
          "rel" : "bookmark"
        } ],
        "availability_zone" : "AZ1",
        "os-vol-host-attr:host" : "AZ1.xxxxxx#FusionStorage",
        "encrypted" : false,
        "updated_at" : "2019-05-08T06:56:26.207240",
        "replication_status" : "disabled",
        "snapshot_id" : null,
        "id" : "8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99",
        "size" : 10,
        "user_id" : "f3d66502790d4ddaadef5056059ed8f4",
        "os-vol-tenant-attr:tenant_id" : "3aec9116a6a5487ca14987121d2818fe",
        "os-vol-mig-status-attr:migstat" : null,
        "metadata" : {
          "policy" : "cf3274fc-d23e-4c12-8be7-1e41b3c2faea",
          "readonly" : "False",
          "attached_mode" : "rw"
        },
        "status" : "in-use",
        "description" : null,
        "multiattach" : false,
        "source_volid" : null,
        "consistencygroup_id" : null,
        "os-vol-mig-status-attr:name_id" : null,
        "name" : "volume-f926-0001",
        "bootable" : "false",
        "created_at" : "2019-03-26T09:30:46.783578",
        "volume_type" : "SATA",
        "shareable" : false
      },
      "children" : [ ],
      "type" : "OS::Cinder::Volume",
      "id" : "8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99",
      "size" : 10
    }, {
      "status" : "in-use",
      "name" : "no_delete_for_cbr_interface-volume-0000",
      "detail" : {
        "attachments" : [ {
          "server_id" : "55ecd8b8-1457-4a2a-a9df-53756a690082",
          "attachment_id" : "e16631fa-0522-4ac8-8f78-19db435caf68",
          "volume_id" : "13eb535f-8635-4faf-9f08-584d21e78f0a",
          "host_name" : null,
          "attached_at" : "2019-05-08T06:55:26.563986",
          "device" : "/dev/vda",
          "id" : "13eb535f-8635-4faf-9f08-584d21e78f0a"
        } ],
        "links" : [ {
          "href" : "https://volume.region1.com/v2/3aec9116a6a5487ca14987121d2818fe/volumes/13eb535f-8635-4faf-9f08-584d21e78f0a",
          "rel" : "self"
        }, {
          "href" : "https://volume.region1.com/3aec9116a6a5487ca14987121d2818fe/volumes/13eb535f-8635-4faf-9f08-584d21e78f0a",
          "rel" : "bookmark"
        } ],
        "availability_zone" : "AZ1",
        "os-vol-host-attr:host" : "AZ1.xxxxxx#kvm_fusionstorage",
        "encrypted" : false,
        "updated_at" : "2019-05-08T08:33:07.855484",
        "replication_status" : "disabled",
        "snapshot_id" : null,
        "id" : "13eb535f-8635-4faf-9f08-584d21e78f0a",
        "size" : 40,
        "user_id" : "3204777a731c4ebea330350c04f41b92",
        "os-vol-tenant-attr:tenant_id" : "3aec9116a6a5487ca14987121d2818fe",
        "os-vol-mig-status-attr:migstat" : null,
        "metadata" : {
          "policy" : "2ecbcffd-08ba-43f7-bf8d-95daba753464",
          "readonly" : "False",
          "attached_mode" : "rw"
        },
        "status" : "in-use",
        "volume_image_metadata" : {
          "container_format" : "bare",
          "min_ram" : "0",
          "__account_code" : "",
          "__os_bit" : "64",
          "size" : "2",
          "__os_version" : "CentOS 7.2 64bit",
          "__backup_id" : "",
          "__description" : "",
          "__support_diskintensive" : "true",
          "disk_format" : "vhd",
          "__isregistered" : "true",
          "__image_size" : "3295645696",
          "__platform" : "CentOS",
          "__root_origin" : "file",
          "__originalimagename" : "703eb90a-a65f-4c72-b4c1-f070a55d068b",
          "__quick_start" : "true",
          "image_name" : "CentOS7.2-cloudinit",
          "image_id" : "703eb90a-a65f-4c72-b4c1-f070a55d068b",
          "__os_type" : "Linux",
          "__image_location" : "172.100.45.130:443:pcsimsf8bd00bf6c304d2e8cf4e2beb0aed702:703eb90a-a65f-4c72-b4c1-f070a55d068b",
          "min_disk" : "40",
          "__data_origin" : "file,jingxiang:CentOS-7.2-64bit.zvhd2",
          "__support_kvm" : "true",
          "virtual_env_type" : "FusionCompute",
          "__image_source_type" : "uds",
          "__support_xen" : "true",
          "checksum" : "99914b932bd37a50b983c5e7c90ae93b",
          "__imagetype" : "gold",
          "__productcode" : ""
        },
        "description" : null,
        "multiattach" : false,
        "source_volid" : null,
        "consistencygroup_id" : null,
        "os-vol-mig-status-attr:name_id" : null,
        "name" : "no_delete_for_cbr_interface-volume-0000",
        "bootable" : "true",
        "created_at" : "2019-05-08T06:54:58.477749",
        "volume_type" : "SATA",
        "shareable" : false
      },
      "children" : [ ],
      "type" : "OS::Cinder::Volume",
      "id" : "13eb535f-8635-4faf-9f08-584d21e78f0a",
      "size" : 40
    } ],
    "protectable" : {
      "vault" : null,
      "reason" : "",
      "code" : "",
      "result" : true
    },
    "name" : "no_delete_for_cbr_interface",
    "detail" : {
      "OS-EXT-STS:task_state" : null,
      "addresses" : {
        "94b88790-c906-4450-b7c2-1c2b1ea639bf" : [ {
          "OS-EXT-IPS-MAC:mac_addr" : "fa:16:3e:9b:9d:af",
          "version" : 4,
          "addr" : "192.168.1.44",
          "OS-EXT-IPS:type" : "fixed"
        }, {
          "OS-EXT-IPS-MAC:mac_addr" : "fa:16:3e:9b:9d:af",
          "version" : 4,
          "addr" : "100.78.0.199",
          "OS-EXT-IPS:type" : "floating"
        } ]
      },
      "links" : [ {
        "href" : "https://compute.region1.com/v2.1/3aec9116a6a5487ca14987121d2818fe/servers/55ecd8b8-1457-4a2a-a9df-53756a690082",
        "rel" : "self"
      }, {
        "href" : "https://compute.region1.com/3aec9116a6a5487ca14987121d2818fe/servers/55ecd8b8-1457-4a2a-a9df-53756a690082",
        "rel" : "bookmark"
      } ],
      "image" : "",
      "OS-EXT-STS:vm_state" : "active",
      "OS-EXT-SRV-ATTR:instance_name" : "instance-0004456e",
      "OS-SRV-USG:launched_at" : "2019-05-08T06:55:38.000000",
      "flavor" : {
        "id" : "s3.small.1",
        "links" : [ {
          "href" : "https://compute.region1.com/3aec9116a6a5487ca14987121d2818fe/flavors/s3.small.1",
          "rel" : "bookmark"
        } ]
      },
      "id" : "55ecd8b8-1457-4a2a-a9df-53756a690082",
      "security_groups" : [ {
        "name" : "default"
      } ],
      "user_id" : "f3d66502790d4ddaadef5056059ed8f4",
      "OS-DCF:diskConfig" : "MANUAL",
      "accessIPv4" : "",
      "accessIPv6" : "",
      "progress" : 0,
      "OS-EXT-STS:power_state" : 1,
      "OS-EXT-AZ:availability_zone" : "AZ1",
      "config_drive" : "",
      "status" : "ACTIVE",
      "updated" : "2019-05-08T06:57:02Z",
      "hostId" : "179f22cafe6b951921bd6deb3b13a978df620427fb37bbb7c619de98",
      "OS-EXT-SRV-ATTR:host" : "AZ1.xxxxxx",
      "OS-SRV-USG:terminated_at" : null,
      "key_name" : null,
      "OS-EXT-SRV-ATTR:hypervisor_hostname" : "nova003@36",
      "name" : "no_delete_for_cbr_interface",
      "created" : "2019-05-08T06:55:22Z",
      "tenant_id" : "3aec9116a6a5487ca14987121d2818fe",
      "os-extended-volumes:volumes_attached" : [ {
        "id" : "8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99"
      }, {
        "id" : "13eb535f-8635-4faf-9f08-584d21e78f0a"
      } ],
      "metadata" : {
        "metering.image_id" : "703eb90a-a65f-4c72-b4c1-f070a55d068b",
        "metering.imagetype" : "gold",
        "metering.resourcespeccode" : "s3.small.1.linux",
        "metering.cloudServiceType" : "sys.service.type.ec2",
        "virtual_env_type" : "FusionCompute",
        "image_name" : "CentOS7.2-cloudinit",
        "metering.resourcetype" : "1",
        "vpc_id" : "94b88790-c906-4450-b7c2-1c2b1ea639bf",
        "os_bit" : "64",
        "cascaded.instance_extrainfo" : "",
        "os_type" : "Linux",
        "charging_mode" : "0"
      }
    },
    "type" : "OS::Nova::Server",
    "id" : "55ecd8b8-1457-4a2a-a9df-53756a690082",
    "size" : 50
  }
}

Códigos de estado

Código de estado

Descripción

200

OK

Códigos de error

Consulte Códigos de error.