Documentation ¶
Index ¶
- func FormatCtyPath(path cty.Path) string
- func FormatError(err error) string
- type ApplyResourceChangeRequest
- type ApplyResourceChangeResponse
- type ConfigureProviderRequest
- type ConfigureProviderResponse
- type Diagnostic
- type DiagnosticSeverity
- type Diagnostics
- type GetProviderSchemaResponse
- type ImportResourceStateRequest
- type ImportResourceStateResponse
- type ImportedResource
- type PlanResourceChangeRequest
- type PlanResourceChangeResponse
- type ReadDataSourceRequest
- type ReadDataSourceResponse
- type ReadResourceRequest
- type ReadResourceResponse
- type ServerCapabilities
- type UpgradeResourceStateRequest
- type UpgradeResourceStateResponse
- type ValidateDataResourceConfigRequest
- type ValidateDataResourceConfigResponse
- type ValidateProviderConfigRequest
- type ValidateProviderConfigResponse
- type ValidateResourceConfigRequest
- type ValidateResourceConfigResponse
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func FormatCtyPath ¶
func FormatError ¶
Types ¶
type ApplyResourceChangeRequest ¶
type ApplyResourceChangeRequest struct { // TypeName is the name of the resource type being applied. TypeName string // PriorState is the current state of resource. PriorState cty.Value // Planned state is the state returned from PlanResourceChange, and should // represent the new state, minus any remaining computed attributes. PlannedState cty.Value // Config is the resource configuration, before being merged with the // PriorState. Any value not explicitly set in the configuration will be // null. Config is supplied for reference, but Provider implementations // should prefer the PlannedState in most circumstances. Config cty.Value // PlannedPrivate is the same value as returned by PlanResourceChange. PlannedPrivate []byte // ProviderMeta is the configuration for the provider_meta block for the // module and provider this resource belongs to. Its use is defined by // each provider, and it should not be used without coordination with // HashiCorp. It is considered experimental and subject to change. ProviderMeta cty.Value }
type ApplyResourceChangeResponse ¶
type ApplyResourceChangeResponse struct { // NewState is the new complete state after applying the planned change. // In the event of an error, NewState should represent the most recent // known state of the resource, if it exists. NewState cty.Value // Private is an opaque blob that will be stored in state along with the // resource. It is intended only for interpretation by the provider itself. Private []byte // LegacyTypeSystem is set only if the provider is using the legacy SDK // whose type system cannot be precisely mapped into the Terraform type // system. We use this to bypass certain consistency checks that would // otherwise fail due to this imprecise mapping. No other provider or SDK // implementation is permitted to set this. LegacyTypeSystem bool }
type ConfigureProviderRequest ¶
type ConfigureProviderRequest struct { // Terraform version is the version string from the running instance of // terraform. Providers can use TerraformVersion to verify compatibility, // and to store for informational purposes. TerraformVersion string // Config is the complete configuration value for the provider. Config cty.Value }
type ConfigureProviderResponse ¶
type ConfigureProviderResponse struct { }
type Diagnostic ¶
type Diagnostic struct { Severity DiagnosticSeverity Summary string Detail string Attribute cty.Path }
type DiagnosticSeverity ¶
type DiagnosticSeverity rune
const ( Error DiagnosticSeverity = 'E' Warning DiagnosticSeverity = 'W' )
type Diagnostics ¶
type Diagnostics []Diagnostic
func ErrorDiagnostics ¶
func ErrorDiagnostics(summary string, err error) Diagnostics
func RPCErrorDiagnostics ¶
func RPCErrorDiagnostics(err error) Diagnostics
func (Diagnostics) Err ¶
func (diags Diagnostics) Err() error
func (Diagnostics) HasErrors ¶
func (diags Diagnostics) HasErrors() bool
type GetProviderSchemaResponse ¶
type GetProviderSchemaResponse struct { // Provider is the schema for the provider itself. Provider tfjson.Schema // ProviderMeta is the schema for the provider's meta info in a module ProviderMeta tfjson.Schema // ResourceTypes map the resource type name to that type's schema. ResourceTypes map[string]tfjson.Schema // DataSources maps the data source name to that data source's schema. DataSources map[string]tfjson.Schema // ServerCapabilities lists optional features supported by the provider. ServerCapabilities ServerCapabilities }
type ImportResourceStateResponse ¶
type ImportResourceStateResponse struct { // ImportedResources contains one or more state values related to the // imported resource. It is not required that these be complete, only that // there is enough identifying information for the provider to successfully // update the states in ReadResource. ImportedResources []ImportedResource }
type ImportedResource ¶
type ImportedResource struct { // TypeName is the name of the resource type associated with the // returned state. It's possible for providers to import multiple related // types with a single import request. TypeName string // State is the state of the remote object being imported. This may not be // complete, but must contain enough information to uniquely identify the // resource. State cty.Value // Private is an opaque blob that will be stored in state along with the // resource. It is intended only for interpretation by the provider itself. Private []byte }
ImportedResource represents an object being imported into Terraform with the help of a provider. An ImportedObject is a RemoteObject that has been read by the provider's import handler but hasn't yet been committed to state.
type PlanResourceChangeRequest ¶
type PlanResourceChangeRequest struct { // TypeName is the name of the resource type to plan. TypeName string // PriorState is the previously saved state value for this resource. PriorState cty.Value // ProposedNewState is the expected state after the new configuration is // applied. This is created by directly applying the configuration to the // PriorState. The provider is then responsible for applying any further // changes required to create the proposed final state. ProposedNewState cty.Value // Config is the resource configuration, before being merged with the // PriorState. Any value not explicitly set in the configuration will be // null. Config is supplied for reference, but Provider implementations // should prefer the ProposedNewState in most circumstances. Config cty.Value // PriorPrivate is the previously saved private data returned from the // provider during the last apply. PriorPrivate []byte // ProviderMeta is the configuration for the provider_meta block for the // module and provider this resource belongs to. Its use is defined by // each provider, and it should not be used without coordination with // HashiCorp. It is considered experimental and subject to change. ProviderMeta cty.Value }
type PlanResourceChangeResponse ¶
type PlanResourceChangeResponse struct { // PlannedState is the expected state of the resource once the current // configuration is applied. PlannedState cty.Value // RequiresReplace is the list of the attributes that are requiring // resource replacement. RequiresReplace []cty.Path // PlannedPrivate is an opaque blob that is not interpreted by terraform // core. This will be saved and relayed back to the provider during // ApplyResourceChange. PlannedPrivate []byte // LegacyTypeSystem is set only if the provider is using the legacy SDK // whose type system cannot be precisely mapped into the Terraform type // system. We use this to bypass certain consistency checks that would // otherwise fail due to this imprecise mapping. No other provider or SDK // implementation is permitted to set this. LegacyTypeSystem bool }
type ReadDataSourceRequest ¶
type ReadDataSourceRequest struct { // TypeName is the name of the data source type to Read. TypeName string // Config is the complete configuration for the requested data source. Config cty.Value // ProviderMeta is the configuration for the provider_meta block for the // module and provider this resource belongs to. Its use is defined by // each provider, and it should not be used without coordination with // HashiCorp. It is considered experimental and subject to change. ProviderMeta cty.Value }
type ReadDataSourceResponse ¶
type ReadResourceRequest ¶
type ReadResourceRequest struct { // TypeName is the name of the resource type being read. TypeName string // PriorState contains the previously saved state value for this resource. PriorState cty.Value // Private is an opaque blob that will be stored in state along with the // resource. It is intended only for interpretation by the provider itself. Private []byte // ProviderMeta is the configuration for the provider_meta block for the // module and provider this resource belongs to. Its use is defined by // each provider, and it should not be used without coordination with // HashiCorp. It is considered experimental and subject to change. ProviderMeta cty.Value }
type ReadResourceResponse ¶
type ServerCapabilities ¶
type ServerCapabilities struct { // PlanDestroy signals that this provider expects to receive a // PlanResourceChange call for resources that are to be destroyed. PlanDestroy bool }
ServerCapabilities allows providers to communicate extra information regarding supported protocol features. This is used to indicate availability of certain forward-compatible changes which may be optional in a major protocol version, but cannot be tested for directly.
type UpgradeResourceStateRequest ¶
type UpgradeResourceStateRequest struct { // TypeName is the name of the resource type being upgraded TypeName string // Version is version of the schema that created the current state. Version int64 // RawStateJSON and RawStateFlatmap contiain the state that needs to be // upgraded to match the current schema version. Because the schema is // unknown, this contains only the raw data as stored in the state. // RawStateJSON is the current json state encoding. // RawStateFlatmap is the legacy flatmap encoding. // Only on of these fields may be set for the upgrade request. RawStateJSON []byte RawStateFlatmap map[string]string }
type ValidateDataResourceConfigResponse ¶
type ValidateDataResourceConfigResponse struct { }
type ValidateResourceConfigResponse ¶
type ValidateResourceConfigResponse struct { }
Click to show internal directories.
Click to hide internal directories.