From 9e10396ca4a978c6438538fcc6ce576b574401ea Mon Sep 17 00:00:00 2001 From: Evan Light Date: Wed, 26 Feb 2014 15:16:57 -0500 Subject: [PATCH] Incorporated feedback from @mikhailov --- lib/fog/rackspace/docs/storage.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/lib/fog/rackspace/docs/storage.md b/lib/fog/rackspace/docs/storage.md index bb971ddf7..44059febb 100644 --- a/lib/fog/rackspace/docs/storage.md +++ b/lib/fog/rackspace/docs/storage.md @@ -269,6 +269,13 @@ To retrieve a specific directory: service.directories.get "blue" +**Note** As a general rule, only use `get` when you want to iterate over the contents of a `Directory` + +This call is similar to... + + service.directories.new :key => "blue" + +... except the `get` method makes an HTTP call that returns metadata for up to the first 10,000 files. **This can be slow!** This returns a `Fog::Storage::Rackspace::Directory` instance: @@ -279,8 +286,6 @@ This returns a `Fog::Storage::Rackspace::Directory` instance: cdn_cname=nil > -**Note**: This will retrieve the metadata for up to the first 10,000 files in the directory. This can be slow! - ## Create Directory To create a directory: