We recommend new projects start with resources from the AWS provider.
aws-native.imagebuilder.Component
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
Resource schema for AWS::ImageBuilder::Component
Example Usage
Example
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;
return await Deployment.RunAsync(() =>
{
var componentAllParameters = new AwsNative.ImageBuilder.Component("componentAllParameters", new()
{
Name = "component-name",
Platform = AwsNative.ImageBuilder.ComponentPlatform.Linux,
Version = "1.0.0",
Description = "description",
ChangeDescription = "change-description",
KmsKeyId = "customer-kms-key-id",
SupportedOsVersions = new[]
{
"Amazon Linux 2",
},
Tags =
{
{ "customerComponentTagKey1", "CustomerComponentTagValue1" },
{ "customerComponentTagKey2", "CustomerComponentTagValue2" },
},
Data = @"name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo ""Hello World! Build.""
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo ""Hello World! Validate.""
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo ""Hello World! Test.""
",
});
});
package main
import (
"github.com/pulumi/pulumi-aws-native/sdk/go/aws/imagebuilder"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := imagebuilder.NewComponent(ctx, "componentAllParameters", &imagebuilder.ComponentArgs{
Name: pulumi.String("component-name"),
Platform: imagebuilder.ComponentPlatformLinux,
Version: pulumi.String("1.0.0"),
Description: pulumi.String("description"),
ChangeDescription: pulumi.String("change-description"),
KmsKeyId: pulumi.String("customer-kms-key-id"),
SupportedOsVersions: pulumi.StringArray{
pulumi.String("Amazon Linux 2"),
},
Tags: pulumi.StringMap{
"customerComponentTagKey1": pulumi.String("CustomerComponentTagValue1"),
"customerComponentTagKey2": pulumi.String("CustomerComponentTagValue2"),
},
Data: pulumi.String(`name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Build."
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Validate."
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Test."
`),
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_aws_native as aws_native
component_all_parameters = aws_native.imagebuilder.Component("componentAllParameters",
name="component-name",
platform=aws_native.imagebuilder.ComponentPlatform.LINUX,
version="1.0.0",
description="description",
change_description="change-description",
kms_key_id="customer-kms-key-id",
supported_os_versions=["Amazon Linux 2"],
tags={
"customerComponentTagKey1": "CustomerComponentTagValue1",
"customerComponentTagKey2": "CustomerComponentTagValue2",
},
data="""name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Build."
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Validate."
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Test."
""")
import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";
const componentAllParameters = new aws_native.imagebuilder.Component("componentAllParameters", {
name: "component-name",
platform: aws_native.imagebuilder.ComponentPlatform.Linux,
version: "1.0.0",
description: "description",
changeDescription: "change-description",
kmsKeyId: "customer-kms-key-id",
supportedOsVersions: ["Amazon Linux 2"],
tags: {
customerComponentTagKey1: "CustomerComponentTagValue1",
customerComponentTagKey2: "CustomerComponentTagValue2",
},
data: `name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Build."
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Validate."
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Test."
`,
});
Coming soon!
Example
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;
return await Deployment.RunAsync(() =>
{
var componentAllParameters = new AwsNative.ImageBuilder.Component("componentAllParameters", new()
{
Name = "component-name",
Platform = AwsNative.ImageBuilder.ComponentPlatform.Linux,
Version = "1.0.0",
Description = "description",
ChangeDescription = "change-description",
KmsKeyId = "customer-kms-key-id",
SupportedOsVersions = new[]
{
"Amazon Linux 2",
},
Tags =
{
{ "customerComponentTagKey1", "CustomerComponentTagValue1" },
{ "customerComponentTagKey2", "CustomerComponentTagValue2" },
},
Data = @"name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo ""Hello World! Build.""
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo ""Hello World! Validate.""
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo ""Hello World! Test.""
",
});
});
package main
import (
"github.com/pulumi/pulumi-aws-native/sdk/go/aws/imagebuilder"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := imagebuilder.NewComponent(ctx, "componentAllParameters", &imagebuilder.ComponentArgs{
Name: pulumi.String("component-name"),
Platform: imagebuilder.ComponentPlatformLinux,
Version: pulumi.String("1.0.0"),
Description: pulumi.String("description"),
ChangeDescription: pulumi.String("change-description"),
KmsKeyId: pulumi.String("customer-kms-key-id"),
SupportedOsVersions: pulumi.StringArray{
pulumi.String("Amazon Linux 2"),
},
Tags: pulumi.StringMap{
"customerComponentTagKey1": pulumi.String("CustomerComponentTagValue1"),
"customerComponentTagKey2": pulumi.String("CustomerComponentTagValue2"),
},
Data: pulumi.String(`name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Build."
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Validate."
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Test."
`),
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_aws_native as aws_native
component_all_parameters = aws_native.imagebuilder.Component("componentAllParameters",
name="component-name",
platform=aws_native.imagebuilder.ComponentPlatform.LINUX,
version="1.0.0",
description="description",
change_description="change-description",
kms_key_id="customer-kms-key-id",
supported_os_versions=["Amazon Linux 2"],
tags={
"customerComponentTagKey1": "CustomerComponentTagValue1",
"customerComponentTagKey2": "CustomerComponentTagValue2",
},
data="""name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Build."
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Validate."
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Test."
""")
import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";
const componentAllParameters = new aws_native.imagebuilder.Component("componentAllParameters", {
name: "component-name",
platform: aws_native.imagebuilder.ComponentPlatform.Linux,
version: "1.0.0",
description: "description",
changeDescription: "change-description",
kmsKeyId: "customer-kms-key-id",
supportedOsVersions: ["Amazon Linux 2"],
tags: {
customerComponentTagKey1: "CustomerComponentTagValue1",
customerComponentTagKey2: "CustomerComponentTagValue2",
},
data: `name: HelloWorldTestingLinuxDoc - InlineData
description: This is hello world testing doc
schemaVersion: 1.0
phases:
- name: build
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Build."
- name: validate
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Validate."
- name: test
steps:
- name: HelloWorldStep
action: ExecuteBash
inputs:
commands:
- echo "Hello World! Test."
`,
});
Coming soon!
Example
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;
return await Deployment.RunAsync(() =>
{
var componentAllParameters = new AwsNative.ImageBuilder.Component("componentAllParameters", new()
{
Name = "component-name",
Platform = AwsNative.ImageBuilder.ComponentPlatform.Linux,
Version = "1.0.0",
Uri = "s3://imagebuilder/component_document.yml",
Description = "description",
ChangeDescription = "change-description",
KmsKeyId = "customer-kms-key-id",
SupportedOsVersions = new[]
{
"CentOS",
"Red Hat Enterprise Linux",
},
Tags =
{
{ "customerComponentTagKey1", "CustomerComponentTagValue1" },
{ "customerComponentTagKey2", "CustomerComponentTagValue2" },
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws-native/sdk/go/aws/imagebuilder"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := imagebuilder.NewComponent(ctx, "componentAllParameters", &imagebuilder.ComponentArgs{
Name: pulumi.String("component-name"),
Platform: imagebuilder.ComponentPlatformLinux,
Version: pulumi.String("1.0.0"),
Uri: pulumi.String("s3://imagebuilder/component_document.yml"),
Description: pulumi.String("description"),
ChangeDescription: pulumi.String("change-description"),
KmsKeyId: pulumi.String("customer-kms-key-id"),
SupportedOsVersions: pulumi.StringArray{
pulumi.String("CentOS"),
pulumi.String("Red Hat Enterprise Linux"),
},
Tags: pulumi.StringMap{
"customerComponentTagKey1": pulumi.String("CustomerComponentTagValue1"),
"customerComponentTagKey2": pulumi.String("CustomerComponentTagValue2"),
},
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_aws_native as aws_native
component_all_parameters = aws_native.imagebuilder.Component("componentAllParameters",
name="component-name",
platform=aws_native.imagebuilder.ComponentPlatform.LINUX,
version="1.0.0",
uri="s3://imagebuilder/component_document.yml",
description="description",
change_description="change-description",
kms_key_id="customer-kms-key-id",
supported_os_versions=[
"CentOS",
"Red Hat Enterprise Linux",
],
tags={
"customerComponentTagKey1": "CustomerComponentTagValue1",
"customerComponentTagKey2": "CustomerComponentTagValue2",
})
import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";
const componentAllParameters = new aws_native.imagebuilder.Component("componentAllParameters", {
name: "component-name",
platform: aws_native.imagebuilder.ComponentPlatform.Linux,
version: "1.0.0",
uri: "s3://imagebuilder/component_document.yml",
description: "description",
changeDescription: "change-description",
kmsKeyId: "customer-kms-key-id",
supportedOsVersions: [
"CentOS",
"Red Hat Enterprise Linux",
],
tags: {
customerComponentTagKey1: "CustomerComponentTagValue1",
customerComponentTagKey2: "CustomerComponentTagValue2",
},
});
Coming soon!
Example
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;
return await Deployment.RunAsync(() =>
{
var componentAllParameters = new AwsNative.ImageBuilder.Component("componentAllParameters", new()
{
Name = "component-name",
Platform = AwsNative.ImageBuilder.ComponentPlatform.Linux,
Version = "1.0.0",
Uri = "s3://imagebuilder/component_document.yml",
Description = "description",
ChangeDescription = "change-description",
KmsKeyId = "customer-kms-key-id",
SupportedOsVersions = new[]
{
"CentOS",
"Red Hat Enterprise Linux",
},
Tags =
{
{ "customerComponentTagKey1", "CustomerComponentTagValue1" },
{ "customerComponentTagKey2", "CustomerComponentTagValue2" },
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws-native/sdk/go/aws/imagebuilder"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := imagebuilder.NewComponent(ctx, "componentAllParameters", &imagebuilder.ComponentArgs{
Name: pulumi.String("component-name"),
Platform: imagebuilder.ComponentPlatformLinux,
Version: pulumi.String("1.0.0"),
Uri: pulumi.String("s3://imagebuilder/component_document.yml"),
Description: pulumi.String("description"),
ChangeDescription: pulumi.String("change-description"),
KmsKeyId: pulumi.String("customer-kms-key-id"),
SupportedOsVersions: pulumi.StringArray{
pulumi.String("CentOS"),
pulumi.String("Red Hat Enterprise Linux"),
},
Tags: pulumi.StringMap{
"customerComponentTagKey1": pulumi.String("CustomerComponentTagValue1"),
"customerComponentTagKey2": pulumi.String("CustomerComponentTagValue2"),
},
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_aws_native as aws_native
component_all_parameters = aws_native.imagebuilder.Component("componentAllParameters",
name="component-name",
platform=aws_native.imagebuilder.ComponentPlatform.LINUX,
version="1.0.0",
uri="s3://imagebuilder/component_document.yml",
description="description",
change_description="change-description",
kms_key_id="customer-kms-key-id",
supported_os_versions=[
"CentOS",
"Red Hat Enterprise Linux",
],
tags={
"customerComponentTagKey1": "CustomerComponentTagValue1",
"customerComponentTagKey2": "CustomerComponentTagValue2",
})
import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";
const componentAllParameters = new aws_native.imagebuilder.Component("componentAllParameters", {
name: "component-name",
platform: aws_native.imagebuilder.ComponentPlatform.Linux,
version: "1.0.0",
uri: "s3://imagebuilder/component_document.yml",
description: "description",
changeDescription: "change-description",
kmsKeyId: "customer-kms-key-id",
supportedOsVersions: [
"CentOS",
"Red Hat Enterprise Linux",
],
tags: {
customerComponentTagKey1: "CustomerComponentTagValue1",
customerComponentTagKey2: "CustomerComponentTagValue2",
},
});
Coming soon!
Create Component Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Component(name: string, args: ComponentArgs, opts?: CustomResourceOptions);
@overload
def Component(resource_name: str,
args: ComponentArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Component(resource_name: str,
opts: Optional[ResourceOptions] = None,
platform: Optional[ComponentPlatform] = None,
version: Optional[str] = None,
change_description: Optional[str] = None,
data: Optional[str] = None,
description: Optional[str] = None,
kms_key_id: Optional[str] = None,
name: Optional[str] = None,
supported_os_versions: Optional[Sequence[str]] = None,
tags: Optional[Mapping[str, str]] = None,
uri: Optional[str] = None)
func NewComponent(ctx *Context, name string, args ComponentArgs, opts ...ResourceOption) (*Component, error)
public Component(string name, ComponentArgs args, CustomResourceOptions? opts = null)
public Component(String name, ComponentArgs args)
public Component(String name, ComponentArgs args, CustomResourceOptions options)
type: aws-native:imagebuilder:Component
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 ComponentArgs
- 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 ComponentArgs
- 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 ComponentArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ComponentArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ComponentArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Component 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 Component resource accepts the following input properties:
- Platform
Pulumi.
Aws Native. Image Builder. Component Platform - The platform of the component.
- Version string
- The version of the component.
- Change
Description string - The change description of the component.
- Data string
- The data of the component.
- Description string
- The description of the component.
- Kms
Key stringId - The KMS key identifier used to encrypt the component.
- Name string
- The name of the component.
- Supported
Os List<string>Versions - The operating system (OS) version supported by the component.
- Dictionary<string, string>
- The tags associated with the component.
- Uri string
- The uri of the component.
- Platform
Component
Platform - The platform of the component.
- Version string
- The version of the component.
- Change
Description string - The change description of the component.
- Data string
- The data of the component.
- Description string
- The description of the component.
- Kms
Key stringId - The KMS key identifier used to encrypt the component.
- Name string
- The name of the component.
- Supported
Os []stringVersions - The operating system (OS) version supported by the component.
- map[string]string
- The tags associated with the component.
- Uri string
- The uri of the component.
- platform
Component
Platform - The platform of the component.
- version String
- The version of the component.
- change
Description String - The change description of the component.
- data String
- The data of the component.
- description String
- The description of the component.
- kms
Key StringId - The KMS key identifier used to encrypt the component.
- name String
- The name of the component.
- supported
Os List<String>Versions - The operating system (OS) version supported by the component.
- Map<String,String>
- The tags associated with the component.
- uri String
- The uri of the component.
- platform
Component
Platform - The platform of the component.
- version string
- The version of the component.
- change
Description string - The change description of the component.
- data string
- The data of the component.
- description string
- The description of the component.
- kms
Key stringId - The KMS key identifier used to encrypt the component.
- name string
- The name of the component.
- supported
Os string[]Versions - The operating system (OS) version supported by the component.
- {[key: string]: string}
- The tags associated with the component.
- uri string
- The uri of the component.
- platform
Component
Platform - The platform of the component.
- version str
- The version of the component.
- change_
description str - The change description of the component.
- data str
- The data of the component.
- description str
- The description of the component.
- kms_
key_ strid - The KMS key identifier used to encrypt the component.
- name str
- The name of the component.
- supported_
os_ Sequence[str]versions - The operating system (OS) version supported by the component.
- Mapping[str, str]
- The tags associated with the component.
- uri str
- The uri of the component.
- platform
"Windows" | "Linux" | "mac
OS" - The platform of the component.
- version String
- The version of the component.
- change
Description String - The change description of the component.
- data String
- The data of the component.
- description String
- The description of the component.
- kms
Key StringId - The KMS key identifier used to encrypt the component.
- name String
- The name of the component.
- supported
Os List<String>Versions - The operating system (OS) version supported by the component.
- Map<String>
- The tags associated with the component.
- uri String
- The uri of the component.
Outputs
All input properties are implicitly available as output properties. Additionally, the Component resource produces the following output properties:
- Arn string
- The Amazon Resource Name (ARN) of the component.
- Encrypted bool
- The encryption status of the component.
- Id string
- The provider-assigned unique ID for this managed resource.
- Type
Pulumi.
Aws Native. Image Builder. Component Type - The type of the component denotes whether the component is used to build the image or only to test it.
- Arn string
- The Amazon Resource Name (ARN) of the component.
- Encrypted bool
- The encryption status of the component.
- Id string
- The provider-assigned unique ID for this managed resource.
- Type
Component
Type - The type of the component denotes whether the component is used to build the image or only to test it.
- arn String
- The Amazon Resource Name (ARN) of the component.
- encrypted Boolean
- The encryption status of the component.
- id String
- The provider-assigned unique ID for this managed resource.
- type
Component
Type - The type of the component denotes whether the component is used to build the image or only to test it.
- arn string
- The Amazon Resource Name (ARN) of the component.
- encrypted boolean
- The encryption status of the component.
- id string
- The provider-assigned unique ID for this managed resource.
- type
Component
Type - The type of the component denotes whether the component is used to build the image or only to test it.
- arn str
- The Amazon Resource Name (ARN) of the component.
- encrypted bool
- The encryption status of the component.
- id str
- The provider-assigned unique ID for this managed resource.
- type
Component
Type - The type of the component denotes whether the component is used to build the image or only to test it.
- arn String
- The Amazon Resource Name (ARN) of the component.
- encrypted Boolean
- The encryption status of the component.
- id String
- The provider-assigned unique ID for this managed resource.
- type "BUILD" | "TEST"
- The type of the component denotes whether the component is used to build the image or only to test it.
Supporting Types
ComponentPlatform, ComponentPlatformArgs
- Windows
- Windows
- Linux
- Linux
- Mac
Os - macOS
- Component
Platform Windows - Windows
- Component
Platform Linux - Linux
- Component
Platform Mac Os - macOS
- Windows
- Windows
- Linux
- Linux
- Mac
Os - macOS
- Windows
- Windows
- Linux
- Linux
- Mac
Os - macOS
- WINDOWS
- Windows
- LINUX
- Linux
- MAC_OS
- macOS
- "Windows"
- Windows
- "Linux"
- Linux
- "mac
OS" - macOS
ComponentType, ComponentTypeArgs
- Build
- BUILD
- Test
- TEST
- Component
Type Build - BUILD
- Component
Type Test - TEST
- Build
- BUILD
- Test
- TEST
- Build
- BUILD
- Test
- TEST
- BUILD
- BUILD
- TEST
- TEST
- "BUILD"
- BUILD
- "TEST"
- TEST
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.