10349: Add "Create a collection sharing link"

Arvados-DCO-1.1-Signed-off-by: Peter Amstutz <pamstutz@veritasgenetics.com>

diff --git a/doc/sdk/python/cookbook.html.textile.liquid b/doc/sdk/python/cookbook.html.textile.liquid
index 2adb986a5e1f8eb86618fd8aec9827a7e2bc06ea..7ce547a690f1430ac451f556c9a0d902e15141f1 100644 (file)
--- a/doc/sdk/python/cookbook.html.textile.liquid
+++ b/doc/sdk/python/cookbook.html.textile.liquid
@@ -62,4 +62,18 @@ collection = arvados.collection.CollectionReader(container_request["output_uuid"
 print(collection.open("cwl.output.json").read())
 </code>
 
+h2. Create a collection sharing link
+
+<code>
+import arvados
+api = arvados.api()
+download="https://your.download.server"
+collection_uuid="your-4zz18-collectionuuid"
+token = api.api_client_authorizations().create(body={"api_client_authorization":{"scopes": [
+    "GET /arvados/v1/collections/%s" % collection_uuid,
+    "GET /arvados/v1/collections/%s/" % collection_uuid,
+    "GET /arvados/v1/keep_services/accessible"]}}).execute()
+print("%s/c=%s/t=%s/_/" % (download, collection_uuid, token["api_token"]))
+</code>
+
 h2. Run a CWL workflow from a workflow record