UNPKG

aws-cdk-lib

Version:

Version 2 of the AWS Cloud Development Kit library

209 lines (208 loc) 10.7 kB
import * as constructs from 'constructs'; import * as cdk from '../../core'; import * as cfn_parse from '../../core/lib/helpers-internal'; /** * Properties for defining a `CfnGitHubRepository` * * @struct * @stability external * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html */ export interface CfnGitHubRepositoryProps { /** * The name of the repository you want to create in GitHub with AWS CloudFormation stack creation. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositoryname */ readonly repositoryName: string; /** * The GitHub user name for the owner of the GitHub repository to be created. If this repository should be owned by a GitHub organization, provide its name. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositoryowner */ readonly repositoryOwner: string; /** * Information about code to be committed to a repository after it is created in an AWS CloudFormation stack. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-code */ readonly code?: CfnGitHubRepository.CodeProperty | cdk.IResolvable; /** * `AWS::CodeStar::GitHubRepository.ConnectionArn` * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-connectionarn */ readonly connectionArn?: string; /** * Indicates whether to enable issues for the GitHub repository. You can use GitHub issues to track information and bugs for your repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-enableissues */ readonly enableIssues?: boolean | cdk.IResolvable; /** * Indicates whether the GitHub repository is a private repository. If so, you choose who can see and commit to this repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-isprivate */ readonly isPrivate?: boolean | cdk.IResolvable; /** * The GitHub user's personal access token for the GitHub repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositoryaccesstoken */ readonly repositoryAccessToken?: string; /** * A comment or description about the new repository. This description is displayed in GitHub after the repository is created. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositorydescription */ readonly repositoryDescription?: string; } /** * A CloudFormation `AWS::CodeStar::GitHubRepository` * * The `AWS::CodeStar::GitHubRepository` resource creates a GitHub repository where users can store source code for use with AWS workflows. You must provide a location for the source code ZIP file in the AWS CloudFormation template, so the code can be uploaded to the created repository. You must have created a personal access token in GitHub to provide in the AWS CloudFormation template. AWS uses this token to connect to GitHub on your behalf. For more information about using a GitHub source repository with AWS CodeStar projects, see [AWS CodeStar Project Files and Resources](https://docs.aws.amazon.com/codestar/latest/userguide/templates.html#templates-whatis) . * * @cloudformationResource AWS::CodeStar::GitHubRepository * @stability external * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html */ export declare class CfnGitHubRepository extends cdk.CfnResource implements cdk.IInspectable { /** * The CloudFormation resource type name for this resource class. */ static readonly CFN_RESOURCE_TYPE_NAME = "AWS::CodeStar::GitHubRepository"; /** * A factory method that creates a new instance of this class from an object * containing the CloudFormation properties of this resource. * Used in the @aws-cdk/cloudformation-include module. * * @internal */ static _fromCloudFormation(scope: constructs.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnGitHubRepository; /** * The name of the repository you want to create in GitHub with AWS CloudFormation stack creation. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositoryname */ repositoryName: string; /** * The GitHub user name for the owner of the GitHub repository to be created. If this repository should be owned by a GitHub organization, provide its name. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositoryowner */ repositoryOwner: string; /** * Information about code to be committed to a repository after it is created in an AWS CloudFormation stack. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-code */ code: CfnGitHubRepository.CodeProperty | cdk.IResolvable | undefined; /** * `AWS::CodeStar::GitHubRepository.ConnectionArn` * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-connectionarn */ connectionArn: string | undefined; /** * Indicates whether to enable issues for the GitHub repository. You can use GitHub issues to track information and bugs for your repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-enableissues */ enableIssues: boolean | cdk.IResolvable | undefined; /** * Indicates whether the GitHub repository is a private repository. If so, you choose who can see and commit to this repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-isprivate */ isPrivate: boolean | cdk.IResolvable | undefined; /** * The GitHub user's personal access token for the GitHub repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositoryaccesstoken */ repositoryAccessToken: string | undefined; /** * A comment or description about the new repository. This description is displayed in GitHub after the repository is created. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html#cfn-codestar-githubrepository-repositorydescription */ repositoryDescription: string | undefined; /** * Create a new `AWS::CodeStar::GitHubRepository`. * * @param scope - scope in which this resource is defined * @param id - scoped id of the resource * @param props - resource properties */ constructor(scope: constructs.Construct, id: string, props: CfnGitHubRepositoryProps); /** * Examines the CloudFormation resource and discloses attributes. * * @param inspector - tree inspector to collect and process attributes * */ inspect(inspector: cdk.TreeInspector): void; protected get cfnProperties(): { [key: string]: any; }; protected renderProperties(props: { [key: string]: any; }): { [key: string]: any; }; } export declare namespace CfnGitHubRepository { /** * The `Code` property type specifies information about code to be committed. * * `Code` is a property of the `AWS::CodeStar::GitHubRepository` resource. * * @struct * @stability external * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codestar-githubrepository-code.html */ interface CodeProperty { /** * Information about the Amazon S3 bucket that contains a ZIP file of code to be committed to the repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codestar-githubrepository-code.html#cfn-codestar-githubrepository-code-s3 */ readonly s3: CfnGitHubRepository.S3Property | cdk.IResolvable; } } export declare namespace CfnGitHubRepository { /** * The `S3` property type specifies information about the Amazon S3 bucket that contains the code to be committed to the new repository. * * `S3` is a property of the `AWS::CodeStar::GitHubRepository` resource. * * @struct * @stability external * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codestar-githubrepository-s3.html */ interface S3Property { /** * The name of the Amazon S3 bucket that contains the ZIP file with the content to be committed to the new repository. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codestar-githubrepository-s3.html#cfn-codestar-githubrepository-s3-bucket */ readonly bucket: string; /** * The S3 object key or file name for the ZIP file. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codestar-githubrepository-s3.html#cfn-codestar-githubrepository-s3-key */ readonly key: string; /** * The object version of the ZIP file, if versioning is enabled for the Amazon S3 bucket. * * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codestar-githubrepository-s3.html#cfn-codestar-githubrepository-s3-objectversion */ readonly objectVersion?: string; } }