功能介紹
查詢可保護(hù)性資源列表
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動認(rèn)證鑒權(quán)。API Explorer可以自動生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
GET /v3/{project_id}/protectables/{protectable_type}/instances
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目ID |
|
protectable_type |
是 |
String |
對象類型 枚舉值：
|
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
id |
否 |
String |
根據(jù)資源id過濾 |
|
limit |
否 |
Integer |
每頁顯示的條目數(shù)量，每頁最多支持50條 |
|
marker |
否 |
String |
上一次查詢最后一條的ID |
|
name |
否 |
String |
按名稱過濾 |
|
offset |
否 |
Integer |
偏移值 |
|
server_id |
否 |
String |
根據(jù)該id過濾屬于該服務(wù)器的所有磁盤，支持企業(yè)多項(xiàng)目的用戶才能傳入此參數(shù) |
|
status |
否 |
String |
資源的狀態(tài)，如available，error 等 |
請求參數(shù)
無
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
instances |
可保護(hù)性查詢實(shí)例 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
children |
Array of objects |
子資源 |
|
detail |
Object |
資源詳情 |
|
id |
String |
id |
|
name |
String |
名稱 |
|
protectable |
是否可備份 |
|
|
size |
Integer |
大小，單位GB |
|
status |
String |
資源狀態(tài) 枚舉值：
|
|
type |
String |
待備份資源的類型: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo, OS:: Workspace ::DesktopV2 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
code |
String |
不支持備份的錯誤碼 |
|
reason |
String |
不支持備份的原因 |
|
result |
Boolean |
是否可備份 |
|
vault |
綁定的存儲庫 |
|
|
message |
String |
資源不可備份的原因信息，當(dāng)資源可保護(hù)性檢驗(yàn)失敗時才有該字段。 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
billing |
運(yùn)營信息 |
|
|
description |
String |
存儲庫自定義描述信息。 最小長度：0 最大長度：255 |
|
id |
String |
存儲庫ID |
|
name |
String |
存儲庫名稱 最小長度：1 最大長度：64 |
|
project_id |
String |
項(xiàng)目ID |
|
provider_id |
String |
存儲庫資源類型id |
|
resources |
資源 |
|
|
tags |
存儲庫標(biāo)簽 |
|
|
enterprise_project_id |
String |
企業(yè)項(xiàng)目id，默認(rèn)為‘0’。 |
|
auto_bind |
Boolean |
是否自動綁定，默認(rèn)為false，不支持。 |
|
bind_rules |
綁定規(guī)則 |
|
|
user_id |
String |
用戶id |
|
created_at |
String |
創(chuàng)建時間,例如:"2020-02-05T10:38:34.209782" |
|
auto_expand |
Boolean |
是否開啟存儲庫自動擴(kuò)容能力（只支持按需存儲庫）。 |
|
smn_notify |
Boolean |
存儲庫smn 消息通知 開關(guān) 缺省值：true |
|
threshold |
Integer |
存儲庫容量閾值，已用容量占總?cè)萘窟_(dá)到此百分比即發(fā)送相關(guān)通知 最小值：1 最大值：100 缺省值：80 |
|
updated_at |
String |
更新時間,例如:"2020-02-05T10:38:34.209782" |
|
version |
String |
版本 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
allocated |
Integer |
已分配容量，單位GB |
|
charging_mode |
String |
創(chuàng)建模式，按需：post_paid，包周期：pre_paid，默認(rèn)為post_paid |
|
cloud_type |
String |
公有云:public ;混合云:hybrid |
|
consistent_level |
String |
規(guī)格，崩潰一致性（crash_consistent）或應(yīng)用一致性（app_consistent） |
|
object_type |
String |
對象類型： 云服務(wù)器 （server）， 云硬盤 （disk），文件系統(tǒng)（turbo）， 云桌面 （workspace），VMware（vmware），關(guān)系型 數(shù)據(jù)庫 （rds），文件（file）。 |
|
order_id |
String |
訂單ID |
|
product_id |
String |
產(chǎn)品ID |
|
protect_type |
String |
保護(hù)類型：備份（backup）、復(fù)制(replication)。 |
|
size |
Integer |
容量，單位GB 最小值：1 最大值：10485760 |
|
spec_code |
String |
規(guī)格編碼。 云服務(wù)備份存儲庫：vault.backup.server.normal； 云硬盤備份 存儲庫：vault.backup.volume.normal；文件備份存儲庫：vault.backup.turbo.normal |
|
status |
String |
存儲庫狀態(tài) 枚舉值：
|
|
storage_unit |
String |
存儲庫桶名 |
|
used |
Integer |
已使用容量，單位MB |
|
frozen_scene |
String |
凍結(jié)場景 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
extra_info |
資源附加信息 |
|
|
id |
String |
待備份資源id |
|
name |
String |
待備份資源名稱 最小長度：0 最大長度：255 |
|
protect_status |
String |
保護(hù)狀態(tài) 枚舉值：
|
|
size |
Integer |
資源已分配容量,單位為GB |
|
type |
String |
待備份資源的類型: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo, OS::Workspace::DesktopV2 |
|
backup_size |
Integer |
副本大小 |
|
backup_count |
Integer |
副本數(shù)量 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
exclude_volumes |
Array of strings |
需要排除備份的卷id。僅在多盤備份特性中有效，排除不需要備份的磁盤。當(dāng)虛擬機(jī)新綁定磁盤時，也能繼續(xù)排除之前設(shè)置不用備份的卷。 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
key |
String |
鍵。 key最大長度為36個字符。 key不能為空字符串。 key前后空格會被丟棄。 key不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 key只能由中文，字母，數(shù)字，“-”，“_”組成。 |
|
value |
String |
值。 添加標(biāo)簽時value值必選，刪除標(biāo)簽時value值可選。 value最大長度為43個字符。 value可以為空字符串。 value前后的空格會被丟棄。 value不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 value只能由中文，字母，數(shù)字，“-”，“_”，“.”組成。 |
請求示例
GET https://{endpoint}/v3/{project_id}/protectables/{protectable_type}/instances
響應(yīng)示例
狀態(tài)碼： 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" : "IyEvYmluL2Jhc2gKZWNobyAncm9vdDok
NiQ5c1FaeXIkdnk5N1pGYXg5WUpRTUpPRElGdGdjYnovTUdEZ1dad3E4VTM1dWE4MjQxTmtDTG1
GRjJUUm1BdnZSQnNCLy93VER0aFVRNUt0Z1p6dUlrenp2NmQwYTAnIHwgY2hwYXNzd2QgLWU7",
"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",
"cas cad ed.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
} ]
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
200 |
OK |
錯誤碼
請參見錯誤碼。
