We recommend new projects start with resources from the AWS provider.
aws-native.ec2.Host
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
Resource Type definition for AWS::EC2::Host
Create Host Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Host(name: string, args: HostArgs, opts?: CustomResourceOptions);
@overload
def Host(resource_name: str,
args: HostArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Host(resource_name: str,
opts: Optional[ResourceOptions] = None,
availability_zone: Optional[str] = None,
asset_id: Optional[str] = None,
auto_placement: Optional[str] = None,
host_maintenance: Optional[str] = None,
host_recovery: Optional[str] = None,
instance_family: Optional[str] = None,
instance_type: Optional[str] = None,
outpost_arn: Optional[str] = None)
func NewHost(ctx *Context, name string, args HostArgs, opts ...ResourceOption) (*Host, error)
public Host(string name, HostArgs args, CustomResourceOptions? opts = null)
type: aws-native:ec2:Host
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args HostArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args HostArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args HostArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args HostArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args HostArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Host Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Host resource accepts the following input properties:
- Availability
Zone string - The Availability Zone in which to allocate the Dedicated Host.
- Asset
Id string - The ID of the Outpost hardware asset.
- Auto
Placement string - Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID.
- Host
Maintenance string - Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
- Host
Recovery string - Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
- Instance
Family string - Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
- Instance
Type string - Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
- Outpost
Arn string - The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.
- Availability
Zone string - The Availability Zone in which to allocate the Dedicated Host.
- Asset
Id string - The ID of the Outpost hardware asset.
- Auto
Placement string - Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID.
- Host
Maintenance string - Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
- Host
Recovery string - Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
- Instance
Family string - Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
- Instance
Type string - Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
- Outpost
Arn string - The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.
- availability
Zone String - The Availability Zone in which to allocate the Dedicated Host.
- asset
Id String - The ID of the Outpost hardware asset.
- auto
Placement String - Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID.
- host
Maintenance String - Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
- host
Recovery String - Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
- instance
Family String - Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
- instance
Type String - Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
- outpost
Arn String - The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.
- availability
Zone string - The Availability Zone in which to allocate the Dedicated Host.
- asset
Id string - The ID of the Outpost hardware asset.
- auto
Placement string - Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID.
- host
Maintenance string - Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
- host
Recovery string - Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
- instance
Family string - Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
- instance
Type string - Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
- outpost
Arn string - The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.
- availability_
zone str - The Availability Zone in which to allocate the Dedicated Host.
- asset_
id str - The ID of the Outpost hardware asset.
- auto_
placement str - Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID.
- host_
maintenance str - Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
- host_
recovery str - Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
- instance_
family str - Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
- instance_
type str - Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
- outpost_
arn str - The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.
- availability
Zone String - The Availability Zone in which to allocate the Dedicated Host.
- asset
Id String - The ID of the Outpost hardware asset.
- auto
Placement String - Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID.
- host
Maintenance String - Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
- host
Recovery String - Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
- instance
Family String - Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
- instance
Type String - Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
- outpost
Arn String - The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.
Outputs
All input properties are implicitly available as output properties. Additionally, the Host resource produces the following output properties:
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.