AWS::CodeCommit::Repository - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::CodeCommit::Repository

创建新的空存储库。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::CodeCommit::Repository", "Properties" : { "Code" : Code, "RepositoryDescription" : String, "RepositoryName" : String, "Tags" : [ Tag, ... ], "Triggers" : [ RepositoryTrigger, ... ] } }

YAML

Type: AWS::CodeCommit::Repository Properties: Code: Code RepositoryDescription: String RepositoryName: String Tags: - Tag Triggers: - RepositoryTrigger

属性

Code

有关在 AWS CloudFormation 堆栈中创建存储库后提交到该存储库的代码的信息。

必需:否

类型Code

Update requires: No interruption

RepositoryDescription

有关新存储库的注释或描述。

注意

存储库的描述字段可接受所有 HTML 字符和所有有效的 Unicode 字符。如果应用程序不对描述进行 HTML 编码并在网页中显示描述,则可能会导致用户受到潜在恶意代码的攻击。在使用该 API 在网页上显示存储库描述的任何应用程序中,请确保对描述字段进行 HTML 编码。

必需:否

类型:字符串

最高1000

Update requires: No interruption

RepositoryName

要创建的新存储库的名称。

注意

存储库名称在调用的 AWS 账户中必须是唯一的。存储库名称限制为 100 个字母数字、短划线和下划线字符,并且不能包含某些字符。有关存储库名称限制的更多信息,请参阅 AWS CodeCommit 用户指南 中的限制。禁止使用 .git 后缀。

必需:是

类型:字符串

最低1

最高100

模式[\w\.-]+

Update requires: No interruption

Tags

标记该存储库时要使用一个或多个标签键–值对。

必需:否

类型Tag 的列表

Update requires: No interruption

Triggers

每个触发器的配置信息的 JSON 数据块。

必需:否

类型RepositoryTrigger 的列表

Update requires: Some interruptions

返回值

Ref

当向 Ref 内部函数提供该资源的逻辑 ID 时,Ref 将返回存储库 ID。

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

Arn

当您传递此资源的逻辑 ID 时,该函数将返回存储库的 Amazon 资源名称 (ARN)。

CloneUrlHttp

当您传递此资源的逻辑 ID 时,该函数将返回用于通过 HTTPS 克隆存储库的 URL。

CloneUrlSsh

当您传递此资源的逻辑 ID 时,该函数将返回用于通过 SSH 克隆存储库的 URL。

Name

当您传递此资源的逻辑 ID 时,该函数将返回存储库的名称。

示例

示例

以下示例创建一个 CodeCommit 存储库,它具有主分支中的所有事件的触发器。

JSON

{ "MyRepo": { "Type": "AWS: : CodeCommit: : Repository", "Properties": { "RepositoryName": "MyRepoName", "RepositoryDescription": "a description", "Triggers": [ { "Name": "MasterTrigger", "CustomData": "Project ID 12345", "DestinationArn": { "Ref": "SNSarn" }, "Branches": [ "Master" ], "Events": [ "all" ] } ] } } }

YAML

MyRepo: Type: AWS::CodeCommit::Repository Properties: RepositoryName: MyRepoName RepositoryDescription: a description Triggers: - Name: MasterTrigger CustomData: Project ID 12345 DestinationArn: Ref: SNSarn Branches: - Master Events: - all