Documentation
¶
Index ¶
- func AllFieldsEmpty(v interface{}) bool
- func BoolPolicy(b bool) *types.BoolPolicy
- func BoolPtr(v bool) *bool
- func BoolStringPtrState(v interface{}) string
- func ByteToGB(n interface{}) interface{}
- func ByteToGiB(n interface{}) interface{}
- func ByteToMB(n interface{}) interface{}
- func DeRef(v interface{}) interface{}
- func DiffSlice(a, b []interface{}) []interface{}
- func DropSliceItem(a []interface{}, n int) []interface{}
- func GBToByte(n interface{}) int64
- func GetBool(d *schema.ResourceData, key string) *bool
- func GetBoolPolicy(d *schema.ResourceData, key string) *types.BoolPolicy
- func GetBoolPolicyReverse(d *schema.ResourceData, key string) *types.BoolPolicy
- func GetBoolPtr(d *schema.ResourceData, key string) *bool
- func GetBoolStringPtr(d *schema.ResourceData, key string) (*bool, error)
- func GetInt64Ptr(d *schema.ResourceData, key string) *int64
- func GetInt64PtrEmptyZero(d *schema.ResourceData, key string) *int64
- func GetLongPolicy(d *schema.ResourceData, key string) *types.LongPolicy
- func GetString(d *schema.ResourceData, key string) *string
- func GetStringPolicy(d *schema.ResourceData, key string) *types.StringPolicy
- func GetStringPtr(d *schema.ResourceData, key string) *string
- func GiBToByte(n interface{}) int64
- func Int32Ptr(v int32) *int32
- func Int64Ptr(v int64) *int64
- func LogCond(c bool, t, f interface{}) interface{}
- func LongPolicy(n interface{}) *types.LongPolicy
- func MergeSchema(dst, src map[string]*schema.Schema)
- func NormalizeValue(v interface{}) interface{}
- func ResourceIDString(d ResourceIDStringer, name string) string
- func SetBatch(d *schema.ResourceData, attrs map[string]interface{}) error
- func SetBoolPolicy(d *schema.ResourceData, key string, val *types.BoolPolicy) error
- func SetBoolPolicyReverse(d *schema.ResourceData, key string, val *types.BoolPolicy) error
- func SetBoolPtr(d *schema.ResourceData, key string, val *bool) error
- func SetBoolStringPtr(d *schema.ResourceData, key string, val *bool) error
- func SetInt64Ptr(d *schema.ResourceData, key string, val *int64) error
- func SetLongPolicy(d *schema.ResourceData, key string, val *types.LongPolicy) error
- func SetStringPolicy(d *schema.ResourceData, key string, val *types.StringPolicy) error
- func SetStringPtr(d *schema.ResourceData, key string, val *string) error
- func SliceInterfacesToManagedObjectReferences(s []interface{}, t string) []types.ManagedObjectReference
- func SliceInterfacesToStrings(s []interface{}) []string
- func SliceStringsToInterfaces(s []string) []interface{}
- func SliceStringsToManagedObjectReferences(s []string, t string) []types.ManagedObjectReference
- func StringPolicy(s string) *types.StringPolicy
- func StringPtr(v string) *string
- func ValidateBoolStringPtr() schema.SchemaValidateFunc
- func ValuesAvailable(base string, keys []string, d *schema.ResourceDiff) bool
- type MoRefSorter
- type ResourceIDStringer
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AllFieldsEmpty ¶
func AllFieldsEmpty(v interface{}) bool
AllFieldsEmpty checks to see if all fields in a given struct are zero values. It does not recurse, so finer-grained checking should be done for deep accuracy when necessary. It also does not dereference pointers, except if the value itself is a pointer and is not nil.
func BoolPolicy ¶
func BoolPolicy(b bool) *types.BoolPolicy
BoolPolicy converts a bool into a VMware BoolPolicy value.
func BoolPtr ¶
BoolPtr makes a *bool out of the value passed in through v.
vSphere uses nil values in bools to omit values in the SOAP XML request, and helps denote inheritance in certain cases.
func BoolStringPtrState ¶ added in v1.4.0
func BoolStringPtrState(v interface{}) string
BoolStringPtrState is a state normalization function for stringified 3-state bool pointers.
The function silently drops any result that can't be parsed with ParseBool, and will return an empty string for these cases.
This is designed to address the current lack of HCL and Terraform to be able to distinguish between nil states and zero values properly. This is a systemic issue that affects reading, writing, and diffing of these values. These issues will eventually be addressed in HCL2.
func ByteToGB ¶
func ByteToGB(n interface{}) interface{}
ByteToGB returns n/1000000000. The input must be an integer that can be divisible by 1000000000.
Remember that int32 overflows at 2GB, so any values higher than that will produce an inaccurate result.
func ByteToGiB ¶
func ByteToGiB(n interface{}) interface{}
ByteToGiB returns n/1024^3. The input must be an integer that can be appropriately divisible.
Remember that int32 overflows at approximately 2GiB, so any values higher than that will produce an inaccurate result.
func ByteToMB ¶
func ByteToMB(n interface{}) interface{}
ByteToMB returns n/1000000. The input must be an integer that can be divisible by 1000000.
func DeRef ¶
func DeRef(v interface{}) interface{}
DeRef returns the value pointed to by the interface if the interface is a pointer and is not nil, otherwise returns nil, or the direct value if it's not a pointer.
func DropSliceItem ¶ added in v1.22.0
func DropSliceItem(a []interface{}, n int) []interface{}
func GBToByte ¶
func GBToByte(n interface{}) int64
GBToByte returns n*1000000000.
The output is returned as int64 - if another type is needed, it needs to be cast. Remember that int32 overflows at 2GB and uint32 will overflow at 4GB.
func GetBool ¶
func GetBool(d *schema.ResourceData, key string) *bool
GetBool reads a ResourceData and returns a *bool. This differs from GetBoolPtr in that a nil value is never returned.
func GetBoolPolicy ¶
func GetBoolPolicy(d *schema.ResourceData, key string) *types.BoolPolicy
GetBoolPolicy reads a ResourceData and returns an appropriate BoolPolicy for the state of the definition. nil is returned if it does not exist.
func GetBoolPolicyReverse ¶
func GetBoolPolicyReverse(d *schema.ResourceData, key string) *types.BoolPolicy
GetBoolPolicyReverse acts like GetBoolPolicy, but the value is inverted.
func GetBoolPtr ¶
func GetBoolPtr(d *schema.ResourceData, key string) *bool
GetBoolPtr reads a ResourceData and returns an appropriate *bool for the state of the definition. nil is returned if it does not exist.
func GetBoolStringPtr ¶ added in v1.4.0
func GetBoolStringPtr(d *schema.ResourceData, key string) (*bool, error)
GetBoolStringPtr reads a ResourceData *string* field. This field is handled in the following way:
* If it's empty, nil is returned. * The string is then sent through ParseBool. This will return a valid value for anything ParseBool returns a value for. * If it's anything else, an error is returned.
This is designed to address the current lack of HCL and Terraform to be able to distinguish between nil states and zero values properly. This is a systemic issue that affects reading, writing, and diffing of these values. These issues will eventually be addressed in HCL2.
func GetInt64Ptr ¶
func GetInt64Ptr(d *schema.ResourceData, key string) *int64
GetInt64Ptr reads a ResourceData and returns an appropriate *int64 for the state of the definition. nil is returned if it does not exist.
func GetInt64PtrEmptyZero ¶ added in v1.9.1
func GetInt64PtrEmptyZero(d *schema.ResourceData, key string) *int64
GetInt64PtrEmptyZero reads a ResourceData and returns an appropriate *int64 for the state of the definition. 0 is returned if it does not exist.
func GetLongPolicy ¶
func GetLongPolicy(d *schema.ResourceData, key string) *types.LongPolicy
GetLongPolicy reads a ResourceData and returns an appropriate LongPolicy for the state of the definition. nil is returned if it does not exist.
func GetString ¶ added in v1.4.0
func GetString(d *schema.ResourceData, key string) *string
GetString reads a ResourceData and returns a *string. This differs from GetStringPtr in that a nil value is never returned.
func GetStringPolicy ¶
func GetStringPolicy(d *schema.ResourceData, key string) *types.StringPolicy
GetStringPolicy reads a ResourceData and returns an appropriate StringPolicy for the state of the definition. nil is returned if it does not exist.
func GetStringPtr ¶ added in v1.4.0
func GetStringPtr(d *schema.ResourceData, key string) *string
GetStringPtr reads a ResourceData and returns an appropriate *string for the state of the definition. nil is returned if it does not exist.
func GiBToByte ¶
func GiBToByte(n interface{}) int64
GiBToByte returns n*1024^3.
The output is returned as int64 - if another type is needed, it needs to be cast. Remember that int32 overflows at around 2GiB and uint32 will overflow at 4GiB.
func LogCond ¶ added in v1.1.1
func LogCond(c bool, t, f interface{}) interface{}
LogCond takes a boolean (which can be passed in as a bool or as a conditional), and returns either the first value if true, and the second if false. It's designed to be a "ternary" operator of sorts for logging.
func LongPolicy ¶
func LongPolicy(n interface{}) *types.LongPolicy
LongPolicy converts a supported number into a VMware LongPolicy value. This will panic if there is no implicit conversion of the value into an int64.
func MergeSchema ¶
MergeSchema merges the map[string]*schema.Schema from src into dst. Safety against conflicts is enforced by panicing.
func NormalizeValue ¶
func NormalizeValue(v interface{}) interface{}
NormalizeValue converts a value to something that is suitable to be set in a ResourceData and can be useful in situations where there is not access to normal helper/schema functionality, but you still need saved fields to behave in the same way.
Specifically, this will run the value through DeRef to dereference any pointers first, and then convert numeric primitives, if necessary.
func ResourceIDString ¶ added in v1.4.0
func ResourceIDString(d ResourceIDStringer, name string) string
ResourceIDString prints a friendly string for a resource, supplied by name.
func SetBatch ¶ added in v1.5.0
func SetBatch(d *schema.ResourceData, attrs map[string]interface{}) error
SetBatch takes a map of values and sets the appropriate top-level attributes for each item.
attrs is a map[string]interface{} that follows a pattern in the example below:
err := SetBatch(d, map[string]interface{}{
"foo": obj.Foo,
"bar": obj.Bar,
})
if err != nil {
return err
}
For best results, supplied values should be or have concrete values that map to the correct values for the respective type in helper/schema. This is enforced by way of checking each Set call for errors. If there is an error setting a particular key, processing stops immediately.
func SetBoolPolicy ¶
func SetBoolPolicy(d *schema.ResourceData, key string, val *types.BoolPolicy) error
SetBoolPolicy sets a ResourceData field depending on if a BoolPolicy exists or not. The field is not set if it's nil.
func SetBoolPolicyReverse ¶
func SetBoolPolicyReverse(d *schema.ResourceData, key string, val *types.BoolPolicy) error
SetBoolPolicyReverse acts like SetBoolPolicy, but the value is inverted.
func SetBoolPtr ¶
func SetBoolPtr(d *schema.ResourceData, key string, val *bool) error
SetBoolPtr sets a ResourceData field depending on if a *bool exists or not. The field is not set if it's nil.
func SetBoolStringPtr ¶ added in v1.4.0
func SetBoolStringPtr(d *schema.ResourceData, key string, val *bool) error
SetBoolStringPtr sets a stringified ResoruceData bool field. This is a field that is supposed to behave like a bool (true/false), but needs to be a string to represent a nil state as well.
This is designed to address the current lack of HCL and Terraform to be able to distinguish between nil states and zero values properly. This is a systemic issue that affects reading, writing, and diffing of these values. These issues will eventually be addressed in HCL2.
func SetInt64Ptr ¶
func SetInt64Ptr(d *schema.ResourceData, key string, val *int64) error
SetInt64Ptr sets a ResourceData field depending on if an *int64 exists or not. The field is not set if it's nil.
func SetLongPolicy ¶
func SetLongPolicy(d *schema.ResourceData, key string, val *types.LongPolicy) error
SetLongPolicy sets a ResourceData field depending on if a LongPolicy exists or not. The field is not set if it's nil.
func SetStringPolicy ¶
func SetStringPolicy(d *schema.ResourceData, key string, val *types.StringPolicy) error
SetStringPolicy sets a ResourceData field depending on if a StringPolicy exists or not. The field is not set if it's nil.
func SetStringPtr ¶ added in v1.4.0
func SetStringPtr(d *schema.ResourceData, key string, val *string) error
SetStringPtr sets a ResourceData field depending on if a *string exists or not. The field is not set if it's nil.
func SliceInterfacesToManagedObjectReferences ¶ added in v1.5.0
func SliceInterfacesToManagedObjectReferences(s []interface{}, t string) []types.ManagedObjectReference
SliceInterfacesToManagedObjectReferences converts an interface slice into a slice of ManagedObjectReferences with the type of t.
func SliceInterfacesToStrings ¶
func SliceInterfacesToStrings(s []interface{}) []string
SliceInterfacesToStrings converts an interface slice to a string slice. The function does not attempt to do any sanity checking and will panic if one of the items in the slice is not a string.
func SliceStringsToInterfaces ¶
func SliceStringsToInterfaces(s []string) []interface{}
SliceStringsToInterfaces converts a string slice to an interface slice.
func SliceStringsToManagedObjectReferences ¶ added in v1.5.0
func SliceStringsToManagedObjectReferences(s []string, t string) []types.ManagedObjectReference
SliceStringsToManagedObjectReferences converts a string slice into a slice of ManagedObjectReferences with the type of t.
func StringPolicy ¶
func StringPolicy(s string) *types.StringPolicy
StringPolicy converts a string into a VMware StringPolicy value.
func StringPtr ¶ added in v1.4.0
StringPtr makes a *string out of the value passed in through v.
vSphere uses nil values in strings to omit values in the SOAP XML request, and helps denote inheritance in certain cases.
func ValidateBoolStringPtr ¶ added in v1.4.0
func ValidateBoolStringPtr() schema.SchemaValidateFunc
ValidateBoolStringPtr validates that the input value can be parsed by ParseBool. It also succeeds on empty strings.
This is designed to address the current lack of HCL and Terraform to be able to distinguish between nil states and zero values properly. This is a systemic issue that affects reading, writing, and diffing of these values. These issues will eventually be addressed in HCL2.
func ValuesAvailable ¶ added in v1.21.0
func ValuesAvailable(base string, keys []string, d *schema.ResourceDiff) bool
ValuesAvailable takes a subresource path and a list of keys and checks that the value for each key is available at CustomizeDiff time. This function will return false if any of they values are based on computed values from other new or updated resources.
Types ¶
type MoRefSorter ¶ added in v1.5.0
type MoRefSorter []types.ManagedObjectReference
MoRefSorter is a sorting wrapper for a slice of MangedObjectReference.
func (MoRefSorter) Len ¶ added in v1.5.0
func (s MoRefSorter) Len() int
Len implements sort.Interface for MoRefSorter.
func (MoRefSorter) Less ¶ added in v1.5.0
func (s MoRefSorter) Less(i, j int) bool
Less helps implement sort.Interface for MoRefSorter.
func (MoRefSorter) Swap ¶ added in v1.5.0
func (s MoRefSorter) Swap(i, j int)
Swap helps implement sort.Interface for MoRefSorter.
type ResourceIDStringer ¶ added in v1.4.0
type ResourceIDStringer interface {
Id() string
}
ResourceIDStringer is a small interface that can be used to supply ResourceData and ResourceDiff to functions that need to print the ID of a resource, namely used by logging.
Source Files