From a4bedc7e2eb7b04dc8317fe43b8fe8014e43ba05 Mon Sep 17 00:00:00 2001
From: Qiu Jian <qiujian@yunionyun.com>
Date: Tue, 29 Sep 2020 14:24:23 +0800
Subject: [PATCH] add mcclient sample

---
 pkg/mcclient/README.md | 45 ++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

diff --git a/pkg/mcclient/README.md b/pkg/mcclient/README.md
index 971cf5ae75..597bf438a1 100644
--- a/pkg/mcclient/README.md
+++ b/pkg/mcclient/README.md
@@ -1,2 +1,43 @@
-Yunion CMP API go library
-==========================
+Yunion OneCloud API go library
+===============================
+
+
+Sample code
+
+    :::golang
+    package main
+
+    import (
+        "context"
+        "fmt"
+
+        "yunion.io/x/onecloud/pkg/mcclient"
+        "yunion.io/x/onecloud/pkg/mcclient/modules"
+    )
+
+    func main() {
+        client := mcclient.NewClient("https://<onecloud_controller_ip>:30500/v3",
+            60,
+            true,
+            true,
+            "",
+            "")
+        token, err := client.Authenticate("sysadmin", "<password>", "Default", "system", "Default")
+        if err != nil {
+            panic(err)
+        }
+        s := client.NewSession(context.Background(),
+            "region0",
+            "",
+            "PublicURL",
+            token,
+            "")
+
+        result, err := modules.Servers.List(s, nil)
+        if err != nil {
+            panic(err)
+        }
+        fmt.Printf("%#v\n", result)
+    }
+
+