使用 AWS CLI 的 CodeConnections 示例

创建连接

以下 create-connection 示例演示如何创建与第三方存储库的连接。此示例创建第三方提供程序为 Bitbucket 的连接。

默认情况下，通过 AWS CLI 或 AWS CloudFormation 创建的连接处于 Pending 状态。使用 CLI 或 AWS CloudFormation 创建一个连接后，可使用控制台编辑该连接以使其状态为 Available。

aws codestar-connections create-connection \
    --provider-type Bitbucket \
    --connection-name MyConnection

输出：

{
    "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的创建连接。

创建主机

以下 create-host 示例演示如何创建主机，来表示安装第三方提供程序的基础设施的端点。此示例创建了一台主机，其中安装的第三方提供程序是 GitHub Enterprise Server。

默认情况下，通过 AWS CLI 创建的主机处于 Pending 状态。使用 CLI 创建主机后，可使用控制台或 CLI 设置主机以使其状态为 Available。

aws codestar-connections create-host \
    --name MyHost \
    --provider-type GitHubEnterpriseServer \
    --provider-endpoint "https://my-instance.dev"

输出：

{
    "HostArn": "arn:aws:codestar-connections:us-east-1:123456789012:host/My-Host-28aef605"
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的创建主机（CLI）。

删除连接

以下 delete-connection 示例演示如何删除连接。

aws codestar-connections delete-connection \
    --connection-arn arn:aws:codestar-connections:us-west-2:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

此命令不生成任何输出。

有关更多信息，请参阅《开发人员工具控制台用户指南》中的删除连接（CLI）。

删除主机

下面的 delete-host 示例演示如何删除主机。必须先删除与主机关联的所有连接，然后才能删除主机。

aws codestar-connections delete-host \
    --host-arn "arn:aws:codestar-connections:us-east-1 :123456789012:host/My-Host-28aef605"

此命令不生成任何输出。

有关更多信息，请参阅《开发人员工具控制台用户指南》中的删除主机（CLI）。

获取有关连接的信息

以下 get-connection 示例演示有关连接的信息。

aws codestar-connections get-connection \
    --connection-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

输出：

{
    "Connection": {
        "ConnectionName": "MyConnection",
        "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
        "ProviderType": "Bitbucket",
        "OwnerAccountId": "123456789012",
        "ConnectionStatus": "AVAILABLE"
    }
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的查看连接的详细信息。

获取有关主机的信息

以下 get-host 示例演示有关主机的信息。

aws codestar-connections get-host \
    --host-arn arn:aws:codestar-connections:us-east-1:123456789012:host/MyHost-28aef605

输出：

{
    "Name": "MyHost",
    "Status": "AVAILABLE",
    "ProviderType": "GitHubEnterpriseServer",
    "ProviderEndpoint": "https://test-instance-1.dev/"
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的查看主机的详细信息（CLI）。

列出连接

以下 list-connections 示例检索您账户中 Bitbucket 提供程序类型的所有连接的列表：

aws codestar-connections list-connections \
--provider-type Bitbucket \
--max-results 5 \
--next-token: next-token

输出：

{
    "Connections": [
        {
            "ConnectionName": "my-connection",
            "ProviderType": "Bitbucket",
            "Status": "PENDING",
            "ARN": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
            "OwnerAccountId": "123456789012"
        },
        {
            "ConnectionName": "my-other-connection",
            "ProviderType": "Bitbucket",
            "Status": "AVAILABLE",
            "ARN": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
            "OwnerAccountId": "123456789012"
        },
    ],
    "NextToken": "next-token"
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的列出连接（CLI）。

列出主机

以下 list-hosts 示例检索您账户中所有主机的列表。

aws codestar-connections list-hosts

输出：

{
    "Hosts": [
        {
            "Name": "My-Host",
            "HostArn": "arn:aws:codestar-connections:us-east-1:123456789012:host/My-Host-28aef605",
            "ProviderType": "GitHubEnterpriseServer",
            "ProviderEndpoint": "https://my-instance.test.dev",
            "Status": "AVAILABLE"
        }
    ]
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的列出主机（CLI）。

列出标签

以下 list-tags-for-resource 示例检索附加到指定连接资源的所有标签的列表。

aws codestar-connections list-tags-for-resource \
    --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

输出：

{
    "Tags": [
        {
            "Key": "Project",
            "Value": "ProjectA"
        },
        {
            "Key": "ReadOnly",
            "Value": "true"
        }
    ]
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的查看连接资源的标签。

标记资源

以下 tag-resource 示例将一组提供的标签与连接关联。使用此命令添加或编辑标签。

aws codestar-connections tag-resource \
    --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f \
    --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true

此命令不生成任何输出。

有关更多信息，请参阅《开发人员工具控制台用户指南》中的向连接资源添加标签。

移除连接资源的 AWS 标签

以下 untag-resource 移除指定资源的标签。

aws codestar-connections untag-resource \
    --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f \
    --tag-keys Project ReadOnly

输出：

{
    "Tags": []
}

有关更多信息，请参阅《开发人员工具控制台用户指南》中的移除连接资源的标签。