aws-cdk-lib
Version:
Version 2 of the AWS Cloud Development Kit library
209 lines (208 loc) • 10.7 kB
TypeScript
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;
}
}