Merge pull request #1786 from dougm/tags-example

vapi: add CreateTag example

Author: dougm

vapi/tags/example_test.go

@@ -0,0 +1,66 @@
+/*
+Copyright (c) 2020 VMware, Inc. All Rights Reserved.
+
+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.
+*/
+
+package tags_test
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/vmware/govmomi/simulator"
+	"github.com/vmware/govmomi/vapi/rest"
+	"github.com/vmware/govmomi/vapi/tags"
+	"github.com/vmware/govmomi/vim25"
+
+	_ "github.com/vmware/govmomi/vapi/simulator"
+)
+
+func ExampleManager_CreateTag() {
+	simulator.Run(func(ctx context.Context, vc *vim25.Client) error {
+		c := rest.NewClient(vc)
+		_ = c.Login(ctx, simulator.DefaultLogin)
+
+		m := tags.NewManager(c)
+
+		id, err := m.CreateCategory(ctx, &tags.Category{
+			AssociableTypes: []string{"VirtualMachine"},
+			Cardinality:     "SINGLE",
+			Description:     "This is My Category",
+			Name:            "my-category",
+		})
+		if err != nil {
+			return err
+		}
+
+		id, err = m.CreateTag(ctx, &tags.Tag{
+			CategoryID:  id,
+			Description: "This is My Tag",
+			Name:        "my-tag",
+		})
+		if err != nil {
+			return err
+		}
+
+		tag, err := m.GetTag(ctx, id)
+		if err != nil {
+			return err
+		}
+
+		fmt.Println(tag.Name)
+		return nil
+	})
+	// Output: my-tag
+}