Documentation ¶
Index ¶
- type Connection
- type ConnectionArgs
- type ConnectionArray
- func (ConnectionArray) ElementType() reflect.Type
- func (i ConnectionArray) ToConnectionArrayOutput() ConnectionArrayOutput
- func (i ConnectionArray) ToConnectionArrayOutputWithContext(ctx context.Context) ConnectionArrayOutput
- func (i ConnectionArray) ToOutput(ctx context.Context) pulumix.Output[[]*Connection]
- type ConnectionArrayInput
- type ConnectionArrayOutput
- func (ConnectionArrayOutput) ElementType() reflect.Type
- func (o ConnectionArrayOutput) Index(i pulumi.IntInput) ConnectionOutput
- func (o ConnectionArrayOutput) ToConnectionArrayOutput() ConnectionArrayOutput
- func (o ConnectionArrayOutput) ToConnectionArrayOutputWithContext(ctx context.Context) ConnectionArrayOutput
- func (o ConnectionArrayOutput) ToOutput(ctx context.Context) pulumix.Output[[]*Connection]
- type ConnectionInput
- type ConnectionMap
- func (ConnectionMap) ElementType() reflect.Type
- func (i ConnectionMap) ToConnectionMapOutput() ConnectionMapOutput
- func (i ConnectionMap) ToConnectionMapOutputWithContext(ctx context.Context) ConnectionMapOutput
- func (i ConnectionMap) ToOutput(ctx context.Context) pulumix.Output[map[string]*Connection]
- type ConnectionMapInput
- type ConnectionMapOutput
- func (ConnectionMapOutput) ElementType() reflect.Type
- func (o ConnectionMapOutput) MapIndex(k pulumi.StringInput) ConnectionOutput
- func (o ConnectionMapOutput) ToConnectionMapOutput() ConnectionMapOutput
- func (o ConnectionMapOutput) ToConnectionMapOutputWithContext(ctx context.Context) ConnectionMapOutput
- func (o ConnectionMapOutput) ToOutput(ctx context.Context) pulumix.Output[map[string]*Connection]
- type ConnectionOutput
- func (o ConnectionOutput) Arn() pulumi.StringOutput
- func (o ConnectionOutput) ConnectionStatus() pulumi.StringOutput
- func (ConnectionOutput) ElementType() reflect.Type
- func (o ConnectionOutput) HostArn() pulumi.StringPtrOutput
- func (o ConnectionOutput) Name() pulumi.StringOutput
- func (o ConnectionOutput) ProviderType() pulumi.StringOutput
- func (o ConnectionOutput) Tags() pulumi.StringMapOutput
- func (o ConnectionOutput) TagsAll() pulumi.StringMapOutputdeprecated
- func (o ConnectionOutput) ToConnectionOutput() ConnectionOutput
- func (o ConnectionOutput) ToConnectionOutputWithContext(ctx context.Context) ConnectionOutput
- func (o ConnectionOutput) ToOutput(ctx context.Context) pulumix.Output[*Connection]
- type ConnectionState
- type Host
- type HostArgs
- type HostArray
- type HostArrayInput
- type HostArrayOutput
- func (HostArrayOutput) ElementType() reflect.Type
- func (o HostArrayOutput) Index(i pulumi.IntInput) HostOutput
- func (o HostArrayOutput) ToHostArrayOutput() HostArrayOutput
- func (o HostArrayOutput) ToHostArrayOutputWithContext(ctx context.Context) HostArrayOutput
- func (o HostArrayOutput) ToOutput(ctx context.Context) pulumix.Output[[]*Host]
- type HostInput
- type HostMap
- type HostMapInput
- type HostMapOutput
- func (HostMapOutput) ElementType() reflect.Type
- func (o HostMapOutput) MapIndex(k pulumi.StringInput) HostOutput
- func (o HostMapOutput) ToHostMapOutput() HostMapOutput
- func (o HostMapOutput) ToHostMapOutputWithContext(ctx context.Context) HostMapOutput
- func (o HostMapOutput) ToOutput(ctx context.Context) pulumix.Output[map[string]*Host]
- type HostOutput
- func (o HostOutput) Arn() pulumi.StringOutput
- func (HostOutput) ElementType() reflect.Type
- func (o HostOutput) Name() pulumi.StringOutput
- func (o HostOutput) ProviderEndpoint() pulumi.StringOutput
- func (o HostOutput) ProviderType() pulumi.StringOutput
- func (o HostOutput) Status() pulumi.StringOutput
- func (o HostOutput) ToHostOutput() HostOutput
- func (o HostOutput) ToHostOutputWithContext(ctx context.Context) HostOutput
- func (o HostOutput) ToOutput(ctx context.Context) pulumix.Output[*Host]
- func (o HostOutput) VpcConfiguration() HostVpcConfigurationPtrOutput
- type HostState
- type HostVpcConfiguration
- type HostVpcConfigurationArgs
- func (HostVpcConfigurationArgs) ElementType() reflect.Type
- func (i HostVpcConfigurationArgs) ToHostVpcConfigurationOutput() HostVpcConfigurationOutput
- func (i HostVpcConfigurationArgs) ToHostVpcConfigurationOutputWithContext(ctx context.Context) HostVpcConfigurationOutput
- func (i HostVpcConfigurationArgs) ToHostVpcConfigurationPtrOutput() HostVpcConfigurationPtrOutput
- func (i HostVpcConfigurationArgs) ToHostVpcConfigurationPtrOutputWithContext(ctx context.Context) HostVpcConfigurationPtrOutput
- func (i HostVpcConfigurationArgs) ToOutput(ctx context.Context) pulumix.Output[HostVpcConfiguration]
- type HostVpcConfigurationInput
- type HostVpcConfigurationOutput
- func (HostVpcConfigurationOutput) ElementType() reflect.Type
- func (o HostVpcConfigurationOutput) SecurityGroupIds() pulumi.StringArrayOutput
- func (o HostVpcConfigurationOutput) SubnetIds() pulumi.StringArrayOutput
- func (o HostVpcConfigurationOutput) TlsCertificate() pulumi.StringPtrOutput
- func (o HostVpcConfigurationOutput) ToHostVpcConfigurationOutput() HostVpcConfigurationOutput
- func (o HostVpcConfigurationOutput) ToHostVpcConfigurationOutputWithContext(ctx context.Context) HostVpcConfigurationOutput
- func (o HostVpcConfigurationOutput) ToHostVpcConfigurationPtrOutput() HostVpcConfigurationPtrOutput
- func (o HostVpcConfigurationOutput) ToHostVpcConfigurationPtrOutputWithContext(ctx context.Context) HostVpcConfigurationPtrOutput
- func (o HostVpcConfigurationOutput) ToOutput(ctx context.Context) pulumix.Output[HostVpcConfiguration]
- func (o HostVpcConfigurationOutput) VpcId() pulumi.StringOutput
- type HostVpcConfigurationPtrInput
- type HostVpcConfigurationPtrOutput
- func (o HostVpcConfigurationPtrOutput) Elem() HostVpcConfigurationOutput
- func (HostVpcConfigurationPtrOutput) ElementType() reflect.Type
- func (o HostVpcConfigurationPtrOutput) SecurityGroupIds() pulumi.StringArrayOutput
- func (o HostVpcConfigurationPtrOutput) SubnetIds() pulumi.StringArrayOutput
- func (o HostVpcConfigurationPtrOutput) TlsCertificate() pulumi.StringPtrOutput
- func (o HostVpcConfigurationPtrOutput) ToHostVpcConfigurationPtrOutput() HostVpcConfigurationPtrOutput
- func (o HostVpcConfigurationPtrOutput) ToHostVpcConfigurationPtrOutputWithContext(ctx context.Context) HostVpcConfigurationPtrOutput
- func (o HostVpcConfigurationPtrOutput) ToOutput(ctx context.Context) pulumix.Output[*HostVpcConfiguration]
- func (o HostVpcConfigurationPtrOutput) VpcId() pulumi.StringPtrOutput
- type LookupConnectionArgs
- type LookupConnectionOutputArgs
- type LookupConnectionResult
- type LookupConnectionResultOutput
- func (o LookupConnectionResultOutput) Arn() pulumi.StringOutput
- func (o LookupConnectionResultOutput) ConnectionStatus() pulumi.StringOutput
- func (LookupConnectionResultOutput) ElementType() reflect.Type
- func (o LookupConnectionResultOutput) HostArn() pulumi.StringOutput
- func (o LookupConnectionResultOutput) Id() pulumi.StringOutput
- func (o LookupConnectionResultOutput) Name() pulumi.StringOutput
- func (o LookupConnectionResultOutput) ProviderType() pulumi.StringOutput
- func (o LookupConnectionResultOutput) Tags() pulumi.StringMapOutput
- func (o LookupConnectionResultOutput) ToLookupConnectionResultOutput() LookupConnectionResultOutput
- func (o LookupConnectionResultOutput) ToLookupConnectionResultOutputWithContext(ctx context.Context) LookupConnectionResultOutput
- func (o LookupConnectionResultOutput) ToOutput(ctx context.Context) pulumix.Output[LookupConnectionResult]
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Connection ¶
type Connection struct { pulumi.CustomResourceState // The codestar connection ARN. Arn pulumi.StringOutput `pulumi:"arn"` // The codestar connection status. Possible values are `PENDING`, `AVAILABLE` and `ERROR`. ConnectionStatus pulumi.StringOutput `pulumi:"connectionStatus"` // The Amazon Resource Name (ARN) of the host associated with the connection. Conflicts with `providerType` HostArn pulumi.StringPtrOutput `pulumi:"hostArn"` // The name of the connection to be created. The name must be unique in the calling AWS account. Changing `name` will create a new resource. Name pulumi.StringOutput `pulumi:"name"` // The name of the external provider where your third-party code repository is configured. Valid values are `Bitbucket`, `GitHub` or `GitHubEnterpriseServer`. Changing `providerType` will create a new resource. Conflicts with `hostArn` ProviderType pulumi.StringOutput `pulumi:"providerType"` // Map of key-value resource tags to associate with the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. Tags pulumi.StringMapOutput `pulumi:"tags"` // A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. // // Deprecated: Please use `tags` instead. TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"` }
Provides a CodeStar Connection.
> **NOTE:** The `codestarconnections.Connection` resource is created in the state `PENDING`. Authentication with the connection provider must be completed in the AWS Console. See the [AWS documentation](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html) for details.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/codepipeline" "github.com/pulumi/pulumi-aws/sdk/v6/go/aws/codestarconnections" "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { exampleConnection, err := codestarconnections.NewConnection(ctx, "exampleConnection", &codestarconnections.ConnectionArgs{ ProviderType: pulumi.String("Bitbucket"), }) if err != nil { return err } _, err = codepipeline.NewPipeline(ctx, "examplePipeline", &codepipeline.PipelineArgs{ RoleArn: pulumi.Any(aws_iam_role.Codepipeline_role.Arn), ArtifactStores: codepipeline.PipelineArtifactStoreArray{ nil, }, Stages: codepipeline.PipelineStageArray{ &codepipeline.PipelineStageArgs{ Name: pulumi.String("Source"), Actions: codepipeline.PipelineStageActionArray{ &codepipeline.PipelineStageActionArgs{ Name: pulumi.String("Source"), Category: pulumi.String("Source"), Owner: pulumi.String("AWS"), Provider: pulumi.String("CodeStarSourceConnection"), Version: pulumi.String("1"), OutputArtifacts: pulumi.StringArray{ pulumi.String("source_output"), }, Configuration: pulumi.StringMap{ "ConnectionArn": exampleConnection.Arn, "FullRepositoryId": pulumi.String("my-organization/test"), "BranchName": pulumi.String("main"), }, }, }, }, &codepipeline.PipelineStageArgs{ Name: pulumi.String("Build"), Actions: codepipeline.PipelineStageActionArray{ nil, }, }, &codepipeline.PipelineStageArgs{ Name: pulumi.String("Deploy"), Actions: codepipeline.PipelineStageActionArray{ nil, }, }, }, }) if err != nil { return err } return nil }) }
```
## Import
Using `pulumi import`, import CodeStar connections using the ARN. For example:
```sh
$ pulumi import aws:codestarconnections/connection:Connection test-connection arn:aws:codestar-connections:us-west-1:0123456789:connection/79d4d357-a2ee-41e4-b350-2fe39ae59448
```
func GetConnection ¶
func GetConnection(ctx *pulumi.Context, name string, id pulumi.IDInput, state *ConnectionState, opts ...pulumi.ResourceOption) (*Connection, error)
GetConnection gets an existing Connection resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).
func NewConnection ¶
func NewConnection(ctx *pulumi.Context, name string, args *ConnectionArgs, opts ...pulumi.ResourceOption) (*Connection, error)
NewConnection registers a new resource with the given unique name, arguments, and options.
func (*Connection) ElementType ¶
func (*Connection) ElementType() reflect.Type
func (*Connection) ToConnectionOutput ¶
func (i *Connection) ToConnectionOutput() ConnectionOutput
func (*Connection) ToConnectionOutputWithContext ¶
func (i *Connection) ToConnectionOutputWithContext(ctx context.Context) ConnectionOutput
func (*Connection) ToOutput ¶ added in v6.1.0
func (i *Connection) ToOutput(ctx context.Context) pulumix.Output[*Connection]
type ConnectionArgs ¶
type ConnectionArgs struct { // The Amazon Resource Name (ARN) of the host associated with the connection. Conflicts with `providerType` HostArn pulumi.StringPtrInput // The name of the connection to be created. The name must be unique in the calling AWS account. Changing `name` will create a new resource. Name pulumi.StringPtrInput // The name of the external provider where your third-party code repository is configured. Valid values are `Bitbucket`, `GitHub` or `GitHubEnterpriseServer`. Changing `providerType` will create a new resource. Conflicts with `hostArn` ProviderType pulumi.StringPtrInput // Map of key-value resource tags to associate with the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. Tags pulumi.StringMapInput }
The set of arguments for constructing a Connection resource.
func (ConnectionArgs) ElementType ¶
func (ConnectionArgs) ElementType() reflect.Type
type ConnectionArray ¶
type ConnectionArray []ConnectionInput
func (ConnectionArray) ElementType ¶
func (ConnectionArray) ElementType() reflect.Type
func (ConnectionArray) ToConnectionArrayOutput ¶
func (i ConnectionArray) ToConnectionArrayOutput() ConnectionArrayOutput
func (ConnectionArray) ToConnectionArrayOutputWithContext ¶
func (i ConnectionArray) ToConnectionArrayOutputWithContext(ctx context.Context) ConnectionArrayOutput
func (ConnectionArray) ToOutput ¶ added in v6.1.0
func (i ConnectionArray) ToOutput(ctx context.Context) pulumix.Output[[]*Connection]
type ConnectionArrayInput ¶
type ConnectionArrayInput interface { pulumi.Input ToConnectionArrayOutput() ConnectionArrayOutput ToConnectionArrayOutputWithContext(context.Context) ConnectionArrayOutput }
ConnectionArrayInput is an input type that accepts ConnectionArray and ConnectionArrayOutput values. You can construct a concrete instance of `ConnectionArrayInput` via:
ConnectionArray{ ConnectionArgs{...} }
type ConnectionArrayOutput ¶
type ConnectionArrayOutput struct{ *pulumi.OutputState }
func (ConnectionArrayOutput) ElementType ¶
func (ConnectionArrayOutput) ElementType() reflect.Type
func (ConnectionArrayOutput) Index ¶
func (o ConnectionArrayOutput) Index(i pulumi.IntInput) ConnectionOutput
func (ConnectionArrayOutput) ToConnectionArrayOutput ¶
func (o ConnectionArrayOutput) ToConnectionArrayOutput() ConnectionArrayOutput
func (ConnectionArrayOutput) ToConnectionArrayOutputWithContext ¶
func (o ConnectionArrayOutput) ToConnectionArrayOutputWithContext(ctx context.Context) ConnectionArrayOutput
func (ConnectionArrayOutput) ToOutput ¶ added in v6.1.0
func (o ConnectionArrayOutput) ToOutput(ctx context.Context) pulumix.Output[[]*Connection]
type ConnectionInput ¶
type ConnectionInput interface { pulumi.Input ToConnectionOutput() ConnectionOutput ToConnectionOutputWithContext(ctx context.Context) ConnectionOutput }
type ConnectionMap ¶
type ConnectionMap map[string]ConnectionInput
func (ConnectionMap) ElementType ¶
func (ConnectionMap) ElementType() reflect.Type
func (ConnectionMap) ToConnectionMapOutput ¶
func (i ConnectionMap) ToConnectionMapOutput() ConnectionMapOutput
func (ConnectionMap) ToConnectionMapOutputWithContext ¶
func (i ConnectionMap) ToConnectionMapOutputWithContext(ctx context.Context) ConnectionMapOutput
func (ConnectionMap) ToOutput ¶ added in v6.1.0
func (i ConnectionMap) ToOutput(ctx context.Context) pulumix.Output[map[string]*Connection]
type ConnectionMapInput ¶
type ConnectionMapInput interface { pulumi.Input ToConnectionMapOutput() ConnectionMapOutput ToConnectionMapOutputWithContext(context.Context) ConnectionMapOutput }
ConnectionMapInput is an input type that accepts ConnectionMap and ConnectionMapOutput values. You can construct a concrete instance of `ConnectionMapInput` via:
ConnectionMap{ "key": ConnectionArgs{...} }
type ConnectionMapOutput ¶
type ConnectionMapOutput struct{ *pulumi.OutputState }
func (ConnectionMapOutput) ElementType ¶
func (ConnectionMapOutput) ElementType() reflect.Type
func (ConnectionMapOutput) MapIndex ¶
func (o ConnectionMapOutput) MapIndex(k pulumi.StringInput) ConnectionOutput
func (ConnectionMapOutput) ToConnectionMapOutput ¶
func (o ConnectionMapOutput) ToConnectionMapOutput() ConnectionMapOutput
func (ConnectionMapOutput) ToConnectionMapOutputWithContext ¶
func (o ConnectionMapOutput) ToConnectionMapOutputWithContext(ctx context.Context) ConnectionMapOutput
func (ConnectionMapOutput) ToOutput ¶ added in v6.1.0
func (o ConnectionMapOutput) ToOutput(ctx context.Context) pulumix.Output[map[string]*Connection]
type ConnectionOutput ¶
type ConnectionOutput struct{ *pulumi.OutputState }
func (ConnectionOutput) Arn ¶
func (o ConnectionOutput) Arn() pulumi.StringOutput
The codestar connection ARN.
func (ConnectionOutput) ConnectionStatus ¶
func (o ConnectionOutput) ConnectionStatus() pulumi.StringOutput
The codestar connection status. Possible values are `PENDING`, `AVAILABLE` and `ERROR`.
func (ConnectionOutput) ElementType ¶
func (ConnectionOutput) ElementType() reflect.Type
func (ConnectionOutput) HostArn ¶
func (o ConnectionOutput) HostArn() pulumi.StringPtrOutput
The Amazon Resource Name (ARN) of the host associated with the connection. Conflicts with `providerType`
func (ConnectionOutput) Name ¶
func (o ConnectionOutput) Name() pulumi.StringOutput
The name of the connection to be created. The name must be unique in the calling AWS account. Changing `name` will create a new resource.
func (ConnectionOutput) ProviderType ¶
func (o ConnectionOutput) ProviderType() pulumi.StringOutput
The name of the external provider where your third-party code repository is configured. Valid values are `Bitbucket`, `GitHub` or `GitHubEnterpriseServer`. Changing `providerType` will create a new resource. Conflicts with `hostArn`
func (ConnectionOutput) Tags ¶
func (o ConnectionOutput) Tags() pulumi.StringMapOutput
Map of key-value resource tags to associate with the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
func (ConnectionOutput) TagsAll
deprecated
func (o ConnectionOutput) TagsAll() pulumi.StringMapOutput
A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
Deprecated: Please use `tags` instead.
func (ConnectionOutput) ToConnectionOutput ¶
func (o ConnectionOutput) ToConnectionOutput() ConnectionOutput
func (ConnectionOutput) ToConnectionOutputWithContext ¶
func (o ConnectionOutput) ToConnectionOutputWithContext(ctx context.Context) ConnectionOutput
func (ConnectionOutput) ToOutput ¶ added in v6.1.0
func (o ConnectionOutput) ToOutput(ctx context.Context) pulumix.Output[*Connection]
type ConnectionState ¶
type ConnectionState struct { // The codestar connection ARN. Arn pulumi.StringPtrInput // The codestar connection status. Possible values are `PENDING`, `AVAILABLE` and `ERROR`. ConnectionStatus pulumi.StringPtrInput // The Amazon Resource Name (ARN) of the host associated with the connection. Conflicts with `providerType` HostArn pulumi.StringPtrInput // The name of the connection to be created. The name must be unique in the calling AWS account. Changing `name` will create a new resource. Name pulumi.StringPtrInput // The name of the external provider where your third-party code repository is configured. Valid values are `Bitbucket`, `GitHub` or `GitHubEnterpriseServer`. Changing `providerType` will create a new resource. Conflicts with `hostArn` ProviderType pulumi.StringPtrInput // Map of key-value resource tags to associate with the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. Tags pulumi.StringMapInput // A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. // // Deprecated: Please use `tags` instead. TagsAll pulumi.StringMapInput }
func (ConnectionState) ElementType ¶
func (ConnectionState) ElementType() reflect.Type
type Host ¶
type Host struct { pulumi.CustomResourceState // The CodeStar Host ARN. Arn pulumi.StringOutput `pulumi:"arn"` // The name of the host to be created. The name must be unique in the calling AWS account. Name pulumi.StringOutput `pulumi:"name"` // The endpoint of the infrastructure to be represented by the host after it is created. ProviderEndpoint pulumi.StringOutput `pulumi:"providerEndpoint"` // The name of the external provider where your third-party code repository is configured. ProviderType pulumi.StringOutput `pulumi:"providerType"` // The CodeStar Host status. Possible values are `PENDING`, `AVAILABLE`, `VPC_CONFIG_DELETING`, `VPC_CONFIG_INITIALIZING`, and `VPC_CONFIG_FAILED_INITIALIZATION`. Status pulumi.StringOutput `pulumi:"status"` // The VPC configuration to be provisioned for the host. A VPC must be configured, and the infrastructure to be represented by the host must already be connected to the VPC. VpcConfiguration HostVpcConfigurationPtrOutput `pulumi:"vpcConfiguration"` }
Provides a CodeStar Host.
> **NOTE:** The `codestarconnections.Host` resource is created in the state `PENDING`. Authentication with the host provider must be completed in the AWS Console. For more information visit [Set up a pending host](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-setup.html).
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/codestarconnections" "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := codestarconnections.NewHost(ctx, "example", &codestarconnections.HostArgs{ ProviderEndpoint: pulumi.String("https://example.com"), ProviderType: pulumi.String("GitHubEnterpriseServer"), }) if err != nil { return err } return nil }) }
```
## Import
Using `pulumi import`, import CodeStar Host using the ARN. For example:
```sh
$ pulumi import aws:codestarconnections/host:Host example-host arn:aws:codestar-connections:us-west-1:0123456789:host/79d4d357-a2ee-41e4-b350-2fe39ae59448
```
func GetHost ¶
func GetHost(ctx *pulumi.Context, name string, id pulumi.IDInput, state *HostState, opts ...pulumi.ResourceOption) (*Host, error)
GetHost gets an existing Host resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).
func NewHost ¶
func NewHost(ctx *pulumi.Context, name string, args *HostArgs, opts ...pulumi.ResourceOption) (*Host, error)
NewHost registers a new resource with the given unique name, arguments, and options.
func (*Host) ElementType ¶
func (*Host) ToHostOutput ¶
func (i *Host) ToHostOutput() HostOutput
func (*Host) ToHostOutputWithContext ¶
func (i *Host) ToHostOutputWithContext(ctx context.Context) HostOutput
type HostArgs ¶
type HostArgs struct { // The name of the host to be created. The name must be unique in the calling AWS account. Name pulumi.StringPtrInput // The endpoint of the infrastructure to be represented by the host after it is created. ProviderEndpoint pulumi.StringInput // The name of the external provider where your third-party code repository is configured. ProviderType pulumi.StringInput // The VPC configuration to be provisioned for the host. A VPC must be configured, and the infrastructure to be represented by the host must already be connected to the VPC. VpcConfiguration HostVpcConfigurationPtrInput }
The set of arguments for constructing a Host resource.
func (HostArgs) ElementType ¶
type HostArray ¶
type HostArray []HostInput
func (HostArray) ElementType ¶
func (HostArray) ToHostArrayOutput ¶
func (i HostArray) ToHostArrayOutput() HostArrayOutput
func (HostArray) ToHostArrayOutputWithContext ¶
func (i HostArray) ToHostArrayOutputWithContext(ctx context.Context) HostArrayOutput
type HostArrayInput ¶
type HostArrayInput interface { pulumi.Input ToHostArrayOutput() HostArrayOutput ToHostArrayOutputWithContext(context.Context) HostArrayOutput }
HostArrayInput is an input type that accepts HostArray and HostArrayOutput values. You can construct a concrete instance of `HostArrayInput` via:
HostArray{ HostArgs{...} }
type HostArrayOutput ¶
type HostArrayOutput struct{ *pulumi.OutputState }
func (HostArrayOutput) ElementType ¶
func (HostArrayOutput) ElementType() reflect.Type
func (HostArrayOutput) Index ¶
func (o HostArrayOutput) Index(i pulumi.IntInput) HostOutput
func (HostArrayOutput) ToHostArrayOutput ¶
func (o HostArrayOutput) ToHostArrayOutput() HostArrayOutput
func (HostArrayOutput) ToHostArrayOutputWithContext ¶
func (o HostArrayOutput) ToHostArrayOutputWithContext(ctx context.Context) HostArrayOutput
type HostInput ¶
type HostInput interface { pulumi.Input ToHostOutput() HostOutput ToHostOutputWithContext(ctx context.Context) HostOutput }
type HostMap ¶
func (HostMap) ElementType ¶
func (HostMap) ToHostMapOutput ¶
func (i HostMap) ToHostMapOutput() HostMapOutput
func (HostMap) ToHostMapOutputWithContext ¶
func (i HostMap) ToHostMapOutputWithContext(ctx context.Context) HostMapOutput
type HostMapInput ¶
type HostMapInput interface { pulumi.Input ToHostMapOutput() HostMapOutput ToHostMapOutputWithContext(context.Context) HostMapOutput }
HostMapInput is an input type that accepts HostMap and HostMapOutput values. You can construct a concrete instance of `HostMapInput` via:
HostMap{ "key": HostArgs{...} }
type HostMapOutput ¶
type HostMapOutput struct{ *pulumi.OutputState }
func (HostMapOutput) ElementType ¶
func (HostMapOutput) ElementType() reflect.Type
func (HostMapOutput) MapIndex ¶
func (o HostMapOutput) MapIndex(k pulumi.StringInput) HostOutput
func (HostMapOutput) ToHostMapOutput ¶
func (o HostMapOutput) ToHostMapOutput() HostMapOutput
func (HostMapOutput) ToHostMapOutputWithContext ¶
func (o HostMapOutput) ToHostMapOutputWithContext(ctx context.Context) HostMapOutput
type HostOutput ¶
type HostOutput struct{ *pulumi.OutputState }
func (HostOutput) ElementType ¶
func (HostOutput) ElementType() reflect.Type
func (HostOutput) Name ¶
func (o HostOutput) Name() pulumi.StringOutput
The name of the host to be created. The name must be unique in the calling AWS account.
func (HostOutput) ProviderEndpoint ¶
func (o HostOutput) ProviderEndpoint() pulumi.StringOutput
The endpoint of the infrastructure to be represented by the host after it is created.
func (HostOutput) ProviderType ¶
func (o HostOutput) ProviderType() pulumi.StringOutput
The name of the external provider where your third-party code repository is configured.
func (HostOutput) Status ¶
func (o HostOutput) Status() pulumi.StringOutput
The CodeStar Host status. Possible values are `PENDING`, `AVAILABLE`, `VPC_CONFIG_DELETING`, `VPC_CONFIG_INITIALIZING`, and `VPC_CONFIG_FAILED_INITIALIZATION`.
func (HostOutput) ToHostOutput ¶
func (o HostOutput) ToHostOutput() HostOutput
func (HostOutput) ToHostOutputWithContext ¶
func (o HostOutput) ToHostOutputWithContext(ctx context.Context) HostOutput
func (HostOutput) VpcConfiguration ¶
func (o HostOutput) VpcConfiguration() HostVpcConfigurationPtrOutput
The VPC configuration to be provisioned for the host. A VPC must be configured, and the infrastructure to be represented by the host must already be connected to the VPC.
type HostState ¶
type HostState struct { // The CodeStar Host ARN. Arn pulumi.StringPtrInput // The name of the host to be created. The name must be unique in the calling AWS account. Name pulumi.StringPtrInput // The endpoint of the infrastructure to be represented by the host after it is created. ProviderEndpoint pulumi.StringPtrInput // The name of the external provider where your third-party code repository is configured. ProviderType pulumi.StringPtrInput // The CodeStar Host status. Possible values are `PENDING`, `AVAILABLE`, `VPC_CONFIG_DELETING`, `VPC_CONFIG_INITIALIZING`, and `VPC_CONFIG_FAILED_INITIALIZATION`. Status pulumi.StringPtrInput // The VPC configuration to be provisioned for the host. A VPC must be configured, and the infrastructure to be represented by the host must already be connected to the VPC. VpcConfiguration HostVpcConfigurationPtrInput }
func (HostState) ElementType ¶
type HostVpcConfiguration ¶
type HostVpcConfiguration struct { // ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed. SecurityGroupIds []string `pulumi:"securityGroupIds"` // The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed. SubnetIds []string `pulumi:"subnetIds"` // The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed. TlsCertificate *string `pulumi:"tlsCertificate"` // The ID of the Amazon VPC connected to the infrastructure where your provider type is installed. VpcId string `pulumi:"vpcId"` }
type HostVpcConfigurationArgs ¶
type HostVpcConfigurationArgs struct { // ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed. SecurityGroupIds pulumi.StringArrayInput `pulumi:"securityGroupIds"` // The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed. SubnetIds pulumi.StringArrayInput `pulumi:"subnetIds"` // The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed. TlsCertificate pulumi.StringPtrInput `pulumi:"tlsCertificate"` // The ID of the Amazon VPC connected to the infrastructure where your provider type is installed. VpcId pulumi.StringInput `pulumi:"vpcId"` }
func (HostVpcConfigurationArgs) ElementType ¶
func (HostVpcConfigurationArgs) ElementType() reflect.Type
func (HostVpcConfigurationArgs) ToHostVpcConfigurationOutput ¶
func (i HostVpcConfigurationArgs) ToHostVpcConfigurationOutput() HostVpcConfigurationOutput
func (HostVpcConfigurationArgs) ToHostVpcConfigurationOutputWithContext ¶
func (i HostVpcConfigurationArgs) ToHostVpcConfigurationOutputWithContext(ctx context.Context) HostVpcConfigurationOutput
func (HostVpcConfigurationArgs) ToHostVpcConfigurationPtrOutput ¶
func (i HostVpcConfigurationArgs) ToHostVpcConfigurationPtrOutput() HostVpcConfigurationPtrOutput
func (HostVpcConfigurationArgs) ToHostVpcConfigurationPtrOutputWithContext ¶
func (i HostVpcConfigurationArgs) ToHostVpcConfigurationPtrOutputWithContext(ctx context.Context) HostVpcConfigurationPtrOutput
func (HostVpcConfigurationArgs) ToOutput ¶ added in v6.1.0
func (i HostVpcConfigurationArgs) ToOutput(ctx context.Context) pulumix.Output[HostVpcConfiguration]
type HostVpcConfigurationInput ¶
type HostVpcConfigurationInput interface { pulumi.Input ToHostVpcConfigurationOutput() HostVpcConfigurationOutput ToHostVpcConfigurationOutputWithContext(context.Context) HostVpcConfigurationOutput }
HostVpcConfigurationInput is an input type that accepts HostVpcConfigurationArgs and HostVpcConfigurationOutput values. You can construct a concrete instance of `HostVpcConfigurationInput` via:
HostVpcConfigurationArgs{...}
type HostVpcConfigurationOutput ¶
type HostVpcConfigurationOutput struct{ *pulumi.OutputState }
func (HostVpcConfigurationOutput) ElementType ¶
func (HostVpcConfigurationOutput) ElementType() reflect.Type
func (HostVpcConfigurationOutput) SecurityGroupIds ¶
func (o HostVpcConfigurationOutput) SecurityGroupIds() pulumi.StringArrayOutput
ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed.
func (HostVpcConfigurationOutput) SubnetIds ¶
func (o HostVpcConfigurationOutput) SubnetIds() pulumi.StringArrayOutput
The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed.
func (HostVpcConfigurationOutput) TlsCertificate ¶
func (o HostVpcConfigurationOutput) TlsCertificate() pulumi.StringPtrOutput
The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
func (HostVpcConfigurationOutput) ToHostVpcConfigurationOutput ¶
func (o HostVpcConfigurationOutput) ToHostVpcConfigurationOutput() HostVpcConfigurationOutput
func (HostVpcConfigurationOutput) ToHostVpcConfigurationOutputWithContext ¶
func (o HostVpcConfigurationOutput) ToHostVpcConfigurationOutputWithContext(ctx context.Context) HostVpcConfigurationOutput
func (HostVpcConfigurationOutput) ToHostVpcConfigurationPtrOutput ¶
func (o HostVpcConfigurationOutput) ToHostVpcConfigurationPtrOutput() HostVpcConfigurationPtrOutput
func (HostVpcConfigurationOutput) ToHostVpcConfigurationPtrOutputWithContext ¶
func (o HostVpcConfigurationOutput) ToHostVpcConfigurationPtrOutputWithContext(ctx context.Context) HostVpcConfigurationPtrOutput
func (HostVpcConfigurationOutput) ToOutput ¶ added in v6.1.0
func (o HostVpcConfigurationOutput) ToOutput(ctx context.Context) pulumix.Output[HostVpcConfiguration]
func (HostVpcConfigurationOutput) VpcId ¶
func (o HostVpcConfigurationOutput) VpcId() pulumi.StringOutput
The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
type HostVpcConfigurationPtrInput ¶
type HostVpcConfigurationPtrInput interface { pulumi.Input ToHostVpcConfigurationPtrOutput() HostVpcConfigurationPtrOutput ToHostVpcConfigurationPtrOutputWithContext(context.Context) HostVpcConfigurationPtrOutput }
HostVpcConfigurationPtrInput is an input type that accepts HostVpcConfigurationArgs, HostVpcConfigurationPtr and HostVpcConfigurationPtrOutput values. You can construct a concrete instance of `HostVpcConfigurationPtrInput` via:
HostVpcConfigurationArgs{...} or: nil
func HostVpcConfigurationPtr ¶
func HostVpcConfigurationPtr(v *HostVpcConfigurationArgs) HostVpcConfigurationPtrInput
type HostVpcConfigurationPtrOutput ¶
type HostVpcConfigurationPtrOutput struct{ *pulumi.OutputState }
func (HostVpcConfigurationPtrOutput) Elem ¶
func (o HostVpcConfigurationPtrOutput) Elem() HostVpcConfigurationOutput
func (HostVpcConfigurationPtrOutput) ElementType ¶
func (HostVpcConfigurationPtrOutput) ElementType() reflect.Type
func (HostVpcConfigurationPtrOutput) SecurityGroupIds ¶
func (o HostVpcConfigurationPtrOutput) SecurityGroupIds() pulumi.StringArrayOutput
ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed.
func (HostVpcConfigurationPtrOutput) SubnetIds ¶
func (o HostVpcConfigurationPtrOutput) SubnetIds() pulumi.StringArrayOutput
The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed.
func (HostVpcConfigurationPtrOutput) TlsCertificate ¶
func (o HostVpcConfigurationPtrOutput) TlsCertificate() pulumi.StringPtrOutput
The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
func (HostVpcConfigurationPtrOutput) ToHostVpcConfigurationPtrOutput ¶
func (o HostVpcConfigurationPtrOutput) ToHostVpcConfigurationPtrOutput() HostVpcConfigurationPtrOutput
func (HostVpcConfigurationPtrOutput) ToHostVpcConfigurationPtrOutputWithContext ¶
func (o HostVpcConfigurationPtrOutput) ToHostVpcConfigurationPtrOutputWithContext(ctx context.Context) HostVpcConfigurationPtrOutput
func (HostVpcConfigurationPtrOutput) ToOutput ¶ added in v6.1.0
func (o HostVpcConfigurationPtrOutput) ToOutput(ctx context.Context) pulumix.Output[*HostVpcConfiguration]
func (HostVpcConfigurationPtrOutput) VpcId ¶
func (o HostVpcConfigurationPtrOutput) VpcId() pulumi.StringPtrOutput
The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
type LookupConnectionArgs ¶
type LookupConnectionArgs struct { // CodeStar Connection ARN. Arn *string `pulumi:"arn"` // CodeStar Connection name. // // > **NOTE:** When both `arn` and `name` are specified, `arn` takes precedence. Name *string `pulumi:"name"` // Map of key-value resource tags to associate with the resource. Tags map[string]string `pulumi:"tags"` }
A collection of arguments for invoking getConnection.
type LookupConnectionOutputArgs ¶
type LookupConnectionOutputArgs struct { // CodeStar Connection ARN. Arn pulumi.StringPtrInput `pulumi:"arn"` // CodeStar Connection name. // // > **NOTE:** When both `arn` and `name` are specified, `arn` takes precedence. Name pulumi.StringPtrInput `pulumi:"name"` // Map of key-value resource tags to associate with the resource. Tags pulumi.StringMapInput `pulumi:"tags"` }
A collection of arguments for invoking getConnection.
func (LookupConnectionOutputArgs) ElementType ¶
func (LookupConnectionOutputArgs) ElementType() reflect.Type
type LookupConnectionResult ¶
type LookupConnectionResult struct { Arn string `pulumi:"arn"` // CodeStar Connection status. Possible values are `PENDING`, `AVAILABLE` and `ERROR`. ConnectionStatus string `pulumi:"connectionStatus"` // ARN of the host associated with the connection. HostArn string `pulumi:"hostArn"` // The provider-assigned unique ID for this managed resource. Id string `pulumi:"id"` // Name of the CodeStar Connection. The name is unique in the calling AWS account. Name string `pulumi:"name"` // Name of the external provider where your third-party code repository is configured. Possible values are `Bitbucket` and `GitHub`. For connections to a GitHub Enterprise Server instance, you must create an codestarconnections.Host resource and use `hostArn` instead. ProviderType string `pulumi:"providerType"` // Map of key-value resource tags to associate with the resource. Tags map[string]string `pulumi:"tags"` }
A collection of values returned by getConnection.
func LookupConnection ¶
func LookupConnection(ctx *pulumi.Context, args *LookupConnectionArgs, opts ...pulumi.InvokeOption) (*LookupConnectionResult, error)
Provides details about CodeStar Connection.
## Example Usage ### By ARN
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/codestarconnections" "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := codestarconnections.LookupConnection(ctx, &codestarconnections.LookupConnectionArgs{ Arn: pulumi.StringRef(aws_codestarconnections_connection.Example.Arn), }, nil) if err != nil { return err } return nil }) }
``` ### By Name
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/codestarconnections" "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := codestarconnections.LookupConnection(ctx, &codestarconnections.LookupConnectionArgs{ Name: pulumi.StringRef(aws_codestarconnections_connection.Example.Name), }, nil) if err != nil { return err } return nil }) }
```
type LookupConnectionResultOutput ¶
type LookupConnectionResultOutput struct{ *pulumi.OutputState }
A collection of values returned by getConnection.
func LookupConnectionOutput ¶
func LookupConnectionOutput(ctx *pulumi.Context, args LookupConnectionOutputArgs, opts ...pulumi.InvokeOption) LookupConnectionResultOutput
func (LookupConnectionResultOutput) Arn ¶
func (o LookupConnectionResultOutput) Arn() pulumi.StringOutput
func (LookupConnectionResultOutput) ConnectionStatus ¶
func (o LookupConnectionResultOutput) ConnectionStatus() pulumi.StringOutput
CodeStar Connection status. Possible values are `PENDING`, `AVAILABLE` and `ERROR`.
func (LookupConnectionResultOutput) ElementType ¶
func (LookupConnectionResultOutput) ElementType() reflect.Type
func (LookupConnectionResultOutput) HostArn ¶
func (o LookupConnectionResultOutput) HostArn() pulumi.StringOutput
ARN of the host associated with the connection.
func (LookupConnectionResultOutput) Id ¶
func (o LookupConnectionResultOutput) Id() pulumi.StringOutput
The provider-assigned unique ID for this managed resource.
func (LookupConnectionResultOutput) Name ¶
func (o LookupConnectionResultOutput) Name() pulumi.StringOutput
Name of the CodeStar Connection. The name is unique in the calling AWS account.
func (LookupConnectionResultOutput) ProviderType ¶
func (o LookupConnectionResultOutput) ProviderType() pulumi.StringOutput
Name of the external provider where your third-party code repository is configured. Possible values are `Bitbucket` and `GitHub`. For connections to a GitHub Enterprise Server instance, you must create an codestarconnections.Host resource and use `hostArn` instead.
func (LookupConnectionResultOutput) Tags ¶
func (o LookupConnectionResultOutput) Tags() pulumi.StringMapOutput
Map of key-value resource tags to associate with the resource.
func (LookupConnectionResultOutput) ToLookupConnectionResultOutput ¶
func (o LookupConnectionResultOutput) ToLookupConnectionResultOutput() LookupConnectionResultOutput
func (LookupConnectionResultOutput) ToLookupConnectionResultOutputWithContext ¶
func (o LookupConnectionResultOutput) ToLookupConnectionResultOutputWithContext(ctx context.Context) LookupConnectionResultOutput
func (LookupConnectionResultOutput) ToOutput ¶ added in v6.1.0
func (o LookupConnectionResultOutput) ToOutput(ctx context.Context) pulumix.Output[LookupConnectionResult]