schema
packageThis package is not in the latest version of its module.
Details
Validgo.mod file
The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license
Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version
Modules with tagged versions give importers more predictable builds.
Stable version
When a project reaches major version v1 it is considered stable.
- Learn more about best practices
Repository
Links
Documentation¶
Overview¶
Package schema contains all available schema functionality for resources.Resource schemas define the structure and value types for configuration,plan, and state data. Schemas are implemented via the resource.Resource typeSchema method.
Index¶
- type Attribute
- type Block
- type BoolAttribute
- func (a BoolAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a BoolAttribute) BoolDefaultValue() defaults.Bool
- func (a BoolAttribute) BoolPlanModifiers() []planmodifier.Bool
- func (a BoolAttribute) BoolValidators() []validator.Bool
- func (a BoolAttribute) Equal(o fwschema.Attribute) bool
- func (a BoolAttribute) GetDeprecationMessage() string
- func (a BoolAttribute) GetDescription() string
- func (a BoolAttribute) GetMarkdownDescription() string
- func (a BoolAttribute) GetType() attr.Type
- func (a BoolAttribute) IsComputed() bool
- func (a BoolAttribute) IsOptional() bool
- func (a BoolAttribute) IsOptionalForImport() bool
- func (a BoolAttribute) IsRequired() bool
- func (a BoolAttribute) IsRequiredForImport() bool
- func (a BoolAttribute) IsSensitive() bool
- func (a BoolAttribute) IsWriteOnly() bool
- func (a BoolAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type DynamicAttribute
- func (a DynamicAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a DynamicAttribute) DynamicDefaultValue() defaults.Dynamic
- func (a DynamicAttribute) DynamicPlanModifiers() []planmodifier.Dynamic
- func (a DynamicAttribute) DynamicValidators() []validator.Dynamic
- func (a DynamicAttribute) Equal(o fwschema.Attribute) bool
- func (a DynamicAttribute) GetDeprecationMessage() string
- func (a DynamicAttribute) GetDescription() string
- func (a DynamicAttribute) GetMarkdownDescription() string
- func (a DynamicAttribute) GetType() attr.Type
- func (a DynamicAttribute) IsComputed() bool
- func (a DynamicAttribute) IsOptional() bool
- func (a DynamicAttribute) IsOptionalForImport() bool
- func (a DynamicAttribute) IsRequired() bool
- func (a DynamicAttribute) IsRequiredForImport() bool
- func (a DynamicAttribute) IsSensitive() bool
- func (a DynamicAttribute) IsWriteOnly() bool
- func (a DynamicAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type Float32Attribute
- func (a Float32Attribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a Float32Attribute) Equal(o fwschema.Attribute) bool
- func (a Float32Attribute) Float32DefaultValue() defaults.Float32
- func (a Float32Attribute) Float32PlanModifiers() []planmodifier.Float32
- func (a Float32Attribute) Float32Validators() []validator.Float32
- func (a Float32Attribute) GetDeprecationMessage() string
- func (a Float32Attribute) GetDescription() string
- func (a Float32Attribute) GetMarkdownDescription() string
- func (a Float32Attribute) GetType() attr.Type
- func (a Float32Attribute) IsComputed() bool
- func (a Float32Attribute) IsOptional() bool
- func (a Float32Attribute) IsOptionalForImport() bool
- func (a Float32Attribute) IsRequired() bool
- func (a Float32Attribute) IsRequiredForImport() bool
- func (a Float32Attribute) IsSensitive() bool
- func (a Float32Attribute) IsWriteOnly() bool
- func (a Float32Attribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type Float64Attribute
- func (a Float64Attribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a Float64Attribute) Equal(o fwschema.Attribute) bool
- func (a Float64Attribute) Float64DefaultValue() defaults.Float64
- func (a Float64Attribute) Float64PlanModifiers() []planmodifier.Float64
- func (a Float64Attribute) Float64Validators() []validator.Float64
- func (a Float64Attribute) GetDeprecationMessage() string
- func (a Float64Attribute) GetDescription() string
- func (a Float64Attribute) GetMarkdownDescription() string
- func (a Float64Attribute) GetType() attr.Type
- func (a Float64Attribute) IsComputed() bool
- func (a Float64Attribute) IsOptional() bool
- func (a Float64Attribute) IsOptionalForImport() bool
- func (a Float64Attribute) IsRequired() bool
- func (a Float64Attribute) IsRequiredForImport() bool
- func (a Float64Attribute) IsSensitive() bool
- func (a Float64Attribute) IsWriteOnly() bool
- func (a Float64Attribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type Int32Attribute
- func (a Int32Attribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a Int32Attribute) Equal(o fwschema.Attribute) bool
- func (a Int32Attribute) GetDeprecationMessage() string
- func (a Int32Attribute) GetDescription() string
- func (a Int32Attribute) GetMarkdownDescription() string
- func (a Int32Attribute) GetType() attr.Type
- func (a Int32Attribute) Int32DefaultValue() defaults.Int32
- func (a Int32Attribute) Int32PlanModifiers() []planmodifier.Int32
- func (a Int32Attribute) Int32Validators() []validator.Int32
- func (a Int32Attribute) IsComputed() bool
- func (a Int32Attribute) IsOptional() bool
- func (a Int32Attribute) IsOptionalForImport() bool
- func (a Int32Attribute) IsRequired() bool
- func (a Int32Attribute) IsRequiredForImport() bool
- func (a Int32Attribute) IsSensitive() bool
- func (a Int32Attribute) IsWriteOnly() bool
- func (a Int32Attribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type Int64Attribute
- func (a Int64Attribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a Int64Attribute) Equal(o fwschema.Attribute) bool
- func (a Int64Attribute) GetDeprecationMessage() string
- func (a Int64Attribute) GetDescription() string
- func (a Int64Attribute) GetMarkdownDescription() string
- func (a Int64Attribute) GetType() attr.Type
- func (a Int64Attribute) Int64DefaultValue() defaults.Int64
- func (a Int64Attribute) Int64PlanModifiers() []planmodifier.Int64
- func (a Int64Attribute) Int64Validators() []validator.Int64
- func (a Int64Attribute) IsComputed() bool
- func (a Int64Attribute) IsOptional() bool
- func (a Int64Attribute) IsOptionalForImport() bool
- func (a Int64Attribute) IsRequired() bool
- func (a Int64Attribute) IsRequiredForImport() bool
- func (a Int64Attribute) IsSensitive() bool
- func (a Int64Attribute) IsWriteOnly() bool
- func (a Int64Attribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type ListAttribute
- func (a ListAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a ListAttribute) Equal(o fwschema.Attribute) bool
- func (a ListAttribute) GetDeprecationMessage() string
- func (a ListAttribute) GetDescription() string
- func (a ListAttribute) GetMarkdownDescription() string
- func (a ListAttribute) GetType() attr.Type
- func (a ListAttribute) IsComputed() bool
- func (a ListAttribute) IsOptional() bool
- func (a ListAttribute) IsOptionalForImport() bool
- func (a ListAttribute) IsRequired() bool
- func (a ListAttribute) IsRequiredForImport() bool
- func (a ListAttribute) IsSensitive() bool
- func (a ListAttribute) IsWriteOnly() bool
- func (a ListAttribute) ListDefaultValue() defaults.List
- func (a ListAttribute) ListPlanModifiers() []planmodifier.List
- func (a ListAttribute) ListValidators() []validator.List
- func (a ListAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type ListNestedAttribute
- func (a ListNestedAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a ListNestedAttribute) Equal(o fwschema.Attribute) bool
- func (a ListNestedAttribute) GetDeprecationMessage() string
- func (a ListNestedAttribute) GetDescription() string
- func (a ListNestedAttribute) GetMarkdownDescription() string
- func (a ListNestedAttribute) GetNestedObject() fwschema.NestedAttributeObject
- func (a ListNestedAttribute) GetNestingMode() fwschema.NestingMode
- func (a ListNestedAttribute) GetType() attr.Type
- func (a ListNestedAttribute) IsComputed() bool
- func (a ListNestedAttribute) IsOptional() bool
- func (a ListNestedAttribute) IsOptionalForImport() bool
- func (a ListNestedAttribute) IsRequired() bool
- func (a ListNestedAttribute) IsRequiredForImport() bool
- func (a ListNestedAttribute) IsSensitive() bool
- func (a ListNestedAttribute) IsWriteOnly() bool
- func (a ListNestedAttribute) ListDefaultValue() defaults.List
- func (a ListNestedAttribute) ListPlanModifiers() []planmodifier.List
- func (a ListNestedAttribute) ListValidators() []validator.List
- func (a ListNestedAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type ListNestedBlock
- func (b ListNestedBlock) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (b ListNestedBlock) Equal(o fwschema.Block) bool
- func (b ListNestedBlock) GetDeprecationMessage() string
- func (b ListNestedBlock) GetDescription() string
- func (b ListNestedBlock) GetMarkdownDescription() string
- func (b ListNestedBlock) GetNestedObject() fwschema.NestedBlockObject
- func (b ListNestedBlock) GetNestingMode() fwschema.BlockNestingMode
- func (b ListNestedBlock) ListPlanModifiers() []planmodifier.List
- func (b ListNestedBlock) ListValidators() []validator.List
- func (b ListNestedBlock) Type() attr.Type
- func (b ListNestedBlock) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type MapAttribute
- func (a MapAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a MapAttribute) Equal(o fwschema.Attribute) bool
- func (a MapAttribute) GetDeprecationMessage() string
- func (a MapAttribute) GetDescription() string
- func (a MapAttribute) GetMarkdownDescription() string
- func (a MapAttribute) GetType() attr.Type
- func (a MapAttribute) IsComputed() bool
- func (a MapAttribute) IsOptional() bool
- func (a MapAttribute) IsOptionalForImport() bool
- func (a MapAttribute) IsRequired() bool
- func (a MapAttribute) IsRequiredForImport() bool
- func (a MapAttribute) IsSensitive() bool
- func (a MapAttribute) IsWriteOnly() bool
- func (a MapAttribute) MapDefaultValue() defaults.Map
- func (a MapAttribute) MapPlanModifiers() []planmodifier.Map
- func (a MapAttribute) MapValidators() []validator.Map
- func (a MapAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type MapNestedAttribute
- func (a MapNestedAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a MapNestedAttribute) Equal(o fwschema.Attribute) bool
- func (a MapNestedAttribute) GetDeprecationMessage() string
- func (a MapNestedAttribute) GetDescription() string
- func (a MapNestedAttribute) GetMarkdownDescription() string
- func (a MapNestedAttribute) GetNestedObject() fwschema.NestedAttributeObject
- func (a MapNestedAttribute) GetNestingMode() fwschema.NestingMode
- func (a MapNestedAttribute) GetType() attr.Type
- func (a MapNestedAttribute) IsComputed() bool
- func (a MapNestedAttribute) IsOptional() bool
- func (a MapNestedAttribute) IsOptionalForImport() bool
- func (a MapNestedAttribute) IsRequired() bool
- func (a MapNestedAttribute) IsRequiredForImport() bool
- func (a MapNestedAttribute) IsSensitive() bool
- func (a MapNestedAttribute) IsWriteOnly() bool
- func (a MapNestedAttribute) MapDefaultValue() defaults.Map
- func (a MapNestedAttribute) MapPlanModifiers() []planmodifier.Map
- func (a MapNestedAttribute) MapValidators() []validator.Map
- func (a MapNestedAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type NestedAttribute
- type NestedAttributeObject
- func (o NestedAttributeObject) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (any, error)
- func (o NestedAttributeObject) Equal(other fwschema.NestedAttributeObject) bool
- func (o NestedAttributeObject) GetAttributes() fwschema.UnderlyingAttributes
- func (o NestedAttributeObject) ObjectPlanModifiers() []planmodifier.Object
- func (o NestedAttributeObject) ObjectValidators() []validator.Object
- func (o NestedAttributeObject) Type() basetypes.ObjectTypable
- type NestedBlockObject
- func (o NestedBlockObject) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (any, error)
- func (o NestedBlockObject) Equal(other fwschema.NestedBlockObject) bool
- func (o NestedBlockObject) GetAttributes() fwschema.UnderlyingAttributes
- func (o NestedBlockObject) GetBlocks() map[string]fwschema.Block
- func (o NestedBlockObject) ObjectPlanModifiers() []planmodifier.Object
- func (o NestedBlockObject) ObjectValidators() []validator.Object
- func (o NestedBlockObject) Type() basetypes.ObjectTypable
- type NumberAttribute
- func (a NumberAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a NumberAttribute) Equal(o fwschema.Attribute) bool
- func (a NumberAttribute) GetDeprecationMessage() string
- func (a NumberAttribute) GetDescription() string
- func (a NumberAttribute) GetMarkdownDescription() string
- func (a NumberAttribute) GetType() attr.Type
- func (a NumberAttribute) IsComputed() bool
- func (a NumberAttribute) IsOptional() bool
- func (a NumberAttribute) IsOptionalForImport() bool
- func (a NumberAttribute) IsRequired() bool
- func (a NumberAttribute) IsRequiredForImport() bool
- func (a NumberAttribute) IsSensitive() bool
- func (a NumberAttribute) IsWriteOnly() bool
- func (a NumberAttribute) NumberDefaultValue() defaults.Number
- func (a NumberAttribute) NumberPlanModifiers() []planmodifier.Number
- func (a NumberAttribute) NumberValidators() []validator.Number
- func (a NumberAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type ObjectAttribute
- func (a ObjectAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a ObjectAttribute) Equal(o fwschema.Attribute) bool
- func (a ObjectAttribute) GetDeprecationMessage() string
- func (a ObjectAttribute) GetDescription() string
- func (a ObjectAttribute) GetMarkdownDescription() string
- func (a ObjectAttribute) GetType() attr.Type
- func (a ObjectAttribute) IsComputed() bool
- func (a ObjectAttribute) IsOptional() bool
- func (a ObjectAttribute) IsOptionalForImport() bool
- func (a ObjectAttribute) IsRequired() bool
- func (a ObjectAttribute) IsRequiredForImport() bool
- func (a ObjectAttribute) IsSensitive() bool
- func (a ObjectAttribute) IsWriteOnly() bool
- func (a ObjectAttribute) ObjectDefaultValue() defaults.Object
- func (a ObjectAttribute) ObjectPlanModifiers() []planmodifier.Object
- func (a ObjectAttribute) ObjectValidators() []validator.Object
- func (a ObjectAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type Schema
- func (s Schema) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (any, error)
- func (s Schema) AttributeAtPath(ctx context.Context, p path.Path) (fwschema.Attribute, diag.Diagnostics)
- func (s Schema) AttributeAtTerraformPath(ctx context.Context, p *tftypes.AttributePath) (fwschema.Attribute, error)
- func (s Schema) GetAttributes() map[string]fwschema.Attribute
- func (s Schema) GetBlocks() map[string]fwschema.Block
- func (s Schema) GetDeprecationMessage() string
- func (s Schema) GetDescription() string
- func (s Schema) GetMarkdownDescription() string
- func (s Schema) GetVersion() int64
- func (s Schema) Type() attr.Type
- func (s Schema) TypeAtPath(ctx context.Context, p path.Path) (attr.Type, diag.Diagnostics)
- func (s Schema) TypeAtTerraformPath(ctx context.Context, p *tftypes.AttributePath) (attr.Type, error)
- func (s Schema) Validate() diag.Diagnosticsdeprecated
- func (s Schema) ValidateImplementation(ctx context.Context) diag.Diagnostics
- type SetAttribute
- func (a SetAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a SetAttribute) Equal(o fwschema.Attribute) bool
- func (a SetAttribute) GetDeprecationMessage() string
- func (a SetAttribute) GetDescription() string
- func (a SetAttribute) GetMarkdownDescription() string
- func (a SetAttribute) GetType() attr.Type
- func (a SetAttribute) IsComputed() bool
- func (a SetAttribute) IsOptional() bool
- func (a SetAttribute) IsOptionalForImport() bool
- func (a SetAttribute) IsRequired() bool
- func (a SetAttribute) IsRequiredForImport() bool
- func (a SetAttribute) IsSensitive() bool
- func (a SetAttribute) IsWriteOnly() bool
- func (a SetAttribute) SetDefaultValue() defaults.Set
- func (a SetAttribute) SetPlanModifiers() []planmodifier.Set
- func (a SetAttribute) SetValidators() []validator.Set
- func (a SetAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type SetNestedAttribute
- func (a SetNestedAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a SetNestedAttribute) Equal(o fwschema.Attribute) bool
- func (a SetNestedAttribute) GetDeprecationMessage() string
- func (a SetNestedAttribute) GetDescription() string
- func (a SetNestedAttribute) GetMarkdownDescription() string
- func (a SetNestedAttribute) GetNestedObject() fwschema.NestedAttributeObject
- func (a SetNestedAttribute) GetNestingMode() fwschema.NestingMode
- func (a SetNestedAttribute) GetType() attr.Type
- func (a SetNestedAttribute) IsComputed() bool
- func (a SetNestedAttribute) IsOptional() bool
- func (a SetNestedAttribute) IsOptionalForImport() bool
- func (a SetNestedAttribute) IsRequired() bool
- func (a SetNestedAttribute) IsRequiredForImport() bool
- func (a SetNestedAttribute) IsSensitive() bool
- func (a SetNestedAttribute) IsWriteOnly() bool
- func (a SetNestedAttribute) SetDefaultValue() defaults.Set
- func (a SetNestedAttribute) SetPlanModifiers() []planmodifier.Set
- func (a SetNestedAttribute) SetValidators() []validator.Set
- func (a SetNestedAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type SetNestedBlock
- func (b SetNestedBlock) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (b SetNestedBlock) Equal(o fwschema.Block) bool
- func (b SetNestedBlock) GetDeprecationMessage() string
- func (b SetNestedBlock) GetDescription() string
- func (b SetNestedBlock) GetMarkdownDescription() string
- func (b SetNestedBlock) GetNestedObject() fwschema.NestedBlockObject
- func (b SetNestedBlock) GetNestingMode() fwschema.BlockNestingMode
- func (b SetNestedBlock) SetPlanModifiers() []planmodifier.Set
- func (b SetNestedBlock) SetValidators() []validator.Set
- func (b SetNestedBlock) Type() attr.Type
- func (b SetNestedBlock) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type SingleNestedAttribute
- func (a SingleNestedAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a SingleNestedAttribute) Equal(o fwschema.Attribute) bool
- func (a SingleNestedAttribute) GetAttributes() fwschema.UnderlyingAttributes
- func (a SingleNestedAttribute) GetDeprecationMessage() string
- func (a SingleNestedAttribute) GetDescription() string
- func (a SingleNestedAttribute) GetMarkdownDescription() string
- func (a SingleNestedAttribute) GetNestedObject() fwschema.NestedAttributeObject
- func (a SingleNestedAttribute) GetNestingMode() fwschema.NestingMode
- func (a SingleNestedAttribute) GetType() attr.Type
- func (a SingleNestedAttribute) IsComputed() bool
- func (a SingleNestedAttribute) IsOptional() bool
- func (a SingleNestedAttribute) IsOptionalForImport() bool
- func (a SingleNestedAttribute) IsRequired() bool
- func (a SingleNestedAttribute) IsRequiredForImport() bool
- func (a SingleNestedAttribute) IsSensitive() bool
- func (a SingleNestedAttribute) IsWriteOnly() bool
- func (a SingleNestedAttribute) ObjectDefaultValue() defaults.Object
- func (a SingleNestedAttribute) ObjectPlanModifiers() []planmodifier.Object
- func (a SingleNestedAttribute) ObjectValidators() []validator.Object
- func (a SingleNestedAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
- type SingleNestedBlock
- func (b SingleNestedBlock) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (b SingleNestedBlock) Equal(o fwschema.Block) bool
- func (b SingleNestedBlock) GetDeprecationMessage() string
- func (b SingleNestedBlock) GetDescription() string
- func (b SingleNestedBlock) GetMarkdownDescription() string
- func (b SingleNestedBlock) GetNestedObject() fwschema.NestedBlockObject
- func (b SingleNestedBlock) GetNestingMode() fwschema.BlockNestingMode
- func (b SingleNestedBlock) ObjectPlanModifiers() []planmodifier.Object
- func (b SingleNestedBlock) ObjectValidators() []validator.Object
- func (b SingleNestedBlock) Type() attr.Type
- type StringAttribute
- func (a StringAttribute) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (interface{}, error)
- func (a StringAttribute) Equal(o fwschema.Attribute) bool
- func (a StringAttribute) GetDeprecationMessage() string
- func (a StringAttribute) GetDescription() string
- func (a StringAttribute) GetMarkdownDescription() string
- func (a StringAttribute) GetType() attr.Type
- func (a StringAttribute) IsComputed() bool
- func (a StringAttribute) IsOptional() bool
- func (a StringAttribute) IsOptionalForImport() bool
- func (a StringAttribute) IsRequired() bool
- func (a StringAttribute) IsRequiredForImport() bool
- func (a StringAttribute) IsSensitive() bool
- func (a StringAttribute) IsWriteOnly() bool
- func (a StringAttribute) StringDefaultValue() defaults.String
- func (a StringAttribute) StringPlanModifiers() []planmodifier.String
- func (a StringAttribute) StringValidators() []validator.String
- func (a StringAttribute) ValidateImplementation(ctx context.Context, req fwschema.ValidateImplementationRequest, ...)
Constants¶
This section is empty.
Variables¶
This section is empty.
Functions¶
This section is empty.
Types¶
typeAttribute¶
Attribute define a value field inside the Schema. Implementations in thispackage include:
- BoolAttribute
- DynamicAttribute
- Float32Attribute
- Float64Attribute
- Int32Attribute
- Int64Attribute
- ListAttribute
- MapAttribute
- NumberAttribute
- ObjectAttribute
- SetAttribute
- StringAttribute
Additionally, the NestedAttribute interface extends Attribute with nestedattributes. Only supported in protocol version 6. Implementations in thispackage include:
- ListNestedAttribute
- MapNestedAttribute
- SetNestedAttribute
- SingleNestedAttribute
In practitioner configurations, an equals sign (=) is required to setthe value.Configuration Reference
typeBlock¶
Block defines a structural field inside a Schema. Implementations in thispackage include:
- ListNestedBlock
- SetNestedBlock
- SingleNestedBlock
In practitioner configurations, an equals sign (=) cannot be used to set thevalue. Blocks are instead repeated as necessary, or require the use ofDynamic Block Expressions.
Prefer NestedAttribute over Block. Blocks should typically be used forconfiguration compatibility with previously existing schemas from an olderTerraform Plugin SDK. Efforts should be made to convert from Block toNestedAttribute as a breaking change for practitioners.
typeBoolAttribute¶
type BoolAttribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.BoolType. When retrieving data, the basetypes.BoolValuable// associated with this custom type must be used in place of types.Bool.CustomTypebasetypes.BoolTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Bool// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Bool// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Bool// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}BoolAttribute represents a schema attribute that is a boolean. Whenretrieving the value for this attribute, use types.Bool as the value typeunless the CustomType field is set.
Terraform configurations configure this attribute using expressions thatreturn a boolean or directly via the true/false keywords.
example_attribute = true
Terraform configurations reference this attribute using the attribute name.
.example_attribute
func (BoolAttribute)ApplyTerraform5AttributePathStep¶
func (aBoolAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a BoolAttribute.
func (BoolAttribute)BoolDefaultValue¶added inv1.2.0
func (aBoolAttribute) BoolDefaultValue()defaults.Bool
BoolDefaultValue returns the Default field value.
func (BoolAttribute)BoolPlanModifiers¶
func (aBoolAttribute) BoolPlanModifiers() []planmodifier.Bool
BoolPlanModifiers returns the PlanModifiers field value.
func (BoolAttribute)BoolValidators¶
func (aBoolAttribute) BoolValidators() []validator.Bool
BoolValidators returns the Validators field value.
func (BoolAttribute)Equal¶
func (aBoolAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a BoolAttributeand all fields are equal.
func (BoolAttribute)GetDeprecationMessage¶
func (aBoolAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (BoolAttribute)GetDescription¶
func (aBoolAttribute) GetDescription()string
GetDescription returns the Description field value.
func (BoolAttribute)GetMarkdownDescription¶
func (aBoolAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (BoolAttribute)GetType¶
func (aBoolAttribute) GetType()attr.Type
GetType returns types.StringType or the CustomType field value if defined.
func (BoolAttribute)IsComputed¶
func (aBoolAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (BoolAttribute)IsOptional¶
func (aBoolAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (BoolAttribute)IsOptionalForImport¶added inv1.15.0
func (aBoolAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (BoolAttribute)IsRequired¶
func (aBoolAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (BoolAttribute)IsRequiredForImport¶added inv1.15.0
func (aBoolAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (BoolAttribute)IsSensitive¶
func (aBoolAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (BoolAttribute)IsWriteOnly¶added inv1.14.0
func (aBoolAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (BoolAttribute)ValidateImplementation¶added inv1.3.0
func (aBoolAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeDynamicAttribute¶added inv1.7.0
type DynamicAttribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.DynamicType. When retrieving data, the basetypes.DynamicValuable// associated with this custom type must be used in place of types.Dynamic.CustomTypebasetypes.DynamicTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Dynamic// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Dynamic// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Dynamic// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}DynamicAttribute represents a schema attribute that is a dynamic, ratherthan a single static type. Static types are always preferable over dynamictypes in Terraform as practitioners will receive less helpful configurationassistance from validation error diagnostics and editor integrations. Whenretrieving the value for this attribute, use types.Dynamic as the value typeunless the CustomType field is set.
The concrete value type for a dynamic is determined at runtime in this order:
- By Terraform, if defined in the configuration (if Required or Optional).
- By the provider (if Computed).
Once the concrete value type has been determined, it must remain consistent betweenplan and apply or Terraform will return an error.
func (DynamicAttribute)ApplyTerraform5AttributePathStep¶added inv1.7.0
func (aDynamicAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a DynamicAttribute.
func (DynamicAttribute)DynamicDefaultValue¶added inv1.7.0
func (aDynamicAttribute) DynamicDefaultValue()defaults.Dynamic
DynamicDefaultValue returns the Default field value.
func (DynamicAttribute)DynamicPlanModifiers¶added inv1.7.0
func (aDynamicAttribute) DynamicPlanModifiers() []planmodifier.Dynamic
DynamicPlanModifiers returns the PlanModifiers field value.
func (DynamicAttribute)DynamicValidators¶added inv1.7.0
func (aDynamicAttribute) DynamicValidators() []validator.Dynamic
DynamicValidators returns the Validators field value.
func (DynamicAttribute)Equal¶added inv1.7.0
func (aDynamicAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a DynamicAttributeand all fields are equal.
func (DynamicAttribute)GetDeprecationMessage¶added inv1.7.0
func (aDynamicAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (DynamicAttribute)GetDescription¶added inv1.7.0
func (aDynamicAttribute) GetDescription()string
GetDescription returns the Description field value.
func (DynamicAttribute)GetMarkdownDescription¶added inv1.7.0
func (aDynamicAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (DynamicAttribute)GetType¶added inv1.7.0
func (aDynamicAttribute) GetType()attr.Type
GetType returns types.DynamicType or the CustomType field value if defined.
func (DynamicAttribute)IsComputed¶added inv1.7.0
func (aDynamicAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (DynamicAttribute)IsOptional¶added inv1.7.0
func (aDynamicAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (DynamicAttribute)IsOptionalForImport¶added inv1.15.0
func (aDynamicAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (DynamicAttribute)IsRequired¶added inv1.7.0
func (aDynamicAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (DynamicAttribute)IsRequiredForImport¶added inv1.15.0
func (aDynamicAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (DynamicAttribute)IsSensitive¶added inv1.7.0
func (aDynamicAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (DynamicAttribute)IsWriteOnly¶added inv1.14.0
func (aDynamicAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (DynamicAttribute)ValidateImplementation¶added inv1.7.0
func (aDynamicAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeFloat32Attribute¶added inv1.10.0
type Float32Attribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.Float32Type. When retrieving data, the basetypes.Float32Valuable// associated with this custom type must be used in place of types.Float32.CustomTypebasetypes.Float32Typable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Float32// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Float32// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Float32// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}Float32Attribute represents a schema attribute that is a 32-bit floatingpoint number. When retrieving the value for this attribute, usetypes.Float32 as the value type unless the CustomType field is set.
Use Int32Attribute for 32-bit integer attributes or NumberAttribute for512-bit generic number attributes.
Terraform configurations configure this attribute using expressions thatreturn a number or directly via a floating point value.
example_attribute = 123.45
Terraform configurations reference this attribute using the attribute name.
.example_attribute
func (Float32Attribute)ApplyTerraform5AttributePathStep¶added inv1.10.0
func (aFloat32Attribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a Float32Attribute.
func (Float32Attribute)Equal¶added inv1.10.0
func (aFloat32Attribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a Float32Attributeand all fields are equal.
func (Float32Attribute)Float32DefaultValue¶added inv1.10.0
func (aFloat32Attribute) Float32DefaultValue()defaults.Float32
Float32DefaultValue returns the Default field value.
func (Float32Attribute)Float32PlanModifiers¶added inv1.10.0
func (aFloat32Attribute) Float32PlanModifiers() []planmodifier.Float32
Float32PlanModifiers returns the PlanModifiers field value.
func (Float32Attribute)Float32Validators¶added inv1.10.0
func (aFloat32Attribute) Float32Validators() []validator.Float32
Float32Validators returns the Validators field value.
func (Float32Attribute)GetDeprecationMessage¶added inv1.10.0
func (aFloat32Attribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (Float32Attribute)GetDescription¶added inv1.10.0
func (aFloat32Attribute) GetDescription()string
GetDescription returns the Description field value.
func (Float32Attribute)GetMarkdownDescription¶added inv1.10.0
func (aFloat32Attribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (Float32Attribute)GetType¶added inv1.10.0
func (aFloat32Attribute) GetType()attr.Type
GetType returns types.Float32Type or the CustomType field value if defined.
func (Float32Attribute)IsComputed¶added inv1.10.0
func (aFloat32Attribute) IsComputed()bool
IsComputed returns the Computed field value.
func (Float32Attribute)IsOptional¶added inv1.10.0
func (aFloat32Attribute) IsOptional()bool
IsOptional returns the Optional field value.
func (Float32Attribute)IsOptionalForImport¶added inv1.15.0
func (aFloat32Attribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Float32Attribute)IsRequired¶added inv1.10.0
func (aFloat32Attribute) IsRequired()bool
IsRequired returns the Required field value.
func (Float32Attribute)IsRequiredForImport¶added inv1.15.0
func (aFloat32Attribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Float32Attribute)IsSensitive¶added inv1.10.0
func (aFloat32Attribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (Float32Attribute)IsWriteOnly¶added inv1.14.0
func (aFloat32Attribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (Float32Attribute)ValidateImplementation¶added inv1.10.0
func (aFloat32Attribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeFloat64Attribute¶
type Float64Attribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.Float64Type. When retrieving data, the basetypes.Float64Valuable// associated with this custom type must be used in place of types.Float64.CustomTypebasetypes.Float64Typable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Float64// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Float64// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Float64// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}Float64Attribute represents a schema attribute that is a 64-bit floatingpoint number. When retrieving the value for this attribute, usetypes.Float64 as the value type unless the CustomType field is set.
Use Int64Attribute for 64-bit integer attributes or NumberAttribute for512-bit generic number attributes.
Terraform configurations configure this attribute using expressions thatreturn a number or directly via a floating point value.
example_attribute = 123.45
Terraform configurations reference this attribute using the attribute name.
.example_attribute
func (Float64Attribute)ApplyTerraform5AttributePathStep¶
func (aFloat64Attribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a Float64Attribute.
func (Float64Attribute)Equal¶
func (aFloat64Attribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a Float64Attributeand all fields are equal.
func (Float64Attribute)Float64DefaultValue¶added inv1.2.0
func (aFloat64Attribute) Float64DefaultValue()defaults.Float64
Float64DefaultValue returns the Default field value.
func (Float64Attribute)Float64PlanModifiers¶
func (aFloat64Attribute) Float64PlanModifiers() []planmodifier.Float64
Float64PlanModifiers returns the PlanModifiers field value.
func (Float64Attribute)Float64Validators¶
func (aFloat64Attribute) Float64Validators() []validator.Float64
Float64Validators returns the Validators field value.
func (Float64Attribute)GetDeprecationMessage¶
func (aFloat64Attribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (Float64Attribute)GetDescription¶
func (aFloat64Attribute) GetDescription()string
GetDescription returns the Description field value.
func (Float64Attribute)GetMarkdownDescription¶
func (aFloat64Attribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (Float64Attribute)GetType¶
func (aFloat64Attribute) GetType()attr.Type
GetType returns types.Float64Type or the CustomType field value if defined.
func (Float64Attribute)IsComputed¶
func (aFloat64Attribute) IsComputed()bool
IsComputed returns the Computed field value.
func (Float64Attribute)IsOptional¶
func (aFloat64Attribute) IsOptional()bool
IsOptional returns the Optional field value.
func (Float64Attribute)IsOptionalForImport¶added inv1.15.0
func (aFloat64Attribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Float64Attribute)IsRequired¶
func (aFloat64Attribute) IsRequired()bool
IsRequired returns the Required field value.
func (Float64Attribute)IsRequiredForImport¶added inv1.15.0
func (aFloat64Attribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Float64Attribute)IsSensitive¶
func (aFloat64Attribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (Float64Attribute)IsWriteOnly¶added inv1.14.0
func (aFloat64Attribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (Float64Attribute)ValidateImplementation¶added inv1.3.0
func (aFloat64Attribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeInt32Attribute¶added inv1.10.0
type Int32Attribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.Int32Type. When retrieving data, the basetypes.Int32Valuable// associated with this custom type must be used in place of types.Int32.CustomTypebasetypes.Int32Typable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Int32// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Int32// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Int32// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}Int32Attribute represents a schema attribute that is a 32-bit integer.When retrieving the value for this attribute, use types.Int32 as the valuetype unless the CustomType field is set.
Use Float32Attribute for 32-bit floating point number attributes orNumberAttribute for 512-bit generic number attributes.
Terraform configurations configure this attribute using expressions thatreturn a number or directly via an integer value.
example_attribute = 123
Terraform configurations reference this attribute using the attribute name.
.example_attribute
func (Int32Attribute)ApplyTerraform5AttributePathStep¶added inv1.10.0
func (aInt32Attribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a Int32Attribute.
func (Int32Attribute)Equal¶added inv1.10.0
func (aInt32Attribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a Int32Attributeand all fields are equal.
func (Int32Attribute)GetDeprecationMessage¶added inv1.10.0
func (aInt32Attribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (Int32Attribute)GetDescription¶added inv1.10.0
func (aInt32Attribute) GetDescription()string
GetDescription returns the Description field value.
func (Int32Attribute)GetMarkdownDescription¶added inv1.10.0
func (aInt32Attribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (Int32Attribute)GetType¶added inv1.10.0
func (aInt32Attribute) GetType()attr.Type
GetType returns types.Int32Type or the CustomType field value if defined.
func (Int32Attribute)Int32DefaultValue¶added inv1.10.0
func (aInt32Attribute) Int32DefaultValue()defaults.Int32
Int32DefaultValue returns the Default field value.
func (Int32Attribute)Int32PlanModifiers¶added inv1.10.0
func (aInt32Attribute) Int32PlanModifiers() []planmodifier.Int32
Int32PlanModifiers returns the PlanModifiers field value.
func (Int32Attribute)Int32Validators¶added inv1.10.0
func (aInt32Attribute) Int32Validators() []validator.Int32
Int32Validators returns the Validators field value.
func (Int32Attribute)IsComputed¶added inv1.10.0
func (aInt32Attribute) IsComputed()bool
IsComputed returns the Computed field value.
func (Int32Attribute)IsOptional¶added inv1.10.0
func (aInt32Attribute) IsOptional()bool
IsOptional returns the Optional field value.
func (Int32Attribute)IsOptionalForImport¶added inv1.15.0
func (aInt32Attribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Int32Attribute)IsRequired¶added inv1.10.0
func (aInt32Attribute) IsRequired()bool
IsRequired returns the Required field value.
func (Int32Attribute)IsRequiredForImport¶added inv1.15.0
func (aInt32Attribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Int32Attribute)IsSensitive¶added inv1.10.0
func (aInt32Attribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (Int32Attribute)IsWriteOnly¶added inv1.14.0
func (aInt32Attribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (Int32Attribute)ValidateImplementation¶added inv1.10.0
func (aInt32Attribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeInt64Attribute¶
type Int64Attribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.Int64Type. When retrieving data, the basetypes.Int64Valuable// associated with this custom type must be used in place of types.Int64.CustomTypebasetypes.Int64Typable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Int64// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Int64// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Int64// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}Int64Attribute represents a schema attribute that is a 64-bit integer.When retrieving the value for this attribute, use types.Int64 as the valuetype unless the CustomType field is set.
Use Float64Attribute for 64-bit floating point number attributes orNumberAttribute for 512-bit generic number attributes.
Terraform configurations configure this attribute using expressions thatreturn a number or directly via an integer value.
example_attribute = 123
Terraform configurations reference this attribute using the attribute name.
.example_attribute
func (Int64Attribute)ApplyTerraform5AttributePathStep¶
func (aInt64Attribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a Int64Attribute.
func (Int64Attribute)Equal¶
func (aInt64Attribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a Int64Attributeand all fields are equal.
func (Int64Attribute)GetDeprecationMessage¶
func (aInt64Attribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (Int64Attribute)GetDescription¶
func (aInt64Attribute) GetDescription()string
GetDescription returns the Description field value.
func (Int64Attribute)GetMarkdownDescription¶
func (aInt64Attribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (Int64Attribute)GetType¶
func (aInt64Attribute) GetType()attr.Type
GetType returns types.Int64Type or the CustomType field value if defined.
func (Int64Attribute)Int64DefaultValue¶added inv1.2.0
func (aInt64Attribute) Int64DefaultValue()defaults.Int64
Int64DefaultValue returns the Default field value.
func (Int64Attribute)Int64PlanModifiers¶
func (aInt64Attribute) Int64PlanModifiers() []planmodifier.Int64
Int64PlanModifiers returns the PlanModifiers field value.
func (Int64Attribute)Int64Validators¶
func (aInt64Attribute) Int64Validators() []validator.Int64
Int64Validators returns the Validators field value.
func (Int64Attribute)IsComputed¶
func (aInt64Attribute) IsComputed()bool
IsComputed returns the Computed field value.
func (Int64Attribute)IsOptional¶
func (aInt64Attribute) IsOptional()bool
IsOptional returns the Optional field value.
func (Int64Attribute)IsOptionalForImport¶added inv1.15.0
func (aInt64Attribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Int64Attribute)IsRequired¶
func (aInt64Attribute) IsRequired()bool
IsRequired returns the Required field value.
func (Int64Attribute)IsRequiredForImport¶added inv1.15.0
func (aInt64Attribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (Int64Attribute)IsSensitive¶
func (aInt64Attribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (Int64Attribute)IsWriteOnly¶added inv1.14.0
func (aInt64Attribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (Int64Attribute)ValidateImplementation¶added inv1.3.0
func (aInt64Attribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeListAttribute¶
type ListAttribute struct {// ElementType is the type for all elements of the list. This field must be// set.//// Element types that contain a dynamic type (i.e. types.Dynamic) are not supported.// If underlying dynamic values are required, replace this attribute definition with// DynamicAttribute instead.ElementTypeattr.Type// CustomType enables the use of a custom attribute type in place of the// default basetypes.ListType. When retrieving data, the basetypes.ListValuable// associated with this custom type must be used in place of types.List.CustomTypebasetypes.ListTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.List// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.List// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.List// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}ListAttribute represents a schema attribute that is a list with a singleelement type. When retrieving the value for this attribute, use types.Listas the value type unless the CustomType field is set. The ElementType fieldmust be set.
Use ListNestedAttribute if the underlying elements should be objects andrequire definition beyond type information.
Terraform configurations configure this attribute using expressions thatreturn a list or directly via square brace syntax.
# list of stringsexample_attribute = ["first", "second"]
Terraform configurations reference this attribute using expressions thataccept a list or an element directly via square brace 0-based index syntax:
# first known element.example_attribute[0]
func (ListAttribute)ApplyTerraform5AttributePathStep¶
func (aListAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the result of stepping into a listindex or an error.
func (ListAttribute)Equal¶
func (aListAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a ListAttributeand all fields are equal.
func (ListAttribute)GetDeprecationMessage¶
func (aListAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (ListAttribute)GetDescription¶
func (aListAttribute) GetDescription()string
GetDescription returns the Description field value.
func (ListAttribute)GetMarkdownDescription¶
func (aListAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (ListAttribute)GetType¶
func (aListAttribute) GetType()attr.Type
GetType returns types.ListType or the CustomType field value if defined.
func (ListAttribute)IsComputed¶
func (aListAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (ListAttribute)IsOptional¶
func (aListAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (ListAttribute)IsOptionalForImport¶added inv1.15.0
func (aListAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (ListAttribute)IsRequired¶
func (aListAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (ListAttribute)IsRequiredForImport¶added inv1.15.0
func (aListAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (ListAttribute)IsSensitive¶
func (aListAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (ListAttribute)IsWriteOnly¶added inv1.14.0
func (aListAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (ListAttribute)ListDefaultValue¶added inv1.2.0
func (aListAttribute) ListDefaultValue()defaults.List
ListDefaultValue returns the Default field value.
func (ListAttribute)ListPlanModifiers¶
func (aListAttribute) ListPlanModifiers() []planmodifier.List
ListPlanModifiers returns the PlanModifiers field value.
func (ListAttribute)ListValidators¶
func (aListAttribute) ListValidators() []validator.List
ListValidators returns the Validators field value.
func (ListAttribute)ValidateImplementation¶added inv1.3.0
func (aListAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeListNestedAttribute¶
type ListNestedAttribute struct {// NestedObject is the underlying object that contains nested attributes.// This field must be set.//// Nested attributes that contain a dynamic type (i.e. DynamicAttribute) are not supported.// If underlying dynamic values are required, replace this attribute definition with// DynamicAttribute instead.NestedObjectNestedAttributeObject// CustomType enables the use of a custom attribute type in place of the// default types.ListType of types.ObjectType. When retrieving data, the// basetypes.ListValuable associated with this custom type must be used in// place of types.List.CustomTypebasetypes.ListTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.List// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.List// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.List// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// If WriteOnly is true for a nested attribute, all of its child attributes// must also set WriteOnly to true and no child attribute can be Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}ListNestedAttribute represents an attribute that is a list of objects wherethe object attributes can be fully defined, including further nestedattributes. When retrieving the value for this attribute, use types.Listas the value type unless the CustomType field is set. The NestedObject fieldmust be set. Nested attributes are only compatible with protocol version 6.
Use ListAttribute if the underlying elements are of a single type and donot require definition beyond type information.
Terraform configurations configure this attribute using expressions thatreturn a list of objects or directly via square and curly brace syntax.
# list of objectsexample_attribute = [{nested_attribute = #...},]Terraform configurations reference this attribute using expressions thataccept a list of objects or an element directly via square brace 0-basedindex syntax:
# first known object.example_attribute[0]# first known object nested_attribute value.example_attribute[0].nested_attribute
func (ListNestedAttribute)ApplyTerraform5AttributePathStep¶
func (aListNestedAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the Attributes field value if stepis ElementKeyInt, otherwise returns an error.
func (ListNestedAttribute)Equal¶
func (aListNestedAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a ListNestedAttributeand all fields are equal.
func (ListNestedAttribute)GetDeprecationMessage¶
func (aListNestedAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (ListNestedAttribute)GetDescription¶
func (aListNestedAttribute) GetDescription()string
GetDescription returns the Description field value.
func (ListNestedAttribute)GetMarkdownDescription¶
func (aListNestedAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (ListNestedAttribute)GetNestedObject¶
func (aListNestedAttribute) GetNestedObject()fwschema.NestedAttributeObject
GetNestedObject returns the NestedObject field value.
func (ListNestedAttribute)GetNestingMode¶
func (aListNestedAttribute) GetNestingMode()fwschema.NestingMode
GetNestingMode always returns NestingModeList.
func (ListNestedAttribute)GetType¶
func (aListNestedAttribute) GetType()attr.Type
GetType returns ListType of ObjectType or CustomType.
func (ListNestedAttribute)IsComputed¶
func (aListNestedAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (ListNestedAttribute)IsOptional¶
func (aListNestedAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (ListNestedAttribute)IsOptionalForImport¶added inv1.15.0
func (aListNestedAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (ListNestedAttribute)IsRequired¶
func (aListNestedAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (ListNestedAttribute)IsRequiredForImport¶added inv1.15.0
func (aListNestedAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (ListNestedAttribute)IsSensitive¶
func (aListNestedAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (ListNestedAttribute)IsWriteOnly¶added inv1.14.0
func (aListNestedAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (ListNestedAttribute)ListDefaultValue¶added inv1.2.0
func (aListNestedAttribute) ListDefaultValue()defaults.List
ListDefaultValue returns the Default field value.
func (ListNestedAttribute)ListPlanModifiers¶
func (aListNestedAttribute) ListPlanModifiers() []planmodifier.List
ListPlanModifiers returns the PlanModifiers field value.
func (ListNestedAttribute)ListValidators¶
func (aListNestedAttribute) ListValidators() []validator.List
ListValidators returns the Validators field value.
func (ListNestedAttribute)ValidateImplementation¶added inv1.3.0
func (aListNestedAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeListNestedBlock¶
type ListNestedBlock struct {// NestedObject is the underlying object that contains nested attributes or// blocks. This field must be set.//// Nested attributes that contain a dynamic type (i.e. DynamicAttribute) are not supported.// If underlying dynamic values are required, replace this block definition with// a DynamicAttribute.NestedObjectNestedBlockObject// CustomType enables the use of a custom attribute type in place of the// default types.ListType of types.ObjectType. When retrieving data, the// basetypes.ListValuable associated with this custom type must be used in// place of types.List.CustomTypebasetypes.ListTypable// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.List// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.List}ListNestedBlock represents a block that is a list of objects wherethe object attributes can be fully defined, including further attributesor blocks. When retrieving the value for this block, use types.Listas the value type unless the CustomType field is set. The NestedObject fieldmust be set.
Prefer ListNestedAttribute over ListNestedBlock if the provider isusing protocol version 6. Nested attributes allow practitioners to configurevalues directly with expressions.
Terraform configurations configure this block repeatedly using curly bracesyntax without an equals (=) sign orDynamic Block Expressions.
# list of blocks with two elementsexample_block {nested_attribute = #...}example_block {nested_attribute = #...}Terraform configurations reference this block using expressions thataccept a list of objects or an element directly via square brace 0-basedindex syntax:
# first known object.example_block[0]# first known object nested_attribute value.example_block[0].nested_attribute
func (ListNestedBlock)ApplyTerraform5AttributePathStep¶
func (bListNestedBlock) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the NestedObject field value if stepis ElementKeyInt, otherwise returns an error.
func (ListNestedBlock)Equal¶
func (bListNestedBlock) Equal(ofwschema.Block)bool
Equal returns true if the given Block is ListNestedBlockand all fields are equal.
func (ListNestedBlock)GetDeprecationMessage¶
func (bListNestedBlock) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (ListNestedBlock)GetDescription¶
func (bListNestedBlock) GetDescription()string
GetDescription returns the Description field value.
func (ListNestedBlock)GetMarkdownDescription¶
func (bListNestedBlock) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (ListNestedBlock)GetNestedObject¶
func (bListNestedBlock) GetNestedObject()fwschema.NestedBlockObject
GetNestedObject returns the NestedObject field value.
func (ListNestedBlock)GetNestingMode¶
func (bListNestedBlock) GetNestingMode()fwschema.BlockNestingMode
GetNestingMode always returns BlockNestingModeList.
func (ListNestedBlock)ListPlanModifiers¶
func (bListNestedBlock) ListPlanModifiers() []planmodifier.List
ListPlanModifiers returns the PlanModifiers field value.
func (ListNestedBlock)ListValidators¶
func (bListNestedBlock) ListValidators() []validator.List
ListValidators returns the Validators field value.
func (ListNestedBlock)Type¶
func (bListNestedBlock) Type()attr.Type
Type returns ListType of ObjectType or CustomType.
func (ListNestedBlock)ValidateImplementation¶added inv1.7.0
func (bListNestedBlock) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the block to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeMapAttribute¶
type MapAttribute struct {// ElementType is the type for all elements of the map. This field must be// set.//// Element types that contain a dynamic type (i.e. types.Dynamic) are not supported.// If underlying dynamic values are required, replace this attribute definition with// DynamicAttribute instead.ElementTypeattr.Type// CustomType enables the use of a custom attribute type in place of the// default basetypes.MapType. When retrieving data, the basetypes.MapValuable// associated with this custom type must be used in place of types.Map.CustomTypebasetypes.MapTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Map// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Map// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Map// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}MapAttribute represents a schema attribute that is a map with a singleelement type. When retrieving the value for this attribute, use types.Mapas the value type unless the CustomType field is set. The ElementType fieldmust be set.
Use MapNestedAttribute if the underlying elements should be objects andrequire definition beyond type information.
Terraform configurations configure this attribute using expressions thatreturn a map or directly via curly brace syntax.
# map of stringsexample_attribute = {key1 = "first",key2 = "second",}Terraform configurations reference this attribute using expressions thataccept a map or an element directly via square brace string syntax:
# key1 known element.example_attribute["key1"]
func (MapAttribute)ApplyTerraform5AttributePathStep¶
func (aMapAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the result of stepping into a mapindex or an error.
func (MapAttribute)Equal¶
func (aMapAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a MapAttributeand all fields are equal.
func (MapAttribute)GetDeprecationMessage¶
func (aMapAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (MapAttribute)GetDescription¶
func (aMapAttribute) GetDescription()string
GetDescription returns the Description field value.
func (MapAttribute)GetMarkdownDescription¶
func (aMapAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (MapAttribute)GetType¶
func (aMapAttribute) GetType()attr.Type
GetType returns types.MapType or the CustomType field value if defined.
func (MapAttribute)IsComputed¶
func (aMapAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (MapAttribute)IsOptional¶
func (aMapAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (MapAttribute)IsOptionalForImport¶added inv1.15.0
func (aMapAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (MapAttribute)IsRequired¶
func (aMapAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (MapAttribute)IsRequiredForImport¶added inv1.15.0
func (aMapAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (MapAttribute)IsSensitive¶
func (aMapAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (MapAttribute)IsWriteOnly¶added inv1.14.0
func (aMapAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (MapAttribute)MapDefaultValue¶added inv1.2.0
func (aMapAttribute) MapDefaultValue()defaults.Map
MapDefaultValue returns the Default field value.
func (MapAttribute)MapPlanModifiers¶
func (aMapAttribute) MapPlanModifiers() []planmodifier.Map
MapPlanModifiers returns the PlanModifiers field value.
func (MapAttribute)MapValidators¶
func (aMapAttribute) MapValidators() []validator.Map
MapValidators returns the Validators field value.
func (MapAttribute)ValidateImplementation¶added inv1.3.0
func (aMapAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeMapNestedAttribute¶
type MapNestedAttribute struct {// NestedObject is the underlying object that contains nested attributes.// This field must be set.//// Nested attributes that contain a dynamic type (i.e. DynamicAttribute) are not supported.// If underlying dynamic values are required, replace this attribute definition with// DynamicAttribute instead.NestedObjectNestedAttributeObject// CustomType enables the use of a custom attribute type in place of the// default types.MapType of types.ObjectType. When retrieving data, the// basetypes.MapValuable associated with this custom type must be used in// place of types.Map.CustomTypebasetypes.MapTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Map// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Map// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Map// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// If WriteOnly is true for a nested attribute, all of its child attributes// must also set WriteOnly to true and no child attribute can be Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}MapNestedAttribute represents an attribute that is a map of objects wherethe object attributes can be fully defined, including further nestedattributes. When retrieving the value for this attribute, use types.Mapas the value type unless the CustomType field is set. The NestedObject fieldmust be set. Nested attributes are only compatible with protocol version 6.
Use MapAttribute if the underlying elements are of a single type and donot require definition beyond type information.
Terraform configurations configure this attribute using expressions thatreturn a map of objects or directly via curly brace syntax.
# map of objectsexample_attribute = {key = {nested_attribute = #...},]Terraform configurations reference this attribute using expressions thataccept a map of objects or an element directly via square brace stringsyntax:
# known object at key.example_attribute["key"]# known object nested_attribute value at key.example_attribute["key"].nested_attribute
func (MapNestedAttribute)ApplyTerraform5AttributePathStep¶
func (aMapNestedAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the Attributes field value if stepis ElementKeyString, otherwise returns an error.
func (MapNestedAttribute)Equal¶
func (aMapNestedAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a MapNestedAttributeand all fields are equal.
func (MapNestedAttribute)GetDeprecationMessage¶
func (aMapNestedAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (MapNestedAttribute)GetDescription¶
func (aMapNestedAttribute) GetDescription()string
GetDescription returns the Description field value.
func (MapNestedAttribute)GetMarkdownDescription¶
func (aMapNestedAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (MapNestedAttribute)GetNestedObject¶
func (aMapNestedAttribute) GetNestedObject()fwschema.NestedAttributeObject
GetNestedObject returns the NestedObject field value.
func (MapNestedAttribute)GetNestingMode¶
func (aMapNestedAttribute) GetNestingMode()fwschema.NestingMode
GetNestingMode always returns NestingModeMap.
func (MapNestedAttribute)GetType¶
func (aMapNestedAttribute) GetType()attr.Type
GetType returns MapType of ObjectType or CustomType.
func (MapNestedAttribute)IsComputed¶
func (aMapNestedAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (MapNestedAttribute)IsOptional¶
func (aMapNestedAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (MapNestedAttribute)IsOptionalForImport¶added inv1.15.0
func (aMapNestedAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (MapNestedAttribute)IsRequired¶
func (aMapNestedAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (MapNestedAttribute)IsRequiredForImport¶added inv1.15.0
func (aMapNestedAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (MapNestedAttribute)IsSensitive¶
func (aMapNestedAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (MapNestedAttribute)IsWriteOnly¶added inv1.14.0
func (aMapNestedAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (MapNestedAttribute)MapDefaultValue¶added inv1.2.0
func (aMapNestedAttribute) MapDefaultValue()defaults.Map
MapDefaultValue returns the Default field value.
func (MapNestedAttribute)MapPlanModifiers¶
func (aMapNestedAttribute) MapPlanModifiers() []planmodifier.Map
MapPlanModifiers returns the PlanModifiers field value.
func (MapNestedAttribute)MapValidators¶
func (aMapNestedAttribute) MapValidators() []validator.Map
MapValidators returns the Validators field value.
func (MapNestedAttribute)ValidateImplementation¶added inv1.3.0
func (aMapNestedAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeNestedAttribute¶
type NestedAttribute interface {Attributefwschema.NestedAttribute}Nested attributes are only compatible with protocol version 6.
typeNestedAttributeObject¶
type NestedAttributeObject struct {// Attributes is the mapping of underlying attribute names to attribute// definitions. This field must be set.Attributes map[string]Attribute// CustomType enables the use of a custom attribute type in place of the// default basetypes.ObjectType. When retrieving data, the basetypes.ObjectValuable// associated with this custom type must be used in place of types.Object.CustomTypebasetypes.ObjectTypable// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Object// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Object}NestedAttributeObject is the object containing the underlying attributesfor a ListNestedAttribute, MapNestedAttribute, SetNestedAttribute, orSingleNestedAttribute (automatically generated). When retrieving the valuefor this attribute, use types.Object as the value type unless the CustomTypefield is set. The Attributes field must be set. Nested attributes are onlycompatible with protocol version 6.
This object enables customizing and simplifying details within its parentNestedAttribute, therefore it cannot have Terraform schema fields such asRequired, Description, etc.
func (NestedAttributeObject)ApplyTerraform5AttributePathStep¶
func (oNestedAttributeObject) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (any,error)
ApplyTerraform5AttributePathStep performs an AttributeName step on theunderlying attributes or returns an error.
func (NestedAttributeObject)Equal¶
func (oNestedAttributeObject) Equal(otherfwschema.NestedAttributeObject)bool
Equal returns true if the given NestedAttributeObject is equivalent.
func (NestedAttributeObject)GetAttributes¶
func (oNestedAttributeObject) GetAttributes()fwschema.UnderlyingAttributes
GetAttributes returns the Attributes field value.
func (NestedAttributeObject)ObjectPlanModifiers¶
func (oNestedAttributeObject) ObjectPlanModifiers() []planmodifier.Object
ObjectPlanModifiers returns the PlanModifiers field value.
func (NestedAttributeObject)ObjectValidators¶
func (oNestedAttributeObject) ObjectValidators() []validator.Object
ObjectValidators returns the Validators field value.
func (NestedAttributeObject)Type¶
func (oNestedAttributeObject) Type()basetypes.ObjectTypable
Type returns the framework type of the NestedAttributeObject.
typeNestedBlockObject¶
type NestedBlockObject struct {// Attributes is the mapping of underlying attribute names to attribute// definitions.//// Names must only contain lowercase letters, numbers, and underscores.// Names must not collide with any Blocks names.Attributes map[string]Attribute// Blocks is the mapping of underlying block names to block definitions.//// Names must only contain lowercase letters, numbers, and underscores.// Names must not collide with any Attributes names.Blocks map[string]Block// CustomType enables the use of a custom attribute type in place of the// default basetypes.ObjectType. When retrieving data, the basetypes.ObjectValuable// associated with this custom type must be used in place of types.Object.CustomTypebasetypes.ObjectTypable// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Object// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Object}NestedBlockObject is the object containing the underlying attributes andblocks for a ListNestedBlock or SetNestedBlock. When retrieving the valuefor this attribute, use types.Object as the value type unless the CustomTypefield is set.
This object enables customizing and simplifying details within its parentBlock, therefore it cannot have Terraform schema fields such as Description,etc.
func (NestedBlockObject)ApplyTerraform5AttributePathStep¶
func (oNestedBlockObject) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (any,error)
ApplyTerraform5AttributePathStep performs an AttributeName step on theunderlying attributes or returns an error.
func (NestedBlockObject)Equal¶
func (oNestedBlockObject) Equal(otherfwschema.NestedBlockObject)bool
Equal returns true if the given NestedBlockObject is equivalent.
func (NestedBlockObject)GetAttributes¶
func (oNestedBlockObject) GetAttributes()fwschema.UnderlyingAttributes
GetAttributes returns the Attributes field value.
func (NestedBlockObject)GetBlocks¶
func (oNestedBlockObject) GetBlocks() map[string]fwschema.Block
GetAttributes returns the Blocks field value.
func (NestedBlockObject)ObjectPlanModifiers¶
func (oNestedBlockObject) ObjectPlanModifiers() []planmodifier.Object
ObjectPlanModifiers returns the PlanModifiers field value.
func (NestedBlockObject)ObjectValidators¶
func (oNestedBlockObject) ObjectValidators() []validator.Object
ObjectValidators returns the Validators field value.
func (NestedBlockObject)Type¶
func (oNestedBlockObject) Type()basetypes.ObjectTypable
Type returns the framework type of the NestedBlockObject.
typeNumberAttribute¶
type NumberAttribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.NumberType. When retrieving data, the basetypes.NumberValuable// associated with this custom type must be used in place of types.Number.CustomTypebasetypes.NumberTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Number// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Number// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Number// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}NumberAttribute represents a schema attribute that is a generic number withup to 512 bits of floating point or integer precision. When retrieving thevalue for this attribute, use types.Number as the value type unless theCustomType field is set.
Use Float64Attribute for 64-bit floating point number attributes orInt64Attribute for 64-bit integer number attributes.
Terraform configurations configure this attribute using expressions thatreturn a number or directly via a floating point or integer value.
example_attribute = 123
Terraform configurations reference this attribute using the attribute name.
.example_attribute
func (NumberAttribute)ApplyTerraform5AttributePathStep¶
func (aNumberAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a NumberAttribute.
func (NumberAttribute)Equal¶
func (aNumberAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a NumberAttributeand all fields are equal.
func (NumberAttribute)GetDeprecationMessage¶
func (aNumberAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (NumberAttribute)GetDescription¶
func (aNumberAttribute) GetDescription()string
GetDescription returns the Description field value.
func (NumberAttribute)GetMarkdownDescription¶
func (aNumberAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (NumberAttribute)GetType¶
func (aNumberAttribute) GetType()attr.Type
GetType returns types.NumberType or the CustomType field value if defined.
func (NumberAttribute)IsComputed¶
func (aNumberAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (NumberAttribute)IsOptional¶
func (aNumberAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (NumberAttribute)IsOptionalForImport¶added inv1.15.0
func (aNumberAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (NumberAttribute)IsRequired¶
func (aNumberAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (NumberAttribute)IsRequiredForImport¶added inv1.15.0
func (aNumberAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (NumberAttribute)IsSensitive¶
func (aNumberAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (NumberAttribute)IsWriteOnly¶added inv1.14.0
func (aNumberAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (NumberAttribute)NumberDefaultValue¶added inv1.2.0
func (aNumberAttribute) NumberDefaultValue()defaults.Number
NumberDefaultValue returns the Default field value.
func (NumberAttribute)NumberPlanModifiers¶
func (aNumberAttribute) NumberPlanModifiers() []planmodifier.Number
NumberPlanModifiers returns the PlanModifiers field value.
func (NumberAttribute)NumberValidators¶
func (aNumberAttribute) NumberValidators() []validator.Number
NumberValidators returns the Validators field value.
func (NumberAttribute)ValidateImplementation¶added inv1.3.0
func (aNumberAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeObjectAttribute¶
type ObjectAttribute struct {// AttributeTypes is the mapping of underlying attribute names to attribute// types. This field must be set.//// Attribute types that contain a collection with a nested dynamic type (i.e. types.List[types.Dynamic]) are not supported.// If underlying dynamic collection values are required, replace this attribute definition with// DynamicAttribute instead.AttributeTypes map[string]attr.Type// CustomType enables the use of a custom attribute type in place of the// default basetypes.ObjectType. When retrieving data, the basetypes.ObjectValuable// associated with this custom type must be used in place of types.Object.CustomTypebasetypes.ObjectTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Object// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Object// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Object// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}ObjectAttribute represents a schema attribute that is an object with onlytype information for underlying attributes. When retrieving the value forthis attribute, use types.Object as the value type unless the CustomTypefield is set. The AttributeTypes field must be set.
Prefer SingleNestedAttribute over ObjectAttribute if the provider isusing protocol version 6 and full attribute functionality is needed.
Terraform configurations configure this attribute using expressions thatreturn an object or directly via curly brace syntax.
# object with one attributeexample_attribute = {underlying_attribute = #...}Terraform configurations reference this attribute using expressions thataccept an object or an attribute directly via period syntax:
# underlying attribute.example_attribute.underlying_attribute
func (ObjectAttribute)ApplyTerraform5AttributePathStep¶
func (aObjectAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the result of stepping into anattribute name or an error.
func (ObjectAttribute)Equal¶
func (aObjectAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a ObjectAttributeand all fields are equal.
func (ObjectAttribute)GetDeprecationMessage¶
func (aObjectAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (ObjectAttribute)GetDescription¶
func (aObjectAttribute) GetDescription()string
GetDescription returns the Description field value.
func (ObjectAttribute)GetMarkdownDescription¶
func (aObjectAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (ObjectAttribute)GetType¶
func (aObjectAttribute) GetType()attr.Type
GetType returns types.ObjectType or the CustomType field value if defined.
func (ObjectAttribute)IsComputed¶
func (aObjectAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (ObjectAttribute)IsOptional¶
func (aObjectAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (ObjectAttribute)IsOptionalForImport¶added inv1.15.0
func (aObjectAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (ObjectAttribute)IsRequired¶
func (aObjectAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (ObjectAttribute)IsRequiredForImport¶added inv1.15.0
func (aObjectAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (ObjectAttribute)IsSensitive¶
func (aObjectAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (ObjectAttribute)IsWriteOnly¶added inv1.14.0
func (aObjectAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (ObjectAttribute)ObjectDefaultValue¶added inv1.2.0
func (aObjectAttribute) ObjectDefaultValue()defaults.Object
ObjectDefaultValue returns the Default field value.
func (ObjectAttribute)ObjectPlanModifiers¶
func (aObjectAttribute) ObjectPlanModifiers() []planmodifier.Object
ObjectPlanModifiers returns the PlanModifiers field value.
func (ObjectAttribute)ObjectValidators¶
func (aObjectAttribute) ObjectValidators() []validator.Object
ObjectValidators returns the Validators field value.
func (ObjectAttribute)ValidateImplementation¶added inv1.3.0
func (aObjectAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeSchema¶
type Schema struct {// Attributes is the mapping of underlying attribute names to attribute// definitions.//// Names must only contain lowercase letters, numbers, and underscores.// Names must not collide with any Blocks names.Attributes map[string]Attribute// Blocks is the mapping of underlying block names to block definitions.//// Names must only contain lowercase letters, numbers, and underscores.// Names must not collide with any Attributes names.Blocks map[string]Block// Description is used in various tooling, like the language server, to// give practitioners more information about what this resource is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this resource is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this resource. The warning diagnostic// summary is automatically set to "Resource Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Use examplecloud_other resource instead. This resource// will be removed in the next major version of the provider."// - "Remove this resource as it no longer is valid and// will be removed in the next major version of the provider."//DeprecationMessagestring// Version indicates the current version of the resource schema. Resource// schema versioning enables state upgrades in conjunction with the// [resource.ResourceWithStateUpgrades] interface. Versioning is only// required if there is a breaking change involving existing state data,// such as changing an attribute or block type in a manner that is// incompatible with the Terraform type.//// Versions are conventionally only incremented by one each release.Versionint64}Schema defines the structure and value types of resource data. This typeis used as the resource.SchemaResponse type Schema field, which isimplemented by the resource.DataSource type Schema method.
func (Schema)ApplyTerraform5AttributePathStep¶
func (sSchema) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (any,error)
ApplyTerraform5AttributePathStep applies the given AttributePathStep to theschema.
func (Schema)AttributeAtPath¶
func (sSchema) AttributeAtPath(ctxcontext.Context, ppath.Path) (fwschema.Attribute,diag.Diagnostics)
AttributeAtPath returns the Attribute at the passed path. If the path pointsto an element or attribute of a complex type, rather than to an Attribute,it will return an ErrPathInsideAtomicAttribute error.
func (Schema)AttributeAtTerraformPath¶
func (sSchema) AttributeAtTerraformPath(ctxcontext.Context, p *tftypes.AttributePath) (fwschema.Attribute,error)
AttributeAtPath returns the Attribute at the passed path. If the path pointsto an element or attribute of a complex type, rather than to an Attribute,it will return an ErrPathInsideAtomicAttribute error.
func (Schema)GetAttributes¶
GetAttributes returns the Attributes field value.
func (Schema)GetDeprecationMessage¶
GetDeprecationMessage returns the DeprecationMessage field value.
func (Schema)GetDescription¶
GetDescription returns the Description field value.
func (Schema)GetMarkdownDescription¶
GetMarkdownDescription returns the MarkdownDescription field value.
func (Schema)TypeAtPath¶
TypeAtPath returns the framework type at the given schema path.
func (Schema)TypeAtTerraformPath¶
TypeAtTerraformPath returns the framework type at the given tftypes path.
func (Schema)Validatedeprecatedadded inv1.0.0
func (sSchema) Validate()diag.Diagnostics
Validate verifies that the schema is not using a reserved field name for a top-level attribute.
Deprecated: Use the ValidateImplementation method instead.
func (Schema)ValidateImplementation¶added inv1.3.0
func (sSchema) ValidateImplementation(ctxcontext.Context)diag.Diagnostics
ValidateImplementation contains logic for validating the provider-definedimplementation of the schema and underlying attributes and blocks to preventunexpected errors or panics. This logic runs during theValidateResourceConfig RPC, or via provider-defined unit testing, and shouldnever include false positives.
typeSetAttribute¶
type SetAttribute struct {// ElementType is the type for all elements of the set. This field must be// set.//// Element types that contain a dynamic type (i.e. types.Dynamic) are not supported.// If underlying dynamic values are required, replace this attribute definition with// DynamicAttribute instead.ElementTypeattr.Type// CustomType enables the use of a custom attribute type in place of the// default basetypes.SetType. When retrieving data, the basetypes.SetValuable// associated with this custom type must be used in place of types.Set.CustomTypebasetypes.SetTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Set// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Set// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Set}SetAttribute represents a schema attribute that is a set with a singleelement type. When retrieving the value for this attribute, use types.Setas the value type unless the CustomType field is set. The ElementType fieldmust be set.
Use SetNestedAttribute if the underlying elements should be objects andrequire definition beyond type information.
Terraform configurations configure this attribute using expressions thatreturn a set or directly via square brace syntax.
# set of stringsexample_attribute = ["first", "second"]
Terraform configurations reference this attribute using expressions thataccept a set. Sets cannot be indexed in Terraform, therefore an expressionis required to access an explicit element.
func (SetAttribute)ApplyTerraform5AttributePathStep¶
func (aSetAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the result of stepping into a setindex or an error.
func (SetAttribute)Equal¶
func (aSetAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a SetAttributeand all fields are equal.
func (SetAttribute)GetDeprecationMessage¶
func (aSetAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (SetAttribute)GetDescription¶
func (aSetAttribute) GetDescription()string
GetDescription returns the Description field value.
func (SetAttribute)GetMarkdownDescription¶
func (aSetAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (SetAttribute)GetType¶
func (aSetAttribute) GetType()attr.Type
GetType returns types.SetType or the CustomType field value if defined.
func (SetAttribute)IsComputed¶
func (aSetAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (SetAttribute)IsOptional¶
func (aSetAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (SetAttribute)IsOptionalForImport¶added inv1.15.0
func (aSetAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (SetAttribute)IsRequired¶
func (aSetAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (SetAttribute)IsRequiredForImport¶added inv1.15.0
func (aSetAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (SetAttribute)IsSensitive¶
func (aSetAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (SetAttribute)IsWriteOnly¶added inv1.14.0
func (aSetAttribute) IsWriteOnly()bool
IsWriteOnly returns false as write-only attributes are not supported for sets and set-based data.
func (SetAttribute)SetDefaultValue¶added inv1.2.0
func (aSetAttribute) SetDefaultValue()defaults.Set
SetDefaultValue returns the Default field value.
func (SetAttribute)SetPlanModifiers¶
func (aSetAttribute) SetPlanModifiers() []planmodifier.Set
SetPlanModifiers returns the PlanModifiers field value.
func (SetAttribute)SetValidators¶
func (aSetAttribute) SetValidators() []validator.Set
SetValidators returns the Validators field value.
func (SetAttribute)ValidateImplementation¶added inv1.3.0
func (aSetAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeSetNestedAttribute¶
type SetNestedAttribute struct {// NestedObject is the underlying object that contains nested attributes.// This field must be set.//// Nested attributes that contain a dynamic type (i.e. DynamicAttribute) are not supported.// If underlying dynamic values are required, replace this attribute definition with// DynamicAttribute instead.NestedObjectNestedAttributeObject// CustomType enables the use of a custom attribute type in place of the// default types.SetType of types.ObjectType. When retrieving data, the// basetypes.SetValuable associated with this custom type must be used in// place of types.Set.CustomTypebasetypes.SetTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Set// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Set// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Set}SetNestedAttribute represents an attribute that is a set of objects wherethe object attributes can be fully defined, including further nestedattributes. When retrieving the value for this attribute, use types.Setas the value type unless the CustomType field is set. The NestedObject fieldmust be set. Nested attributes are only compatible with protocol version 6.
Use SetAttribute if the underlying elements are of a single type and donot require definition beyond type information.
Terraform configurations configure this attribute using expressions thatreturn a set of objects or directly via square and curly brace syntax.
# set of objectsexample_attribute = [{nested_attribute = #...},]Terraform configurations reference this attribute using expressions thataccept a set of objects. Sets cannot be indexed in Terraform, thereforean expression is required to access an explicit element.
func (SetNestedAttribute)ApplyTerraform5AttributePathStep¶
func (aSetNestedAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the Attributes field value if stepis ElementKeyValue, otherwise returns an error.
func (SetNestedAttribute)Equal¶
func (aSetNestedAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a SetNestedAttributeand all fields are equal.
func (SetNestedAttribute)GetDeprecationMessage¶
func (aSetNestedAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (SetNestedAttribute)GetDescription¶
func (aSetNestedAttribute) GetDescription()string
GetDescription returns the Description field value.
func (SetNestedAttribute)GetMarkdownDescription¶
func (aSetNestedAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (SetNestedAttribute)GetNestedObject¶
func (aSetNestedAttribute) GetNestedObject()fwschema.NestedAttributeObject
GetNestedObject returns the NestedObject field value.
func (SetNestedAttribute)GetNestingMode¶
func (aSetNestedAttribute) GetNestingMode()fwschema.NestingMode
GetNestingMode always returns NestingModeSet.
func (SetNestedAttribute)GetType¶
func (aSetNestedAttribute) GetType()attr.Type
GetType returns SetType of ObjectType or CustomType.
func (SetNestedAttribute)IsComputed¶
func (aSetNestedAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (SetNestedAttribute)IsOptional¶
func (aSetNestedAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (SetNestedAttribute)IsOptionalForImport¶added inv1.15.0
func (aSetNestedAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (SetNestedAttribute)IsRequired¶
func (aSetNestedAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (SetNestedAttribute)IsRequiredForImport¶added inv1.15.0
func (aSetNestedAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (SetNestedAttribute)IsSensitive¶
func (aSetNestedAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (SetNestedAttribute)IsWriteOnly¶added inv1.14.0
func (aSetNestedAttribute) IsWriteOnly()bool
IsWriteOnly returns false as write-only attributes are not supported for sets and set-based data.
func (SetNestedAttribute)SetDefaultValue¶added inv1.2.0
func (aSetNestedAttribute) SetDefaultValue()defaults.Set
SetDefaultValue returns the Default field value.
func (SetNestedAttribute)SetPlanModifiers¶
func (aSetNestedAttribute) SetPlanModifiers() []planmodifier.Set
SetPlanModifiers returns the PlanModifiers field value.
func (SetNestedAttribute)SetValidators¶
func (aSetNestedAttribute) SetValidators() []validator.Set
SetValidators returns the Validators field value.
func (SetNestedAttribute)ValidateImplementation¶added inv1.3.0
func (aSetNestedAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeSetNestedBlock¶
type SetNestedBlock struct {// NestedObject is the underlying object that contains nested attributes or// blocks. This field must be set.//// Nested attributes that contain a dynamic type (i.e. DynamicAttribute) are not supported.// If underlying dynamic values are required, replace this block definition with// a DynamicAttribute.NestedObjectNestedBlockObject// CustomType enables the use of a custom attribute type in place of the// default types.SetType of types.ObjectType. When retrieving data, the// basetypes.SetValuable associated with this custom type must be used in// place of types.Set.CustomTypebasetypes.SetTypable// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Set// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Set}SetNestedBlock represents a block that is a set of objects wherethe object attributes can be fully defined, including further attributesor blocks. When retrieving the value for this block, use types.Setas the value type unless the CustomType field is set. The NestedObject fieldmust be set.
Prefer SetNestedAttribute over SetNestedBlock if the provider isusing protocol version 6. Nested attributes allow practitioners to configurevalues directly with expressions.
Terraform configurations configure this block repeatedly using curly bracesyntax without an equals (=) sign orDynamic Block Expressions.
# set of blocks with two elementsexample_block {nested_attribute = #...}example_block {nested_attribute = #...}Terraform configurations reference this block using expressions thataccept a set of objects or an element directly via square brace 0-basedindex syntax:
# first known object.example_block[0]# first known object nested_attribute value.example_block[0].nested_attribute
func (SetNestedBlock)ApplyTerraform5AttributePathStep¶
func (bSetNestedBlock) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the NestedObject field value if stepis ElementKeyValue, otherwise returns an error.
func (SetNestedBlock)Equal¶
func (bSetNestedBlock) Equal(ofwschema.Block)bool
Equal returns true if the given Block is SetNestedBlockand all fields are equal.
func (SetNestedBlock)GetDeprecationMessage¶
func (bSetNestedBlock) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (SetNestedBlock)GetDescription¶
func (bSetNestedBlock) GetDescription()string
GetDescription returns the Description field value.
func (SetNestedBlock)GetMarkdownDescription¶
func (bSetNestedBlock) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (SetNestedBlock)GetNestedObject¶
func (bSetNestedBlock) GetNestedObject()fwschema.NestedBlockObject
GetNestedObject returns the NestedObject field value.
func (SetNestedBlock)GetNestingMode¶
func (bSetNestedBlock) GetNestingMode()fwschema.BlockNestingMode
GetNestingMode always returns BlockNestingModeSet.
func (SetNestedBlock)SetPlanModifiers¶
func (bSetNestedBlock) SetPlanModifiers() []planmodifier.Set
SetPlanModifiers returns the PlanModifiers field value.
func (SetNestedBlock)SetValidators¶
func (bSetNestedBlock) SetValidators() []validator.Set
SetValidators returns the Validators field value.
func (SetNestedBlock)Type¶
func (bSetNestedBlock) Type()attr.Type
Type returns SetType of ObjectType or CustomType.
func (SetNestedBlock)ValidateImplementation¶added inv1.7.0
func (bSetNestedBlock) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the block to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeSingleNestedAttribute¶
type SingleNestedAttribute struct {// Attributes is the mapping of underlying attribute names to attribute// definitions. This field must be set.Attributes map[string]Attribute// CustomType enables the use of a custom attribute type in place of the// default basetypes.ObjectType. When retrieving data, the basetypes.ObjectValuable// associated with this custom type must be used in place of types.Object.CustomTypebasetypes.ObjectTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Object// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Object// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.Object// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}SingleNestedAttribute represents an attribute that is a single object wherethe object attributes can be fully defined, including further nestedattributes. When retrieving the value for this attribute, use types.Objectas the value type unless the CustomType field is set. The Attributes fieldmust be set. Nested attributes are only compatible with protocol version 6.
Use ObjectAttribute if the underlying attributes do not require definitionbeyond type information.
Terraform configurations configure this attribute using expressions thatreturn an object or directly via curly brace syntax.
# single objectexample_attribute = {nested_attribute = #...}Terraform configurations reference this attribute using expressions thataccept an object or an attribute name directly via period syntax:
# object nested_attribute value.example_attribute.nested_attribute
func (SingleNestedAttribute)ApplyTerraform5AttributePathStep¶
func (aSingleNestedAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the Attributes field value if stepis AttributeName, otherwise returns an error.
func (SingleNestedAttribute)Equal¶
func (aSingleNestedAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a SingleNestedAttributeand all fields are equal.
func (SingleNestedAttribute)GetAttributes¶
func (aSingleNestedAttribute) GetAttributes()fwschema.UnderlyingAttributes
GetAttributes returns the Attributes field value.
func (SingleNestedAttribute)GetDeprecationMessage¶
func (aSingleNestedAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (SingleNestedAttribute)GetDescription¶
func (aSingleNestedAttribute) GetDescription()string
GetDescription returns the Description field value.
func (SingleNestedAttribute)GetMarkdownDescription¶
func (aSingleNestedAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (SingleNestedAttribute)GetNestedObject¶
func (aSingleNestedAttribute) GetNestedObject()fwschema.NestedAttributeObject
GetNestedObject returns a generated NestedAttributeObject from theAttributes, CustomType, and Validators field values.
func (SingleNestedAttribute)GetNestingMode¶
func (aSingleNestedAttribute) GetNestingMode()fwschema.NestingMode
GetNestingMode always returns NestingModeSingle.
func (SingleNestedAttribute)GetType¶
func (aSingleNestedAttribute) GetType()attr.Type
GetType returns ListType of ObjectType or CustomType.
func (SingleNestedAttribute)IsComputed¶
func (aSingleNestedAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (SingleNestedAttribute)IsOptional¶
func (aSingleNestedAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (SingleNestedAttribute)IsOptionalForImport¶added inv1.15.0
func (aSingleNestedAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (SingleNestedAttribute)IsRequired¶
func (aSingleNestedAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (SingleNestedAttribute)IsRequiredForImport¶added inv1.15.0
func (aSingleNestedAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (SingleNestedAttribute)IsSensitive¶
func (aSingleNestedAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (SingleNestedAttribute)IsWriteOnly¶added inv1.14.0
func (aSingleNestedAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (SingleNestedAttribute)ObjectDefaultValue¶added inv1.2.0
func (aSingleNestedAttribute) ObjectDefaultValue()defaults.Object
ObjectDefaultValue returns the Default field value.
func (SingleNestedAttribute)ObjectPlanModifiers¶
func (aSingleNestedAttribute) ObjectPlanModifiers() []planmodifier.Object
ObjectPlanModifiers returns the PlanModifiers field value.
func (SingleNestedAttribute)ObjectValidators¶
func (aSingleNestedAttribute) ObjectValidators() []validator.Object
ObjectValidators returns the Validators field value.
func (SingleNestedAttribute)ValidateImplementation¶added inv1.3.0
func (aSingleNestedAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
typeSingleNestedBlock¶
type SingleNestedBlock struct {// Attributes is the mapping of underlying attribute names to attribute// definitions.//// Names must only contain lowercase letters, numbers, and underscores.// Names must not collide with any Blocks names.Attributes map[string]Attribute// Blocks is the mapping of underlying block names to block definitions.//// Names must only contain lowercase letters, numbers, and underscores.// Names must not collide with any Attributes names.Blocks map[string]Block// CustomType enables the use of a custom attribute type in place of the// default basetypes.ObjectType. When retrieving data, the basetypes.ObjectValuable// associated with this custom type must be used in place of types.Object.CustomTypebasetypes.ObjectTypable// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.Object// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.Object}SingleNestedBlock represents a block that is a single object wherethe object attributes can be fully defined, including further attributesor blocks. When retrieving the value for this block, use types.Objectas the value type unless the CustomType field is set.
Prefer SingleNestedAttribute over SingleNestedBlock if the provider isusing protocol version 6. Nested attributes allow practitioners to configurevalues directly with expressions.
Terraform configurations configure this block only once using curly bracesyntax without an equals (=) sign orDynamic Block Expressions.
# single blockexample_block {nested_attribute = #...}Terraform configurations reference this block using expressions thataccept an object or an attribute name directly via period syntax:
# object nested_attribute value.example_block.nested_attribute
func (SingleNestedBlock)ApplyTerraform5AttributePathStep¶
func (bSingleNestedBlock) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep returns the Attributes field value if stepis AttributeName, otherwise returns an error.
func (SingleNestedBlock)Equal¶
func (bSingleNestedBlock) Equal(ofwschema.Block)bool
Equal returns true if the given Attribute is b SingleNestedBlockand all fields are equal.
func (SingleNestedBlock)GetDeprecationMessage¶
func (bSingleNestedBlock) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (SingleNestedBlock)GetDescription¶
func (bSingleNestedBlock) GetDescription()string
GetDescription returns the Description field value.
func (SingleNestedBlock)GetMarkdownDescription¶
func (bSingleNestedBlock) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (SingleNestedBlock)GetNestedObject¶
func (bSingleNestedBlock) GetNestedObject()fwschema.NestedBlockObject
GetNestedObject returns a generated NestedBlockObject from theAttributes, CustomType, and Validators field values.
func (SingleNestedBlock)GetNestingMode¶
func (bSingleNestedBlock) GetNestingMode()fwschema.BlockNestingMode
GetNestingMode always returns BlockNestingModeSingle.
func (SingleNestedBlock)ObjectPlanModifiers¶
func (bSingleNestedBlock) ObjectPlanModifiers() []planmodifier.Object
ObjectPlanModifiers returns the PlanModifiers field value.
func (SingleNestedBlock)ObjectValidators¶
func (bSingleNestedBlock) ObjectValidators() []validator.Object
ObjectValidators returns the Validators field value.
func (SingleNestedBlock)Type¶
func (bSingleNestedBlock) Type()attr.Type
Type returns ObjectType or CustomType.
typeStringAttribute¶
type StringAttribute struct {// CustomType enables the use of a custom attribute type in place of the// default basetypes.StringType. When retrieving data, the basetypes.StringValuable// associated with this custom type must be used in place of types.String.CustomTypebasetypes.StringTypable// Required indicates whether the practitioner must enter a value for// this attribute or not. Required and Optional cannot both be true,// and Required and Computed cannot both be true.Requiredbool// Optional indicates whether the practitioner can choose to enter a value// for this attribute or not. Optional and Required cannot both be true.Optionalbool// Computed indicates whether the provider may return its own value for// this Attribute or not. Required and Computed cannot both be true. If// Required and Optional are both false, Computed must be true, and the// attribute will be considered "read only" for the practitioner, with// only the provider able to set its value.Computedbool// Sensitive indicates whether the value of this attribute should be// considered sensitive data. Setting it to true will obscure the value// in CLI output. Sensitive does not impact how values are stored, and// practitioners are encouraged to store their state as if the entire// file is sensitive.Sensitivebool// Description is used in various tooling, like the language server, to// give practitioners more information about what this attribute is,// what it's for, and how it should be used. It should be written as// plain text, with no special formatting.Descriptionstring// MarkdownDescription is used in various tooling, like the// documentation generator, to give practitioners more information// about what this attribute is, what it's for, and how it should be// used. It should be formatted using Markdown.MarkdownDescriptionstring// DeprecationMessage defines warning diagnostic details to display when// practitioner configurations use this Attribute. The warning diagnostic// summary is automatically set to "Attribute Deprecated" along with// configuration source file and line information.//// Set this field to a practitioner actionable message such as://// - "Configure other_attribute instead. This attribute will be removed// in the next major version of the provider."// - "Remove this attribute's configuration as it no longer is used and// the attribute will be removed in the next major version of the// provider."//// In Terraform 1.2.7 and later, this warning diagnostic is displayed any// time a practitioner attempts to configure a value for this attribute and// certain scenarios where this attribute is referenced.//// In Terraform 1.2.6 and earlier, this warning diagnostic is only// displayed when the Attribute is Required or Optional, and if the// practitioner configuration sets the value to a known or unknown value// (which may eventually be null). It has no effect when the Attribute is// Computed-only (read-only; not Required or Optional).//// Across any Terraform version, there are no warnings raised for// practitioner configuration values set directly to null, as there is no// way for the framework to differentiate between an unset and null// configuration due to how Terraform sends configuration information// across the protocol.//// Additional information about deprecation enhancements for read-only// attributes can be found in://// -https://github.com/hashicorp/terraform/issues/7569//DeprecationMessagestring// Validators define value validation functionality for the attribute. All// elements of the slice of AttributeValidator are run, regardless of any// previous error diagnostics.//// Many common use case validators can be found in the// github.com/hashicorp/terraform-plugin-framework-validators Go module.//// If the Type field points to a custom type that implements the// xattr.TypeWithValidate interface, the validators defined in this field// are run in addition to the validation defined by the type.Validators []validator.String// PlanModifiers defines a sequence of modifiers for this attribute at// plan time. Schema-based plan modifications occur before any// resource-level plan modifications.//// Schema-based plan modifications can adjust Terraform's plan by://// - Requiring resource recreation. Typically used for configuration// updates which cannot be done in-place.// - Setting the planned value. Typically used for enhancing the plan// to replace unknown values. Computed must be true or Terraform will// return an error. If the plan value is known due to a known// configuration value, the plan value cannot be changed or Terraform// will return an error.//// Any errors will prevent further execution of this sequence or modifiers.PlanModifiers []planmodifier.String// Default defines a proposed new state (plan) value for the attribute// if the configuration value is null. Default prevents the framework// from automatically marking the value as unknown during planning when// other proposed new state changes are detected. If the attribute is// computed and the value could be altered by other changes then a default// should be avoided and a plan modifier should be used instead.Defaultdefaults.String// WriteOnly indicates that Terraform will not store this attribute value// in the plan or state artifacts.// If WriteOnly is true, either Optional or Required must also be true.// WriteOnly cannot be set with Computed.//// This functionality is only supported in Terraform 1.11 and later.// Practitioners that choose a value for this attribute with older// versions of Terraform will receive an error.WriteOnlybool}StringAttribute represents a schema attribute that is a string. Whenretrieving the value for this attribute, use types.String as the value typeunless the CustomType field is set.
Terraform configurations configure this attribute using expressions thatreturn a string or directly via double quote syntax.
example_attribute = "value"
Terraform configurations reference this attribute using the attribute name.
.example_attribute
func (StringAttribute)ApplyTerraform5AttributePathStep¶
func (aStringAttribute) ApplyTerraform5AttributePathStep(steptftypes.AttributePathStep) (interface{},error)
ApplyTerraform5AttributePathStep always returns an error as it is notpossible to step further into a StringAttribute.
func (StringAttribute)Equal¶
func (aStringAttribute) Equal(ofwschema.Attribute)bool
Equal returns true if the given Attribute is a StringAttributeand all fields are equal.
func (StringAttribute)GetDeprecationMessage¶
func (aStringAttribute) GetDeprecationMessage()string
GetDeprecationMessage returns the DeprecationMessage field value.
func (StringAttribute)GetDescription¶
func (aStringAttribute) GetDescription()string
GetDescription returns the Description field value.
func (StringAttribute)GetMarkdownDescription¶
func (aStringAttribute) GetMarkdownDescription()string
GetMarkdownDescription returns the MarkdownDescription field value.
func (StringAttribute)GetType¶
func (aStringAttribute) GetType()attr.Type
GetType returns types.StringType or the CustomType field value if defined.
func (StringAttribute)IsComputed¶
func (aStringAttribute) IsComputed()bool
IsComputed returns the Computed field value.
func (StringAttribute)IsOptional¶
func (aStringAttribute) IsOptional()bool
IsOptional returns the Optional field value.
func (StringAttribute)IsOptionalForImport¶added inv1.15.0
func (aStringAttribute) IsOptionalForImport()bool
IsOptionalForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (StringAttribute)IsRequired¶
func (aStringAttribute) IsRequired()bool
IsRequired returns the Required field value.
func (StringAttribute)IsRequiredForImport¶added inv1.15.0
func (aStringAttribute) IsRequiredForImport()bool
IsRequiredForImport returns false as this behavior is only relevantfor managed resource identity schema attributes.
func (StringAttribute)IsSensitive¶
func (aStringAttribute) IsSensitive()bool
IsSensitive returns the Sensitive field value.
func (StringAttribute)IsWriteOnly¶added inv1.14.0
func (aStringAttribute) IsWriteOnly()bool
IsWriteOnly returns the WriteOnly field value.
func (StringAttribute)StringDefaultValue¶added inv1.2.0
func (aStringAttribute) StringDefaultValue()defaults.String
StringDefaultValue returns the Default field value.
func (StringAttribute)StringPlanModifiers¶
func (aStringAttribute) StringPlanModifiers() []planmodifier.String
StringPlanModifiers returns the PlanModifiers field value.
func (StringAttribute)StringValidators¶
func (aStringAttribute) StringValidators() []validator.String
StringValidators returns the Validators field value.
func (StringAttribute)ValidateImplementation¶added inv1.3.0
func (aStringAttribute) ValidateImplementation(ctxcontext.Context, reqfwschema.ValidateImplementationRequest, resp *fwschema.ValidateImplementationResponse)
ValidateImplementation contains logic for validating theprovider-defined implementation of the attribute to prevent unexpectederrors or panics. This logic runs during the GetProviderSchema RPC andshould never include false positives.
Source Files¶
- attribute.go
- block.go
- bool_attribute.go
- doc.go
- dynamic_attribute.go
- float32_attribute.go
- float64_attribute.go
- int32_attribute.go
- int64_attribute.go
- list_attribute.go
- list_nested_attribute.go
- list_nested_block.go
- map_attribute.go
- map_nested_attribute.go
- nested_attribute.go
- nested_attribute_object.go
- nested_block_object.go
- number_attribute.go
- object_attribute.go
- schema.go
- set_attribute.go
- set_nested_attribute.go
- set_nested_block.go
- single_nested_attribute.go
- single_nested_block.go
- string_attribute.go
Directories¶
| Path | Synopsis |
|---|---|
Package booldefault provides default values for types.Bool attributes. | Package booldefault provides default values for types.Bool attributes. |
Package boolplanmodifier provides plan modifiers for types.Bool attributes. | Package boolplanmodifier provides plan modifiers for types.Bool attributes. |
Package defaults contains schema default value interfaces and request/response implementations. | Package defaults contains schema default value interfaces and request/response implementations. |
Package dynamicdefault provides default values for types.Dynamic attributes. | Package dynamicdefault provides default values for types.Dynamic attributes. |
Package dynamicplanmodifier provides plan modifiers for types.Dynamic attributes. | Package dynamicplanmodifier provides plan modifiers for types.Dynamic attributes. |
Package float32default provides default values for types.Float32 attributes. | Package float32default provides default values for types.Float32 attributes. |
Package float32planmodifier provides plan modifiers for types.Float32 attributes. | Package float32planmodifier provides plan modifiers for types.Float32 attributes. |
Package float64default provides default values for types.Float64 attributes. | Package float64default provides default values for types.Float64 attributes. |
Package float64planmodifier provides plan modifiers for types.Float64 attributes. | Package float64planmodifier provides plan modifiers for types.Float64 attributes. |
Package int32default provides default values for types.Int32 attributes. | Package int32default provides default values for types.Int32 attributes. |
Package int32planmodifier provides plan modifiers for types.Int32 attributes. | Package int32planmodifier provides plan modifiers for types.Int32 attributes. |
Package int64default provides default values for types.Int64 attributes. | Package int64default provides default values for types.Int64 attributes. |
Package int64planmodifier provides plan modifiers for types.Int64 attributes. | Package int64planmodifier provides plan modifiers for types.Int64 attributes. |
Package listdefault provides default values for types.List attributes. | Package listdefault provides default values for types.List attributes. |
Package listplanmodifier provides plan modifiers for types.List attributes. | Package listplanmodifier provides plan modifiers for types.List attributes. |
Package mapdefault provides default values for types.Map attributes. | Package mapdefault provides default values for types.Map attributes. |
Package mapplanmodifier provides plan modifiers for types.Map attributes. | Package mapplanmodifier provides plan modifiers for types.Map attributes. |
Package numberdefault provides default values for types.Number attributes. | Package numberdefault provides default values for types.Number attributes. |
Package numberplanmodifier provides plan modifiers for types.Number attributes. | Package numberplanmodifier provides plan modifiers for types.Number attributes. |
Package objectdefault provides default values for types.Object attributes. | Package objectdefault provides default values for types.Object attributes. |
Package objectplanmodifier provides plan modifiers for types.Object attributes. | Package objectplanmodifier provides plan modifiers for types.Object attributes. |
Package planmodifier contains schema plan modifier interfaces and request/response implementations. | Package planmodifier contains schema plan modifier interfaces and request/response implementations. |
Package setdefault provides default values for types.Set attributes. | Package setdefault provides default values for types.Set attributes. |
Package setplanmodifier provides plan modifiers for types.Set attributes. | Package setplanmodifier provides plan modifiers for types.Set attributes. |
Package stringdefault provides default values for types.String attributes. | Package stringdefault provides default values for types.String attributes. |
Package stringplanmodifier provides plan modifiers for types.String attributes. | Package stringplanmodifier provides plan modifiers for types.String attributes. |