華為云計算 云知識 查詢共享詳細信息showShareDetal
查詢共享詳細信息showShareDetal
時間: 2023-08-29 11:34:54
猜你想看：
實時語音識別 云服務(wù)器配置 CDN是什么意思 視頻點播加速 什么是云桌面

 

接口說明

查詢共享詳細信息。

約束說明

接口也支持V1版本。

URL
GET  https://sfs.cn-south-2.myhuaweicloud.com/v2/{project_id}/shares/{share_id} 
請求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
 string header 是

用戶Token。

通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。
X-Openstack-Manila-Api-Version
 
 float header 否

指定微版本號。
project_id
 
 string path 是

操作用戶的項目ID。
share_id
 
 string path 是

共享的UUID。
返回參數(shù)
返回碼: 200

OK

名稱 類型 必選 描述
share
 
 share_response object 是

share對象
200 share
名稱 類型 必選 描述
access_rules_status
 
 string 否

共享訪問權(quán)限的設(shè)置結(jié)果,active表示已生效,error表示設(shè)置失敗,syncing表示正在配置中。(API 微版本2.10以后支持)。
availability_zone
 
 string 是

可用區(qū)AZ(availability zone)。
consistency_group_id
 
 string 否

一致性組的UUID,當(dāng)前不支持一致性組,該字段當(dāng)前無意義。(API 微版本2.31到2.42以后支持)
create_share_from_snapshot_support
 
 boolean 否

是否支持從快照創(chuàng)建共享,目前不支持快照,該字段無意義。(API 微版本2.24以后支持)。
created_at
 
 string 否

共享創(chuàng)建的時間標(biāo)簽。
description
 
 string 否

共享描述。
export_location
 
 string 否

共享掛載路徑,當(dāng)請求消息頭指定的X-Openstack-Manila-Api-Version的值低于2.9,該字段存在,若為2.9到2.42之間以后,該消息不存在。
export_locations
 
 Array of strings 否

共享掛載路徑信息列表,當(dāng)前只支持有一個共享。當(dāng)請求消息頭指定的X-Openstack-Manila-Api-Version的值低于2.9,該字段存在,若為2.9到2.42之間以后,該消息不存在。
has_replicas
 
 boolean 否

是否有復(fù)制,當(dāng)前不支持復(fù)制,該字段無意義。(API 微版本2.11到2.42以后支持)。
host
 
 string 否

共享主機名,管理員才會顯示此字段。
id
 
 string 是

共享的UUID。
is_public
 
 boolean 否

共享的可見程度。設(shè)置為true時公共可見,設(shè)置為false時私有個人可見,默認值為false。
links
 
 Array of links objects 否

共享鏈接。
metadata
 
 metadata object 否

一到多個字典形式組織的鍵值對。其中share_used作為key,對應(yīng)的value表示共享已經(jīng)使用的容量,單位是Bytes;enterprise_project_id作為key,對應(yīng)的value是共享所屬的企業(yè)項目ID。
mount_snapshot_support
 
 boolean 否

是否支持掛載快照,目前不支持快照,該字段無意義。(API 微版本2.32以后支持)。
name
 
 string 否

共享名稱。
project_id
 
 string 是

創(chuàng)建共享的項目的UUID。
replication_type
 
 string 否

復(fù)制類型,當(dāng)前不支持復(fù)制,該字段無意義。(API 微版本2.11到2.42以后支持)。
revert_to_snapshot_support
 
 boolean 否

是否支持從快照回滾,目前不支持快照,該字段無意義。(API 微版本2.27以后支持)。
share_network_id
 
 string 否

共享網(wǎng)絡(luò)的UUID,當(dāng)前不支持共享網(wǎng)絡(luò)管理,該字段無意義。
share_proto
 
 string 否

文件系統(tǒng)的共享協(xié)議。
share_server_id
 
 string 否

共享服務(wù)管理的UUID
share_type
 
 string 否

共享類型的UUID。
share_type_name
 
 string 否

共享類型的名稱,共享類型用于指定分配哪些類型的存儲服務(wù),例如高性能類型(由SSD磁盤組成)、大容量類型(由SATA盤組成)。(API 微版本2.6以后支持)。
size
 
 integer 是

共享容量,單位GB。
snapshot_id
 
 string 否

創(chuàng)建共享的源快照的UUID,當(dāng)前不支持快照,該字段當(dāng)前無意義。
snapshot_support
 
 boolean 否

是否支持快照,當(dāng)前不支持快照,該字段當(dāng)前無意義。(API 微版本2.2以后支持)。
source_share_group_snapshot_member_id
 
 string 否

一致性快照源的UUID,當(dāng)前不支持一致性快照,該字段無意義。(API 微版本2.31以后支持)。
status
 
 string 否

共享的狀態(tài)。
task_state
 
 string 否

數(shù)據(jù)遷移 狀態(tài),當(dāng)前不支持數(shù)據(jù) 遷移 ,該字段無意義。(API 微版本2.5以后支持)
user_id
 
 string 否

用戶ID。(API 微版本2.16以后支持)。
volume_type
 
 string 否

卷類型,,與share_type含義相同。
請求示例
示例 1

查詢共享詳細信息

 
"GET https://{endpoint}/v2/{project_id}/shares/{share_id}"
 
"GET https://{endpoint}/v2/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309"
返回示例
返回碼：200

OK

示例 1
 
{
"share": {
"access_rules_status": "active",
"availability_zone": "az1.dc1",
"create_share_from_snapshot_support": null,
"created_at": "2018-12-25T08:45:22.525899",
"description": "My custom share London",
"has_replicas": false,
"host": "DJ38@a4588256-3880-4136-b3c9-4c3aade8a84b#a4588256-3880-4136-b3c9-4c3aade8a84b",
"id": "f26d867f-9876-433d-8db2-25d210f29309",
"is_public": false,
"links": [
{
"href": "https://192.168.196.47:8796/v2/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
"rel": "self"
},
{
"href": "https://192.168.196.47:8796/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
"rel": "bookmark"
}
],
"metadata": {
"enterprise_project_id": "ttt",
"share_key": "test",
"share_used": "1"
},
"mount_snapshot_support": null,
"name": "luzhongguo_1",
"project_id": "07412155bf474db9a2f697fd978593d7",
"replication_type": null,
"revert_to_snapshot_support": null,
"share_group_id": null,
"share_network_id": null,
"share_proto": "NFS",
"share_server_id": null,
"share_type": "8ae4e74e-83f4-4980-8ab8-e637f9294e0b",
"share_type_name": "sla",
"size": 1,
"snapshot_id": null,
"snapshot_support": true,
"source_share_group_snapshot_member_id": null,
"status": "available",
"task_state": null,
"user_id": "daa3f8f8d7254465841da769298a76f6",
"volume_type": "sla"
}
}
錯誤碼
請參考 錯誤碼說明。

 

查詢共享詳細信息showShareDetal

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會繼續(xù)努力做到更好 反饋提交失?。≌埳院笾卦?！