Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/Cloud Backup and Recovery/Referência de API/APIs do CBR/Proteção/Proteção
Atualizado em 2023-04-26 GMT+08:00
Ver PDF
Compartilhar

Proteção

Função

Proteção

URI

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

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Proteção

protectable_type

Sim

String

Tipo de objeto

Valores de enumeração:

  • server
  • disk
Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

id

Não

String

Filtra por ID de recurso.

limit

Não

Integer

Número de registros exibidos por página. Um máximo de 50 registros podem ser exibidos em cada página.

marker

Não

String

ID do último registro exibido na página anterior

name

Não

String

Filtra pelo nome do recurso.

offset

Não

Integer

Valor do deslocamento

server_id

Não

String

Filtra todos os discos que pertencem ao servidor com base no ID do servidor. Esse parâmetro é obrigatório somente para usuários que ativaram o multi projeto empresarial.

status

Não

String

Status do recurso

Parâmetros de solicitação

Nenhum

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

instances

Array of ProtectablesResp objects

Instância de consulta de recursos protegíveis

Tabela 4 ProtectablesResp

Parâmetro

Tipo

Descrição

children

Array of objects

Recurso filho

detail

Object

Detalhes do recurso

id

String

id

name

String

Nome do recurso

protectable

ProtectableResult object

Se o backup é suportado

size

Integer

Tamanho do recurso, em GB

status

String

Status do recurso

Valores de enumeração:

  • active
  • deleted
  • error

type

String

Tipo do recurso a ser copiado, que pode ser OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo ou OS::Workspace::DesktopV2

Tabela 5 ProtectableResult

Parâmetro

Tipo

Descrição

code

String

Código de erro retornado indicando que o backup não é suportado

reason

String

Motivo pelo qual o backup não é suportado

result

Boolean

Se o backup é suportado

vault

VaultGet object

Cofre associado

message

String

Razão pela qual o recurso não pode ser feito backup. Esse campo é retornado somente se a verificação de proteção do recurso falhar.

Tabela 6 VaultGet

Parâmetro

Tipo

Descrição

billing

Billing object

Informação da operação

description

String

Descrição do cofre definida pelo usuário

Mínimo: 0

Máximo: 255

id

String

ID do cofre

name

String

Nome do cofre

Mínimo: 1

Máximo: 64

project_id

String

ID do projeto

provider_id

String

ID do tipo de recurso do cofre

resources

Array of ResourceResp objects

Recurso

tags

Array of TagsResp objects

Tag

enterprise_project_id

String

ID do projeto empresarial. O valor padrão é 0.

auto_bind

Boolean

Indica se a associação automática está ativada. Seu valor padrão é false (não ativado).

bind_rules

VaultBindRules object

Regra de associação

user_id

String

ID do usuário

created_at

String

Tempo de criação, por exemplo, 2020-02-05T10:38:34.209782

auto_expand

Boolean

Se ativar a expansão de capacidade automática para o cofre. Somente os cofres do pagamento por uso suportam a autoexpansão da capacidade.

smn_notify

Boolean

Função de notificação de exceção

Padrão: true

threshold

Integer

Limite de capacidade do cofre. Se o uso da capacidade do cofre excede este limite, uma notificação de exceção é enviada.

Mínimo: 1

Máximo: 100

Padrão: 80

updated_at

String

Tempo de atualização, por exemplo, 2020-02-05T10:38:34.209782

version

String

Versão

Tabela 7 Billing

Parâmetro

Tipo

Descrição

allocated

Integer

Capacidade alocada, em GB.

charging_mode

String

Modo de cobrança, que pode ser post_paid (pagamento por uso) ou pre_paid (anual/mensal). O valor padrão é post_paid.

cloud_type

String

Tipo de nuvem, que pode ser public ou hybrid

consistent_level

String

Especificação do cofre, que pode ser crash_consistent (backup consistente com falhas) ou app_consistent (backup consistente com a aplicação)

object_type

String

Tipo de objeto, que pode ser server, disk, turbo ou workspace

order_id

String

ID do pedido

product_id

String

ID do produto

protect_type

String

Tipo de proteção, que pode ser backup ou replication

size

Integer

Capacidade, em GB

Mínimo: 1

Máximo: 10485760

spec_code

String

Código de especificação. Cofre de backup do servidor: vault.backup.server.normal; Cofre de backup de disco: vault.backup.volume.normal; Cofre de backup do sistema de arquivos: vault.backup.turbo.normal

status

String

Estado do cofre

Valores de enumeração:

  • available
  • lock
  • frozen
  • deleting
  • error

storage_unit

String

Nome do bucket para o cofre

used

Integer

Capacidade utilizada, em MB.

frozen_scene

String

Cenário quando uma conta é congelada

Tabela 8 ResourceResp

Parâmetro

Tipo

Descrição

extra_info

ResourceExtraInfo object

Informações adicionais do recurso

id

String

ID do recurso a ser copiado

name

String

Nome do recurso a ser copiado

Mínimo: 0

Máximo: 255

protect_status

String

Status da proteção

Valores de enumeração:

  • available
  • error
  • protecting
  • restoring
  • removing

size

Integer

Capacidade alocada para os recursos associados, em GB

type

String

Tipo do recurso a ser copiado, que pode ser OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo ou OS::Workspace::DesktopV2

backup_size

Integer

Tamanho do backup

backup_count

Integer

Número de backups

Tabela 9 ResourceExtraInfo

Parâmetro

Tipo

Descrição

exclude_volumes

Array of strings

IDs dos discos dos quais não será feito backup. Este parâmetro é usado quando os servidores são adicionados a um cofre, que inclui todos os discos do servidor. Mas alguns discos não precisam ser copiados. Ou no caso de um servidor ter sido adicionado anteriormente e alguns discos neste servidor não precisarem ser copiados.

Tabela 10 TagsResp

Parâmetro

Tipo

Descrição

key

String

Chave

É composta por até 36 caracteres.

Não pode ser uma cadeia vazia.

Pode conter apenas caracteres chineses, letras, dígitos, hifens (-) e sublinhados (_).

values

String

Lista de valores

É composta por até 43 caracteres.

Pode ser uma cadeia vazia.

Pode conter apenas caracteres chineses, letras, dígitos, hifens (-) e sublinhados (_).

Tabela 11 VaultBindRules

Parâmetro

Tipo

Descrição

tags

Array of BindRulesTags objects

Filtra recursos associados automaticamente por tag.

Tabela 12 BindRulesTags

Parâmetro

Tipo

Descrição

key

String

A chave não pode conter caracteres ASCII não imprimíveis (0–31) ou os seguintes caracteres: =*<>,|/

A chave pode conter apenas letras, dígitos, hifens (-) e sublinhados (_).

value

String

O valor não pode conter caracteres ASCII não imprimíveis (0–31) ou os seguintes caracteres: =*<>,|/

O valor pode conter apenas letras, dígitos, hifens (-) e sublinhados (_).

Exemplo de solicitações

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

Exemplo de respostas

Código de status: 200

OK

{ "instances" : [ { "status" : "ACTIVE", "children" : [ { "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 }, { "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 } ], "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, "OS-EXT-IPS:port_id" : "f22f531a-d38a-480b-b59e-f7e5db0dcdcc", "addr" : "192.168.1.44", "OS-EXT-IPS:type" : "fixed" }, { "OS-EXT-IPS-MAC:mac_addr" : "fa:16:3e:9b:9d:af", "version" : 4, "OS-EXT-IPS:port_id" : "f22f531a-d38a-480b-b59e-f7e5db0dcdcc", "addr" : "100.78.0.199", "OS-EXT-IPS:type" : "floating" } ] }, "OS-EXT-SRV-ATTR:ramdisk_id" : "", "image" : "", "enterprise_project_id" : "0", "updated" : "2019-05-08T06:57:02Z", "OS-EXT-SRV-ATTR:user_data" : "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiQ5c1FaeXIkdnk5N1pGYXg5WUpRTUpPRElGdGdjYnovTUdEZ1dad3E4VTM1dWE4MjQxTmtDTG1GRjJUUm1BdnZSQnNCLy93VER0aFVRNUt0Z1p6dUlrenp2NmQwYTAnIHwgY2hwYXNzd2QgLWU7", "OS-EXT-STS:vm_state" : "active", "OS-EXT-SRV-ATTR:instance_name" : "instance-0004456e", "OS-EXT-SRV-ATTR:root_device_name" : "/dev/vda", "OS-SRV-USG:launched_at" : "2019-05-08T06:55:38.000000", "flavor" : { "vcpus" : "1", "disk" : "0", "ram" : "1024", "id" : "s3.small.1", "name" : "s3.small.1" }, "id" : "55ecd8b8-1457-4a2a-a9df-53756a690082", "security_groups" : [ { "name" : "default" } ], "OS-SRV-USG:terminated_at" : null, "os-extended-volumes:volumes_attached" : [ { "device" : "/dev/vda", "id" : "13eb535f-8635-4faf-9f08-584d21e78f0a", "delete_on_termination" : false, "bootIndex" : 0 }, { "device" : "/dev/vdb", "id" : "8d3d519f-d409-4be3-8a1f-9f7a5ecb7a99", "delete_on_termination" : false, "bootIndex" : null } ], "user_id" : "f3d66502790d4ddaadef5056059ed8f4", "OS-EXT-SRV-ATTR:hostname" : "no-delete-for-cbr-interface", "OS-DCF:diskConfig" : "MANUAL", "accessIPv4" : "", "accessIPv6" : "", "OS-EXT-SRV-ATTR:reservation_id" : "r-kpb5xckf", "progress" : 0, "OS-EXT-STS:power_state" : 1, "OS-EXT-AZ:availability_zone" : "AZ1", "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" }, "status" : "ACTIVE", "sys_tags" : [ { "value" : "0", "key" : "_sys_enterprise_project_id" } ], "os:scheduler_hints" : { }, "hostId" : "179f22cafe6b951921bd6deb3b13a978df620427fb37bbb7c619de98", "OS-EXT-SRV-ATTR:host" : "AZ1.xxxxxx", "description" : "", "tags" : [ ], "key_name" : null, "OS-EXT-SRV-ATTR:kernel_id" : "", "locked" : false, "OS-EXT-SRV-ATTR:hypervisor_hostname" : "nova003@36", "name" : "no_delete_for_cbr_interface", "OS-EXT-SRV-ATTR:launch_index" : 0, "created" : "2019-05-08T06:55:22Z", "tenant_id" : "3aec9116a6a5487ca14987121d2818fe", "host_status" : "UP", "config_drive" : "" }, "type" : "OS::Nova::Server", "id" : "55ecd8b8-1457-4a2a-a9df-53756a690082", "size" : 50 } ] }

Códigos de status

Código de status

Descrição

200

OK

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Proteção