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}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
instance_id |
Sí |
String |
ID de recurso |
project_id |
Sí |
String |
ID de proyecto |
protectable_type |
Sí |
String |
Tipo de protección Valores de enumeración:
|
Parámetros de solicitud
Ninguna
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
instance |
ProtectablesResp object |
Recursos que pueden ser protegidos |
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:
|
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 |
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. |
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 |
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:
|
storage_unit |
String |
Nombre del bucket del almacén |
used |
Integer |
Capacidad utilizada, en MB. |
frozen_scene |
String |
Escenario cuando una cuenta está congelada |
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:
|
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 |
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. |
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. |
Parámetro |
Tipo |
Descripción |
---|---|---|
tags |
Array of Tag objects |
Filtra los recursos asociados automáticamente por etiqueta. |
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.