Instance
Represents a Data Fusion instance.
To get more information about Instance, see:
- API documentation
- How-to Guides
Create a Instance Resource
new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);def Instance(resource_name, opts=None, description=None, enable_stackdriver_logging=None, enable_stackdriver_monitoring=None, labels=None, name=None, network_config=None, options=None, private_instance=None, project=None, region=None, type=None, __props__=None);func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- opts ResourceOptions
- A bag of options that control this resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
Instance Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.
Inputs
The Instance resource accepts the following input properties:
- Type string
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- Description string
An optional description of the instance.
- Enable
Stackdriver boolLogging Option to enable Stackdriver Logging.
- Enable
Stackdriver boolMonitoring Option to enable Stackdriver Monitoring.
- Labels Dictionary<string, string>
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- Name string
The ID of the instance or a fully qualified identifier for the instance.
- Network
Config InstanceNetwork Config Args Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- Options Dictionary<string, string>
Map of additional options used to configure the behavior of Data Fusion instance.
- Private
Instance bool Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The region of the Data Fusion instance.
- Type string
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- Description string
An optional description of the instance.
- Enable
Stackdriver boolLogging Option to enable Stackdriver Logging.
- Enable
Stackdriver boolMonitoring Option to enable Stackdriver Monitoring.
- Labels map[string]string
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- Name string
The ID of the instance or a fully qualified identifier for the instance.
- Network
Config InstanceNetwork Config Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- Options map[string]string
Map of additional options used to configure the behavior of Data Fusion instance.
- Private
Instance bool Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The region of the Data Fusion instance.
- type string
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- description string
An optional description of the instance.
- enable
Stackdriver booleanLogging Option to enable Stackdriver Logging.
- enable
Stackdriver booleanMonitoring Option to enable Stackdriver Monitoring.
- labels {[key: string]: string}
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- name string
The ID of the instance or a fully qualified identifier for the instance.
- network
Config InstanceNetwork Config Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- options {[key: string]: string}
Map of additional options used to configure the behavior of Data Fusion instance.
- private
Instance boolean Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
The region of the Data Fusion instance.
- type str
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- description str
An optional description of the instance.
- enable_
stackdriver_ boollogging Option to enable Stackdriver Logging.
- enable_
stackdriver_ boolmonitoring Option to enable Stackdriver Monitoring.
- labels Dict[str, str]
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- name str
The ID of the instance or a fully qualified identifier for the instance.
- network_
config Dict[InstanceNetwork Config] Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- options Dict[str, str]
Map of additional options used to configure the behavior of Data Fusion instance.
- private_
instance bool Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- project str
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
The region of the Data Fusion instance.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- Create
Time string The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Id string
- The provider-assigned unique ID for this managed resource.
- Service
Account string Service account which will be used to access resources in the customer project.
- Service
Endpoint string Endpoint on which the Data Fusion UI and REST APIs are accessible.
- State string
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- State
Message string Additional information about the current state of this Data Fusion instance if available.
- Update
Time string The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Version string
Current version of the Data Fusion.
- Create
Time string The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Id string
- The provider-assigned unique ID for this managed resource.
- Service
Account string Service account which will be used to access resources in the customer project.
- Service
Endpoint string Endpoint on which the Data Fusion UI and REST APIs are accessible.
- State string
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- State
Message string Additional information about the current state of this Data Fusion instance if available.
- Update
Time string The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Version string
Current version of the Data Fusion.
- create
Time string The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- id string
- The provider-assigned unique ID for this managed resource.
- service
Account string Service account which will be used to access resources in the customer project.
- service
Endpoint string Endpoint on which the Data Fusion UI and REST APIs are accessible.
- state string
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- state
Message string Additional information about the current state of this Data Fusion instance if available.
- update
Time string The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- version string
Current version of the Data Fusion.
- create_
time str The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- id str
- The provider-assigned unique ID for this managed resource.
- service_
account str Service account which will be used to access resources in the customer project.
- service_
endpoint str Endpoint on which the Data Fusion UI and REST APIs are accessible.
- state str
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- state_
message str Additional information about the current state of this Data Fusion instance if available.
- update_
time str The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- version str
Current version of the Data Fusion.
Look up an Existing Instance Resource
Get an existing Instance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: InstanceState, opts?: CustomResourceOptions): Instancestatic get(resource_name, id, opts=None, create_time=None, description=None, enable_stackdriver_logging=None, enable_stackdriver_monitoring=None, labels=None, name=None, network_config=None, options=None, private_instance=None, project=None, region=None, service_account=None, service_endpoint=None, state=None, state_message=None, type=None, update_time=None, version=None, __props__=None);func GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
The following state arguments are supported:
- Create
Time string The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Description string
An optional description of the instance.
- Enable
Stackdriver boolLogging Option to enable Stackdriver Logging.
- Enable
Stackdriver boolMonitoring Option to enable Stackdriver Monitoring.
- Labels Dictionary<string, string>
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- Name string
The ID of the instance or a fully qualified identifier for the instance.
- Network
Config InstanceNetwork Config Args Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- Options Dictionary<string, string>
Map of additional options used to configure the behavior of Data Fusion instance.
- Private
Instance bool Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The region of the Data Fusion instance.
- Service
Account string Service account which will be used to access resources in the customer project.
- Service
Endpoint string Endpoint on which the Data Fusion UI and REST APIs are accessible.
- State string
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- State
Message string Additional information about the current state of this Data Fusion instance if available.
- Type string
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- Update
Time string The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Version string
Current version of the Data Fusion.
- Create
Time string The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Description string
An optional description of the instance.
- Enable
Stackdriver boolLogging Option to enable Stackdriver Logging.
- Enable
Stackdriver boolMonitoring Option to enable Stackdriver Monitoring.
- Labels map[string]string
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- Name string
The ID of the instance or a fully qualified identifier for the instance.
- Network
Config InstanceNetwork Config Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- Options map[string]string
Map of additional options used to configure the behavior of Data Fusion instance.
- Private
Instance bool Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The region of the Data Fusion instance.
- Service
Account string Service account which will be used to access resources in the customer project.
- Service
Endpoint string Endpoint on which the Data Fusion UI and REST APIs are accessible.
- State string
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- State
Message string Additional information about the current state of this Data Fusion instance if available.
- Type string
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- Update
Time string The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- Version string
Current version of the Data Fusion.
- create
Time string The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- description string
An optional description of the instance.
- enable
Stackdriver booleanLogging Option to enable Stackdriver Logging.
- enable
Stackdriver booleanMonitoring Option to enable Stackdriver Monitoring.
- labels {[key: string]: string}
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- name string
The ID of the instance or a fully qualified identifier for the instance.
- network
Config InstanceNetwork Config Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- options {[key: string]: string}
Map of additional options used to configure the behavior of Data Fusion instance.
- private
Instance boolean Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
The region of the Data Fusion instance.
- service
Account string Service account which will be used to access resources in the customer project.
- service
Endpoint string Endpoint on which the Data Fusion UI and REST APIs are accessible.
- state string
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- state
Message string Additional information about the current state of this Data Fusion instance if available.
- type string
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- update
Time string The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- version string
Current version of the Data Fusion.
- create_
time str The time the instance was created in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- description str
An optional description of the instance.
- enable_
stackdriver_ boollogging Option to enable Stackdriver Logging.
- enable_
stackdriver_ boolmonitoring Option to enable Stackdriver Monitoring.
- labels Dict[str, str]
The resource labels for instance to use to annotate any related underlying resources, such as Compute Engine VMs.
- name str
The ID of the instance or a fully qualified identifier for the instance.
- network_
config Dict[InstanceNetwork Config] Network configuration options. These are required when a private Data Fusion instance is to be created. Structure is documented below.
- options Dict[str, str]
Map of additional options used to configure the behavior of Data Fusion instance.
- private_
instance bool Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
- project str
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
The region of the Data Fusion instance.
- service_
account str Service account which will be used to access resources in the customer project.
- service_
endpoint str Endpoint on which the Data Fusion UI and REST APIs are accessible.
- state str
The current state of this Data Fusion instance. - CREATING: Instance is being created - RUNNING: Instance is running and ready for requests - FAILED: Instance creation failed - DELETING: Instance is being deleted - UPGRADING: Instance is being upgraded - RESTARTING: Instance is being restarted
- state_
message str Additional information about the current state of this Data Fusion instance if available.
- type str
Represents the type of Data Fusion instance. Each type is configured with the default settings for processing and memory. - BASIC: Basic Data Fusion instance. In Basic type, the user will be able to create data pipelines using point and click UI. However, there are certain limitations, such as fewer number of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc.
- update_
time str The time the instance was last updated in RFC3339 UTC “Zulu” format, accurate to nanoseconds.
- version str
Current version of the Data Fusion.
Supporting Types
InstanceNetworkConfig
- Ip
Allocation string The IP range in CIDR notation to use for the managed Data Fusion instance nodes. This range must not overlap with any other ranges used in the Data Fusion instance network.
- Network string
Name of the network in the project with which the tenant project will be peered for executing pipelines. In case of shared VPC where the network resides in another host project the network should specified in the form of projects/{host-project-id}/global/networks/{network}
- Ip
Allocation string The IP range in CIDR notation to use for the managed Data Fusion instance nodes. This range must not overlap with any other ranges used in the Data Fusion instance network.
- Network string
Name of the network in the project with which the tenant project will be peered for executing pipelines. In case of shared VPC where the network resides in another host project the network should specified in the form of projects/{host-project-id}/global/networks/{network}
- ip
Allocation string The IP range in CIDR notation to use for the managed Data Fusion instance nodes. This range must not overlap with any other ranges used in the Data Fusion instance network.
- network string
Name of the network in the project with which the tenant project will be peered for executing pipelines. In case of shared VPC where the network resides in another host project the network should specified in the form of projects/{host-project-id}/global/networks/{network}
- ip
Allocation str The IP range in CIDR notation to use for the managed Data Fusion instance nodes. This range must not overlap with any other ranges used in the Data Fusion instance network.
- network str
Name of the network in the project with which the tenant project will be peered for executing pipelines. In case of shared VPC where the network resides in another host project the network should specified in the form of projects/{host-project-id}/global/networks/{network}
Package Details
- Repository
- https://github.com/pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-betaTerraform Provider.