[pve-devel] [PATCH v2 pve-docs] resource-pools: add section in docs

Dylan Whyte d.whyte at proxmox.com
Fri Jan 29 08:54:40 CET 2021


Adds a second-level heading for resource pools and adds creation of pool
to example.

Signed-off-by: Dylan Whyte <d.whyte at proxmox.com>
---
v1->v2: no change

 .../screenshot/gui-datacenter-pool-window.png | Bin 0 -> 8591 bytes
 pveum.adoc                                    |  40 ++++++++++++------
 2 files changed, 26 insertions(+), 14 deletions(-)
 create mode 100644 images/screenshot/gui-datacenter-pool-window.png

diff --git a/images/screenshot/gui-datacenter-pool-window.png b/images/screenshot/gui-datacenter-pool-window.png
new file mode 100644
index 0000000000000000000000000000000000000000..60fdaacb4947cb08d6dad8ca7a1abe873c2a2e44
GIT binary patch
literal 8591
zcmbVy1z1#3yY&Dfpp*qTv?z@<(nxogfOK~bT}mpY(v2V;1JYdr(!w~@&>hm<cl-VK
zx%d9x{r>0q?|opHGy9yq_dENncdfPG!v_^5X}o*Tdk_c&PgX`k4FW-92FJ<RcfsFy
zJS;5mcE?gwQ4|8Hh`E1dj0rwdnaZdsLLlC>5J+G!1abkI0 at ooB7#jq#X#|1rCqW>@
zPH7FQg5bnm6M1O~$nD>stmgb!(1PP6qvHyJ5EcA=p_!|8?SV!tH(5nVtQ9meTv{%v
z_l}34iO|$o$sG(J2?8jGK+vPW>;6{IYfBJ-kgSBLhUe7wjF0DI<aN*f=^xtE7pDR^
zgx_88=sotr9*Vw`!+acX71yuKj6Mq~9HV3jf3JyFT1_8bqe1;3s9 at R=U09`D?fJXD
z^iN{gpSEZxgB8Eax)1NhaNTEr{yf}{s0F^Z;5Csvnd~|=<m<9J at FzMUHZ}(mDMjPm
zOhFxNCHKc&z}(y%vL2^)c6K(uv9Yn~f<rCAl97=CK4-;=S#m)~Hr#m0 at U;`=v8ipG
zdCAt at _(As+q>X0T%TI)2T){&~OhU2n&@XKd#p>{In5lzNpZ at ufK%4kAw(}C-CsheK
zDe4{$Rwtg;$AMbygW(^JaxFEeW^%6JHq9=S351I&y$s(gZj5*~Rv&uT;8W3##uQ{(
zK+GP;xiD8I#c>j4i#I);&E;FTF^JN=h21Zyaim<i#?s}e$`RSm%tx>fMDPXClm$fa
zbP!m|dzyLiGsFrIPAjxnGD!Hje6)MMBP5SvqukkkEXCQm5|cdYA}~ib_=07;FA1f`
z%~%D6$&s8+TA!pdmAc-<s0+;R!d5UYk)nh9Cr!M*CrIP_9yKS_qj2LcFH7y0l)jnT
zrn=#^SToO}n%uNW(mSKHN2bNXGfl7C?WRJ{*|PPn$v<1%6{2a7EMJ||DG^B;biAl`
z*yDi;g~AN6L at cHeSKkkP@$j}n-a_f`oh{W)Uiq161Yz8#8Xb;>_avp+_A-~5Eu4Bq
z%JFx;YPA-xgX0e4I5(61q<=Q^wqwap7rop~Sr}vL(&Qfd?>9SD^=ava#GcuXY^Uz`
zOm|i_ at Xa1`dny!<NLSa2N*4!S1WZyR?MyFL6{1%stai5ABYjeGtW#Y5j~Nz<gPzrG
zH!sC$@p=j}q+jx19IhF&tk<4B7Z(^KkA(0?LD7ge)_M(h9Ay(vqbr$a`hMzR6u8k7
zZL?QyhKKxFl+(TN;mDIFyhU+_Z;smWs}6MR9`b6cD5-D?1x;NXxZFDV;<}(|hKI`a
z(toquf~;8^+36X6IeEfXq)b>ER4lfo;Lj&}dC&8kC7}uuu{p^f7#G=b7i)}Lgz*X6
z{#Ir1rRN^p5>@G<!No*Cw5U=Y)^`N;z0}Zy2nR5yh!EJKwVlnjAGLPXj-Ytfx!s_=
zWSS`N+e|NC_pHFv(CYb~Lh>Y`I=;i(&z+-jzL1kNhJ|`=%VbX<>`OWis{N6%KYZ#P
z5v0S0TNV!%L*1DV(b+%y4~^S*;tGxlg#TzhPpge{omEp>ob{#HB9}mwM>Llu$%sUo
z8(8hRLuWd5VG|t<Ig-_RBEGf|*8uX~nB?3vMtaMU at Psq3jlIKBb{3vUmclN)*=|Q~
ztXB=~AMNpHC*y-g)TLXkC?N^ktVSl8gbk8f`nh$SQ(?yB*XIXWA<jZUIw at b2OM1hw
z_%(AI8Gg2XyTw_^jap-<=^ft29#OG8luy^jC{7l`jocy~=xH2)C`96Yl{6Yu{{hlx
z2t@(S9(l)Imri**F48pSCIT-SnmS*UgXkKnmGiWRhL$!x7$VmEbw1qluE;>&IwZ)Q
z+TiN=t5((C>9>j1tgPQksLV9+xrcT}hz~_=Li%so$yH~$S8H*2=2bo!GqkRn6Nz03
zM&UDyu<Dl*)@gW|BR3{;=>pw*s#{&N>)}|kG13 at W)|%Qleyp53->#Rd)w1;YkLm7f
z5NnEq_)FiXepXeH>sciZb5Tm|*SQfFezbcJZ62|E_!LQ3*Zta8N|XUy#O*0C?u*Mb
z+RBK*d5`r(MQM4m%nM@!2F;_w0KX&eLUoN-)^cfnpn^192Q$=kTcY%CP)oL?c2vi7
z=JK4VU$)#n;bP$zT at n{A%!iBR%DN6n$Yl~L$ohd%mSo^N_FAmiDtKVkbVSc`#ej*)
zGg4uLne{eC1`nq(HRs8I7f<lLC3t9l_XM?GamHM!30Sf`X*$)XplIkn)k*QvQoL0b
z<xAiYfCS7X4woUuGH1e-PwtuM$O%ik^p!JBz^3}Tm%1W%D6rce2?d>5HpJugM1UMp
zT1l+*geN~p$5>|kN*MKvlkpQEJGuVi=!F?;V$YJ(E~a1z$dJ2>9{HMh-xCv1vV5jr
zEj5gSY7y(|9g1`xC*2kgFxCSo#@>fH;2BxJeazX?yEsIk{$cOXY*lD*GN2`{uRqch
z3wkU#!51iE*K1}UM<7r6!KAmvH`M)T>1FKju+5MBTe>^8^+C>t7EbM}S+FcR_$}l6
zIutr&9nqJ1F0Qw?v-8$q+9|`ykRTLxv=-uTEV7Guv`C8(>dTDd4Dog4N_;T$%rkp;
zg*6SJF-fdw)ep3-6Yfg+!Btx1>4WQN%X+k3pO*&{jt}4+u2 at q47!>z6kivFG#L63s
zVb at Z>dlBqJ`tZ&F|KU((;{M6W4d2!Sv2a5LSy>z^A)rE}pZ{5f{<Sv!qt)stNJA3g
z(Q_H5uYZRcx_sGN%VXn(Q$ng?>T!p<thV^PlQBQ|zlHR}+$v>t^I3TRe^I=;qBie^
z5aJ|}0Aaa8C}M3mQ&~>#WAWB=Xrbd=%X3=V8<VY9$qII;nn5Je?h}E?)i0zZ;c?w2
zMM9T}@pzej*~?b2H0OtFUWbFP^!0I7V~Sgx-IjlT27O1HeLSwNuWbk61qJh!!@^5H
zK0E^AtXpH(Tj#vAcX((z`Q4l(O6uV7u(!9j9f62FJM-jmoK-L|pt!lY5xo3UNrHQq
zk%>vC+U5xs0mYpx&0?)cDEB=>Lqj<^xg;KYD7 at u@kwv%438vQ&r7V0NJZ>039 at O6U
ziCWy|C~i1YWcYAcWO$)7Y-H<L at N7P4Ael348&%8c{^tz`Cnsox`0ll1J%90{!spcC
z<j-Vhl{Mn$@Nkb67l+ at 48%4m?zAkFE-j$BE`RE~01ZK0rFhW^m at OPm)TKLD0CI`#C
zc9Y*RD<>7q%%009zI-7ln6|&vv$VTAoXlw{qo~+r#r55&9evh&i$y7&U-EEuP^Z!Y
zZ+3PTHrC$R83e9<L`J6I?ajY7l-_B_b2uVRIg+nTd2zBWucbxA&dy$T6E2}&qE-A|
zx3q{oPbs~~#l=NKP3_CY*-}h8Vr?)r|4VFayqcW-be-y8>MLbU4GsFnnX*}*U7`56
zxNmW4jO^^H%?Eu<MO9TAd}R2?-K35Me6FkXse^fB_+cqRJ~dN~9&k0eLfF<=VZG~G
z(f98hxp8Wl0XOxosqyjgjC_1L at d*h$MOUvHTJGZ``F8(IR`waO75H7AFyzMRHhWi(
zZXGjHQ;Ra>{%(7RfsA8NkLz4eA%6K*1ze&TLByi=cbI3-#Owiv>dXAEFABRNh>PF9
zM}I;_R?>2@$pq%Jwzg(uV^bmL*U*e!U$?4;ZE2bFq-wr?9XQqGRSCk2jKqCHM3h(K
zFthpAVg1+FK8IS+?_)%S`mo?(B)C8}mbNgOT%agB``L;Uug30dvu3TsOdK$N_+jF(
zjZsM!!<MF5ehqj&_@<0>bkZQ+>3UbBzQ+uh-)3v9w8*?aL5?98q8$+Vs_Ehcky$iU
zSS<WPLyq0#2lnXbD6iYPO6mFOtPiVtzEW3bCq}xGw1NUIA0OY)c{)F=!-^~08v5YD
z1GmlJI6>`!dDdKxvuWUKLclGmzualuKR7@)+M93x_U+re6YsCB<D);5k8(!VH>W*F
z1w3}Xf%Q4sMBWd4KqJNLlW$R(?AUspkZ9=tR1vYazi-?Tj8pQa0=?Nl+1FQ)NxSS0
z6%9>LT- at WurKQOhKY{l4cEPK?P6z;S=;dzfT)ka20Qw^eiXo5-fkm?idkdX9t^Uof
z$*MV0UlE$y2{h8tW<Am5Lta5x1l_~K1d5384<C#{fSx`+Io42e0rzEauaC#RPJt1y
z at 88GBl8&MHmY?5vVfp~?sIo=giVON7CdTsoV5R9~%9eX|Wp(wt`?l_Y1!qd0s)mMy
zgha5bKMaDl?$)3SC&$NvNJ>ijp06a9=v3x)`>+t*7ZnvPa}cRD<w?cC$1h`N;o^E6
zSW?0axj5chOVifT*+>(y7$6D7C-3VBxqrSG!AinoNAm97J2P|h&!0cP>os#}ftQp-
z*45QPQN2S$?svO#QA0m}I<?^A;5griP*DY5UHPur0=8JYJ@)o19d~cM{s at EE;2MK%
z!5{a=ViBT|*CLnw!$RIi^I*{|XBuEb6?lO!<P&~Xm`c+sB!RnVH&ylF_wV0Qa1l1P
zPsW|0BbAoQ+O<eLYI^ztDeShctfC$37j$&v*wHr4KBu(2yh-T-9^Xy6?pX|_ZTK2q
zo@}QtMZ!LWhf at g%G<H`_PrrReLz50?-400|T!o4v2(^oXoE*oOg-d!U1JY(1J;r$n
z0j at tpM@u2NK)TB)Ddm-vl#FccOjgnXocyq;L~~mIMZH!SI^(bgQck;iHdWKkj+ss=
z%?Q9A;(Ib_xxBK1rfJM$^^0oO|I!{phL7dCHuQp;y8ZlSBuDx$&p2NkS?@IN3PbMV
zlgU_E(2~A#xYK4+&0*Ye=VW)z&=eJP7q7#Pr_$@t0y2s~0O$x22pxTLP5$vi!j6a3
zy)k{IKatbwSC$kKP7N!FXg31A)eH=FHe+OeFQnYjQc)r73?uN^IfH<HgoXjv-0<cT
zXt6fj;&*|nnWbfHT-@&h7{ODH;DQ4Bo3kDf4%2R29=nOxnZkaM@<}`2vxTr~Z`^DL
z+Sm`6_lXFJiNku$77cGNh$|{8h7j2xTb&nw;7rxn%ct_#Pt-bQx(?tJq1&$X#S5NH
zn0k79qig0nY>mU$j>ir2^&8#YHbz6{=ZzWwL`_iudH{x at +6G=BfHgQkYR~!}D(*CF
zy<FqKxQk20!;_%rP>-pINaD8D%GvVF<^P=v;9q4o`9-T#xBkNPA?z36Wppo%>!{`E
zQ-a2oUE^d0+5~2u(RBkPt0<yM_mxzHZ87_0p<s~#m+Zrb*~0(FC5U`xPKiY1D>pV^
zD~%#-Q@(}$r-R53ens!~JF)ITuRWevIIXgSEumN)`G0c)#lf$#FtG6J8nDH<WKMTx
zNUNLfjNuhk2)rj8M<K6_<JHCf)xP#W$B8P&F9FoCI+)tC+#8$B4`T$<M8n57i9D{i
z0T^?GJt#|^ZT6}3+&2O2wZFILbc5h3?cS=Ys$wd$y*SzsJpQfT`bI~Q_7SSa-W3+h
z{qy4!rm`&zRi#Yfs61;8Ev<%z&GA9anXqcp9(=H5T{$tra)6Q9NN~w`odSb{?*J5e
z%zEV)Zz1VJLPGwg85+jjx(51jO}IgGn!sgmES>dSi;#|vPLw}URso0Ws)G0NrskGt
z_2QJZo6)2l&);EbVg%KeHX3T@`~`qz at buIu{hpoup0)MrOOA9*cHA>&=14$z51`P#
z at 8<n%(5U6Lwb<C$p!|Hg{r!Er*{0;CCPCm)yg<^hli)__)|8ij`u6SlP^L(XQhtul
z>5kxD8wQ|@1Qxx}m>2>;%N-qJFW=U+C9#{bB`XZ13lK+ibpR|SahTtm^S at -l#Kcrc
z;p#<ZD#unj&IxzNP!5OOCte4hAu23u%8ut|FHEG||Js{NF~@eij9IrTe0kZdJDObH
z!Xod`xRKI#4^389_Rnl{s*ukKoBb3Qa7XOWD1}VnbU+YIV>Ji_!t3UIjnDszHzkkV
zY5w)B*BZI6uP=#!J2QYaVCdNRcu6lWKFWYAcE5`wYHI3tV7X09Oh86a{_N{pga=$R
zfjP*8eMvy<eeq27$76b1CE`|A^f)*;e~nwNJhA`T0 at hHvKo1b~zhBMS**Q(n>kGAb
z=-z6o<3mbH!<;{=s;UYZg2^m;HAXzCA0i{oHb!%U!@|^cb^CVxPX&Nje^mQeV~_f7
zHS)}%euW4^^z!XbK;;#v?X&Z9_JA8-KtAi6`t98RZgIYXT+E|YO!?N=- at m2raJ-4!
zR1Ua^b*%@!uh8po6*vw#1qBUw)4 at kZ7M8!t-n`#UYBQ9^*Jn}55Z3wCVmPDpWM>Ao
zZa(LCs{hvl0ha>|q&lEKO#$~mPGyz=yhQ~CGC=+T{E;Zf*3vk&&7YrXHdhi2-4ldp
zXvA}KbGhpjQ&O%kPsasXwc!SvodhB!>@3{enrMu#Ue(T?y6;TuGy_Qob^-XhTrqKR
z<k|ib at L_`)LV7dKJ>*4ob#K57Ai0nL_eCHAO`wK=t5RKst}l+&BZyhG08kitdEfXQ
zBelUez+h+?8D;Uit$zY;=HERKa3+B4Y(U81ioU+S-!mR_r4|E8UqQ$p=rUBm%4=9u
z>VTPmdcpZUc1pkr;CQtS3=B2_S~TPsj)814Qc_aFuFjmnaKl2UX(_zUCe5${gP8pM
z{Hbc&L@*zK8hucEmYlr2rle#Dx`vI-ra6j*pI;XbShC4&chD06U^Ce=LsgD}8)PC3
z3{)^Wss>K9-d^u&w)$Vk0UL^{Q49$SE9SHuqR)++`feU^aC)lk<>j>r;D1l$$&)AJ
z*24`oWmTC5Mf~}os-&r=_P(~Z_K-RSHrW~=@|W3HE>3rqb#+q?!|M29o53Si5(utm
z&z^w<dUQ7kO%Y)=+r$T!ZV1M0rc;dUt1#^$;V{Ea$y-=ikpwCT^wza(ZA{Ox3s{<h
ziwH}eR93wcz!W2Silo}NEY>a{wTC~`NRtS8bE$B*Xj~sz2F5dKA56OrFKlhyZ at bUh
z)TV9d7ozqNY(~}|HF9!r$jHi43kzrb^;2YI0{{%TuYu&$-QHZL_iObJ4w?fF28r+#
z!ph2;;d>xE1~=S&yV`QO<C+oO)z#&^{PO`2a!4A1XGqaC11&9ZH2l1VnZSGlLz>B-
zsz7UEYWl7S3!ade7 at M3tnRP<SZS$C4A4&bnWm(4k&jeZ<*w+lID+`5;SlyZ5$j at AD
z+-=DLOa*VfNdbP5 at W~U*w&v4Wc^Mh(M)z%(<DL13QNk~d4i7tRs!b{<_YMw<T<d`~
zw&aBjk!RJ_kz{rI!1(n`$MM5D&l{-wb(x7EtHYVQX_mF9bQETqz#R=C`omHCaHeAX
zGx;7XfN%yzMszABrU+s~-_K7uEqK>1FD|~s$9Dl9B;j|Xzfb&fIfAvtXrkQs&fUA<
zgrt<zUE0{*^9-<~SX^ARu at evwAPp=pFNdPaGVlo>K3u#Cc>Nj@=t_7sdi@$cKJKl5
zy}Wg?37OyB-Aywf7e?+jf5}XMH`q;1PF8Pf3JD1aqyl~zdo!%O<;MvW0O)N~bMs`i
zEirJgW$e52?Loj9?iU+ge+&$StVQDz2NiisH;kcUV4#60?+ObGj~8D%FanZ%t%(hY
z3gc69@`l|m5sNOH?HIFEG?~s;bE$6ivw!k%$^cV*o_j{ksOa!;ND=<xrgZPx>gpJY
zc=3*6dzX{_AI#v3%{|xaDqo~|M0j|?gV*)-^$-ausj(D~dha;}sGr>W!h-1Aw`70q
z4-m}9L_}&@THP5!K4+J6w>wu%qrg<U at 6K-jk=vc92ueyyf;NL%DhidFltfZvH;Jwx
zr0oDC8u;;iQ5YjDt4G2y*t{riKJ`+R>`!2^9xo#Y`%ldIi3(F+un!+P2iXdw1-lq|
zudO?Z^nBYfU at J|;`^ZZ8Vx0y^^tNC;P+_X%<Yc?)x(5)DN5MFcCRzgmqU^&$Lr1{@
zplWQ5;|^eG76s$)On_8A{QVLrNtu2l4}W=?Mpy$7#UpROsIQTkfRlkMHLgYJwD|G?
z--uqML~wgj+iF}n8CWEGA{ume0c?o@$Lch?vpjwJ6k<0~{tloKWO at L(@P6J}k%R5}
zIGobo-~Vs)C3>~^fq(&l5J-Rx7Nqs&7+#@U3ij?;xsQSIk0gDyLtHu#t1K+5ruLB2
zV&FA{q??;t6jL(n!^e-$fKA^(<R1=j4u48ZW7fuD6-RIhUmvN{Dy9AO*=?3ie5ntl
zvgFY13NU`RNyV=mX#((IVPRo``AvD-KMXRWOkW@);Kplh!U8}Pcu32sDr<#g4$QF5
zc3?QfK;6UEUIeU$Wu{*ONaieSXlE$iQf{Jw%MhioFR!xD@#Dh6LLhScy>yve4bj>~
z;`(m<<S{}gBmk=xpwiH^*Kxl(;VGLD1dtxE!w4X`7K1668Z-R~nVHI9235I{dRNQ8
zkwbRs*C-5pwz)%bpT3`QprfY`ueKe3NJ1iGZ2YzV1XKHS{_1ofKDeWZYl<;YS^>q0
zMc{fpV5%?s%{VH|dLLTC<+vO~;`3L-NuzBRV-g)VS6s3F!;m^)BTa=B<KO<M=lNgQ
z(f>i^>c3Q;oNg$zj)z}iQ%k6?p#Am~s{~JHB!Pu<k)scGqWsqtwSy$q5i0l&y^**L
z!;1ULW;Pe!-RAD{lffiE50&PAS<<o6ul5BxrCKj)xx+7-8gc?>p01pc9IeAriX#xq
z6Xf at 7>(eLb#nZ9Us*JCpqoFQ(K~|se3Ughukm7K}9{c*_Ctck&j?vI#TN%>#k;WhH
z($_Na{VID6M{EiqV|kjsGgVW|7~xP)hu=vc?6CjGVd(T2RSKvj3n|Y%P`c&0xkGYn
z_C&jU!HOEE*NayJ`KCwOxwd at M2rV^+82uORj|fbHl%xuVpn%NQ{eXAhl;a2jynacn
zyf76xe-ZENN1thac~EwKa>O6izI{FEGQIfaLeA&|ZLd0f|3;klpyY{yzH7=r_Pwbv
zsMmRhj4meB(-c*&yNh$YKcBuZ($q|In1@|#v&ORWgGC<J;y`S(JWL?r%0JgFa-;66
zSc~NO5pijP{-Qj%?st|u+8yYz!kcqS#v7E+8GB{$T&YOsNA_)5g&~^ew$-<@sH~+K
ztZZ4CAydn#K|jNV-X at MO!@Aa_Cd-t!4Bg;tF52g5q6NiV at rr}F^Ai3zg0}UHuY#U>
zgiuYP%1OOp=OHzvt=AX`tQsm%=>BpKYxjmGg3I;kVOVYVoc!=5Sd6BNBN#jtEH`bT
zw7jExI-`52W;OVR_?Gdbjqx$ADPj1tP-xeVde;!fzQvgE at 1NVHe!NMV$o{l5kp(O0
z54vv$1KRl{D5kiRuTto#8(!HS^vch3AJj6(bBEnuM@<n2jt7u;B`gswK2qigkfwE<
zC6)})uQ1Xk60u0AdtUO|`%U(TgX2+G4)~w%hX-<u*le5W at XSq8e2tLFLHg0TwlP_D
z2+0xuJvpXxPi6c|juOZ;vO7jcZzvlgpPcTfth+wf9rNQcCzS1*IMrN6)!+LM8N3$!
zaF45eM+OZdT`AvNt>vT_Tw7es`0hnY-uqFx4qw(*pHOd~FD at sGB*>aaM8en9G0K#-
zoqI!~CAYip+$(=FH}HlchnIV*ZXOKnp<&ysw(Ffrs?O*f|F*T0uQn=n+nX*z2#yFu
zTJGYmSt&hrZ52`uRE<dt>(*9wb1Lgx|4LJk+``^<At?he#K70t=ZGb7kf=X7!AL%|
zG3Y0>K{gWks>YDaO(fZJNvu9y#IDb1p_5i=HQt#y|Hy`C>!d|Me;~==tKbw%@UU7@
z*~8UDje|?Yr{7k`b}BM{vY2+~;R?DzmmCR9b#Jj}XFtozh6IHP3#r<kzuUgj*A;o%
z`A~6m==O1}=G&nrW7X-0e?mmzBlTXKt9Xus4K$c()p6tA!yl$Oi2M>e^~7^*(l}=A
zh^{$PotwpRt{h{m#tTg-T3AT%_I_C_G&8+V+OwD at 8i}kI&tY5VW+eZ}8M0ypU4C0I
zpO*XH5QYt*Do at 684Xw&f&X1N0>*&eq(KO`vLXlwgg-nherpT{+YCmKsCGlutAZTFm
z-WbKp`NM12oMF|bitvn{H>ZyblYb)*d5_|m{7WoOc^N+Kjx$u}IbulR<^oP;04410
zyS0xo$gjB6V5d9mbE22DaK<!@w2#qe7#NeAy*LqsRPtEv1z_m06*}_bV`lEYQrBIW
zchX`o7N#ii`i?>1>#}H>P_ at 6jX8z*|Oy4)UhFVISIHy;hGjV?j!NMw_JXLPIX)Av2
z^^`hT?_WF at aF)E=9C~fhG(Cpx9 at dcszcgvBT8P&##1loA=V}9NSe}4d2`m;r#&{fB
z?Wpx1bOvY&Dnp^F`O0fxe0cm5&(Y~=;$QB at swa@gUeNmcki$V7E6e(ziHlkSp_#7A
zAJ+LUF)^{YpC*_Pc5raevEY<d`Gy(P<RhhWj;ewQ6+h-#gZe%0T?|khC&+yaeEFR_
zcZ}Fb-s%fe2N$$2IH{<p1gd?!#mYW`-t^!GyaoSc at WM^<jhmUVn>oL!i#d3MaIkT(
zv#_zVaPVrdv-5NE@^f=Av9a^Bv2_z|4g6mn>>bUlExi8U9cty(oj`}De`nBivvzZZ
ns91ZN+qtTkyNH`RxLMnqyP3Oej38^kMG#p at C5bXIqxb&?USGCX

literal 0
HcmV?d00001

diff --git a/pveum.adoc b/pveum.adoc
index b5eea29..6de3597 100644
--- a/pveum.adoc
+++ b/pveum.adoc
@@ -100,6 +100,20 @@ To use an API token, set the HTTP header 'Authorization' to the displayed value
 of the form `PVEAPIToken=USER at REALM!TOKENID=UUID` when making API requests, or
 refer to your API client documentation.
 
+[[pveum_resource_pools]]
+Resource Pools
+--------------
+
+[thumbnail="screenshot/gui-datacenter-pool-window.png"]
+
+A resource pool is a set of virtual machines, containers, and storage
+devices. It is useful for permission handling in cases where certain users
+should have controlled access to a specific set of resources, as it allows for a
+single permission to be applied to a set of elements, rather than having to
+manage this on a per resource basis. Resource pools are often used in tandem
+with groups so that the members of a group have permissions on a set of machines
+and storage.
+
 [[pveum_authentication_realms]]
 Authentication Realms
 ---------------------
@@ -707,20 +721,13 @@ Verify the permissions of the user and token:
  pveum user permissions joe at pve
  pveum user token permissions joe at pve monitoring
 
-Pools
-~~~~~
-
-An enterprise is usually structured into several smaller departments,
-and it is common that you want to assign resources to them and
-delegate management tasks. A pool is simply a set of virtual machines
-and data stores. You can create pools on the GUI. After that you can
-add resources to the pool (VMs, Storage).
-
-You can also assign permissions to the pool. Those permissions are
-inherited to all pool members.
+Resource Pools
+~~~~~~~~~~~~~~
 
-Lets assume you have a software development department, so we first
-create a group
+An enterprise is usually structured into several smaller departments, and it is
+common that you want to assign resources and delegate management tasks to each
+of these. Let's assume that you want to set up a pool for a software development
+department. First, create a group
 
 [source,bash]
  pveum groupadd developers -comment "Our software developers"
@@ -732,7 +739,12 @@ Now we create a new user which is a member of that group
 
 NOTE: The -password parameter will prompt you for a password
 
-I assume we already created a pool called ``dev-pool'' on the GUI. So we can now assign permission to that pool:
+Then we create a resource pool for our development department to use
+
+[source,bash]
+ pveum pooladd dev-pool --comment "IT development pool"
+
+Finally, we can assign permissions to that pool
 
 [source,bash]
  pveum aclmod /pool/dev-pool/ -group developers -role PVEAdmin
-- 
2.20.1






More information about the pve-devel mailing list