CodeConnections 使用示例 Amazon CLI

创建连接

以下create-connection示例说明如何创建与第三方存储库的连接。此示例创建了一个连接，其中第三方提供商是 Bitbucket。

通过 Amazon CLI 创建的连接或默认 Amazon CloudFormation 处于待处理状态。使用 CLI 或创建连接后 Amazon CloudFormation，使用控制台编辑连接以使其状态变为 “可用”。

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 企业服务器。

默认情况下，通过 Amazon CLI 创建的主机处于待处理状态。使用 CLI 创建主机后，使用控制台或 CLI 将主机设置为可用状态。

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

此命令不生成任何输出。

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

从连接资源中移除 Amazon 标签

以下内容从指定资源中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": []
}

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