AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a pipeline.

In the pipeline structure, you must include either artifactStore or artifactStores in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use artifactStores.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreatePipelineAsync.

Namespace: Amazon.CodePipeline
Assembly: AWSSDK.CodePipeline.dll
Version: 3.x.y.z

Syntax

C#
public virtual CreatePipelineResponse CreatePipeline(
         CreatePipelineRequest request
)

Parameters

request
Type: Amazon.CodePipeline.Model.CreatePipelineRequest

Container for the necessary parameters to execute the CreatePipeline service method.

Return Value


The response from the CreatePipeline service method, as returned by CodePipeline.

Exceptions

ExceptionCondition
ConcurrentModificationException Unable to modify the tag due to a simultaneous update request.
InvalidActionDeclarationException The action declaration was specified in an invalid format.
InvalidBlockerDeclarationException Reserved for future use.
InvalidStageDeclarationException The stage declaration was specified in an invalid format.
InvalidStructureException The structure was specified in an invalid format.
InvalidTagsException The specified resource tags are invalid.
LimitExceededException The number of pipelines associated with the Amazon Web Services account has exceeded the limit allowed for the account.
PipelineNameInUseException The specified pipeline name is already in use.
TooManyTagsException The tags limit for a resource has been exceeded.
ValidationException The validation was specified in an invalid format.

Examples

This example creates a simple two-stage pipeline in AWS CodePipeline that uses an Amazon S3 bucket for its source stage and deploys code using AWS CodeDeploy. For more information about the requirements for creating a pipeline, including the structure of the JSON file commonly used to create a pipeline, see "Create a Pipeline" in the AWS CodePipeline User Guide.

Create a pipeline


var client = new AmazonCodePipelineClient();
var response = client.CreatePipeline(new CreatePipelineRequest 
{
    Pipeline = new PipelineDeclaration {
        Version = 1,
        Name = "MySecondPipeline",
        ArtifactStore = new ArtifactStore {
            Type = "S3",
            Location = "codepipeline-us-east-1-11EXAMPLE11"
        },
        RoleArn = "arn:aws:iam::111111111111:role/AWS-CodePipeline-Service",
        Stages = new List<StageDeclaration> {
            new StageDeclaration {
                Name = "Source",
                Actions = new List<ActionDeclaration> {
                    new ActionDeclaration {
                        Name = "Source",
                        ActionTypeId = new ActionTypeId {
                            Version = "1",
                            Category = "Source",
                            Owner = "AWS",
                            Provider = "S3"
                        },
                        Configuration = new Dictionary<string, string> {
                            { "S3Bucket", "awscodepipeline-demo-bucket" },
                            { "S3ObjectKey", "aws-codepipeline-s3-aws-codedeploy_linux.zip" }
                        },
                        InputArtifacts = new List<InputArtifact> {
                                        
                        },
                        OutputArtifacts = new List<OutputArtifact> {
                            new OutputArtifact { Name = "MyApp" }
                        },
                        RunOrder = 1
                    }
                }
            },
            new StageDeclaration {
                Name = "Beta",
                Actions = new List<ActionDeclaration> {
                    new ActionDeclaration {
                        Name = "CodePipelineDemoFleet",
                        ActionTypeId = new ActionTypeId {
                            Version = "1",
                            Category = "Deploy",
                            Owner = "AWS",
                            Provider = "CodeDeploy"
                        },
                        Configuration = new Dictionary<string, string> {
                            { "ApplicationName", "CodePipelineDemoApplication" },
                            { "DeploymentGroupName", "CodePipelineDemoFleet" }
                        },
                        InputArtifacts = new List<InputArtifact> {
                            new InputArtifact { Name = "MyApp" }
                        },
                        OutputArtifacts = new List<OutputArtifact> {
                                        
                        },
                        RunOrder = 1
                    }
                }
            }
        }
    }
});

PipelineDeclaration pipeline = response.Pipeline;

            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also