doc: Note warning for get one collection block.
authorBrett Smith <brett@curoverse.com>
Tue, 11 Mar 2014 20:12:11 +0000 (16:12 -0400)
committerBrett Smith <brett@curoverse.com>
Tue, 11 Mar 2014 20:12:11 +0000 (16:12 -0400)
Added per discussion with Tom.  We're also interested in fixing the
warning, but in the meantime, this is worth documenting.

doc/user/topics/keep.html.textile.liquid

index b8d787d5403bcfea57a9245488bdf87a4d330bad..dae133abee56080005893a717cb680025a01ad98 100644 (file)
@@ -23,6 +23,16 @@ Let's use @arv keep get@ to download the first datablock:
 notextile. <pre><code>~$ <span class="userinput">cd /scratch/<b>you</b></span>
 /scratch/<b>you</b>$ <span class="userinput">arv keep get 204e43b8a1185621ca55a94839582e6f+67108864 &gt; block1</span></code></pre>
 
+{% include 'notebox_begin' %}
+
+When you run this command, you may get this API warning:
+
+notextile. <pre><code>WARNING:root:API lookup failed for collection 204e43b8a1185621ca55a94839582e6f+67108864 (&lt;class 'apiclient.errors.HttpError'&gt;: &lt;HttpError 404 when requesting https://qr1hi.arvadosapi.com/arvados/v1/collections/204e43b8a1185621ca55a94839582e6f%2B67108864?alt=json returned "Not Found"&gt;)</code></pre>
+
+This happens because @arv keep get@ tries to find a collection with this identifier.  When that fails, it emits this warning, then looks for a datablock instead, which succeeds.
+
+{% include 'notebox_end' %}
+
 Let's look at the size and compute the md5 hash of @block1@:
 
 <notextile>