tpgresource

package
v0.0.0-...-7c00c02 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 11, 2024 License: MPL-2.0 Imports: 35 Imported by: 0

Documentation

Overview

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Copyright (c) HashiCorp, Inc. SPDX-License-Identifier: MPL-2.0

Index

Constants

View Source
const (
	GlobalLinkTemplate             = "projects/%s/global/%s/%s"
	GlobalLinkBasePattern          = "projects/(.+)/global/%s/(.+)"
	ZonalLinkTemplate              = "projects/%s/zones/%s/%s/%s"
	ZonalLinkBasePattern           = "projects/(.+)/zones/(.+)/%s/(.+)"
	ZonalPartialLinkBasePattern    = "zones/(.+)/%s/(.+)"
	RegionalLinkTemplate           = "projects/%s/regions/%s/%s/%s"
	RegionalLinkBasePattern        = "projects/(.+)/regions/(.+)/%s/(.+)"
	RegionalPartialLinkBasePattern = "regions/(.+)/%s/(.+)"
	ProjectLinkTemplate            = "projects/%s/%s/%s"
	ProjectBasePattern             = "projects/(.+)/%s/(.+)"
	OrganizationLinkTemplate       = "organizations/%s/%s/%s"
	OrganizationBasePattern        = "organizations/(.+)/%s/(.+)"
)

Variables

This section is empty.

Functions

func AbsoluteDomainSuppress

func AbsoluteDomainSuppress(k, old, new string, _ *schema.ResourceData) bool

For managed SSL certs, if new is an absolute FQDN (trailing '.') but old isn't, treat them as equals.

func AddOptionalFieldsToSchema

func AddOptionalFieldsToSchema(schema map[string]*schema.Schema, keys ...string)

func AddRequiredFieldsToSchema

func AddRequiredFieldsToSchema(schema map[string]*schema.Schema, keys ...string)

func BuildReplacementFunc

func BuildReplacementFunc(re *regexp.Regexp, d TerraformResourceData, config *transport_tpg.Config, linkTmpl string, shorten bool) (func(string) string, error)

This function replaces references to Terraform properties (in the form of {{var}}) with their value in Terraform It also replaces {{project}}, {{project_id_or_project}}, {{region}}, and {{zone}} with their appropriate values This function supports URL-encoding the result by prepending '%' to the field name e.g. {{%var}}

func CalcAddRemove

func CalcAddRemove(from []string, to []string) (add, remove []string)

Given two sets of references (with "from" values in self link form), determine which need to be added or removed // during an update using addX/removeX APIs.

func CanonicalizeServiceScope

func CanonicalizeServiceScope(scope string) string

func CanonicalizeServiceScopes

func CanonicalizeServiceScopes(scopes []string) []string

func CaseDiffSuppress

func CaseDiffSuppress(_, old, new string, _ *schema.ResourceData) bool

func ChangeFieldSchemaToForceNew

func ChangeFieldSchemaToForceNew(sch *schema.Schema)

func CheckGCSName

func CheckGCSName(name string) error

validate name of the gcs bucket. Guidelines are located at https://cloud.google.com/storage/docs/naming-buckets this does not attempt to check for IP addresses or close misspellings of "google"

func CheckGoogleIamPolicy

func CheckGoogleIamPolicy(value string) error

CheckGoogleIamPolicy makes assertions about the contents of a google_iam_policy data source's policy_data attribute

func CheckStringMap

func CheckStringMap(v interface{}) map[string]string

func CidrOrSizeDiffSuppress

func CidrOrSizeDiffSuppress(k, old, new string, d *schema.ResourceData) bool

func CommonRefreshFunc

func CommonRefreshFunc(w Waiter) resource.StateRefreshFunc

func CompareCryptoKeyVersions

func CompareCryptoKeyVersions(_, old, new string, _ *schema.ResourceData) bool

func CompareIpAddressOrSelfLinkOrResourceName

func CompareIpAddressOrSelfLinkOrResourceName(_, old, new string, _ *schema.ResourceData) bool

Use this method when the field accepts either an IP address or a self_link referencing a resource (such as google_compute_route's next_hop_ilb)

func CompareOptionalSubnet

func CompareOptionalSubnet(_, old, new string, _ *schema.ResourceData) bool

Use this method when subnet is optioanl and auto_create_subnetworks = true API sometimes choose a subnet so the diff needs to be ignored

func CompareResourceNames

func CompareResourceNames(_, old, new string, _ *schema.ResourceData) bool

Compare only the resource name of two self links/paths.

func CompareSelfLinkOrResourceName

func CompareSelfLinkOrResourceName(_, old, new string, _ *schema.ResourceData) bool

CompareSelfLinkOrResourceName checks if two resources are the same resource

Use this method when the field accepts either a name or a self_link referencing a resource. The value we store (i.e. `old` in this method), must be a self_link.

func CompareSelfLinkRelativePaths

func CompareSelfLinkRelativePaths(_, old, new string, _ *schema.ResourceData) bool

Compare only the relative path of two self links.

func Convert

func Convert(item, out interface{}) error

Convert between two types by converting to/from JSON. Intended to switch between multiple API versions, as they are strict supersets of one another. item and out are pointers to structs

func ConvertAndMapStringArr

func ConvertAndMapStringArr(ifaceArr []interface{}, f func(string) string) []string

func ConvertSelfLinkToV1

func ConvertSelfLinkToV1(link string) string

func ConvertStringArr

func ConvertStringArr(ifaceArr []interface{}) []string

func ConvertStringArrToInterface

func ConvertStringArrToInterface(strs []string) []interface{}

func ConvertStringMap

func ConvertStringMap(v map[string]interface{}) map[string]string

func ConvertStringSet

func ConvertStringSet(set *schema.Set) []string

func ConvertToMap

func ConvertToMap(item interface{}) (map[string]interface{}, error)

When converting to a map, we can't use setOmittedFields because FieldByName fails. Luckily, we don't use the omitted fields anymore with generated resources, and this function is used to bridge from handwritten -> generated. Since this is a known type, we can create it inline instead of needing to pass an object in.

func DatasourceSchemaFromResourceSchema

func DatasourceSchemaFromResourceSchema(rs map[string]*schema.Schema) map[string]*schema.Schema

DatasourceSchemaFromResourceSchema is a recursive func that converts an existing Resource schema to a Datasource schema. All schema elements are copied, but certain attributes are ignored or changed: - all attributes have Computed = true - all attributes have ForceNew, Required = false - Validation funcs and attributes (e.g. MaxItems) are not copied

func DefaultProviderProject

func DefaultProviderProject(_ context.Context, diff *schema.ResourceDiff, meta interface{}) error

func DefaultProviderRegion

func DefaultProviderRegion(_ context.Context, diff *schema.ResourceDiff, meta interface{}) error

func DefaultProviderZone

func DefaultProviderZone(_ context.Context, diff *schema.ResourceDiff, meta interface{}) error

func DurationDiffSuppress

func DurationDiffSuppress(k, old, new string, d *schema.ResourceData) bool

Suppress diffs for duration format. ex "60.0s" and "60s" same https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration

func EmptyOrDefaultStringSuppress

func EmptyOrDefaultStringSuppress(defaultVal string) schema.SchemaDiffSuppressFunc

func EmptyOrFalseSuppressBoolean

func EmptyOrFalseSuppressBoolean(k, old, new string, d *schema.ResourceData) bool

func EmptyOrUnsetBlockDiffSuppress

func EmptyOrUnsetBlockDiffSuppress(k, old, new string, d *schema.ResourceData) bool

func EmptyOrUnsetBlockDiffSuppressLogic

func EmptyOrUnsetBlockDiffSuppressLogic(k, old, new string, o, n interface{}) bool

The core logic for EmptyOrUnsetBlockDiffSuppress, in a format that is more conducive to unit testing.

func ExpandBuildEnvironmentVariables

func ExpandBuildEnvironmentVariables(d *schema.ResourceData) map[string]string

ExpandBuildEnvironmentVariables pulls the value of "build_environment_variables" out of a schema.ResourceData as a map[string]string.

func ExpandEffectiveLabels

func ExpandEffectiveLabels(d TerraformResourceData) map[string]string

ExpandEffectiveLabels pulls the value of "effective_labels" out of a TerraformResourceData as a map[string]string.

func ExpandEnvironmentVariables

func ExpandEnvironmentVariables(d *schema.ResourceData) map[string]string

ExpandEnvironmentVariables pulls the value of "environment_variables" out of a schema.ResourceData as a map[string]string.

func ExpandLabels

func ExpandLabels(d TerraformResourceData) map[string]string

ExpandLabels pulls the value of "labels" out of a TerraformResourceData as a map[string]string.

func ExpandString

func ExpandString(v interface{}, d TerraformResourceData, config *transport_tpg.Config) (string, error)

func ExpandStringMap

func ExpandStringMap(d TerraformResourceData, key string) map[string]string

ExpandStringMap pulls the value of key out of a TerraformResourceData as a map[string]string.

func ExtractFieldByPattern

func ExtractFieldByPattern(fieldName, fieldValue, parentFieldValue, pattern string) (string, error)

ExtractFieldByPattern returns the value of a field extracted from a parent field according to the given regular expression pattern. An error is returned if the field already has a value different than the value extracted.

func ExtractFirstMapConfig

func ExtractFirstMapConfig(m []interface{}) map[string]interface{}

func Fake404

func Fake404(reasonResourceType, resourceName string) *googleapi.Error

return a fake 404 so requests get retried or nested objects are considered deleted

func FixDatasourceSchemaFlags

func FixDatasourceSchemaFlags(schema map[string]*schema.Schema, required bool, keys ...string)

fixDatasourceSchemaFlags is a convenience func that toggles the Computed, Optional + Required flags on a schema element. This is useful when the schema has been generated (using `DatasourceSchemaFromResourceSchema` above for example) and therefore the attribute flags were not set appropriately when first added to the schema definition. Currently only supports top-level schema elements.

func FlattenContainerAwsNodePoolManagement

func FlattenContainerAwsNodePoolManagement(obj *containeraws.NodePoolManagement, d *schema.ResourceData, config *transport_tpg.Config) interface{}

func FlattenContainerAzureNodePoolManagement

func FlattenContainerAzureNodePoolManagement(obj *containerazure.NodePoolManagement, d *schema.ResourceData, config *transport_tpg.Config) interface{}

func FrameworkDiagsToSdkDiags

func FrameworkDiagsToSdkDiags(fwD fwDiags.Diagnostics) *diag.Diagnostics

func GenerateUserAgentString

func GenerateUserAgentString(d TerraformResourceData, currentUserAgent string) (string, error)

func GetBillingProject

func GetBillingProject(d TerraformResourceData, config *transport_tpg.Config) (string, error)

GetBillingProject reads the "billing_project" field from the given resource data and falls back to the provider's value if not given. If no value is found, an error is returned.

func GetBillingProjectFromSchema

func GetBillingProjectFromSchema(billingProjectSchemaField string, d TerraformResourceData, config *transport_tpg.Config) (string, error)

func GetContentMd5Hash

func GetContentMd5Hash(content []byte) string

func GetFileMd5Hash

func GetFileMd5Hash(filename string) string

func GetImportIdQualifiers

func GetImportIdQualifiers(idRegexes []string, d TerraformResourceData, config *transport_tpg.Config, id string) (map[string]string, error)

Parse an import id extracting field values using the given list of regexes. They are applied in order. The first in the list is tried first. This does not mutate any of the parameters, returning a map of matches Similar to ParseImportId in import.go, but less import specific

e.g: - projects/(?P<project>[^/]+)/regions/(?P<region>[^/]+)/subnetworks/(?P<name>[^/]+) (applied first) - (?P<project>[^/]+)/(?P<region>[^/]+)/(?P<name>[^/]+), - (?P<name>[^/]+) (applied last)

func GetInterconnectAttachmentLink(config *transport_tpg.Config, project, region, ic, userAgent string) (string, error)

func GetLocation

func GetLocation(d TerraformResourceData, config *transport_tpg.Config) (string, error)

GetLocation attempts to get values in this order (if they exist): - location argument in the resource config - region argument in the resource config - zone argument in the resource config - region argument in the provider config - zone argument set in the provider config

func GetLocationalResourcePropertiesFromSelfLinkString

func GetLocationalResourcePropertiesFromSelfLinkString(selfLink string) (string, string, string, error)

given a full locational (non-global) self link, returns the project + region/zone + name or an error

func GetProject

func GetProject(d TerraformResourceData, config *transport_tpg.Config) (string, error)

GetProject reads the "project" field from the given resource data and falls back to the provider's value if not given. If the provider's value is not given, an error is returned.

func GetProjectFromDiff

func GetProjectFromDiff(d *schema.ResourceDiff, config *transport_tpg.Config) (string, error)

GetProjectFromDiff reads the "project" field from the given diff and falls back to the provider's value if not given. If the provider's value is not given, an error is returned.

func GetProjectFromSchema

func GetProjectFromSchema(projectSchemaField string, d TerraformResourceData, config *transport_tpg.Config) (string, error)

func GetRegion

func GetRegion(d TerraformResourceData, config *transport_tpg.Config) (string, error)

Infers the region based on the following (in order of priority): - `region` field in resource schema - region extracted from the `zone` field in resource schema - provider-level region - region extracted from the provider-level zone

func GetRegionFromDiff

func GetRegionFromDiff(d *schema.ResourceDiff, config *transport_tpg.Config) (string, error)

getRegionFromDiff reads the "region" field from the given diff and falls back to the provider's value if not given. If the provider's value is not given, an error is returned.

func GetRegionFromRegionalSelfLink(selfLink string) string

This function supports selflinks that have regions and locations in their paths

func GetRegionFromSchema

func GetRegionFromSchema(regionSchemaField, zoneSchemaField string, d TerraformResourceData, config *transport_tpg.Config) (string, error)

Infers the region based on the following (in order of priority): - `regionSchemaField` in resource schema - region extracted from the `zoneSchemaField` in resource schema - provider-level region - region extracted from the provider-level zone

func GetRegionFromZone

func GetRegionFromZone(zone string) string

GetRegionFromZone returns the region from a zone for Google cloud. This is by removing the last two chars from the zone name to leave the region If there aren't enough characters in the input string, an empty string is returned e.g. southamerica-west1-a => southamerica-west1

func GetRegionalResourcePropertiesFromSelfLinkOrSchema

func GetRegionalResourcePropertiesFromSelfLinkOrSchema(d *schema.ResourceData, config *transport_tpg.Config) (string, string, string, error)

func GetRelativePath

func GetRelativePath(selfLink string) (string, error)

func GetResourceAttributes

func GetResourceAttributes(n string, s *terraform.State) (map[string]string, error)
func GetResourceNameFromSelfLink(link string) string

func GetRouterLockName

func GetRouterLockName(region string, router string) string

func GetUniverseDomain

func GetUniverseDomain(d TerraformResourceData, config *transport_tpg.Config) (string, error)

GetUniverse reads the "universe_domain" field from the given resource data and falls back to the provider's value if not given. If the provider's value is not given, an error is returned.

func GetUniverseDomainFromSchema

func GetUniverseDomainFromSchema(universeSchemaField string, d TerraformResourceData, config *transport_tpg.Config) (string, error)

func GetZonalResourcePropertiesFromSelfLinkOrSchema

func GetZonalResourcePropertiesFromSelfLinkOrSchema(d *schema.ResourceData, config *transport_tpg.Config) (string, string, string, error)

func GetZone

func GetZone(d TerraformResourceData, config *transport_tpg.Config) (string, error)

GetZone reads the "zone" value from the given resource data and falls back to provider's value if not given. If neither is provided, returns an error.

func GetZoneFromDiff

func GetZoneFromDiff(d *schema.ResourceDiff, config *transport_tpg.Config) (string, error)

getZoneFromDiff reads the "zone" field from the given diff and falls back to the provider's value if not given. If the provider's value is not given, an error is returned.

func GolangSetFromStringSlice

func GolangSetFromStringSlice(strings []string) map[string]struct{}

func Hashcode

func Hashcode(s string) int

Hashcode hashes a string to a unique hashcode.

crc32 returns a uint32, but for our use we need and non negative integer. Here we cast to an integer and invert it if the result is negative.

func IgnoreMissingKeyInMap

func IgnoreMissingKeyInMap(key string) schema.SchemaDiffSuppressFunc

func InternalIpDiffSuppress

func InternalIpDiffSuppress(_, old, new string, _ *schema.ResourceData) bool

Suppresses diff for IPv4 and IPv6 different formats. It also suppresses diffs if an IP is changing to a reference.

func IpCidrRangeDiffSuppress

func IpCidrRangeDiffSuppress(k, old, new string, d *schema.ResourceData) bool

func IsConflictError

func IsConflictError(err error) bool

func IsEmptyValue

func IsEmptyValue(v reflect.Value) bool

func IsFailedPreconditionError

func IsFailedPreconditionError(err error) bool

func IsNewResource

func IsNewResource(diff TerraformResourceDiff) bool

func IsNotFoundGrpcError

func IsNotFoundGrpcError(err error) bool

gRPC does not return errors of type *googleapi.Error. Instead the errors returned are *status.Error. See the types of codes returned here (https://pkg.go.dev/google.golang.org/grpc/codes#Code).

func IsQuotaError

func IsQuotaError(err error) bool

func IsZone

func IsZone(location string) bool

func LabelsStateUpgrade

func LabelsStateUpgrade(rawState map[string]interface{}, labesPrefix string) (map[string]interface{}, error)

Upgrade the field "labels" in the state to exclude the labels with the labels prefix and the field "effective_labels" to have all of labels, including the labels with the labels prefix

func LocationDiffSuppress

func LocationDiffSuppress(k, old, new string, d *schema.ResourceData) bool

Suppress diffs for values that are equivalent except for their use of the words "location" compared to "region" or "zone"

func LocationDiffSuppressHelper

func LocationDiffSuppressHelper(a, b string) bool

func MapStringArr

func MapStringArr(original []string, f func(string) string) []string

func MergeSchemas

func MergeSchemas(a, b map[string]*schema.Schema) map[string]*schema.Schema

func MergeStringMaps

func MergeStringMaps(a, b map[string]string) map[string]string

func MigrateStateNoop

func MigrateStateNoop(v int, is *terraform.InstanceState, meta interface{}) (*terraform.InstanceState, error)

func NameFromSelfLinkStateFunc

func NameFromSelfLinkStateFunc(v interface{}) string

func OperationDone

func OperationDone(w Waiter) bool

func OperationWait

func OperationWait(w Waiter, activity string, timeout time.Duration, pollInterval time.Duration) error

func OptionalPrefixSuppress

func OptionalPrefixSuppress(prefix string) schema.SchemaDiffSuppressFunc

func OptionalSurroundingSpacesSuppress

func OptionalSurroundingSpacesSuppress(k, old, new string, d *schema.ResourceData) bool

func PaginatedListRequest

func PaginatedListRequest(project, baseUrl, userAgent string, config *transport_tpg.Config, flattener func(map[string]interface{}) []interface{}) ([]interface{}, error)

func ParseImportId

func ParseImportId(idRegexes []string, d TerraformResourceData, config *transport_tpg.Config) error

Parse an import id extracting field values using the given list of regexes. They are applied in order. The first in the list is tried first.

e.g: - projects/(?P<project>[^/]+)/regions/(?P<region>[^/]+)/subnetworks/(?P<name>[^/]+) (applied first) - (?P<project>[^/]+)/(?P<region>[^/]+)/(?P<name>[^/]+), - (?P<name>[^/]+) (applied last)

func PortRangeDiffSuppress

func PortRangeDiffSuppress(k, old, new string, d *schema.ResourceData) bool

Port range '80' and '80-80' is equivalent. `old` is read from the server and always has the full range format (e.g. '80-80', '1024-2048'). `new` can be either a single port or a port range.

func ProjectNumberDiffSuppress

func ProjectNumberDiffSuppress(_, old, new string, _ *schema.ResourceData) bool

Suppress diffs when the value read from api has the project number instead of the project name

func ReplaceVars

func ReplaceVars(d TerraformResourceData, config *transport_tpg.Config, linkTmpl string) (string, error)

func ReplaceVarsForId

func ReplaceVarsForId(d TerraformResourceData, config *transport_tpg.Config, linkTmpl string) (string, error)

relaceVarsForId shortens variables by running them through GetResourceNameFromSelfLink this allows us to use long forms of variables from configs without needing custom id formats. For instance: accessPolicies/{{access_policy}}/accessLevels/{{access_level}} with values: access_policy: accessPolicies/foo access_level: accessPolicies/foo/accessLevels/bar becomes accessPolicies/foo/accessLevels/bar

func ReplaceVarsForTest

func ReplaceVarsForTest(config *transport_tpg.Config, rs *terraform.ResourceState, linkTmpl string) (string, error)

This function isn't a test of transport.go; instead, it is used as an alternative to ReplaceVars inside tests.

func ReplaceVarsRecursive

func ReplaceVarsRecursive(d TerraformResourceData, config *transport_tpg.Config, linkTmpl string, shorten bool, depth int) (string, error)

ReplaceVars must be done recursively because there are baseUrls that can contain references to regions (eg cloudrun service) there aren't any cases known for 2+ recursion but we will track a run away substitution as 10+ calls to allow for future use cases.

func ReverseStringMap

func ReverseStringMap(m map[string]string) map[string]string

func Rfc3339TimeDiffSuppress

func Rfc3339TimeDiffSuppress(k, old, new string, d *schema.ResourceData) bool

Single-digit hour is equivalent to hour with leading zero e.g. suppress diff 1:00 => 01:00. Assume either value could be in either format.

func SelfLinkNameHash

func SelfLinkNameHash(selfLink interface{}) int

Hash the name path of a self link.

func SelfLinkRelativePathHash

func SelfLinkRelativePathHash(selfLink interface{}) int

Hash the relative path of a self link.

func ServiceAccountFQN

func ServiceAccountFQN(serviceAccount string, d TerraformResourceData, config *transport_tpg.Config) (string, error)
ServiceAccountFQN will attempt to generate the fully qualified name in the format of:

"projects/(-|<project>)/serviceAccounts/<service_account_id>@<project>.iam.gserviceaccount.com" A project is required if we are trying to build the FQN from a service account id and and error will be returned in this case if no project is set in the resource or the provider-level config

func SetAnnotationsDiff

func SetAnnotationsDiff(_ context.Context, d *schema.ResourceDiff, meta interface{}) error

func SetDataSourceAnnotations

func SetDataSourceAnnotations(d *schema.ResourceData) error

Sets the "annotations" field with the value of the field "effective_annotations" for data sources. When reading data source, as the annotations field is unavailable in the configuration of the data source, the "annotations" field will be empty. With this funciton, the labels "annotations" will have all of annotations in the resource.

func SetDataSourceLabels

func SetDataSourceLabels(d *schema.ResourceData) error

Sets the "labels" field and "terraform_labels" with the value of the field "effective_labels" for data sources. When reading data source, as the labels field is unavailable in the configuration of the data source, the "labels" field will be empty. With this funciton, the labels "field" will have all of labels in the resource.

func SetLabels

func SetLabels(labels map[string]string, d *schema.ResourceData, lineage string) error

SetLabels is called in the READ method of the resources to set the field "labels" and "terraform_labels" in the state based on the labels field in the configuration. So the field "labels" and "terraform_labels" in the state will only have the user defined labels. param "labels" is all of labels returned from API read reqeust. param "lineage" is the terraform lineage of the field and could be "labels" or "terraform_labels".

func SetLabelsDiff

func SetLabelsDiff(_ context.Context, d *schema.ResourceDiff, meta interface{}) error

func SetMetadataAnnotationsDiff

func SetMetadataAnnotationsDiff(_ context.Context, d *schema.ResourceDiff, meta interface{}) error

func SetMetadataLabelsDiff

func SetMetadataLabelsDiff(_ context.Context, d *schema.ResourceDiff, meta interface{}) error

func SetupTestResourceDataFromConfigMap

func SetupTestResourceDataFromConfigMap(t *testing.T, s map[string]*schema.Schema, configValues map[string]interface{}) *schema.ResourceData

Used to create populated schema.ResourceData structs in tests. Pass in a schema and a config map containing the fields and values you wish to set The returned schema.ResourceData can represent a configured resource, data source or provider.

func Sha256DiffSuppress

func Sha256DiffSuppress(_, old, new string, _ *schema.ResourceData) bool

Sha256DiffSuppress if old is the hex-encoded sha256 sum of new, treat them as equal

func SnakeToPascalCase

func SnakeToPascalCase(s string) string

func StoreResourceName

func StoreResourceName(resourceLink interface{}) string

func StringInSlice

func StringInSlice(arr []string, str string) bool

func StringScopeHashcode

func StringScopeHashcode(v interface{}) int

func StringSliceFromGolangSet

func StringSliceFromGolangSet(sset map[string]struct{}) []string

func StringToFixed64

func StringToFixed64(v string) (int64, error)

func TerraformLabelsStateUpgrade

func TerraformLabelsStateUpgrade(rawState map[string]interface{}) (map[string]interface{}, error)

Upgrade the field "terraform_labels" in the state to have the value of filed "labels" when it is not set but "labels" field is set in the state

func TimestampDiffSuppress

func TimestampDiffSuppress(format string) schema.SchemaDiffSuppressFunc

Types

type CommonOpError

type CommonOpError struct {
	*cloudresourcemanager.Status
}

Wraps Op.Error in an implementation of built-in Error

func (*CommonOpError) Error

func (e *CommonOpError) Error() string

type CommonOperation

type CommonOperation cloudresourcemanager.Operation

The cloud resource manager API operation is an example of one of many interchangeable API operations. Choose it somewhat arbitrarily to represent the "common" operation.

type CommonOperationWaiter

type CommonOperationWaiter struct {
	Op CommonOperation
}

func (*CommonOperationWaiter) Error

func (w *CommonOperationWaiter) Error() error

func (*CommonOperationWaiter) IsRetryable

func (w *CommonOperationWaiter) IsRetryable(error) bool

func (*CommonOperationWaiter) OpName

func (w *CommonOperationWaiter) OpName() string

func (*CommonOperationWaiter) PendingStates

func (w *CommonOperationWaiter) PendingStates() []string

func (*CommonOperationWaiter) SetOp

func (w *CommonOperationWaiter) SetOp(op interface{}) error

func (*CommonOperationWaiter) State

func (w *CommonOperationWaiter) State() string

func (*CommonOperationWaiter) TargetStates

func (w *CommonOperationWaiter) TargetStates() []string

type GlobalFieldValue

type GlobalFieldValue struct {
	Project string
	Name    string
	// contains filtered or unexported fields
}

func ParseGlobalFieldValue

func ParseGlobalFieldValue(resourceType, fieldValue, projectSchemaField string, d TerraformResourceData, config *transport_tpg.Config, isEmptyValid bool) (*GlobalFieldValue, error)

Parses a global field supporting 5 different formats: - https://www.googleapis.com/compute/ANY_VERSION/projects/{my_project}/global/{resource_type}/{resource_name} - projects/{my_project}/global/{resource_type}/{resource_name} - global/{resource_type}/{resource_name} - resource_name - "" (empty string). RelativeLink() returns empty if isEmptyValid is true.

If the project is not specified, it first tries to get the project from the `projectSchemaField` and then fallback on the default project.

func ParseHttpHealthCheckFieldValue

func ParseHttpHealthCheckFieldValue(healthCheck string, d TerraformResourceData, config *transport_tpg.Config) (*GlobalFieldValue, error)

func ParseInstanceTemplateFieldValue

func ParseInstanceTemplateFieldValue(instanceTemplate string, d TerraformResourceData, config *transport_tpg.Config) (*GlobalFieldValue, error)

func ParseMachineImageFieldValue

func ParseMachineImageFieldValue(machineImage string, d TerraformResourceData, config *transport_tpg.Config) (*GlobalFieldValue, error)

func ParseNetworkFieldValue

func ParseNetworkFieldValue(network string, d TerraformResourceData, config *transport_tpg.Config) (*GlobalFieldValue, error)

func ParseSecurityPolicyFieldValue

func ParseSecurityPolicyFieldValue(securityPolicy string, d TerraformResourceData, config *transport_tpg.Config) (*GlobalFieldValue, error)

func ParseSslCertificateFieldValue

func ParseSslCertificateFieldValue(sslCertificate string, d TerraformResourceData, config *transport_tpg.Config) (*GlobalFieldValue, error)
func (f GlobalFieldValue) RelativeLink() string

type LocationType

type LocationType int
const (
	Zonal LocationType = iota
	Regional
	Global
)

type OrganizationFieldValue

type OrganizationFieldValue struct {
	OrgId string
	Name  string
	// contains filtered or unexported fields
}

func ParseOrganizationCustomRoleName

func ParseOrganizationCustomRoleName(role string) (*OrganizationFieldValue, error)

func ParseOrganizationFieldValue

func ParseOrganizationFieldValue(resourceType, fieldValue string, isEmptyValid bool) (*OrganizationFieldValue, error)

Parses an organization field with the following formats: - organizations/{my_organizations}/{resource_type}/{resource_name}

func (f OrganizationFieldValue) RelativeLink() string

type ProjectFieldValue

type ProjectFieldValue struct {
	Project string
	Name    string

	ResourceType string
}

func ParseProjectFieldValue

func ParseProjectFieldValue(resourceType, fieldValue, projectSchemaField string, d TerraformResourceData, config *transport_tpg.Config, isEmptyValid bool) (*ProjectFieldValue, error)

Parses a project field with the following formats: - projects/{my_projects}/{resource_type}/{resource_name}

func (f ProjectFieldValue) RelativeLink() string

type RegionalFieldValue

type RegionalFieldValue struct {
	Project string
	Region  string
	Name    string
	// contains filtered or unexported fields
}

func ParseNetworkEndpointGroupRegionalFieldValue

func ParseNetworkEndpointGroupRegionalFieldValue(networkEndpointGroup string, d TerraformResourceData, config *transport_tpg.Config) (*RegionalFieldValue, error)

func ParseRegionDiskFieldValue

func ParseRegionDiskFieldValue(disk string, d TerraformResourceData, config *transport_tpg.Config) (*RegionalFieldValue, error)

func ParseRegionalFieldValue

func ParseRegionalFieldValue(resourceType, fieldValue, projectSchemaField, regionSchemaField, zoneSchemaField string, d TerraformResourceData, config *transport_tpg.Config, isEmptyValid bool) (*RegionalFieldValue, error)

Parses a regional field supporting 5 different formats: - https://www.googleapis.com/compute/ANY_VERSION/projects/{my_project}/regions/{region}/{resource_type}/{resource_name} - projects/{my_project}/regions/{region}/{resource_type}/{resource_name} - regions/{region}/{resource_type}/{resource_name} - resource_name - "" (empty string). RelativeLink() returns empty if isEmptyValid is true.

If the project is not specified, it first tries to get the project from the `projectSchemaField` and then fallback on the default project. If the region is not specified, see function documentation for `GetRegionFromSchema`.

func ParseSecurityPolicyRegionalFieldValue

func ParseSecurityPolicyRegionalFieldValue(securityPolicy string, d TerraformResourceData, config *transport_tpg.Config) (*RegionalFieldValue, error)

func ParseSubnetworkFieldValue

func ParseSubnetworkFieldValue(subnetwork string, d TerraformResourceData, config *transport_tpg.Config) (*RegionalFieldValue, error)

func ParseSubnetworkFieldValueWithProjectField

func ParseSubnetworkFieldValueWithProjectField(subnetwork, projectField string, d TerraformResourceData, config *transport_tpg.Config) (*RegionalFieldValue, error)
func (f RegionalFieldValue) RelativeLink() string

type ResourceDataMock

type ResourceDataMock struct {
	FieldsInSchema      map[string]interface{}
	FieldsWithHasChange []string
	// contains filtered or unexported fields
}

func (*ResourceDataMock) Get

func (d *ResourceDataMock) Get(key string) interface{}

func (*ResourceDataMock) GetOk

func (d *ResourceDataMock) GetOk(key string) (interface{}, bool)

func (*ResourceDataMock) GetOkExists

func (d *ResourceDataMock) GetOkExists(key string) (interface{}, bool)

func (*ResourceDataMock) GetProviderMeta

func (d *ResourceDataMock) GetProviderMeta(dst interface{}) error

func (*ResourceDataMock) HasChange

func (d *ResourceDataMock) HasChange(key string) bool

func (*ResourceDataMock) Id

func (d *ResourceDataMock) Id() string

func (*ResourceDataMock) Set

func (d *ResourceDataMock) Set(key string, value interface{}) error

func (*ResourceDataMock) SetId

func (d *ResourceDataMock) SetId(v string)

func (*ResourceDataMock) Timeout

func (d *ResourceDataMock) Timeout(key string) time.Duration

type ResourceDiffMock

type ResourceDiffMock struct {
	Before     map[string]interface{}
	After      map[string]interface{}
	Cleared    map[string]interface{}
	IsForceNew bool
}

func (*ResourceDiffMock) Clear

func (d *ResourceDiffMock) Clear(key string) error

func (*ResourceDiffMock) ForceNew

func (d *ResourceDiffMock) ForceNew(key string) error

func (*ResourceDiffMock) Get

func (d *ResourceDiffMock) Get(key string) interface{}

func (*ResourceDiffMock) GetChange

func (d *ResourceDiffMock) GetChange(key string) (interface{}, interface{})

func (*ResourceDiffMock) GetOk

func (d *ResourceDiffMock) GetOk(key string) (interface{}, bool)

func (*ResourceDiffMock) HasChange

func (d *ResourceDiffMock) HasChange(key string) bool

type TerraformResourceData

type TerraformResourceData interface {
	HasChange(string) bool
	GetOkExists(string) (interface{}, bool)
	GetOk(string) (interface{}, bool)
	Get(string) interface{}
	Set(string, interface{}) error
	SetId(string)
	Id() string
	GetProviderMeta(interface{}) error
	Timeout(key string) time.Duration
}

type TerraformResourceDataChange

type TerraformResourceDataChange interface {
	GetChange(string) (interface{}, interface{})
}

type TerraformResourceDiff

type TerraformResourceDiff interface {
	HasChange(string) bool
	GetChange(string) (interface{}, interface{})
	Get(string) interface{}
	GetOk(string) (interface{}, bool)
	Clear(string) error
	ForceNew(string) error
}

type Waiter

type Waiter interface {
	// State returns the current status of the operation.
	State() string

	// Error returns an error embedded in the operation we're waiting on, or nil
	// if the operation has no current error.
	Error() error

	// IsRetryable returns whether a given error should be retried.
	IsRetryable(error) bool

	// SetOp sets the operation we're waiting on in a Waiter struct so that it
	// can be used in other methods.
	SetOp(interface{}) error

	// QueryOp sends a request to the server to get the current status of the
	// operation. It's expected that QueryOp will return exactly one of an
	// operation or an error as non-nil, and that requests will be retried by
	// specific implementations of the method.
	QueryOp() (interface{}, error)

	// OpName is the name of the operation and is used to log its status.
	OpName() string

	// PendingStates contains the values of State() that cause us to continue
	// refreshing the operation.
	PendingStates() []string

	// TargetStates contain the values of State() that cause us to finish
	// refreshing the operation.
	TargetStates() []string
}

type ZonalFieldValue

type ZonalFieldValue struct {
	Project string
	Zone    string
	Name    string

	ResourceType string
}

func ParseAcceleratorFieldValue

func ParseAcceleratorFieldValue(accelerator string, d TerraformResourceData, config *transport_tpg.Config) (*ZonalFieldValue, error)

func ParseDiskFieldValue

func ParseDiskFieldValue(disk string, d TerraformResourceData, config *transport_tpg.Config) (*ZonalFieldValue, error)

func ParseInstanceFieldValue

func ParseInstanceFieldValue(instance string, d TerraformResourceData, config *transport_tpg.Config) (*ZonalFieldValue, error)

func ParseInstanceGroupFieldValue

func ParseInstanceGroupFieldValue(instanceGroup string, d TerraformResourceData, config *transport_tpg.Config) (*ZonalFieldValue, error)

func ParseMachineTypesFieldValue

func ParseMachineTypesFieldValue(machineType string, d TerraformResourceData, config *transport_tpg.Config) (*ZonalFieldValue, error)

func ParseNetworkEndpointGroupFieldValue

func ParseNetworkEndpointGroupFieldValue(networkEndpointGroup string, d TerraformResourceData, config *transport_tpg.Config) (*ZonalFieldValue, error)

func ParseZonalFieldValue

func ParseZonalFieldValue(resourceType, fieldValue, projectSchemaField, zoneSchemaField string, d TerraformResourceData, config *transport_tpg.Config, isEmptyValid bool) (*ZonalFieldValue, error)

Parses a zonal field supporting 5 different formats: - https://www.googleapis.com/compute/ANY_VERSION/projects/{my_project}/zones/{zone}/{resource_type}/{resource_name} - projects/{my_project}/zones/{zone}/{resource_type}/{resource_name} - zones/{zone}/{resource_type}/{resource_name} - resource_name - "" (empty string). RelativeLink() returns empty if isEmptyValid is true.

If the project is not specified, it first tries to get the project from the `projectSchemaField` and then fallback on the default project. If the zone is not specified, it takes the value of `zoneSchemaField`.

func ParseZonalFieldValueDiff

func ParseZonalFieldValueDiff(resourceType, fieldValue, projectSchemaField, zoneSchemaField string, d *schema.ResourceDiff, config *transport_tpg.Config, isEmptyValid bool) (*ZonalFieldValue, error)

Parses a zonal field supporting 5 different formats: - https://www.googleapis.com/compute/ANY_VERSION/projects/{my_project}/zones/{zone}/{resource_type}/{resource_name} - projects/{my_project}/zones/{zone}/{resource_type}/{resource_name} - zones/{zone}/{resource_type}/{resource_name} - resource_name - "" (empty string). RelativeLink() returns empty if isEmptyValid is true.

If the project is not specified, it first tries to get the project from the `projectSchemaField` and then fallback on the default project. If the zone is not specified, it takes the value of `zoneSchemaField`.

func (f ZonalFieldValue) RelativeLink() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL