readMe structure

Author: kcvemula

README.md

@@ -6,15 +6,6 @@ Contains code samples to invoke NetBackup REST API using different programming l
 These scripts are only meant to be used as a reference. Please do not use these in production.
 
 #### Executing the snippets for different programming languages
-#### Executing the snippets in PowerShell
-Pre-requisites:
-- NetBackup 8.1.1 or higher
-- Powershell 5.0 or higher
-
-Use the following commands to run the powershell samples.
-- `.\Get-NB-Images.ps1 -nbmaster <masterServer> -username <username> -password <password>`
-- `.\Get-NB-Jobs.ps1 -nbmaster <masterServer> -username <username> -password <password>`
-- `.\New-Policy-StepByStep.ps1 -nbmaster <masterServer> -username <username> -password <password>`
 
 The `snippets` folder contains code samples to invoke NetBackup REST API using different programming languages. 
 
@@ -23,49 +14,17 @@ Pre-requisites:
 - NetBackup 8.1.1 or higher
 - See the script's README for the corresponding requirements and usage
 
-#### Executing the recipes in Perl
 
-Pre-requisites:
-- NetBackup 8.1.2 or higher
-- Perl 5.20.2 or higher
+#### Executing the recipes for different programming languages
 
-Use the following commands to run the perl samples.
-- `perl create_policy_step_by_step.pl -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-- `perl create_policy_in_one_step.pl -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-- `perl rbac_filtering_in_policy.pl -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-- `perl api_requests_images.pl -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-- `perl api_requests_image_contents.pl -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-
-#### Executing the recipes in Python
+The `recipes` folder contains code samples to invoke NetBackup REST API using different programming languages. 
 
 Pre-requisites:
-- NetBackup 8.1.2 or higher
-- python 3.5 or higher
-- python modules: `requests`
-
-Use the following commands to run the python samples.
-- `python -W ignore create_policy_step_by_step.py -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-- `python -W ignore create_policy_in_one_step.py -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-- `python -W ignore rbac_filtering_in_policy.py -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]`
-
 
-#### Tools
-The `tools` folder contains utilities that have proven useful in the development of projects using
-NetBackup REST APIs, but do not provide any API usage examples.  Again, these tools are not for
-production use, but they may be of some use in your work.
-
-Use the following commands to run the curl samples.
-- `./get_nb_jobs.sh -master <master_server> -username <username> -password <password>`
-- `./get_nb_images.sh -master <master_server> -username <username> -password <password>`
-
-#### Executing the recipes using go (often referred to as golang)
-Pre-requisites:
 - NetBackup 8.1.2 or higher
-- go1.10.2 or higher
+- See the script's README for the corresponding requirements and usage
+
 
-Use the following commands to run the go samples.
-- `go run ./create_policy_step_by_step.go -nbmaster <master_server> -username <username> -password <password>`
-- `go run ./create_policy_in_one_step.go -nbmaster <master_server> -username <username> -password <password>`
 
 #### Tools
 The `tools` folder contains utilities that have proven useful in the development of projects using

recipes/go/README.md

@@ -0,0 +1,18 @@
+### NetBackup API Code Samples for go (often referred to as golang)
+
+This directory contains code samples to invoke NetBackup REST APIs using go.
+
+#### Disclaimer
+
+These scripts are only meant to be used as a reference. If you intend to use them in production, use it at your own risk.
+
+#### Pre-requisites:
+
+- NetBackup 8.1.2 or higher
+- go1.10.2 or higher
+
+#### Executing the recipes using go
+
+Use the following commands to run the go samples.
+- `go run ./create_policy_step_by_step.go -nbmaster <master_server> -username <username> -password <password>`
+- `go run ./create_policy_in_one_step.go -nbmaster <master_server> -username <username> -password <password>`

recipes/go/create_policy_in_one_step.go

@@ -0,0 +1,56 @@
+//This script can be run using NetBackup 8.1.2 and higher.
+//It creates a VMware policy consisting of the specific attribute values, a client, a schedule, and a VIP query backup selection 
+//and eventually deletes the policy.
+
+package main
+
+import (
+    "flag"
+    "fmt"
+    "log"
+    "os"
+    "policies/apihelper"
+)
+
+//###################
+// Global Variables
+//###################
+var (
+    nbmaster            = flag.String("nbmaster", "", "NetBackup Master Server")
+    username            = flag.String("username", "", "User name to log into the NetBackup webservices")
+    password            = flag.String("password", "", "Password for the given user")
+    domainName          = flag.String("domainName", "", "Domain name of the given user")
+    domainType          = flag.String("domainType", "", "Domain type of the given user")
+)
+
+const usage = "\n\nUsage: go run ./create_policy_in_one_step.go -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]\n\n"
+
+func main() {
+    // Print usage
+    flag.Usage = func() {
+        fmt.Fprintf(os.Stderr, usage)
+        os.Exit(1)
+    }
+
+    // Read command line arguments
+    flag.Parse()
+
+    if len(*nbmaster) == 0 {
+        log.Fatalf("Please specify the name of the NetBackup Master Server using the -nbmaster parameter.\n")
+    }
+    if len(*username) == 0 {
+        log.Fatalf("Please specify the username using the -username parameter.\n")
+    }
+    if len(*password) == 0 {
+        log.Fatalf("Please specify the password using the -password parameter.\n")
+    }
+
+    httpClient := helper.GetHTTPClient()
+    jwt := helper.Login(*nbmaster, httpClient, *username, *password, *domainName, *domainType)
+
+    helper.CreatePolicy(*nbmaster, httpClient, jwt)
+    helper.ListPolicies(*nbmaster, httpClient, jwt)
+    helper.ReadPolicy(*nbmaster, httpClient, jwt)
+    helper.DeletePolicy(*nbmaster, httpClient, jwt)
+    helper.ListPolicies(*nbmaster, httpClient, jwt)
+}

recipes/go/create_policy_step_by_step.go

@@ -0,0 +1,63 @@
+//This script can be run using NetBackup 8.1.2 and higher.
+//It creates a VMware policy with the default attribute values, then adds a client, a schedule, and a VIP query backup selection to it.
+//It then delets the client, schedule from the policy and finally deletes the policy.
+
+package main
+
+import (
+    "flag"
+    "fmt"
+    "log"
+    "os"
+    "policies/apihelper"
+)
+
+//###################
+// Global Variables
+//###################
+var (
+    nbmaster    = flag.String("nbmaster", "", "NetBackup Master Server")
+    username    = flag.String("username", "", "User name to log into the NetBackup webservices")
+    password    = flag.String("password", "", "Password for the given user")
+    domainName  = flag.String("domainName", "", "Domain name of the given user")
+    domainType  = flag.String("domainType", "", "Domain type of the given user")
+)
+
+const usage = "\n\nUsage: go run ./create_policy_step_by_step.go -nbmaster <masterServer> -username <username> -password <password> [-domainName <domainName>] [-domainType <domainType>]\n\n"
+
+func main() {
+    // Print usage
+    flag.Usage = func() {
+        fmt.Fprintf(os.Stderr, usage)
+        os.Exit(1)
+    }
+
+    // Read command line arguments
+    flag.Parse()
+
+    if len(*nbmaster) == 0 {
+        log.Fatalf("Please specify the name of the NetBackup Master Server using the -nbmaster parameter.\n")
+    }
+    if len(*username) == 0 {
+        log.Fatalf("Please specify the username using the -username parameter.\n")
+    }
+    if len(*password) == 0 {
+        log.Fatalf("Please specify the password using the -password parameter.\n")
+    }
+
+    httpClient := helper.GetHTTPClient()
+    jwt := helper.Login(*nbmaster, httpClient, *username, *password, *domainName, *domainType)
+
+    helper.CreatePolicyWithDefaults(*nbmaster, httpClient, jwt)
+    helper.ListPolicies(*nbmaster, httpClient, jwt)
+    helper.ReadPolicy(*nbmaster, httpClient, jwt)
+    helper.AddClient(*nbmaster, httpClient, jwt)
+    helper.AddSchedule(*nbmaster, httpClient, jwt)
+    helper.AddBackupSelection(*nbmaster, httpClient, jwt)
+    helper.ReadPolicy(*nbmaster, httpClient, jwt)
+    helper.DeleteClient(*nbmaster, httpClient, jwt)
+    helper.DeleteSchedule(*nbmaster, httpClient, jwt)
+    helper.ReadPolicy(*nbmaster, httpClient, jwt)
+    helper.DeletePolicy(*nbmaster, httpClient, jwt)
+    helper.ListPolicies(*nbmaster, httpClient, jwt)
+}