Adding ability to update a CDN-enabled container's TTL.

docs/userguide/ObjectStore/USERGUIDE.md

@@ -550,6 +550,15 @@ $iosStreamingUrl = $object->getPublicUrl(UrlType::IOS_STREAMING);
 ```
 [ [Get the executable PHP script for this example](/samples/ObjectStore/get-cdn-object-ios-streaming-url.php) ]
 
+### Update CDN Container TTL
+You can update the TTL of a CDN-enabled container.
+
+```php
+$cdnContainer = $container->getCdn();
+$cdnContainer->setTtl(<NEW TTL, IN SECONDS>);
+```
+[ [Get the executable PHP script for this example](/samples/ObjectStore/set-cdn-container-ttl.php) ]
+
 ### Disable CDN Container
 
 If you no longer need CDN capabilities for a container, you can disable them.

lib/OpenCloud/ObjectStore/Resource/CDNContainer.php

@@ -106,4 +106,17 @@ public function isCdnEnabled()
     {
         return $this->metadata->getProperty(HeaderConst::ENABLED) == 'True';
     }
+
+    /**
+     * Set the TTL.
+     *
+     * @param $ttl The time-to-live in seconds.
+     * @return \Guzzle\Http\Message\Response
+     */
+    public function setTtl($ttl)
+    {
+        $headers = array('X-Ttl' => $ttl);
+
+        return $this->getClient()->post($this->getUrl(), $headers)->send();
+    }
 }

samples/ObjectStore/set-cdn-container-ttl.php

@@ -0,0 +1,47 @@
+<?php
+/**
+ * Copyright 2012-2014 Rackspace US, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+//
+// Pre-requisites:
+// * Prior to running this script, you must setup the following environment variables:
+//   * RAX_USERNAME: Your Rackspace Cloud Account Username, and
+//   * RAX_API_KEY:  Your Rackspace Cloud Account API Key
+// * There exists a container named 'logos' in your Object Store. Run
+//   create-container.php if you need to create one first.
+// * The 'logos' container is CDN-enabled. Run enable-container-cdn.php if
+//   you need to CDN-enable the 'logos' container first.
+//
+
+require __DIR__ . '/../../vendor/autoload.php';
+use OpenCloud\Rackspace;
+
+// 1. Instantiate a Rackspace client.
+$client = new Rackspace(Rackspace::US_IDENTITY_ENDPOINT, array(
+    'username' => getenv('RAX_USERNAME'),
+    'apiKey'   => getenv('RAX_API_KEY')
+));
+
+// 2. Obtain an Object Store service object from the client.
+$region = 'DFW';
+$objectStoreService = $client->objectStoreService(null, $region);
+
+// 3. Get CDN-enabled container.
+$container = $objectStoreService->getContainer('logos');
+$cdnContainer = $container->getCdn();
+
+// 4. Set container metadata.
+$cdnContainer->setTtl(4 * 24 * 60 * 60); // 4 days