1. 调用认证接口获取SID (ip地址替换成自己实际的NAS ip)
请求地址：
返回结果示例
{
"data": {
"did": "xxxxxxxxxxxxxxxxxxxxxx",
"sid": "yyyyyyyyyyyyyyyyyyyyyyyyyy"
},
"success": true
}2. 使用SID作为凭据，访问接口获取状态
请求地址：
返回结果示例，看上去硬盘爆了……一会加班修一下
{
"data": {
"hostname": "MYNAS",
"interfaces": [
{
"id": "ovs_bond0",
"ip": "192.168.1.100",
"type": "ovsbond"
},
{
"id": "ovs_eth3",
"ip": "169.254.79.143",
"type": "ovseth"
}
],
"rule": {
"description": {
"description_format": "{0}",
"description_params": [
"widget:storage_is_warning"
],
"description_use_formatted": false
},
"id": "storage_is_attention",
"priority": 2.2,
"type": 1
},
"uptime": "1137:42:40"
},
"success": true
}3. 获取备份任务的状态，可以在URL参数additional里进行字段过滤，只返回指定的内容
请求地址：
https://192.168.1.100:5001/webapi/entry.cgi?api=SYNO.Backup.Task&method=list&version=1&additional=["last_bkp_time","last_bkp_result","next_bkp_time"]&_sid=yyyyyyyyyyyyyyyyyyyyyyyyyy返回结果示例
{
"data": {
"is_data_restoring": false,
"is_downloading": false,
"is_lun_restoring": false,
"is_restoring": false,
"is_snapshot_restoring": false,
"task_list": [
{
"data_enc": false,
"data_type": "data",
"ext3ShareList": [],
"last_bkp_end_time": "2025/08/21 03:00",
"last_bkp_result": "failed",
"last_bkp_time": "2025/08/21 03:00",
"name": "LOCAL_BACK",
"next_bkp_time": "2025/08/22 03:00",
"repo_id": 8,
"schedule": {
"schedule": {
"date": "2025/8/21",
"date_type": 0,
"hour": 3,
"last_work_hour": 3,
"min": 0,
"next_trigger_time": "2025-08-22 03:00",
"repeat": 0,
"repeat_hour": 0,
"repeat_hour_store_config": null,
"repeat_min": 0,
"repeat_min_store_config": null,
"week_name": "0,1,2,3,4,5,6"
},
"schedule_enable": true
},
"state": "backupable",
"status": "none",
"target_id": "BAK.hbk",
"target_type": "image",
"task_id": 8,
"transfer_type": "image_local",
"type": "image:image_local"
}
],
"total": 1
},
"success": true
}4. 获取存储池状态，可以获取总览数据、所有物理磁盘、所有卷、缓存和存储的详细状态数据
请求地址：
https://192.168.1.100:5001/webapi/entry.cgi?api=SYNO.Storage.CGI.Storage&method=load_info&version=1&_sid=yyyyyyyyyyyyyyyyyyyyy
返回结果示例，确实是容量爆了
{
"data": {
"detected_pools": [],
"disks": [
{
"action": {
"alert": false,
"notification": false,
"selectable": true,
"show_lifetime_chart": true
},
"adv_progress": "",
"adv_status": "not_support",
"below_remain_life_mail_notify_thr": false,
"below_remain_life_show_thr": false,
"below_remain_life_thr": false,
"compatibility": "support",
"container": {
"order": 0,
"str": "DS1618+",
"supportPwrBtnDisable": false,
"type": "internal"
},
"container_id": 0,
"device": "/dev/sda",
"disable_secera": false,
"diskType": "SATA",
"disk_code": "",
"disk_location": "Main",
"erase_time": 414,
"firm": "TN04",
"firmware_status": "-",
"has_system": true,
"hide_info": [],
"i18nNamingInfo": "[\"dsm:volume:volume_disk\",\" \",\"1\"]",
"id": "sda",
"ihm_testing": false,
"is4Kn": false,
"isSsd": false,
"isSynoDrive": false,
"isSynoPartition": true,
"is_bundle_ssd": false,
"is_erasing": false,
"longName": "硬盘 1",
"model": "ST4000NM0035-1V4107",
"name": "硬盘 1",
"num_id": 1,
"order": 1,
"overview_status": "normal",
"pciSlot": -1,
"perf_testing": false,
"portType": "normal",
"remain_life": -1,
"remain_life_danger": false,
"remote_info": {
"compatibility": "disabled",
"unc": 0
},
"sb_days_left": 0,
"sb_days_left_critical": false,
"sb_days_left_warning": false,
"serial": "aaaaaaaa",
"size_total": "4000787030016",
"slot_id": 1,
"smart_progress": "",
"smart_status": "normal",
"smart_test_limit": 0,
"smart_test_support": true,
"smart_testing": false,
"status": "normal",
"summary_status_category": "space",
"summary_status_key": "normal",
"temp": 40,
"testing_progress": "",
"testing_type": "idle",
"tray_status": "join",
"ui_serial": "aaaaaaaa",
"unc": 0,
"used_by": "reuse_1",
"vendor": "Seagate",
"wcache_force_off": false,
"wcache_force_on": false,
"wdda_support": false
},
{
"action": {
"alert": false,
"notification": false,
"selectable": true,
"show_lifetime_chart": true
},
"adv_progress": "",
"adv_status": "not_support",
"below_remain_life_mail_notify_thr": false,
"below_remain_life_show_thr": false,
"below_remain_life_thr": false,
"compatibility": "support",
"container": {
"order": 0,
"str": "DS1618+",
"supportPwrBtnDisable": false,
"type": "internal"
},
"container_id": 0,
"device": "/dev/sde",
"disable_secera": false,
"diskType": "SATA",
"disk_code": "",
"disk_location": "Main",
"erase_time": 2,
"firm": "RVM02B6Q",
"firmware_status": "-",
"has_system": false,
"hide_info": [],
"i18nNamingInfo": "[\"dsm:volume:volume_disk\",\" \",\"5\"]",
"id": "sde",
"ihm_testing": false,
"is4Kn": false,
"isSsd": true,
"isSynoDrive": false,
"isSynoPartition": false,
"is_bundle_ssd": false,
"is_erasing": false,
"longName": "硬盘 5",
"model": "SSD 860 PRO 256GB",
"name": "硬盘 5",
"num_id": 5,
"order": 5,
"overview_status": "normal",
"pciSlot": -1,
"perf_testing": false,
"portType": "normal",
"remain_life": 89,
"remain_life_danger": false,
"remote_info": {
"compatibility": "disabled",
"unc": 0
},
"sb_days_left": 0,
"sb_days_left_critical": false,
"sb_days_left_warning": false,
"serial": "ddddddddddd",
"size_total": "256060514304",
"slot_id": 5,
"smart_progress": "",
"smart_status": "normal",
"smart_test_limit": 0,
"smart_test_support": true,
"smart_testing": false,
"status": "normal",
"summary_status_category": "space",
"summary_status_key": "normal",
"temp": 30,
"testing_progress": "",
"testing_type": "idle",
"tray_status": "ssd cache",
"ui_serial": "ddddddddddd",
"unc": -1,
"used_by": "shared_cache_2",
"vendor": "Samsung ",
"wcache_force_off": false,
"wcache_force_on": false,
"wdda_support": false
}
],
"env": {
"batchtask": {
"max_task": 64,
"remain_task": 64
},
"bay_number": "6",
"cache_max_ssd_num": 6,
"data_scrubbing": {
"sche_enabled": "1",
"sche_pool_order": [
"/dev/vg2",
"/dev/vg1"
],
"sche_status": "done"
},
"eunits": [],
"fs_acting": false,
"is_space_actioning": false,
"m2_card_info": [],
"max_fs_bytes": "118747255799808",
"max_fs_bytes_high_end": "219902325555200",
"model_name": "DS1618+",
"multipathStatus": "normal",
"multipathSupport": false,
"ram_enough_for_fs_high_end": false,
"ram_size": 4,
"ram_size_required": 32,
"showpooltab": true,
"space_size_limit": {
"allocatable_size": 0,
"is_limited": false,
"size_limit": 0
},
"status": {
"is_support_sha_peta_volume": false,
"root_size_byte": 2549940224,
"system_crashed": false,
"system_need_repair": false,
"system_rebuilding": false
},
"storageMachineInfo": [
{
"isInternal": true,
"isSAS": false,
"machineSerial": "fffffffff",
"machineStatus": "existed",
"modelName": "DS1618+",
"nameStr": "MYNAS",
"order": 0,
"ports": []
}
],
"support": {
"ebox": true,
"raid_cross": true,
"sysdef": true
},
"unique_key": "gggggggggg"
},
"missing_pools": [],
"overview_data": {
"incompatible_eunit": [],
"pools_to_show": {
"detected_pool": [],
"storage_pool": [
"reuse_1"
]
},
"sample_level_str": {
"attention": "status_level_abnormal",
"danger": "status_level_danger",
"normal": "status_level_normal"
},
"space_affect_by_eunit_lost": false,
"space_affect_by_location_mismatch": false,
"status_level": "status_level_abnormal"
},
"ports": [],
"sharedCaches": [
{
"apm_flush_status": "no_need",
"can_do": {
"delete": true,
"migrate": {
"to_raid1": 3,
"to_raid5": 2
},
"raid_cross": true
},
"compatibility": true,
"desc": "",
"device_type": "basic",
"disks": [
"sde"
],
"id": "shared_cache_2",
"is_missing": false,
"is_writable": true,
"minimal_disk_size": "256050923520",
"num_id": 2,
"raids": [
{
"designedDiskCount": 1,
"devices": [
{
"id": "sde",
"slot": 0,
"status": "normal"
}
],
"hasParity": false,
"minDevSize": "256050923520",
"normalDevCount": 1,
"raidCrashedReason": 0,
"raidPath": "/dev/md4",
"raidStatus": 1,
"spares": []
}
],
"size": {
"recyclable": "0",
"total": "256049676288",
"used": "255563137024"
},
"space_path": "/dev/shared_cache_vg1",
"task": "none"
}
],
"ssdCaches": [
{
"SSDPath": "/dev/shared_cache_vg1/alloc_cache_1",
"SSDUUID": "mmmmmmmmmmmmmmmmmmmmmmm",
"cacheStatus": "",
"cache_disks": [],
"can_assemble": false,
"can_do": {
"cancelDelete": false,
"delete": true,
"migrate": {
"to_raid1": 3,
"to_raid5": 2
},
"raid_cross": true
},
"compatibility": true,
"container": "internal",
"data_scrubbing": {
"can_do_manual": false,
"can_do_schedule": false,
"reason": "not_support"
},
"designedDiskCount": 1,
"dev_count": 1,
"device_type": "basic",
"disk_failure_number": 0,
"disks": [
"sde"
],
"drive_type": 1,
"hash_mapping": true,
"hit_rate": 84,
"hit_rate_write": 0,
"hit_rates": {
"Current": {
"data_size": 1,
"io_hit": 0,
"io_need_acceleration": 0,
"success": true
},
"Daily": {
"data_size": 0,
"io_hit": 0,
"io_need_acceleration": 0,
"success": false
},
"HalfYearly": {
"data_size": 0,
"io_hit": 0,
"io_need_acceleration": 0,
"success": false
},
"Minutely": {
"data_size": 0,
"io_hit": 0,
"io_need_acceleration": 0,
"success": false
},
"Monthly": {
"data_size": 0,
"io_hit": 0,
"io_need_acceleration": 0,
"success": false
},
"Weekly": {
"data_size": 0,
"io_hit": 0,
"io_need_acceleration": 0,
"success": false
},
"Yearly": {
"data_size": 0,
"io_hit": 0,
"io_need_acceleration": 0,
"success": false
},
"has_history": false
},
"id": "alloc_cache_2_1",
"is_actioning": false,
"is_backgroundbuilding": false,
"is_missing": false,
"is_scheduled": false,
"last_done_time": 0,
"limited_disk_number": 24,
"loaded": true,
"maxDegradeFlush": false,
"maximal_disk_size": "0",
"memory": "97484800",
"metadataCache": false,
"metadataCacheOptionShow": false,
"minimal_disk_size": "256050923520",
"minimal_spare_size": "0",
"missing_drives": [],
"mode": "read",
"mountSpaceId": "volume_2",
"next_schedule_time": 0,
"num_id": 0,
"path": "/volume2",
"policy": 0,
"pool_path": "",
"progress": {
"cur_step": 0,
"is_resync_speed_limited": false,
"percent": "-1",
"remaining_time": 0,
"step": "none",
"total_step": 0
},
"protectProgress": -1,
"raids": [
{
"designedDiskCount": 1,
"devices": [
{
"id": "sde",
"slot": 0,
"status": "normal"
}
],
"hasParity": false,
"minDevSize": "256050923520",
"normalDevCount": 1,
"raidCrashedReason": 0,
"raidPath": "/dev/md4",
"raidStatus": 1,
"spares": []
}
],
"repair_action": "none",
"scrubbingStatus": "",
"show_assemble_btn": false,
"size": {
"occupied": "0",
"reusable": "254721392640",
"total": "255550554112"
},
"skipSeqIO": true,
"space_path": "/dev/shared_cache_vg1/alloc_cache_1",
"space_status": {
"detail": "cache_normal",
"show_attention": false,
"show_danger": false,
"show_flag_detail": "",
"status": "cache_normal",
"summary_status": "normal"
},
"spares": [],
"status": "normal",
"suggestions": [],
"summary_status": "normal",
"task": "none",
"timebackup": false,
"uuid": "hhhhhhhhhhhhhhhhhhh",
"version": 3,
"version_status": "vol_latest_version",
"vspace_can_do": {
"drbd": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
},
"flashcache": {
"apply": {
"can_do": false,
"errCode": 768,
"stopService": false
},
"remove": {
"can_do": false,
"errCode": 768,
"stopService": false
},
"resize": {
"can_do": false,
"errCode": 768,
"stopService": false
}
},
"snapshot": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
}
}
}
],
"storagePools": [
{
"cacheStatus": "",
"cache_disks": [
"sde"
],
"can_assemble": false,
"can_do": {
"delete": true,
"disk_replace": true,
"expand_by_disk": 1,
"migrate": {
"to_shr2": 2
},
"raid_cross": true
},
"compatibility": true,
"container": "internal",
"data_scrubbing": {
"can_do_manual": true,
"can_do_schedule": true,
"reason": ""
},
"desc": "POOL_DATA",
"device_type": "shr_with_1_disk_protect",
"disk_failure_number": 0,
"disks": [
"sdd",
"sdf"
],
"drive_type": 0,
"has_full_child_vol": true,
"id": "reuse_2",
"is_actioning": false,
"is_backgroundbuilding": false,
"is_scheduled": true,
"is_writable": true,
"last_done_time": 1754499457,
"limited_disk_number": 24,
"maximal_disk_size": "0",
"minimal_disk_size": "8001457274880",
"minimal_spare_size": "8001457274880",
"missing_drives": [],
"next_schedule_time": 1757001600,
"num_id": 2,
"pool_child": [
{
"id": "volume_2",
"size": {
"total": "7996155363328"
}
}
],
"pool_path": "reuse_2",
"progress": {
"cur_step": 0,
"is_resync_speed_limited": false,
"percent": "-1",
"remaining_time": 0,
"step": "none",
"total_step": 0
},
"raidType": "multiple",
"raids": [
{
"designedDiskCount": 2,
"devices": [
{
"id": "sdf",
"slot": 1,
"status": "normal"
},
{
"id": "sdd",
"slot": 0,
"status": "normal"
}
],
"hasParity": false,
"minDevSize": "8001457274880",
"normalDevCount": 2,
"raidCrashedReason": 0,
"raidPath": "/dev/md3",
"raidStatus": 1,
"spares": []
}
],
"repair_action": "none",
"scrubbingStatus": "schedule_done",
"show_assemble_btn": false,
"size": {
"total": "7996612542464",
"used": "7996167946240"
},
"space_path": "/dev/vg1",
"space_status": {
"detail": "pool_normal",
"show_attention": false,
"show_danger": false,
"show_flag_detail": "",
"status": "pool_normal",
"summary_status": "normal"
},
"spares": [],
"status": "normal",
"suggestions": [],
"summary_status": "normal",
"timebackup": false,
"uuid": "iiiiiiiiiiiiiiiiiiiiiiiii",
"vspace_can_do": {
"drbd": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
},
"flashcache": {
"apply": {
"can_do": false,
"errCode": 768,
"stopService": false
},
"remove": {
"can_do": false,
"errCode": 768,
"stopService": false
},
"resize": {
"can_do": false,
"errCode": 768,
"stopService": false
}
},
"snapshot": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
}
}
},
{
"cacheStatus": "",
"cache_disks": [],
"can_assemble": false,
"can_do": {
"delete": true,
"disk_replace": true,
"expand_by_disk": 1,
"migrate": {
"to_shr2": 2
},
"raid_cross": true
},
"compatibility": true,
"container": "internal",
"data_scrubbing": {
"can_do_manual": true,
"can_do_schedule": true,
"reason": ""
},
"desc": "POOL_BACK",
"device_type": "shr_with_1_disk_protect",
"disk_failure_number": 0,
"disks": [
"sda",
"sdb"
],
"drive_type": 0,
"has_full_child_vol": true,
"id": "reuse_1",
"is_actioning": false,
"is_backgroundbuilding": false,
"is_scheduled": true,
"is_writable": true,
"last_done_time": 1754411600,
"limited_disk_number": 24,
"maximal_disk_size": "0",
"minimal_disk_size": "3994647805952",
"minimal_spare_size": "3994647805952",
"missing_drives": [],
"next_schedule_time": 1757001600,
"num_id": 1,
"pool_child": [
{
"id": "volume_1",
"size": {
"total": "3988950876160"
}
}
],
"pool_path": "reuse_1",
"progress": {
"cur_step": 0,
"is_resync_speed_limited": false,
"percent": "-1",
"remaining_time": 0,
"step": "none",
"total_step": 0
},
"raidType": "multiple",
"raids": [
{
"designedDiskCount": 2,
"devices": [
{
"id": "sdb",
"slot": 1,
"status": "normal"
},
{
"id": "sda",
"slot": 0,
"status": "normal"
}
],
"hasParity": false,
"minDevSize": "3994647805952",
"normalDevCount": 2,
"raidCrashedReason": 0,
"raidPath": "/dev/md2",
"raidStatus": 1,
"spares": []
}
],
"repair_action": "none",
"scrubbingStatus": "schedule_done",
"show_assemble_btn": false,
"size": {
"total": "3989798125568",
"used": "3988963459072"
},
"space_path": "/dev/vg2",
"space_status": {
"detail": "fs_almost_full",
"show_attention": false,
"show_danger": false,
"show_flag_detail": "",
"status": "pool_normal",
"summary_status": "attention"
},
"spares": [],
"status": "attention",
"suggestions": [
{
"arg": [
"1"
],
"section": "volume",
"str": "volume_usage_suggestion",
"type": "warning"
}
],
"summary_status": "attention",
"timebackup": false,
"uuid": "jjjjjjjjjjjjjjjjjjjjj",
"vspace_can_do": {
"drbd": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
},
"flashcache": {
"apply": {
"can_do": false,
"errCode": 768,
"stopService": false
},
"remove": {
"can_do": false,
"errCode": 768,
"stopService": false
},
"resize": {
"can_do": false,
"errCode": 768,
"stopService": false
}
},
"snapshot": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
}
}
}
],
"volumes": [
{
"atime_checked": false,
"atime_opt": "relatime",
"cache": {
"id": "alloc_cache_2_1",
"status": "normal"
},
"cacheStatus": "",
"cache_advisor_running": false,
"cache_disks": [],
"can_assemble": false,
"can_do": {
"delete": true,
"raid_cross": true
},
"container": "internal",
"device_type": "shr_with_1_disk_protect",
"disk_failure_number": 0,
"disks": [],
"drive_type": 0,
"fs_type": "btrfs",
"id": "volume_2",
"is_acting": false,
"is_actioning": false,
"is_backgroundbuilding": false,
"is_inode_full": false,
"is_scheduled": false,
"is_writable": true,
"last_done_time": 0,
"limited_disk_number": 24,
"max_fs_size": "1152921504606846976",
"metadata_cache_hard_lower_bound_byte": 78014054400,
"metadata_cache_option_show": true,
"missing_drives": [],
"next_schedule_time": 0,
"num_id": 2,
"pool_path": "reuse_2",
"progress": {
"cur_step": 0,
"is_resync_speed_limited": false,
"percent": "-1",
"remaining_time": 0,
"step": "none",
"total_step": 0
},
"raidType": "multiple",
"repair_action": "none",
"scrubbingStatus": "",
"show_assemble_btn": false,
"size": {
"free_inode": "0",
"total": "7676309151744",
"total_device": "7996155363328",
"total_inode": "0",
"used": "4560945549312"
},
"space_status": {
"detail": "pool_normal",
"show_attention": false,
"show_danger": false,
"show_flag_detail": "",
"status": "fs_normal",
"summary_status": "normal"
},
"ssd_trim": {
"support": "not support"
},
"status": "normal",
"suggestions": [],
"summary_status": "normal",
"timebackup": false,
"used_by_gluster": false,
"uuid": "kkkkkkkkkkkkkkkkkkkkk",
"vol_attribute": "generic",
"vol_desc": "主存储",
"vol_path": "/volume2",
"vspace_can_do": {
"drbd": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
},
"flashcache": {
"apply": {
"can_do": false,
"errCode": 49152,
"stopService": false
},
"remove": {
"can_do": true,
"errCode": 0,
"stopService": true
},
"resize": {
"can_do": true,
"errCode": 0,
"stopService": false
}
},
"snapshot": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
}
}
},
{
"atime_checked": false,
"atime_opt": "relatime",
"cacheStatus": "",
"cache_advisor_running": false,
"cache_disks": [],
"can_assemble": false,
"can_do": {
"delete": true,
"raid_cross": true
},
"container": "internal",
"device_type": "shr_with_1_disk_protect",
"disk_failure_number": 0,
"disks": [],
"drive_type": 0,
"fs_type": "btrfs",
"id": "volume_1",
"is_acting": false,
"is_actioning": false,
"is_backgroundbuilding": false,
"is_inode_full": false,
"is_scheduled": false,
"is_writable": true,
"last_done_time": 0,
"limited_disk_number": 24,
"max_fs_size": "1152921504606846976",
"metadata_cache_hard_lower_bound_byte": 67192750080,
"metadata_cache_option_show": true,
"missing_drives": [],
"next_schedule_time": 0,
"num_id": 1,
"pool_path": "reuse_1",
"progress": {
"cur_step": 0,
"is_resync_speed_limited": false,
"percent": "-1",
"remaining_time": 0,
"step": "none",
"total_step": 0
},
"raidType": "multiple",
"repair_action": "none",
"scrubbingStatus": "",
"show_assemble_btn": false,
"size": {
"free_inode": "0",
"total": "3829392842752",
"total_device": "3988950876160",
"total_inode": "0",
"used": "3825933025280"
},
"space_status": {
"detail": "fs_almost_full",
"show_attention": false,
"show_danger": false,
"show_flag_detail": "",
"status": "fs_almost_full",
"summary_status": "attention"
},
"ssd_trim": {
"support": "not support"
},
"status": "attention",
"suggestions": [],
"summary_status": "attention",
"timebackup": false,
"used_by_gluster": false,
"uuid": "lllllllllllllllllll",
"vol_attribute": "generic",
"vol_desc": "备份空间",
"vol_path": "/volume1",
"vspace_can_do": {
"drbd": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
},
"flashcache": {
"apply": {
"can_do": false,
"errCode": 49152,
"stopService": false
},
"remove": {
"can_do": true,
"errCode": 0,
"stopService": true
},
"resize": {
"can_do": true,
"errCode": 0,
"stopService": false
}
},
"snapshot": {
"resize": {
"can_do": false,
"errCode": 53504,
"stopService": false
}
}
}
}
]
},
"success": true
}