€cdocutils.nodes document q)q}q(U nametypesq}q(Xcreate parametersqNXusing a bootable volumeqNXupdatable attributesqNX$url parameters for filtering serversq NXusing an imageq NXsetupq NXserversq NX(creating a server with personality filesq NXintroqNX get serverqNX create serverqNX list serversqNX update serverqNXcreating a server with keypairsqNX delete serverqNuUsubstitution_defsq}qUparse_messagesq]qUcurrent_sourceqNU decorationqNUautofootnote_startqKUnameidsq}q(hUcreate-parametersqhUusing-a-bootable-volumeqhUupdatable-attributesq h U$url-parameters-for-filtering-serversq!h Uusing-an-imageq"h Usetupq#h Userversq$h U(creating-a-server-with-personality-filesq%hUintroq&hU get-serverq'hU create-serverq(hU list-serversq)hU update-serverq*hUcreating-a-server-with-keypairsq+hU delete-serverq,uUchildrenq-]q.cdocutils.nodes section q/)q0}q1(U rawsourceq2UUparentq3hUsourceq4XJ/Users/jamie/projects/php/php-opencloud/doc/services/compute/Server.md.rstq5Utagnameq6Usectionq7U attributesq8}q9(Udupnamesq:]Uclassesq;]Ubackrefsq<]Uidsq=]q>h$aUnamesq?]q@h auUlineqAKUdocumentqBhh-]qC(cdocutils.nodes title qD)qE}qF(h2XServersqGh3h0h4h5h6UtitleqHh8}qI(h:]h;]h<]h=]h?]uhAKhBhh-]qJcdocutils.nodes Text qKXServersqL…qM}qN(h2hGh3hEubaubh/)qO}qP(h2Uh3h0h4h5h6h7h8}qQ(h:]h;]h<]h=]qRh&ah?]qShauhAKhBhh-]qT(hD)qU}qV(h2XIntroqWh3hOh4h5h6hHh8}qX(h:]h;]h<]h=]h?]uhAKhBhh-]qYhKXIntroqZ…q[}q\(h2hWh3hUubaubcdocutils.nodes paragraph q])q^}q_(h2XHA server is a virtual machine instance in the Cloud Servers environment.q`h3hOh4h5h6U paragraphqah8}qb(h:]h;]h<]h=]h?]uhAKhBhh-]qchKXHA server is a virtual machine instance in the Cloud Servers environment.qd…qe}qf(h2h`h3h^ubaubeubh/)qg}qh(h2Uh3h0h4h5h6h7h8}qi(h:]h;]h<]h=]qjh#ah?]qkh auhAK hBhh-]ql(hD)qm}qn(h2XSetupqoh3hgh4h5h6hHh8}qp(h:]h;]h<]h=]h?]uhAK hBhh-]qqhKXSetupqr…qs}qt(h2hoh3hmubaubh])qu}qv(h2XrServer objects are instantiated from the Compute service. For more details, see the `Service `__ docs.h3hgh4h5h6hah8}qw(h:]h;]h<]h=]h?]uhAK hBhh-]qx(hKXTServer objects are instantiated from the Compute service. For more details, see the qy…qz}q{(h2XTServer objects are instantiated from the Compute service. For more details, see the h3huubcdocutils.nodes reference q|)q}}q~(h2X`Service `__h8}q(UnameXServiceUrefuriq€X Service.mdh=]h<]h:]h;]h?]uh3huh-]qhKXServiceq‚…qƒ}q„(h2Uh3h}ubah6U referenceq…ubhKX docs.q†…q‡}qˆ(h2X docs.h3huubeubeubh/)q‰}qŠ(h2Uh3h0h4h5h6h7h8}q‹(h:]h;]h<]h=]qŒh'ah?]qhauhAKhBhh-]qŽ(hD)q}q(h2X Get serverq‘h3h‰h4h5h6hHh8}q’(h:]h;]h<]h=]h?]uhAKhBhh-]q“hKX Get serverq”…q•}q–(h2h‘h3hubaubh])q—}q˜(h2XBThe easiest way to retrieve a specific server is by its unique ID:q™h3h‰h4h5h6hah8}qš(h:]h;]h<]h=]h?]uhAKhBhh-]q›hKXBThe easiest way to retrieve a specific server is by its unique ID:qœ…q}qž(h2h™h3h—ubaubcdocutils.nodes literal_block qŸ)q }q¡(h2X\$serverId = 'ef08aa7a-b5e4-4bb8-86df-5ac56230f841'; $server = $service->server($serverId);h3h‰h4h5h6U literal_blockq¢h8}q£(U xml:spaceq¤Upreserveq¥h=]h<]h:]h;]q¦(Ucodeq§Xphpq¨eh?]uhAKhBhh-]q©cdocutils.nodes inline qª)q«}q¬(h2X\$serverId = 'ef08aa7a-b5e4-4bb8-86df-5ac56230f841'; $server = $service->server($serverId);h8}q­(h:]h;]q®Uotherq¯ah<]h=]h?]uh3h h-]q°hKX\$serverId = 'ef08aa7a-b5e4-4bb8-86df-5ac56230f841'; $server = $service->server($serverId);q±…q²}q³(h2Uh3h«ubah6Uinlineq´ubaubeubh/)qµ}q¶(h2Uh3h0h4h5h6h7h8}q·(h:]h;]h<]h=]q¸h)ah?]q¹hauhAKhBhh-]qº(hD)q»}q¼(h2X List serversq½h3hµh4h5h6hHh8}q¾(h:]h;]h<]h=]h?]uhAKhBhh-]q¿hKX List serversqÀ…qÁ}qÂ(h2h½h3h»ubaubh])qÃ}qÄ(h2X+You can list servers in two different ways:qÅh3hµh4h5h6hah8}qÆ(h:]h;]h<]h=]h?]uhAKhBhh-]qÇhKX+You can list servers in two different ways:qÈ…qÉ}qÊ(h2hÅh3hÃubaubcdocutils.nodes bullet_list qË)qÌ}qÍ(h2Uh3hµh4h5h6U bullet_listqÎh8}qÏ(UbulletqÐX-h=]h<]h:]h;]h?]uhAKhBhh-]qÑ(cdocutils.nodes list_item qÒ)qÓ}qÔ(h2X8return an *overview* of each server (ID, name and links)qÕh3hÌh4h5h6U list_itemqÖh8}q×(h:]h;]h<]h=]h?]uhANhBhh-]qØh])qÙ}qÚ(h2hÕh3hÓh4h5h6hah8}qÛ(h:]h;]h<]h=]h?]uhAKh-]qÜ(hKX return an qÝ…qÞ}qß(h2X return an h3hÙubcdocutils.nodes emphasis qà)qá}qâ(h2X *overview*h8}qã(h:]h;]h<]h=]h?]uh3hÙh-]qähKXoverviewqå…qæ}qç(h2Uh3háubah6UemphasisqèubhKX$ of each server (ID, name and links)qé…qê}që(h2X$ of each server (ID, name and links)h3hÙubeubaubhÒ)qì}qí(h2X.return *detailed information* for each server h3hÌh4h5h6hÖh8}qî(h:]h;]h<]h=]h?]uhANhBhh-]qïh])qð}qñ(h2X-return *detailed information* for each serverh3hìh4h5h6hah8}qò(h:]h;]h<]h=]h?]uhAKh-]qó(hKXreturn qô…qõ}qö(h2Xreturn h3hðubhà)q÷}qø(h2X*detailed information*h8}qù(h:]h;]h<]h=]h?]uh3hðh-]qúhKXdetailed informationqû…qü}qý(h2Uh3h÷ubah6hèubhKX for each serverqþ…qÿ}r(h2X for each serverh3hðubeubaubeubh])r}r(h2XUKnowing which option to use might help save unnecessary bandwidth and reduce latency.rh3hµh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK!hBhh-]rhKXUKnowing which option to use might help save unnecessary bandwidth and reduce latency.r…r}r(h2jh3jubaubhŸ)r }r (h2Xb// overview $servers = $service->serverList(); // detailed $servers = $service->serverList(true);h3hµh4h5h6h¢h8}r (h¤h¥h=]h<]h:]h;]r (h§Xphpr eh?]uhAK+hBhh-]rhª)r}r(h2Xb// overview $servers = $service->serverList(); // detailed $servers = $service->serverList(true);h8}r(h:]h;]rUotherrah<]h=]h?]uh3j h-]rhKXb// overview $servers = $service->serverList(); // detailed $servers = $service->serverList(true);r…r}r(h2Uh3jubah6h´ubaubh/)r}r(h2Uh3hµh4h5h6h7h8}r(h:]h;]h<]h=]rh!ah?]rh auhAK-hBhh-]r(hD)r}r(h2X$URL parameters for filtering serversr h3jh4h5h6hHh8}r!(h:]h;]h<]h=]h?]uhAK-hBhh-]r"hKX$URL parameters for filtering serversr#…r$}r%(h2j h3jubaubcdocutils.nodes table r&)r'}r((h2Uh3jh4h5h6Utabler)h8}r*(h:]h;]h<]h=]h?]uhANhBhh-]r+cdocutils.nodes tgroup r,)r-}r.(h2Uh8}r/(h=]h<]h:]h;]h?]UcolsKuh3j'h-]r0(cdocutils.nodes colspec r1)r2}r3(h2Uh8}r4(h=]h<]h:]h;]h?]UcolwidthKuh3j-h-]h6Ucolspecr5ubj1)r6}r7(h2Uh8}r8(h=]h<]h:]h;]h?]UcolwidthM4uh3j-h-]h6j5ubj1)r9}r:(h2Uh8}r;(h=]h<]h:]h;]h?]UcolwidthK1uh3j-h-]h6j5ubcdocutils.nodes thead r<)r=}r>(h2Uh8}r?(h:]h;]h<]h=]h?]uh3j-h-]r@cdocutils.nodes row rA)rB}rC(h2Uh8}rD(h:]h;]h<]h=]h?]uh3j=h-]rE(cdocutils.nodes entry rF)rG}rH(h2Uh8}rI(h:]h;]h<]h=]h?]uh3jBh-]rJh])rK}rL(h2XNamerMh3jGh4h5h6hah8}rN(h:]h;]h<]h=]h?]uhAK0h-]rOhKXNamerP…rQ}rR(h2jMh3jKubaubah6UentryrSubjF)rT}rU(h2Uh8}rV(h:]h;]h<]h=]h?]uh3jBh-]rWh])rX}rY(h2X DescriptionrZh3jTh4h5h6hah8}r[(h:]h;]h<]h=]h?]uhAK0h-]r\hKX Descriptionr]…r^}r_(h2jZh3jXubaubah6jSubjF)r`}ra(h2Uh8}rb(h:]h;]h<]h=]h?]uh3jBh-]rch])rd}re(h2XTyperfh3j`h4h5h6hah8}rg(h:]h;]h<]h=]h?]uhAK0h-]rhhKXTyperi…rj}rk(h2jfh3jdubaubah6jSubeh6Urowrlubah6Utheadrmubcdocutils.nodes tbody rn)ro}rp(h2Uh8}rq(h:]h;]h<]h=]h?]uh3j-h-]rr(jA)rs}rt(h2Uh8}ru(h:]h;]h<]h=]h?]uh3joh-]rv(jF)rw}rx(h2Uh8}ry(h:]h;]h<]h=]h?]uh3jsh-]rzh])r{}r|(h2Ximager}h3jwh4h5h6hah8}r~(h:]h;]h<]h=]h?]uhAK2h-]rhKXimager€…r}r‚(h2j}h3j{ubaubah6jSubjF)rƒ}r„(h2Uh8}r…(h:]h;]h<]h=]h?]uh3jsh-]r†h])r‡}rˆ(h2X The image IDr‰h3jƒh4h5h6hah8}rŠ(h:]h;]h<]h=]h?]uhAK2h-]r‹hKX The image IDrŒ…r}rŽ(h2j‰h3j‡ubaubah6jSubjF)r}r(h2Uh8}r‘(h:]h;]h<]h=]h?]uh3jsh-]r’h])r“}r”(h2Xstringr•h3jh4h5h6hah8}r–(h:]h;]h<]h=]h?]uhAK2h-]r—hKXstringr˜…r™}rš(h2j•h3j“ubaubah6jSubeh6jlubjA)r›}rœ(h2Uh8}r(h:]h;]h<]h=]h?]uh3joh-]rž(jF)rŸ}r (h2Uh8}r¡(h:]h;]h<]h=]h?]uh3j›h-]r¢h])r£}r¤(h2Xflavorr¥h3jŸh4h5h6hah8}r¦(h:]h;]h<]h=]h?]uhAK4h-]r§hKXflavorr¨…r©}rª(h2j¥h3j£ubaubah6jSubjF)r«}r¬(h2Uh8}r­(h:]h;]h<]h=]h?]uh3j›h-]r®h])r¯}r°(h2X The flavor IDr±h3j«h4h5h6hah8}r²(h:]h;]h<]h=]h?]uhAK4h-]r³hKX The flavor IDr´…rµ}r¶(h2j±h3j¯ubaubah6jSubjF)r·}r¸(h2Uh8}r¹(h:]h;]h<]h=]h?]uh3j›h-]rºh])r»}r¼(h2Xstringr½h3j·h4h5h6hah8}r¾(h:]h;]h<]h=]h?]uhAK4h-]r¿hKXstringrÀ…rÁ}rÂ(h2j½h3j»ubaubah6jSubeh6jlubjA)rÃ}rÄ(h2Uh8}rÅ(h:]h;]h<]h=]h?]uh3joh-]rÆ(jF)rÇ}rÈ(h2Uh8}rÉ(h:]h;]h<]h=]h?]uh3jÃh-]rÊh])rË}rÌ(h2XnamerÍh3jÇh4h5h6hah8}rÎ(h:]h;]h<]h=]h?]uhAK6h-]rÏhKXnamerÐ…rÑ}rÒ(h2jÍh3jËubaubah6jSubjF)rÓ}rÔ(h2Uh8}rÕ(h:]h;]h<]h=]h?]uh3jÃh-]rÖh])r×}rØ(h2XThe server namerÙh3jÓh4h5h6hah8}rÚ(h:]h;]h<]h=]h?]uhAK6h-]rÛhKXThe server namerÜ…rÝ}rÞ(h2jÙh3j×ubaubah6jSubjF)rß}rà(h2Uh8}rá(h:]h;]h<]h=]h?]uh3jÃh-]râh])rã}rä(h2Xstringråh3jßh4h5h6hah8}ræ(h:]h;]h<]h=]h?]uhAK6h-]rçhKXstringrè…ré}rê(h2jåh3jãubaubah6jSubeh6jlubjA)rë}rì(h2Uh8}rí(h:]h;]h<]h=]h?]uh3joh-]rî(jF)rï}rð(h2Uh8}rñ(h:]h;]h<]h=]h?]uh3jëh-]ròh])ró}rô(h2Xstatusrõh3jïh4h5h6hah8}rö(h:]h;]h<]h=]h?]uhAK8h-]r÷hKXstatusrø…rù}rú(h2jõh3jóubaubah6jSubjF)rû}rü(h2Uh8}rý(h:]h;]h<]h=]h?]uh3jëh-]rþh])rÿ}r(h2X0The server status. Servers contain a status attribute that indicates the current server state. You can filter on the server status when you complete a list servers request, and the server status is returned in the response body. For a full list, please consult ``OpenCloud\Compute\Constants\ServerState``h3jûh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK8h-]r(hKXThe server status. Servers contain a status attribute that indicates the current server state. You can filter on the server status when you complete a list servers request, and the server status is returned in the response body. For a full list, please consult r…r}r(h2XThe server status. Servers contain a status attribute that indicates the current server state. You can filter on the server status when you complete a list servers request, and the server status is returned in the response body. For a full list, please consult h3jÿubcdocutils.nodes literal r)r}r(h2X+``OpenCloud\Compute\Constants\ServerState``h8}r (h:]h;]h<]h=]h?]uh3jÿh-]r hKX'OpenCloud\Compute\Constants\ServerStater …r }r (h2Uh3jubah6Uliteralrubeubah6jSubjF)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jëh-]rh])r}r(h2Xstringrh3jh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK8h-]rhKXstringr…r}r(h2jh3jubaubah6jSubeh6jlubjA)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3joh-]r(jF)r}r (h2Uh8}r!(h:]h;]h<]h=]h?]uh3jh-]r"h])r#}r$(h2X changes-sincer%h3jh4h5h6hah8}r&(h:]h;]h<]h=]h?]uhAK:h-]r'hKX changes-sincer(…r)}r*(h2j%h3j#ubaubah6jSubjF)r+}r,(h2Uh8}r-(h:]h;]h<]h=]h?]uh3jh-]r.h])r/}r0(h2X7Value for checking for changes since a previous requestr1h3j+h4h5h6hah8}r2(h:]h;]h<]h=]h?]uhAK:h-]r3hKX7Value for checking for changes since a previous requestr4…r5}r6(h2j1h3j/ubaubah6jSubjF)r7}r8(h2Uh8}r9(h:]h;]h<]h=]h?]uh3jh-]r:h])r;}r<(h2X-A valid ISO 8601 dateTime (2011-01-24T17:08Z)r=h3j7h4h5h6hah8}r>(h:]h;]h<]h=]h?]uhAK:h-]r?hKX-A valid ISO 8601 dateTime (2011-01-24T17:08Z)r@…rA}rB(h2j=h3j;ubaubah6jSubeh6jlubjA)rC}rD(h2Uh8}rE(h:]h;]h<]h=]h?]uh3joh-]rF(jF)rG}rH(h2Uh8}rI(h:]h;]h<]h=]h?]uh3jCh-]rJh])rK}rL(h2XRAX-SI:image\_scheduleh3jGh4h5h6hah8}rM(h:]h;]h<]h=]h?]uhAK`__.h3jzh4h5h6hah8}rã(h:]h;]h<]h=]h?]uhAKNhBhh-]rä(hKX´Firstly we need to find our flavor and image using their UUIDs. For more information about these concepts, including how to find flavor/image UUIDs, please consult §§ 3-4 in the rå…ræ}rç(h2X´Firstly we need to find our flavor and image using their UUIDs. For more information about these concepts, including how to find flavor/image UUIDs, please consult §§ 3-4 in the h3jáubh|)rè}ré(h2X…`Getting Started guide `__h8}rê(UnameXGetting Started guideh€Xihttps://github.com/rackspace/php-opencloud/blob/master/docs/getting-started.md#3-select-your-server-imageh=]h<]h:]h;]h?]uh3jáh-]rëhKXGetting Started guiderì…rí}rî(h2Uh3jèubah6h…ubhKX.…rï}rð(h2X.h3jáubeubhŸ)rñ}rò(h2Xm$ubuntuImage = $compute->image('868a0966-0553-42fe-b8b3-5cadc0e0b3c5'); $twoGbFlavor = $compute->flavor('4');h3jzh4h5h6h¢h8}ró(h¤h¥h=]h<]h:]h;]rô(h§Xphprõeh?]uhAKWhBhh-]röhª)r÷}rø(h2Xm$ubuntuImage = $compute->image('868a0966-0553-42fe-b8b3-5cadc0e0b3c5'); $twoGbFlavor = $compute->flavor('4');h8}rù(h:]h;]rúUotherrûah<]h=]h?]uh3jñh-]rühKXm$ubuntuImage = $compute->image('868a0966-0553-42fe-b8b3-5cadc0e0b3c5'); $twoGbFlavor = $compute->flavor('4');rý…rþ}rÿ(h2Uh3j÷ubah6h´ubaubh])r}r(h2X'Now we're ready to create our instance:rh3jzh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAKXhBhh-]rhKX'Now we're ready to create our instance:r…r}r(h2jh3jubaubhŸ)r}r (h2Xquse OpenCloud\Compute\Constants\Network; $server = $compute->server(); try { $response = $server->create(array( 'name' => 'My lovely server', 'image' => $ubuntuImage, 'flavor' => $twoGbFlavor )); } catch (\Guzzle\Http\Exception\BadResponseException $e) { // No! Something failed. Let's find out: $responseBody = (string) $e->getResponse()->getBody(); $statusCode = $e->getResponse()->getStatusCode(); $headers = $e->getResponse()->getHeaderLines(); echo sprintf('Status: %s\nBody: %s\nHeaders: %s', $statusCode, $responseBody, implode(', ', $headers); }h3jzh4h5h6h¢h8}r (h¤h¥h=]h<]h:]h;]r (h§Xphpr eh?]uhAKohBhh-]r hª)r}r(h2Xquse OpenCloud\Compute\Constants\Network; $server = $compute->server(); try { $response = $server->create(array( 'name' => 'My lovely server', 'image' => $ubuntuImage, 'flavor' => $twoGbFlavor )); } catch (\Guzzle\Http\Exception\BadResponseException $e) { // No! Something failed. Let's find out: $responseBody = (string) $e->getResponse()->getBody(); $statusCode = $e->getResponse()->getStatusCode(); $headers = $e->getResponse()->getHeaderLines(); echo sprintf('Status: %s\nBody: %s\nHeaders: %s', $statusCode, $responseBody, implode(', ', $headers); }h8}r(h:]h;]rUotherrah<]h=]h?]uh3jh-]rhKXquse OpenCloud\Compute\Constants\Network; $server = $compute->server(); try { $response = $server->create(array( 'name' => 'My lovely server', 'image' => $ubuntuImage, 'flavor' => $twoGbFlavor )); } catch (\Guzzle\Http\Exception\BadResponseException $e) { // No! Something failed. Let's find out: $responseBody = (string) $e->getResponse()->getBody(); $statusCode = $e->getResponse()->getStatusCode(); $headers = $e->getResponse()->getHeaderLines(); echo sprintf('Status: %s\nBody: %s\nHeaders: %s', $statusCode, $responseBody, implode(', ', $headers); }r…r}r(h2Uh3jubah6h´ubaubh])r}r(h2XÜIt's always best to be defensive when executing functionality over HTTP; you can achieve this best by wrapping calls in a try/catch block. It allows you to debug your failed operations in a graceful and efficient manner.rh3jzh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAKphBhh-]rhKXÜIt's always best to be defensive when executing functionality over HTTP; you can achieve this best by wrapping calls in a try/catch block. It allows you to debug your failed operations in a graceful and efficient manner.r…r}r(h2jh3jubaubeubh/)r}r (h2Uh3jlh4h5h6h7h8}r!(h:]h;]h<]h=]r"hah?]r#hauhAKvhBhh-]r$(hD)r%}r&(h2XUsing a bootable volumer'h3jh4h5h6hHh8}r((h:]h;]h<]h=]h?]uhAKvhBhh-]r)hKXUsing a bootable volumer*…r+}r,(h2j'h3j%ubaubh])r-}r.(h2XVThere are a few parameter requirements when creating a server using a bootable volume:r/h3jh4h5h6hah8}r0(h:]h;]h<]h=]h?]uhAKxhBhh-]r1hKXVThere are a few parameter requirements when creating a server using a bootable volume:r2…r3}r4(h2j/h3j-ubaubhË)r5}r6(h2Uh3jh4h5h6hÎh8}r7(hÐX-h=]h<]h:]h;]h?]uhAK{hBhh-]r8(hÒ)r9}r:(h2X **name** - needs to be a string;r;h3j5h4h5h6hÖh8}r<(h:]h;]h<]h=]h?]uhANhBhh-]r=h])r>}r?(h2j;h3j9h4h5h6hah8}r@(h:]h;]h<]h=]h?]uhAK{h-]rA(j)rB}rC(h2X**name**h8}rD(h:]h;]h<]h=]h?]uh3j>h-]rEhKXnamerF…rG}rH(h2Uh3jBubah6j¥ubhKX - needs to be a string;rI…rJ}rK(h2X - needs to be a string;h3j>ubeubaubhÒ)rL}rM(h2Xt**flavor** - a ``OpenCloud\Compute\Resource\Flavor`` object, that is populated with the values of a real API flavor;h3j5h4h5h6hÖh8}rN(h:]h;]h<]h=]h?]uhANhBhh-]rOh])rP}rQ(h2Xt**flavor** - a ``OpenCloud\Compute\Resource\Flavor`` object, that is populated with the values of a real API flavor;h3jLh4h5h6hah8}rR(h:]h;]h<]h=]h?]uhAK|h-]rS(j)rT}rU(h2X **flavor**h8}rV(h:]h;]h<]h=]h?]uh3jPh-]rWhKXflavorrX…rY}rZ(h2Uh3jTubah6j¥ubhKX - a r[…r\}r](h2X - a h3jPubj)r^}r_(h2X%``OpenCloud\Compute\Resource\Flavor``h8}r`(h:]h;]h<]h=]h?]uh3jPh-]rahKX!OpenCloud\Compute\Resource\Flavorrb…rc}rd(h2Uh3j^ubah6jubhKX@ object, that is populated with the values of a real API flavor;re…rf}rg(h2X@ object, that is populated with the values of a real API flavor;h3jPubeubaubhÒ)rh}ri(h2Xt**volume** - a ``OpenCloud\Volume\Resource\Volume`` object, that is populated with the values of a real API volume; h3j5h4h5h6hÖh8}rj(h:]h;]h<]h=]h?]uhANhBhh-]rkh])rl}rm(h2Xs**volume** - a ``OpenCloud\Volume\Resource\Volume`` object, that is populated with the values of a real API volume;h3jhh4h5h6hah8}rn(h:]h;]h<]h=]h?]uhAK~h-]ro(j)rp}rq(h2X **volume**h8}rr(h:]h;]h<]h=]h?]uh3jlh-]rshKXvolumert…ru}rv(h2Uh3jpubah6j¥ubhKX - a rw…rx}ry(h2X - a h3jlubj)rz}r{(h2X$``OpenCloud\Volume\Resource\Volume``h8}r|(h:]h;]h<]h=]h?]uh3jlh-]r}hKX OpenCloud\Volume\Resource\Volumer~…r}r€(h2Uh3jzubah6jubhKX@ object, that is populated with the values of a real API volume;r…r‚}rƒ(h2X@ object, that is populated with the values of a real API volume;h3jlubeubaubeubh])r„}r…(h2X>Firstly we need to find our flavor and volume using their IDs.r†h3jh4h5h6hah8}r‡(h:]h;]h<]h=]h?]uhAKhBhh-]rˆhKX>Firstly we need to find our flavor and volume using their IDs.r‰…rŠ}r‹(h2j†h3j„ubaubhŸ)rŒ}r(h2X¡$volumeService = $client->volumeService(); $bootableVolume = $volumeService->volume(''); $flavor = $compute->flavor('');h3jh4h5h6h¢h8}rŽ(h¤h¥h=]h<]h:]h;]r(h§Xphpreh?]uhAKˆhBhh-]r‘hª)r’}r“(h2X¡$volumeService = $client->volumeService(); $bootableVolume = $volumeService->volume(''); $flavor = $compute->flavor('');h8}r”(h:]h;]r•Uotherr–ah<]h=]h?]uh3jŒh-]r—hKX¡$volumeService = $client->volumeService(); $bootableVolume = $volumeService->volume(''); $flavor = $compute->flavor('');r˜…r™}rš(h2Uh3j’ubah6h´ubaubh])r›}rœ(h2X'Now we're ready to create our instance:rh3jh4h5h6hah8}rž(h:]h;]h<]h=]h?]uhAK‰hBhh-]rŸhKX'Now we're ready to create our instance:r …r¡}r¢(h2jh3j›ubaubhŸ)r£}r¤(h2X¡use OpenCloud\Compute\Constants\Network; $server = $compute->server(); try { $response = $server->create(array( 'name' => 'My lovely server', 'volume' => $bootableVolume, 'flavor' => $flavor )); } catch (\Guzzle\Http\Exception\BadResponseException $e) { // No! Something failed. Let's find out: echo $e->getRequest() . PHP_EOL . PHP_EOL; echo $e->getResponse(); }h3jh4h5h6h¢h8}r¥(h¤h¥h=]h<]h:]h;]r¦(h§Xphpr§eh?]uhAKœhBhh-]r¨hª)r©}rª(h2X¡use OpenCloud\Compute\Constants\Network; $server = $compute->server(); try { $response = $server->create(array( 'name' => 'My lovely server', 'volume' => $bootableVolume, 'flavor' => $flavor )); } catch (\Guzzle\Http\Exception\BadResponseException $e) { // No! Something failed. Let's find out: echo $e->getRequest() . PHP_EOL . PHP_EOL; echo $e->getResponse(); }h8}r«(h:]h;]r¬Uotherr­ah<]h=]h?]uh3j£h-]r®hKX¡use OpenCloud\Compute\Constants\Network; $server = $compute->server(); try { $response = $server->create(array( 'name' => 'My lovely server', 'volume' => $bootableVolume, 'flavor' => $flavor )); } catch (\Guzzle\Http\Exception\BadResponseException $e) { // No! Something failed. Let's find out: echo $e->getRequest() . PHP_EOL . PHP_EOL; echo $e->getResponse(); }r¯…r°}r±(h2Uh3j©ubah6h´ubaubh])r²}r³(h2XÜIt's always best to be defensive when executing functionality over HTTP; you can achieve this best by wrapping calls in a try/catch block. It allows you to debug your failed operations in a graceful and efficient manner.r´h3jh4h5h6hah8}rµ(h:]h;]h<]h=]h?]uhAKhBhh-]r¶hKXÜIt's always best to be defensive when executing functionality over HTTP; you can achieve this best by wrapping calls in a try/catch block. It allows you to debug your failed operations in a graceful and efficient manner.r·…r¸}r¹(h2j´h3j²ubaubeubh/)rº}r»(h2Uh3jlh4h5h6h7h8}r¼(h:]h;]h<]h=]r½hah?]r¾hauhAK£hBhh-]r¿(hD)rÀ}rÁ(h2XCreate parametersrÂh3jºh4h5h6hHh8}rÃ(h:]h;]h<]h=]h?]uhAK£hBhh-]rÄhKXCreate parametersrÅ…rÆ}rÇ(h2jÂh3jÀubaubj&)rÈ}rÉ(h2Uh3jºh4h5h6j)h8}rÊ(h:]h;]h<]h=]h?]uhANhBhh-]rËj,)rÌ}rÍ(h2Uh8}rÎ(h=]h<]h:]h;]h?]UcolsKuh3jÈh-]rÏ(j1)rÐ}rÑ(h2Uh8}rÒ(h=]h<]h:]h;]h?]UcolwidthKuh3jÌh-]h6j5ubj1)rÓ}rÔ(h2Uh8}rÕ(h=]h<]h:]h;]h?]UcolwidthMuh3jÌh-]h6j5ubj1)rÖ}r×(h2Uh8}rØ(h=]h<]h:]h;]h?]UcolwidthK uh3jÌh-]h6j5ubj1)rÙ}rÚ(h2Uh8}rÛ(h=]h<]h:]h;]h?]UcolwidthKuh3jÌh-]h6j5ubj<)rÜ}rÝ(h2Uh8}rÞ(h:]h;]h<]h=]h?]uh3jÌh-]rßjA)rà}rá(h2Uh8}râ(h:]h;]h<]h=]h?]uh3jÜh-]rã(jF)rä}rå(h2Uh8}ræ(h:]h;]h<]h=]h?]uh3jàh-]rçh])rè}ré(h2XNamerêh3jäh4h5h6hah8}rë(h:]h;]h<]h=]h?]uhAK¦h-]rìhKXNamerí…rî}rï(h2jêh3jèubaubah6jSubjF)rð}rñ(h2Uh8}rò(h:]h;]h<]h=]h?]uh3jàh-]róh])rô}rõ(h2X Descriptionröh3jðh4h5h6hah8}r÷(h:]h;]h<]h=]h?]uhAK¦h-]røhKX Descriptionrù…rú}rû(h2jöh3jôubaubah6jSubjF)rü}rý(h2Uh8}rþ(h:]h;]h<]h=]h?]uh3jàh-]rÿh])r}r(h2XTyperh3jüh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK¦h-]rhKXTyper…r}r(h2jh3jubaubah6jSubjF)r}r (h2Uh8}r (h:]h;]h<]h=]h?]uh3jàh-]r h])r }r (h2XRequiredrh3jh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK¦h-]rhKXRequiredr…r}r(h2jh3j ubaubah6jSubeh6jlubah6jmubjn)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jÌh-]r(jA)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jh-]r(jF)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jh-]rh])r }r!(h2Xnamer"h3jh4h5h6hah8}r#(h:]h;]h<]h=]h?]uhAK¨h-]r$hKXnamer%…r&}r'(h2j"h3j ubaubah6jSubjF)r(}r)(h2Uh8}r*(h:]h;]h<]h=]h?]uh3jh-]r+h])r,}r-(h2XñThe server name. The name that you specify in a create request becomes the initial host name of the server. After the server is built, if you change the server name in the API or change the host name directly, the names are not kept in sync.r.h3j(h4h5h6hah8}r/(h:]h;]h<]h=]h?]uhAK¨h-]r0hKXñThe server name. The name that you specify in a create request becomes the initial host name of the server. After the server is built, if you change the server name in the API or change the host name directly, the names are not kept in sync.r1…r2}r3(h2j.h3j,ubaubah6jSubjF)r4}r5(h2Uh8}r6(h:]h;]h<]h=]h?]uh3jh-]r7h])r8}r9(h2Xstringr:h3j4h4h5h6hah8}r;(h:]h;]h<]h=]h?]uhAK¨h-]r<hKXstringr=…r>}r?(h2j:h3j8ubaubah6jSubjF)r@}rA(h2Uh8}rB(h:]h;]h<]h=]h?]uh3jh-]rCh])rD}rE(h2XYesrFh3j@h4h5h6hah8}rG(h:]h;]h<]h=]h?]uhAK¨h-]rHhKXYesrI…rJ}rK(h2jFh3jDubaubah6jSubeh6jlubjA)rL}rM(h2Uh8}rN(h:]h;]h<]h=]h?]uh3jh-]rO(jF)rP}rQ(h2Uh8}rR(h:]h;]h<]h=]h?]uh3jLh-]rSh])rT}rU(h2XflavorrVh3jPh4h5h6hah8}rW(h:]h;]h<]h=]h?]uhAKªh-]rXhKXflavorrY…rZ}r[(h2jVh3jTubaubah6jSubjF)r\}r](h2Uh8}r^(h:]h;]h<]h=]h?]uh3jLh-]r_h])r`}ra(h2XXA populated ``OpenCloud\Compute\Resource\Flavor`` object representing your chosen flavorh3j\h4h5h6hah8}rb(h:]h;]h<]h=]h?]uhAKªh-]rc(hKX A populated rd…re}rf(h2X A populated h3j`ubj)rg}rh(h2X%``OpenCloud\Compute\Resource\Flavor``h8}ri(h:]h;]h<]h=]h?]uh3j`h-]rjhKX!OpenCloud\Compute\Resource\Flavorrk…rl}rm(h2Uh3jgubah6jubhKX' object representing your chosen flavorrn…ro}rp(h2X' object representing your chosen flavorh3j`ubeubah6jSubjF)rq}rr(h2Uh8}rs(h:]h;]h<]h=]h?]uh3jLh-]rth])ru}rv(h2Xobjectrwh3jqh4h5h6hah8}rx(h:]h;]h<]h=]h?]uhAKªh-]ryhKXobjectrz…r{}r|(h2jwh3juubaubah6jSubjF)r}}r~(h2Uh8}r(h:]h;]h<]h=]h?]uh3jLh-]r€h])r}r‚(h2XYesrƒh3j}h4h5h6hah8}r„(h:]h;]h<]h=]h?]uhAKªh-]r…hKXYesr†…r‡}rˆ(h2jƒh3jubaubah6jSubeh6jlubjA)r‰}rŠ(h2Uh8}r‹(h:]h;]h<]h=]h?]uh3jh-]rŒ(jF)r}rŽ(h2Uh8}r(h:]h;]h<]h=]h?]uh3j‰h-]rh])r‘}r’(h2Ximager“h3jh4h5h6hah8}r”(h:]h;]h<]h=]h?]uhAK¬h-]r•hKXimager–…r—}r˜(h2j“h3j‘ubaubah6jSubjF)r™}rš(h2Uh8}r›(h:]h;]h<]h=]h?]uh3j‰h-]rœh])r}rž(h2XVA populated ``OpenCloud\Compute\Resource\Image`` object representing your chosen imageh3j™h4h5h6hah8}rŸ(h:]h;]h<]h=]h?]uhAK¬h-]r (hKX A populated r¡…r¢}r£(h2X A populated h3jubj)r¤}r¥(h2X$``OpenCloud\Compute\Resource\Image``h8}r¦(h:]h;]h<]h=]h?]uh3jh-]r§hKX OpenCloud\Compute\Resource\Imager¨…r©}rª(h2Uh3j¤ubah6jubhKX& object representing your chosen imager«…r¬}r­(h2X& object representing your chosen imageh3jubeubah6jSubjF)r®}r¯(h2Uh8}r°(h:]h;]h<]h=]h?]uh3j‰h-]r±h])r²}r³(h2Xobjectr´h3j®h4h5h6hah8}rµ(h:]h;]h<]h=]h?]uhAK¬h-]r¶hKXobjectr·…r¸}r¹(h2j´h3j²ubaubah6jSubjF)rº}r»(h2Uh8}r¼(h:]h;]h<]h=]h?]uh3j‰h-]r½h])r¾}r¿(h2XNo, if volume is specifiedrÀh3jºh4h5h6hah8}rÁ(h:]h;]h<]h=]h?]uhAK¬h-]rÂhKXNo, if volume is specifiedrÃ…rÄ}rÅ(h2jÀh3j¾ubaubah6jSubeh6jlubjA)rÆ}rÇ(h2Uh8}rÈ(h:]h;]h<]h=]h?]uh3jh-]rÉ(jF)rÊ}rË(h2Uh8}rÌ(h:]h;]h<]h=]h?]uh3jÆh-]rÍh])rÎ}rÏ(h2XvolumerÐh3jÊh4h5h6hah8}rÑ(h:]h;]h<]h=]h?]uhAK®h-]rÒhKXvolumerÓ…rÔ}rÕ(h2jÐh3jÎubaubah6jSubjF)rÖ}r×(h2Uh8}rØ(h:]h;]h<]h=]h?]uh3jÆh-]rÙh])rÚ}rÛ(h2X`A populated ``OpenCloud\Volume\Resource\Volume`` object representing your chosen bootable volumeh3jÖh4h5h6hah8}rÜ(h:]h;]h<]h=]h?]uhAK®h-]rÝ(hKX A populated rÞ…rß}rà(h2X A populated h3jÚubj)rá}râ(h2X$``OpenCloud\Volume\Resource\Volume``h8}rã(h:]h;]h<]h=]h?]uh3jÚh-]rähKX OpenCloud\Volume\Resource\Volumerå…ræ}rç(h2Uh3jáubah6jubhKX0 object representing your chosen bootable volumerè…ré}rê(h2X0 object representing your chosen bootable volumeh3jÚubeubah6jSubjF)rë}rì(h2Uh8}rí(h:]h;]h<]h=]h?]uh3jÆh-]rîh])rï}rð(h2Xobjectrñh3jëh4h5h6hah8}rò(h:]h;]h<]h=]h?]uhAK®h-]róhKXobjectrô…rõ}rö(h2jñh3jïubaubah6jSubjF)r÷}rø(h2Uh8}rù(h:]h;]h<]h=]h?]uh3jÆh-]rúh])rû}rü(h2XNo, if image is specifiedrýh3j÷h4h5h6hah8}rþ(h:]h;]h<]h=]h?]uhAK®h-]rÿhKXNo, if image is specifiedr…r}r(h2jýh3jûubaubah6jSubeh6jlubjA)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jh-]r(jF)r}r(h2Uh8}r (h:]h;]h<]h=]h?]uh3jh-]r h])r }r (h2XvolumeDeleteOnTerminationr h3jh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK°h-]rhKXvolumeDeleteOnTerminationr…r}r(h2j h3j ubaubah6jSubjF)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jh-]rh])r}r(h2Xe``true`` if the bootable volume should be deleted when the server is terminated; ``false``, otherwiseh3jh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK°h-]r(j)r}r(h2X``true``h8}r(h:]h;]h<]h=]h?]uh3jh-]rhKXtruer…r }r!(h2Uh3jubah6jubhKXI if the bootable volume should be deleted when the server is terminated; r"…r#}r$(h2XI if the bootable volume should be deleted when the server is terminated; h3jubj)r%}r&(h2X ``false``h8}r'(h:]h;]h<]h=]h?]uh3jh-]r(hKXfalser)…r*}r+(h2Uh3j%ubah6jubhKX , otherwiser,…r-}r.(h2X , otherwiseh3jubeubah6jSubjF)r/}r0(h2Uh8}r1(h:]h;]h<]h=]h?]uh3jh-]r2h])r3}r4(h2Xbooleanr5h3j/h4h5h6hah8}r6(h:]h;]h<]h=]h?]uhAK°h-]r7hKXbooleanr8…r9}r:(h2j5h3j3ubaubah6jSubjF)r;}r<(h2Uh8}r=(h:]h;]h<]h=]h?]uh3jh-]r>h])r?}r@(h2XNo; default = ``false``h3j;h4h5h6hah8}rA(h:]h;]h<]h=]h?]uhAK°h-]rB(hKXNo; default = rC…rD}rE(h2XNo; default = h3j?ubj)rF}rG(h2X ``false``h8}rH(h:]h;]h<]h=]h?]uh3j?h-]rIhKXfalserJ…rK}rL(h2Uh3jFubah6jubeubah6jSubeh6jlubjA)rM}rN(h2Uh8}rO(h:]h;]h<]h=]h?]uh3jh-]rP(jF)rQ}rR(h2Uh8}rS(h:]h;]h<]h=]h?]uh3jMh-]rTh])rU}rV(h2XOS-DCF:diskConfigrWh3jQh4h5h6hah8}rX(h:]h;]h<]h=]h?]uhAK²h-]rYhKXOS-DCF:diskConfigrZ…r[}r\(h2jWh3jUubaubah6jSubjF)r]}r^(h2Uh8}r_(h:]h;]h<]h=]h?]uh3jMh-]r`h])ra}rb(h2X The disk configuration value. You can use two options: ``AUTO`` or ``MANUAL``. \ ``AUTO`` means the server is built with a single partition the size of the target flavor disk. The file system is automatically adjusted to fit the entire partition. This keeps things simple and automated. ``AUTO`` is valid only for images and servers with a single partition that use the EXT3 file system. This is the default setting for applicable Rackspace base images.\ ``MANUAL`` means the server is built using whatever partition scheme and file system is in the source image. If the target flavor disk is larger, the remaining disk space is left unpartitioned. This enables images to have non-EXT3 file systems, multiple partitions, and so on, and enables you to manage the disk configuration.h3j]h4h5h6hah8}rc(h:]h;]h<]h=]h?]uhAK²h-]rd(hKX7The disk configuration value. You can use two options: re…rf}rg(h2X7The disk configuration value. You can use two options: h3jaubj)rh}ri(h2X``AUTO``h8}rj(h:]h;]h<]h=]h?]uh3jah-]rkhKXAUTOrl…rm}rn(h2Uh3jhubah6jubhKX or ro…rp}rq(h2X or h3jaubj)rr}rs(h2X ``MANUAL``h8}rt(h:]h;]h<]h=]h?]uh3jah-]ruhKXMANUALrv…rw}rx(h2Uh3jrubah6jubhKX. ry…rz}r{(h2X. \ h3jaubj)r|}r}(h2X``AUTO``h8}r~(h:]h;]h<]h=]h?]uh3jah-]rhKXAUTOr€…r}r‚(h2Uh3j|ubah6jubhKXÆ means the server is built with a single partition the size of the target flavor disk. The file system is automatically adjusted to fit the entire partition. This keeps things simple and automated. rƒ…r„}r…(h2XÆ means the server is built with a single partition the size of the target flavor disk. The file system is automatically adjusted to fit the entire partition. This keeps things simple and automated. h3jaubj)r†}r‡(h2X``AUTO``h8}rˆ(h:]h;]h<]h=]h?]uh3jah-]r‰hKXAUTOrŠ…r‹}rŒ(h2Uh3j†ubah6jubhKXž is valid only for images and servers with a single partition that use the EXT3 file system. This is the default setting for applicable Rackspace base images.r…rŽ}r(h2X  is valid only for images and servers with a single partition that use the EXT3 file system. This is the default setting for applicable Rackspace base images.\ h3jaubj)r}r‘(h2X ``MANUAL``h8}r’(h:]h;]h<]h=]h?]uh3jah-]r“hKXMANUALr”…r•}r–(h2Uh3jubah6jubhKX< means the server is built using whatever partition scheme and file system is in the source image. If the target flavor disk is larger, the remaining disk space is left unpartitioned. This enables images to have non-EXT3 file systems, multiple partitions, and so on, and enables you to manage the disk configuration.r—…r˜}r™(h2X< means the server is built using whatever partition scheme and file system is in the source image. If the target flavor disk is larger, the remaining disk space is left unpartitioned. This enables images to have non-EXT3 file systems, multiple partitions, and so on, and enables you to manage the disk configuration.h3jaubeubah6jSubjF)rš}r›(h2Uh8}rœ(h:]h;]h<]h=]h?]uh3jMh-]rh])rž}rŸ(h2Xstringr h3jšh4h5h6hah8}r¡(h:]h;]h<]h=]h?]uhAK²h-]r¢hKXstringr£…r¤}r¥(h2j h3jžubaubah6jSubjF)r¦}r§(h2Uh8}r¨(h:]h;]h<]h=]h?]uh3jMh-]r©h])rª}r«(h2XNor¬h3j¦h4h5h6hah8}r­(h:]h;]h<]h=]h?]uhAK²h-]r®hKXNor¯…r°}r±(h2j¬h3jªubaubah6jSubeh6jlubjA)r²}r³(h2Uh8}r´(h:]h;]h<]h=]h?]uh3jh-]rµ(jF)r¶}r·(h2Uh8}r¸(h:]h;]h<]h=]h?]uh3j²h-]r¹h])rº}r»(h2Xnetworksr¼h3j¶h4h5h6hah8}r½(h:]h;]h<]h=]h?]uhAK´h-]r¾hKXnetworksr¿…rÀ}rÁ(h2j¼h3jºubaubah6jSubjF)rÂ}rÃ(h2Uh8}rÄ(h:]h;]h<]h=]h?]uh3j²h-]rÅh])rÆ}rÇ(h2X{An array of populated ``OpenCloud\Compute\Resource\Network`` objects that indicate which networks your instance resides in.h3jÂh4h5h6hah8}rÈ(h:]h;]h<]h=]h?]uhAK´h-]rÉ(hKXAn array of populated rÊ…rË}rÌ(h2XAn array of populated h3jÆubj)rÍ}rÎ(h2X&``OpenCloud\Compute\Resource\Network``h8}rÏ(h:]h;]h<]h=]h?]uh3jÆh-]rÐhKX"OpenCloud\Compute\Resource\NetworkrÑ…rÒ}rÓ(h2Uh3jÍubah6jubhKX? objects that indicate which networks your instance resides in.rÔ…rÕ}rÖ(h2X? objects that indicate which networks your instance resides in.h3jÆubeubah6jSubjF)r×}rØ(h2Uh8}rÙ(h:]h;]h<]h=]h?]uh3j²h-]rÚh])rÛ}rÜ(h2XarrayrÝh3j×h4h5h6hah8}rÞ(h:]h;]h<]h=]h?]uhAK´h-]rßhKXarrayrà…rá}râ(h2jÝh3jÛubaubah6jSubjF)rã}rä(h2Uh8}rå(h:]h;]h<]h=]h?]uh3j²h-]ræh])rç}rè(h2XNoréh3jãh4h5h6hah8}rê(h:]h;]h<]h=]h?]uhAK´h-]rëhKXNorì…rí}rî(h2jéh3jçubaubah6jSubeh6jlubjA)rï}rð(h2Uh8}rñ(h:]h;]h<]h=]h?]uh3jh-]rò(jF)ró}rô(h2Uh8}rõ(h:]h;]h<]h=]h?]uh3jïh-]röh])r÷}rø(h2Xmetadatarùh3jóh4h5h6hah8}rú(h:]h;]h<]h=]h?]uhAK¶h-]rûhKXmetadatarü…rý}rþ(h2jùh3j÷ubaubah6jSubjF)rÿ}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jïh-]rh])r}r(h2XYAn array of arbitrary data (key-value pairs) that adds additional meaning to your server.rh3jÿh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK¶h-]rhKXYAn array of arbitrary data (key-value pairs) that adds additional meaning to your server.r…r }r (h2jh3jubaubah6jSubjF)r }r (h2Uh8}r (h:]h;]h<]h=]h?]uh3jïh-]rh])r}r(h2Xarrayrh3j h4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK¶h-]rhKXarrayr…r}r(h2jh3jubaubah6jSubjF)r}r(h2Uh8}r(h:]h;]h<]h=]h?]uh3jïh-]rh])r}r(h2XNorh3jh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAK¶h-]rhKXNor …r!}r"(h2jh3jubaubah6jSubeh6jlubjA)r#}r$(h2Uh8}r%(h:]h;]h<]h=]h?]uh3jh-]r&(jF)r'}r((h2Uh8}r)(h:]h;]h<]h=]h?]uh3j#h-]r*h])r+}r,(h2Xkeypairr-h3j'h4h5h6hah8}r.(h:]h;]h<]h=]h?]uhAK¸h-]r/hKXkeypairr0…r1}r2(h2j-h3j+ubaubah6jSubjF)r3}r4(h2Uh8}r5(h:]h;]h<]h=]h?]uh3j#h-]r6h])r7}r8(h2X€You can install a registered keypair onto your newly created instance, thereby providing scope for keypair-based authentication.r9h3j3h4h5h6hah8}r:(h:]h;]h<]h=]h?]uhAK¸h-]r;hKX€You can install a registered keypair onto your newly created instance, thereby providing scope for keypair-based authentication.r<…r=}r>(h2j9h3j7ubaubah6jSubjF)r?}r@(h2Uh8}rA(h:]h;]h<]h=]h?]uh3j#h-]rBh])rC}rD(h2XarrayrEh3j?h4h5h6hah8}rF(h:]h;]h<]h=]h?]uhAK¸h-]rGhKXarrayrH…rI}rJ(h2jEh3jCubaubah6jSubjF)rK}rL(h2Uh8}rM(h:]h;]h<]h=]h?]uh3j#h-]rNh])rO}rP(h2XNorQh3jKh4h5h6hah8}rR(h:]h;]h<]h=]h?]uhAK¸h-]rShKXNorT…rU}rV(h2jQh3jOubaubah6jSubeh6jlubjA)rW}rX(h2Uh8}rY(h:]h;]h<]h=]h?]uh3jh-]rZ(jF)r[}r\(h2Uh8}r](h:]h;]h<]h=]h?]uh3jWh-]r^h])r_}r`(h2X personalityrah3j[h4h5h6hah8}rb(h:]h;]h<]h=]h?]uhAKºh-]rchKX personalityrd…re}rf(h2jah3j_ubaubah6jSubjF)rg}rh(h2Uh8}ri(h:]h;]h<]h=]h?]uh3jWh-]rjh])rk}rl(h2XFFiles that you can upload to your newly created instance's filesystem.rmh3jgh4h5h6hah8}rn(h:]h;]h<]h=]h?]uhAKºh-]rohKXFFiles that you can upload to your newly created instance's filesystem.rp…rq}rr(h2jmh3jkubaubah6jSubjF)rs}rt(h2Uh8}ru(h:]h;]h<]h=]h?]uh3jWh-]rvh])rw}rx(h2Xarrayryh3jsh4h5h6hah8}rz(h:]h;]h<]h=]h?]uhAKºh-]r{hKXarrayr|…r}}r~(h2jyh3jwubaubah6jSubjF)r}r€(h2Uh8}r(h:]h;]h<]h=]h?]uh3jWh-]r‚h])rƒ}r„(h2XNor…h3jh4h5h6hah8}r†(h:]h;]h<]h=]h?]uhAKºh-]r‡hKXNorˆ…r‰}rŠ(h2j…h3jƒubaubah6jSubeh6jlubeh6jjubeh6jkubaubeubh/)r‹}rŒ(h2Uh3jlh4h5h6h7h8}r(h:]h;]h<]h=]rŽh+ah?]rhauhAK¾hBhh-]r(hD)r‘}r’(h2XCreating a server with keypairsr“h3j‹h4h5h6hHh8}r”(h:]h;]h<]h=]h?]uhAK¾hBhh-]r•hKXCreating a server with keypairsr–…r—}r˜(h2j“h3j‘ubaubh])r™}rš(h2XBPlease see the `Keypair `__ docs for more information.r›h3j‹h4h5h6hah8}rœ(h:]h;]h<]h=]h?]uhAKÀhBhh-]r(hKXPlease see the rž…rŸ}r (h2XPlease see the h3j™ubh|)r¡}r¢(h2X`Keypair `__h8}r£(UnameXKeypairh€X Keypair.mdh=]h<]h:]h;]h?]uh3j™h-]r¤hKXKeypairr¥…r¦}r§(h2Uh3j¡ubah6h…ubhKX docs for more information.r¨…r©}rª(h2X docs for more information.h3j™ubeubeubh/)r«}r¬(h2Uh3jlh4h5h6h7h8}r­(h:]h;]h<]h=]r®h%ah?]r¯h auhAKÃhBhh-]r°(hD)r±}r²(h2X(Creating a server with personality filesr³h3j«h4h5h6hHh8}r´(h:]h;]h<]h=]h?]uhAKÃhBhh-]rµhKX(Creating a server with personality filesr¶…r·}r¸(h2j³h3j±ubaubh])r¹}rº(h2XªBefore you execute the create operation, you can add "personality" files to your ``OpenCloud\Compute\Resource\Server`` object. These files are structured as a flat array.h3j«h4h5h6hah8}r»(h:]h;]h<]h=]h?]uhAKÅhBhh-]r¼(hKXQBefore you execute the create operation, you can add "personality" files to your r½…r¾}r¿(h2XQBefore you execute the create operation, you can add "personality" files to your h3j¹ubj)rÀ}rÁ(h2X%``OpenCloud\Compute\Resource\Server``h8}rÂ(h:]h;]h<]h=]h?]uh3j¹h-]rÃhKX!OpenCloud\Compute\Resource\ServerrÄ…rÅ}rÆ(h2Uh3jÀubah6jubhKX4 object. These files are structured as a flat array.rÇ…rÈ}rÉ(h2X4 object. These files are structured as a flat array.h3j¹ubeubhŸ)rÊ}rË(h2X3$server->addFile('/var/test_file', 'FILE CONTENT');h3j«h4h5h6h¢h8}rÌ(h¤h¥h=]h<]h:]h;]rÍ(h§XphprÎeh?]uhAKÌhBhh-]rÏhª)rÐ}rÑ(h2X3$server->addFile('/var/test_file', 'FILE CONTENT');h8}rÒ(h:]h;]rÓUotherrÔah<]h=]h?]uh3jÊh-]rÕhKX3$server->addFile('/var/test_file', 'FILE CONTENT');rÖ…r×}rØ(h2Uh3jÐubah6h´ubaubh])rÙ}rÚ(h2X‰As you can see, the first parameter represents the filename, and the second is a string representation of its content. When the server is created these files will be created on its local filesystem. For more information about server personality files, please consult the `official documentation `__.h3j«h4h5h6hah8}rÛ(h:]h;]h<]h=]h?]uhAKÍhBhh-]rÜ(hKXAs you can see, the first parameter represents the filename, and the second is a string representation of its content. When the server is created these files will be created on its local filesystem. For more information about server personality files, please consult the rÝ…rÞ}rß(h2XAs you can see, the first parameter represents the filename, and the second is a string representation of its content. When the server is created these files will be created on its local filesystem. For more information about server personality files, please consult the h3jÙubh|)rà}rá(h2Xy`official documentation `__h8}râ(UnameXofficial documentationh€X\http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Personality-d1e2543.htmlh=]h<]h:]h;]h?]uh3jÙh-]rãhKXofficial documentationrä…rå}ræ(h2Uh3jàubah6h…ubhKX.…rç}rè(h2X.h3jÙubeubeubeubh/)ré}rê(h2Uh3h0h4h5h6h7h8}rë(h:]h;]h<]h=]rìh*ah?]ríhauhAKÔhBhh-]rî(hD)rï}rð(h2X Update serverrñh3jéh4h5h6hHh8}rò(h:]h;]h<]h=]h?]uhAKÔhBhh-]róhKX Update serverrô…rõ}rö(h2jñh3jïubaubh])r÷}rø(h2XtYou can update certain attributes of an existing server instance. These attributes are detailed in the next section.rùh3jéh4h5h6hah8}rú(h:]h;]h<]h=]h?]uhAKÖhBhh-]rûhKXtYou can update certain attributes of an existing server instance. These attributes are detailed in the next section.rü…rý}rþ(h2jùh3j÷ubaubhŸ)rÿ}r(h2X9$server->update(array( 'name' => 'NEW SERVER NAME' ));h3jéh4h5h6h¢h8}r(h¤h¥h=]h<]h:]h;]r(h§Xphpreh?]uhAKÞhBhh-]rhª)r}r(h2X9$server->update(array( 'name' => 'NEW SERVER NAME' ));h8}r(h:]h;]rUotherr ah<]h=]h?]uh3jÿh-]r hKX9$server->update(array( 'name' => 'NEW SERVER NAME' ));r …r }r (h2Uh3jubah6h´ubaubh/)r}r(h2Uh3jéh4h5h6h7h8}r(h:]h;]h<]h=]rh ah?]rhauhAKàhBhh-]r(hD)r}r(h2XUpdatable attributesrh3jh4h5h6hHh8}r(h:]h;]h<]h=]h?]uhAKàhBhh-]rhKXUpdatable attributesr…r}r(h2jh3jubaubj&)r}r(h2Uh3jh4h5h6j)h8}r(h:]h;]h<]h=]h?]uhANhBhh-]rj,)r }r!(h2Uh8}r"(h=]h<]h:]h;]h?]UcolsKuh3jh-]r#(j1)r$}r%(h2Uh8}r&(h=]h<]h:]h;]h?]UcolwidthKuh3j h-]h6j5ubj1)r'}r((h2Uh8}r)(h=]h<]h:]h;]h?]UcolwidthK’uh3j h-]h6j5ubj<)r*}r+(h2Uh8}r,(h:]h;]h<]h=]h?]uh3j h-]r-jA)r.}r/(h2Uh8}r0(h:]h;]h<]h=]h?]uh3j*h-]r1(jF)r2}r3(h2Uh8}r4(h:]h;]h<]h=]h?]uh3j.h-]r5h])r6}r7(h2Xnamer8h3j2h4h5h6hah8}r9(h:]h;]h<]h=]h?]uhAKãh-]r:hKXnamer;…r<}r=(h2j8h3j6ubaubah6jSubjF)r>}r?(h2Uh8}r@(h:]h;]h<]h=]h?]uh3j.h-]rAh])rB}rC(h2X descriptionrDh3j>h4h5h6hah8}rE(h:]h;]h<]h=]h?]uhAKãh-]rFhKX descriptionrG…rH}rI(h2jDh3jBubaubah6jSubeh6jlubah6jmubjn)rJ}rK(h2Uh8}rL(h:]h;]h<]h=]h?]uh3j h-]rM(jA)rN}rO(h2Uh8}rP(h:]h;]h<]h=]h?]uh3jJh-]rQ(jF)rR}rS(h2Uh8}rT(h:]h;]h<]h=]h?]uh3jNh-]rUh])rV}rW(h2XnamerXh3jRh4h5h6hah8}rY(h:]h;]h<]h=]h?]uhAKåh-]rZhKXnamer[…r\}r](h2jXh3jVubaubah6jSubjF)r^}r_(h2Uh8}r`(h:]h;]h<]h=]h?]uh3jNh-]rah])rb}rc(h2XŽThe name of the server. If you edit the server name, the server host name does not change. Also, server names are not guaranteed to be unique.rdh3j^h4h5h6hah8}re(h:]h;]h<]h=]h?]uhAKåh-]rfhKXŽThe name of the server. If you edit the server name, the server host name does not change. Also, server names are not guaranteed to be unique.rg…rh}ri(h2jdh3jbubaubah6jSubeh6jlubjA)rj}rk(h2Uh8}rl(h:]h;]h<]h=]h?]uh3jJh-]rm(jF)rn}ro(h2Uh8}rp(h:]h;]h<]h=]h?]uh3jjh-]rqh])rr}rs(h2X accessIPv4rth3jnh4h5h6hah8}ru(h:]h;]h<]h=]h?]uhAKçh-]rvhKX accessIPv4rw…rx}ry(h2jth3jrubaubah6jSubjF)rz}r{(h2Uh8}r|(h:]h;]h<]h=]h?]uh3jjh-]r}h])r~}r(h2XThe IP version 4 address.r€h3jzh4h5h6hah8}r(h:]h;]h<]h=]h?]uhAKçh-]r‚hKXThe IP version 4 address.rƒ…r„}r…(h2j€h3j~ubaubah6jSubeh6jlubjA)r†}r‡(h2Uh8}rˆ(h:]h;]h<]h=]h?]uh3jJh-]r‰(jF)rŠ}r‹(h2Uh8}rŒ(h:]h;]h<]h=]h?]uh3j†h-]rh])rŽ}r(h2X accessIPv6rh3jŠh4h5h6hah8}r‘(h:]h;]h<]h=]h?]uhAKéh-]r’hKX accessIPv6r“…r”}r•(h2jh3jŽubaubah6jSubjF)r–}r—(h2Uh8}r˜(h:]h;]h<]h=]h?]uh3j†h-]r™h])rš}r›(h2XThe IP version 6 address.rœh3j–h4h5h6hah8}r(h:]h;]h<]h=]h?]uhAKéh-]ržhKXThe IP version 6 address.rŸ…r }r¡(h2jœh3jšubaubah6jSubeh6jlubeh6jjubeh6jkubaubeubeubh/)r¢}r£(h2Uh3h0h4h5h6h7h8}r¤(h:]h;]h<]h=]r¥h,ah?]r¦hauhAKíhBhh-]r§(hD)r¨}r©(h2X Delete serverrªh3j¢h4h5h6hHh8}r«(h:]h;]h<]h=]h?]uhAKíhBhh-]r¬hKX Delete serverr­…r®}r¯(h2jªh3j¨ubaubhŸ)r°}r±(h2X$server->delete();h3j¢h4h5h6h¢h8}r²(h¤h¥h=]h<]h:]h;]r³(h§Xphpr´eh?]uhAKòhBhh-]rµhª)r¶}r·(h2X$server->delete();h8}r¸(h:]h;]r¹Uotherrºah<]h=]h?]uh3j°h-]r»hKX$server->delete();r¼…r½}r¾(h2Uh3j¶ubah6h´ubaubeubeubah2UU transformerr¿NU footnote_refsrÀ}rÁUrefnamesrÂ}rÃUsymbol_footnotesrÄ]rÅUautofootnote_refsrÆ]rÇUsymbol_footnote_refsrÈ]rÉU citationsrÊ]rËhBhU current_linerÌNUtransform_messagesrÍ]rÎUreporterrÏNUid_startrÐKU autofootnotesrÑ]rÒU citation_refsrÓ}rÔUindirect_targetsrÕ]rÖUsettingsr×(cdocutils.frontend Values rØorÙ}rÚ(Ufootnote_backlinksrÛKUrecord_dependenciesrÜNU rfc_base_urlrÝUhttp://tools.ietf.org/html/rÞU tracebackr߈Upep_referencesràNUstrip_commentsráNU toc_backlinksrâjSU language_coderãUenräU datestampråNU report_levelræKU _destinationrçNU halt_levelrèKU strip_classesréNhHNUerror_encoding_error_handlerrêUbackslashreplacerëUdebugrìNUembed_stylesheetrí‰Uoutput_encoding_error_handlerrîUstrictrïU sectnum_xformrðKUdump_transformsrñNU docinfo_xformròKUwarning_streamróNUpep_file_url_templaterôUpep-%04drõUexit_status_levelröKUconfigr÷NUstrict_visitorrøNUcloak_email_addressesrùˆUtrim_footnote_reference_spacerú‰UenvrûNUdump_pseudo_xmlrüNUexpose_internalsrýNUsectsubtitle_xformrþ‰U source_linkrÿNUrfc_referencesrNUoutput_encodingrUutf-8rU source_urlrNUinput_encodingrU utf-8-sigrU_disable_configrNU id_prefixrUU tab_widthrKUerror_encodingr UUTF-8r U_sourcer h5Ugettext_compactr ˆU generatorr NUdump_internalsrNU smart_quotesr‰U pep_base_urlrUhttp://www.python.org/dev/peps/rUsyntax_highlightrUlongrUinput_encoding_error_handlerrjïUauto_id_prefixrUidrUdoctitle_xformr‰Ustrip_elements_with_classesrNU _config_filesr]Ufile_insertion_enabledrˆU raw_enabledrKU dump_settingsrNubUsymbol_footnote_startrKUidsr}r(h!jhjºh%j«hjh jh+j‹h#hgh,j¢h$h0h*jéh&hOh(jlh'h‰h)hµh"jzuUsubstitution_namesr }r!h6hBh8}r"(h:]h=]h<]Usourceh5h;]h?]uU footnotesr#]r$Urefidsr%}r&ub.