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