Try AWS Native preview for resources not in the classic version.
aws.appstream.ImageBuilder
Explore with Pulumi AI
Try AWS Native preview for resources not in the classic version.
Provides an AppStream image builder.
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var testFleet = new Aws.AppStream.ImageBuilder("testFleet", new()
{
Description = "Description of a ImageBuilder",
DisplayName = "Display name of a ImageBuilder",
EnableDefaultInternetAccess = false,
ImageName = "AppStream-WinServer2019-10-05-2022",
InstanceType = "stream.standard.large",
VpcConfig = new Aws.AppStream.Inputs.ImageBuilderVpcConfigArgs
{
SubnetIds = new[]
{
aws_subnet.Example.Id,
},
},
Tags =
{
{ "Name", "Example Image Builder" },
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/appstream"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := appstream.NewImageBuilder(ctx, "testFleet", &appstream.ImageBuilderArgs{
Description: pulumi.String("Description of a ImageBuilder"),
DisplayName: pulumi.String("Display name of a ImageBuilder"),
EnableDefaultInternetAccess: pulumi.Bool(false),
ImageName: pulumi.String("AppStream-WinServer2019-10-05-2022"),
InstanceType: pulumi.String("stream.standard.large"),
VpcConfig: &appstream.ImageBuilderVpcConfigArgs{
SubnetIds: pulumi.StringArray{
aws_subnet.Example.Id,
},
},
Tags: pulumi.StringMap{
"Name": pulumi.String("Example Image Builder"),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.appstream.ImageBuilder;
import com.pulumi.aws.appstream.ImageBuilderArgs;
import com.pulumi.aws.appstream.inputs.ImageBuilderVpcConfigArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var testFleet = new ImageBuilder("testFleet", ImageBuilderArgs.builder()
.description("Description of a ImageBuilder")
.displayName("Display name of a ImageBuilder")
.enableDefaultInternetAccess(false)
.imageName("AppStream-WinServer2019-10-05-2022")
.instanceType("stream.standard.large")
.vpcConfig(ImageBuilderVpcConfigArgs.builder()
.subnetIds(aws_subnet.example().id())
.build())
.tags(Map.of("Name", "Example Image Builder"))
.build());
}
}
import pulumi
import pulumi_aws as aws
test_fleet = aws.appstream.ImageBuilder("testFleet",
description="Description of a ImageBuilder",
display_name="Display name of a ImageBuilder",
enable_default_internet_access=False,
image_name="AppStream-WinServer2019-10-05-2022",
instance_type="stream.standard.large",
vpc_config=aws.appstream.ImageBuilderVpcConfigArgs(
subnet_ids=[aws_subnet["example"]["id"]],
),
tags={
"Name": "Example Image Builder",
})
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const testFleet = new aws.appstream.ImageBuilder("testFleet", {
description: "Description of a ImageBuilder",
displayName: "Display name of a ImageBuilder",
enableDefaultInternetAccess: false,
imageName: "AppStream-WinServer2019-10-05-2022",
instanceType: "stream.standard.large",
vpcConfig: {
subnetIds: [aws_subnet.example.id],
},
tags: {
Name: "Example Image Builder",
},
});
resources:
testFleet:
type: aws:appstream:ImageBuilder
properties:
description: Description of a ImageBuilder
displayName: Display name of a ImageBuilder
enableDefaultInternetAccess: false
imageName: AppStream-WinServer2019-10-05-2022
instanceType: stream.standard.large
vpcConfig:
subnetIds:
- ${aws_subnet.example.id}
tags:
Name: Example Image Builder
Create ImageBuilder Resource
new ImageBuilder(name: string, args: ImageBuilderArgs, opts?: CustomResourceOptions);
@overload
def ImageBuilder(resource_name: str,
opts: Optional[ResourceOptions] = None,
access_endpoints: Optional[Sequence[ImageBuilderAccessEndpointArgs]] = None,
appstream_agent_version: Optional[str] = None,
description: Optional[str] = None,
display_name: Optional[str] = None,
domain_join_info: Optional[ImageBuilderDomainJoinInfoArgs] = None,
enable_default_internet_access: Optional[bool] = None,
iam_role_arn: Optional[str] = None,
image_arn: Optional[str] = None,
image_name: Optional[str] = None,
instance_type: Optional[str] = None,
name: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
vpc_config: Optional[ImageBuilderVpcConfigArgs] = None)
@overload
def ImageBuilder(resource_name: str,
args: ImageBuilderArgs,
opts: Optional[ResourceOptions] = None)
func NewImageBuilder(ctx *Context, name string, args ImageBuilderArgs, opts ...ResourceOption) (*ImageBuilder, error)
public ImageBuilder(string name, ImageBuilderArgs args, CustomResourceOptions? opts = null)
public ImageBuilder(String name, ImageBuilderArgs args)
public ImageBuilder(String name, ImageBuilderArgs args, CustomResourceOptions options)
type: aws:appstream:ImageBuilder
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ImageBuilderArgs
- 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 ImageBuilderArgs
- 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 ImageBuilderArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ImageBuilderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ImageBuilderArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
ImageBuilder Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The ImageBuilder resource accepts the following input properties:
- Instance
Type string Instance type to use when launching the image builder.
- Access
Endpoints List<ImageBuilder Access Endpoint> Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- Appstream
Agent stringVersion Version of the AppStream 2.0 agent to use for this image builder.
- Description string
Description to display.
- Display
Name string Human-readable friendly name for the AppStream image builder.
- Domain
Join ImageInfo Builder Domain Join Info Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- Enable
Default boolInternet Access Enables or disables default internet access for the image builder.
- Iam
Role stringArn ARN of the IAM role to apply to the image builder.
- Image
Arn string ARN of the public, private, or shared image to use.
- Image
Name string Name of the image used to create the image builder.
- Name string
Unique name for the image builder.
The following arguments are optional:
- Dictionary<string, string>
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Vpc
Config ImageBuilder Vpc Config Configuration block for the VPC configuration for the image builder. See below.
- Instance
Type string Instance type to use when launching the image builder.
- Access
Endpoints []ImageBuilder Access Endpoint Args Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- Appstream
Agent stringVersion Version of the AppStream 2.0 agent to use for this image builder.
- Description string
Description to display.
- Display
Name string Human-readable friendly name for the AppStream image builder.
- Domain
Join ImageInfo Builder Domain Join Info Args Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- Enable
Default boolInternet Access Enables or disables default internet access for the image builder.
- Iam
Role stringArn ARN of the IAM role to apply to the image builder.
- Image
Arn string ARN of the public, private, or shared image to use.
- Image
Name string Name of the image used to create the image builder.
- Name string
Unique name for the image builder.
The following arguments are optional:
- map[string]string
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Vpc
Config ImageBuilder Vpc Config Args Configuration block for the VPC configuration for the image builder. See below.
- instance
Type String Instance type to use when launching the image builder.
- access
Endpoints List<ImageBuilder Access Endpoint> Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream
Agent StringVersion Version of the AppStream 2.0 agent to use for this image builder.
- description String
Description to display.
- display
Name String Human-readable friendly name for the AppStream image builder.
- domain
Join ImageInfo Builder Domain Join Info Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable
Default BooleanInternet Access Enables or disables default internet access for the image builder.
- iam
Role StringArn ARN of the IAM role to apply to the image builder.
- image
Arn String ARN of the public, private, or shared image to use.
- image
Name String Name of the image used to create the image builder.
- name String
Unique name for the image builder.
The following arguments are optional:
- Map<String,String>
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- vpc
Config ImageBuilder Vpc Config Configuration block for the VPC configuration for the image builder. See below.
- instance
Type string Instance type to use when launching the image builder.
- access
Endpoints ImageBuilder Access Endpoint[] Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream
Agent stringVersion Version of the AppStream 2.0 agent to use for this image builder.
- description string
Description to display.
- display
Name string Human-readable friendly name for the AppStream image builder.
- domain
Join ImageInfo Builder Domain Join Info Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable
Default booleanInternet Access Enables or disables default internet access for the image builder.
- iam
Role stringArn ARN of the IAM role to apply to the image builder.
- image
Arn string ARN of the public, private, or shared image to use.
- image
Name string Name of the image used to create the image builder.
- name string
Unique name for the image builder.
The following arguments are optional:
- {[key: string]: string}
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- vpc
Config ImageBuilder Vpc Config Configuration block for the VPC configuration for the image builder. See below.
- instance_
type str Instance type to use when launching the image builder.
- access_
endpoints Sequence[ImageBuilder Access Endpoint Args] Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream_
agent_ strversion Version of the AppStream 2.0 agent to use for this image builder.
- description str
Description to display.
- display_
name str Human-readable friendly name for the AppStream image builder.
- domain_
join_ Imageinfo Builder Domain Join Info Args Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable_
default_ boolinternet_ access Enables or disables default internet access for the image builder.
- iam_
role_ strarn ARN of the IAM role to apply to the image builder.
- image_
arn str ARN of the public, private, or shared image to use.
- image_
name str Name of the image used to create the image builder.
- name str
Unique name for the image builder.
The following arguments are optional:
- Mapping[str, str]
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- vpc_
config ImageBuilder Vpc Config Args Configuration block for the VPC configuration for the image builder. See below.
- instance
Type String Instance type to use when launching the image builder.
- access
Endpoints List<Property Map> Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream
Agent StringVersion Version of the AppStream 2.0 agent to use for this image builder.
- description String
Description to display.
- display
Name String Human-readable friendly name for the AppStream image builder.
- domain
Join Property MapInfo Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable
Default BooleanInternet Access Enables or disables default internet access for the image builder.
- iam
Role StringArn ARN of the IAM role to apply to the image builder.
- image
Arn String ARN of the public, private, or shared image to use.
- image
Name String Name of the image used to create the image builder.
- name String
Unique name for the image builder.
The following arguments are optional:
- Map<String>
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- vpc
Config Property Map Configuration block for the VPC configuration for the image builder. See below.
Outputs
All input properties are implicitly available as output properties. Additionally, the ImageBuilder resource produces the following output properties:
- Arn string
ARN of the appstream image builder.
- Created
Time string Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- Id string
The provider-assigned unique ID for this managed resource.
- State string
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Dictionary<string, string>
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- Arn string
ARN of the appstream image builder.
- Created
Time string Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- Id string
The provider-assigned unique ID for this managed resource.
- State string
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- map[string]string
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn String
ARN of the appstream image builder.
- created
Time String Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- id String
The provider-assigned unique ID for this managed resource.
- state String
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Map<String,String>
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn string
ARN of the appstream image builder.
- created
Time string Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- id string
The provider-assigned unique ID for this managed resource.
- state string
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- {[key: string]: string}
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn str
ARN of the appstream image builder.
- created_
time str Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- id str
The provider-assigned unique ID for this managed resource.
- state str
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Mapping[str, str]
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn String
ARN of the appstream image builder.
- created
Time String Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- id String
The provider-assigned unique ID for this managed resource.
- state String
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Map<String>
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
Look up Existing ImageBuilder Resource
Get an existing ImageBuilder 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?: ImageBuilderState, opts?: CustomResourceOptions): ImageBuilder
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
access_endpoints: Optional[Sequence[ImageBuilderAccessEndpointArgs]] = None,
appstream_agent_version: Optional[str] = None,
arn: Optional[str] = None,
created_time: Optional[str] = None,
description: Optional[str] = None,
display_name: Optional[str] = None,
domain_join_info: Optional[ImageBuilderDomainJoinInfoArgs] = None,
enable_default_internet_access: Optional[bool] = None,
iam_role_arn: Optional[str] = None,
image_arn: Optional[str] = None,
image_name: Optional[str] = None,
instance_type: Optional[str] = None,
name: Optional[str] = None,
state: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None,
vpc_config: Optional[ImageBuilderVpcConfigArgs] = None) -> ImageBuilder
func GetImageBuilder(ctx *Context, name string, id IDInput, state *ImageBuilderState, opts ...ResourceOption) (*ImageBuilder, error)
public static ImageBuilder Get(string name, Input<string> id, ImageBuilderState? state, CustomResourceOptions? opts = null)
public static ImageBuilder get(String name, Output<String> id, ImageBuilderState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- 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.
- Access
Endpoints List<ImageBuilder Access Endpoint> Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- Appstream
Agent stringVersion Version of the AppStream 2.0 agent to use for this image builder.
- Arn string
ARN of the appstream image builder.
- Created
Time string Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- Description string
Description to display.
- Display
Name string Human-readable friendly name for the AppStream image builder.
- Domain
Join ImageInfo Builder Domain Join Info Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- Enable
Default boolInternet Access Enables or disables default internet access for the image builder.
- Iam
Role stringArn ARN of the IAM role to apply to the image builder.
- Image
Arn string ARN of the public, private, or shared image to use.
- Image
Name string Name of the image used to create the image builder.
- Instance
Type string Instance type to use when launching the image builder.
- Name string
Unique name for the image builder.
The following arguments are optional:
- State string
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Dictionary<string, string>
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Dictionary<string, string>
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.- Vpc
Config ImageBuilder Vpc Config Configuration block for the VPC configuration for the image builder. See below.
- Access
Endpoints []ImageBuilder Access Endpoint Args Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- Appstream
Agent stringVersion Version of the AppStream 2.0 agent to use for this image builder.
- Arn string
ARN of the appstream image builder.
- Created
Time string Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- Description string
Description to display.
- Display
Name string Human-readable friendly name for the AppStream image builder.
- Domain
Join ImageInfo Builder Domain Join Info Args Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- Enable
Default boolInternet Access Enables or disables default internet access for the image builder.
- Iam
Role stringArn ARN of the IAM role to apply to the image builder.
- Image
Arn string ARN of the public, private, or shared image to use.
- Image
Name string Name of the image used to create the image builder.
- Instance
Type string Instance type to use when launching the image builder.
- Name string
Unique name for the image builder.
The following arguments are optional:
- State string
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- map[string]string
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- map[string]string
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.- Vpc
Config ImageBuilder Vpc Config Args Configuration block for the VPC configuration for the image builder. See below.
- access
Endpoints List<ImageBuilder Access Endpoint> Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream
Agent StringVersion Version of the AppStream 2.0 agent to use for this image builder.
- arn String
ARN of the appstream image builder.
- created
Time String Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- description String
Description to display.
- display
Name String Human-readable friendly name for the AppStream image builder.
- domain
Join ImageInfo Builder Domain Join Info Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable
Default BooleanInternet Access Enables or disables default internet access for the image builder.
- iam
Role StringArn ARN of the IAM role to apply to the image builder.
- image
Arn String ARN of the public, private, or shared image to use.
- image
Name String Name of the image used to create the image builder.
- instance
Type String Instance type to use when launching the image builder.
- name String
Unique name for the image builder.
The following arguments are optional:
- state String
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Map<String,String>
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Map<String,String>
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.- vpc
Config ImageBuilder Vpc Config Configuration block for the VPC configuration for the image builder. See below.
- access
Endpoints ImageBuilder Access Endpoint[] Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream
Agent stringVersion Version of the AppStream 2.0 agent to use for this image builder.
- arn string
ARN of the appstream image builder.
- created
Time string Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- description string
Description to display.
- display
Name string Human-readable friendly name for the AppStream image builder.
- domain
Join ImageInfo Builder Domain Join Info Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable
Default booleanInternet Access Enables or disables default internet access for the image builder.
- iam
Role stringArn ARN of the IAM role to apply to the image builder.
- image
Arn string ARN of the public, private, or shared image to use.
- image
Name string Name of the image used to create the image builder.
- instance
Type string Instance type to use when launching the image builder.
- name string
Unique name for the image builder.
The following arguments are optional:
- state string
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- {[key: string]: string}
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- {[key: string]: string}
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.- vpc
Config ImageBuilder Vpc Config Configuration block for the VPC configuration for the image builder. See below.
- access_
endpoints Sequence[ImageBuilder Access Endpoint Args] Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream_
agent_ strversion Version of the AppStream 2.0 agent to use for this image builder.
- arn str
ARN of the appstream image builder.
- created_
time str Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- description str
Description to display.
- display_
name str Human-readable friendly name for the AppStream image builder.
- domain_
join_ Imageinfo Builder Domain Join Info Args Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable_
default_ boolinternet_ access Enables or disables default internet access for the image builder.
- iam_
role_ strarn ARN of the IAM role to apply to the image builder.
- image_
arn str ARN of the public, private, or shared image to use.
- image_
name str Name of the image used to create the image builder.
- instance_
type str Instance type to use when launching the image builder.
- name str
Unique name for the image builder.
The following arguments are optional:
- state str
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Mapping[str, str]
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Mapping[str, str]
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.- vpc_
config ImageBuilder Vpc Config Args Configuration block for the VPC configuration for the image builder. See below.
- access
Endpoints List<Property Map> Set of interface VPC endpoint (interface endpoint) objects. Maximum of 4. See below.
- appstream
Agent StringVersion Version of the AppStream 2.0 agent to use for this image builder.
- arn String
ARN of the appstream image builder.
- created
Time String Date and time, in UTC and extended RFC 3339 format, when the image builder was created.
- description String
Description to display.
- display
Name String Human-readable friendly name for the AppStream image builder.
- domain
Join Property MapInfo Configuration block for the name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. See below.
- enable
Default BooleanInternet Access Enables or disables default internet access for the image builder.
- iam
Role StringArn ARN of the IAM role to apply to the image builder.
- image
Arn String ARN of the public, private, or shared image to use.
- image
Name String Name of the image used to create the image builder.
- instance
Type String Instance type to use when launching the image builder.
- name String
Unique name for the image builder.
The following arguments are optional:
- state String
State of the image builder. Can be:
PENDING
,UPDATING_AGENT
,RUNNING
,STOPPING
,STOPPED
,REBOOTING
,SNAPSHOTTING
,DELETING
,FAILED
,UPDATING
,PENDING_QUALIFICATION
- Map<String>
Map of tags to assign to the instance. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Map<String>
Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.- vpc
Config Property Map Configuration block for the VPC configuration for the image builder. See below.
Supporting Types
ImageBuilderAccessEndpoint, ImageBuilderAccessEndpointArgs
- Endpoint
Type string Type of interface endpoint.
- Vpce
Id string Identifier (ID) of the VPC in which the interface endpoint is used.
- Endpoint
Type string Type of interface endpoint.
- Vpce
Id string Identifier (ID) of the VPC in which the interface endpoint is used.
- endpoint
Type String Type of interface endpoint.
- vpce
Id String Identifier (ID) of the VPC in which the interface endpoint is used.
- endpoint
Type string Type of interface endpoint.
- vpce
Id string Identifier (ID) of the VPC in which the interface endpoint is used.
- endpoint_
type str Type of interface endpoint.
- vpce_
id str Identifier (ID) of the VPC in which the interface endpoint is used.
- endpoint
Type String Type of interface endpoint.
- vpce
Id String Identifier (ID) of the VPC in which the interface endpoint is used.
ImageBuilderDomainJoinInfo, ImageBuilderDomainJoinInfoArgs
- Directory
Name string Fully qualified name of the directory (for example, corp.example.com).
- Organizational
Unit stringDistinguished Name Distinguished name of the organizational unit for computer accounts.
- Directory
Name string Fully qualified name of the directory (for example, corp.example.com).
- Organizational
Unit stringDistinguished Name Distinguished name of the organizational unit for computer accounts.
- directory
Name String Fully qualified name of the directory (for example, corp.example.com).
- organizational
Unit StringDistinguished Name Distinguished name of the organizational unit for computer accounts.
- directory
Name string Fully qualified name of the directory (for example, corp.example.com).
- organizational
Unit stringDistinguished Name Distinguished name of the organizational unit for computer accounts.
- directory_
name str Fully qualified name of the directory (for example, corp.example.com).
- organizational_
unit_ strdistinguished_ name Distinguished name of the organizational unit for computer accounts.
- directory
Name String Fully qualified name of the directory (for example, corp.example.com).
- organizational
Unit StringDistinguished Name Distinguished name of the organizational unit for computer accounts.
ImageBuilderVpcConfig, ImageBuilderVpcConfigArgs
- Security
Group List<string>Ids Identifiers of the security groups for the image builder or image builder.
- Subnet
Ids List<string> Identifier of the subnet to which a network interface is attached from the image builder instance.
- Security
Group []stringIds Identifiers of the security groups for the image builder or image builder.
- Subnet
Ids []string Identifier of the subnet to which a network interface is attached from the image builder instance.
- security
Group List<String>Ids Identifiers of the security groups for the image builder or image builder.
- subnet
Ids List<String> Identifier of the subnet to which a network interface is attached from the image builder instance.
- security
Group string[]Ids Identifiers of the security groups for the image builder or image builder.
- subnet
Ids string[] Identifier of the subnet to which a network interface is attached from the image builder instance.
- security_
group_ Sequence[str]ids Identifiers of the security groups for the image builder or image builder.
- subnet_
ids Sequence[str] Identifier of the subnet to which a network interface is attached from the image builder instance.
- security
Group List<String>Ids Identifiers of the security groups for the image builder or image builder.
- subnet
Ids List<String> Identifier of the subnet to which a network interface is attached from the image builder instance.
Import
Using pulumi import
, import aws_appstream_image_builder
using the name
. For example:
$ pulumi import aws:appstream/imageBuilder:ImageBuilder example imageBuilderExample
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
aws
Terraform Provider.
Try AWS Native preview for resources not in the classic version.