From 4d12dbffc4580d9788a2e7f18d83c6ac16579112 Mon Sep 17 00:00:00 2001
From: Dominik Csapak <d.csapak@proxmox.com>
Date: Wed, 8 Aug 2018 10:20:09 +0200
Subject: [PATCH] add return description for zfs detail api call

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 PVE/API2/Disks/ZFS.pm | 60 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/PVE/API2/Disks/ZFS.pm b/PVE/API2/Disks/ZFS.pm
index 1690768..3c36ef9 100644
--- a/PVE/API2/Disks/ZFS.pm
+++ b/PVE/API2/Disks/ZFS.pm
@@ -141,7 +141,65 @@ __PACKAGE__->register_method ({
 	},
     },
     returns => {
-	type => 'object'
+	type => 'object',
+	properties => {
+	    name => {
+		type => 'string',
+		description => 'The name of the zpool.',
+	    },
+	    state => {
+		type => 'string',
+		description => 'The state of the zpool.',
+	    },
+	    status => {
+		optional => 1,
+		type => 'string',
+		description => 'Information about the state of the zpool.',
+	    },
+	    action => {
+		optional => 1,
+		type => 'string',
+		description => 'Information about the recommended action to fix the state.',
+	    },
+	    scan => {
+		type => 'string',
+		description => 'Information about the last/current scrub.',
+	    },
+	    scan => {
+		type => 'string',
+		description => 'Information about the errors on the zpool.',
+	    },
+	    children => {
+		type => 'array',
+		description => "The tree of the vdevs. Depending on the configuration of the zpool, they can be nested.",
+		items => {
+		    type => 'object',
+		    properties => {
+			name => {
+			    type => 'string',
+			    description => 'The name of the vdev.',
+			},
+			state => {
+			    type => 'string',
+			    description => 'The state of the vdev.',
+			},
+			read => {
+			    type => 'number',
+			},
+			write => {
+			    type => 'number',
+			},
+			cksum => {
+			    type => 'number',
+			},
+			msg => {
+			    type => 'string',
+			    description => 'An optional message about the vdev.'
+			}
+		    },
+		},
+	    },
+	},
     },
     code => sub {
 	my ($param) = @_;