     1: <?php
     2: /**
     3:  * Copyright 2012-2014 Rackspace US, Inc.
     4:  *
     5:  * Licensed under the Apache License, Version 2.0 (the "License");
     6:  * you may not use this file except in compliance with the License.
     7:  * You may obtain a copy of the License at
     8:  *
     9:  * http://www.apache.org/licenses/LICENSE-2.0
    10:  *
    11:  * Unless required by applicable law or agreed to in writing, software
    12:  * distributed under the License is distributed on an "AS IS" BASIS,
    13:  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    14:  * See the License for the specific language governing permissions and
    15:  * limitations under the License.
    16:  */
    17:
    18: namespace OpenCloud\Common\Resource;
    19:
    20: abstract class NovaResource extends PersistentResource
    21: {
    22:     /**
    23:      * This method is used for many purposes, such as rebooting server, etc.
    24:      *
    25:      * @param $object
    26:      * @return \Guzzle\Http\Message\Response
    27:      * @throws \RuntimeException
    28:      * @throws \InvalidArgumentException
    29:      */
    30:     protected function action($object)
    31:     {
    32:         if (!$this->getProperty($this->primaryKeyField())) {
    33:             throw new \RuntimeException('A primary key is required');
    34:         }
    35:
    36:         if (!is_object($object)) {
    37:             throw new \InvalidArgumentException(sprintf('This method expects an object as its parameter'));
    38:         }
    39:
    40:         // convert the object to json
    41:         $json = json_encode($object);
    42:         $this->checkJsonError();
    43:
    44:         // get the URL for the POST message
    45:         $url = clone $this->getUrl();
    46:         $url->addPath('action');
    47:
    48:         // POST the message
    49:         return $this->getClient()->post($url, self::getJsonHeader(), $json)->send();
    50:     }
    51: }
    52: