为连接资源添加标签

标签是您或 AWS 分配给 AWS 资源的自定义属性标签。每个 AWS 标签分为两部分：

标签键（例如，CostCenter、Environment 或 Project）。标签键区分大小写。
一个称为标签值的可选字段（例如，111122223333、Production 或团队名称）。省略标签值与使用空字符串效果相同。与标签键一样，标签值区分大小写。

这些被统称为键/值对。

您可以使用控制台或CLI来标记资源。

您可以在中标记以下资源类型 AWS CodeConnections：

连接
主机

这些步骤假设您已经安装了的最新版本 AWS CLI 或已更新到当前版本。有关更多信息，请参阅AWS Command Line Interface 《用户指南》中的安装 AWS CLI。

除了使用标签识别、组织和跟踪您的资源外，您还可以在 AWS Identity and Access Management (IAM) 策略中使用标签来帮助控制谁可以查看您的资源并与之交互。有关基于标签的访问策略示例，请参阅使用标签控制对 AWS CodeConnections 资源的访问权限。

标记资源（控制台）

您可以使用控制台添加、更新或删除连接资源上的标签。

主题

为连接资源添加标签（控制台）
查看连接资源的标签（控制台）
编辑连接资源的标签（控制台）
从连接资源中删除标签（控制台）

为连接资源添加标签（控制台）

您可以使用控制台向现有连接或主机添加标签。

注意

当您为已安装的提供商（例如 En GitHub terprise Server）创建连接并且还为您创建主机资源时，创建期间的标签只会添加到连接中。如果要将主机重用于新连接，则可以单独标记主机。如果您要将标签添加到主机，请使用此处的步骤。

为连接添加标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择连接选项卡。
选择要编辑的连接。此时将显示连接设置页面。
在 Connection tags (连接标记) 下，选择 Edit (编辑)。Edit Connection tags (编辑连接标签) 页面随即显示。
在键和值字段中，输入您要添加的每组标签的键/值对。（值字段为可选项。）例如，在键中，输入 Project。在值中，输入 ProjectA。
（可选）选择添加标签以添加多行并输入多个标签。
选择 Submit (提交)。标签在连接设置下列出。

为主机添加标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择 Host (主机) 选项卡。
选择要编辑的主机。此时将显示主机设置页面。
在 Host tags (主机标签) 下，选择 Edit (编辑)。Host tags (主机标签) 页面随即显示。
在键和值字段中，输入您要添加的每组标签的键/值对。（值字段为可选项。）例如，在键中，输入 Project。在值中，输入 ProjectA。
（可选）选择 Add tag (添加标签) 以添加多行并为主机输入多个标签。
选择提交。标签在主机设置下列出。

查看连接资源的标签（控制台）

您可以使用控制台查看现有资源的标签。

要查看连接的标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择连接选项卡。
选择要查看的连接。此时将显示连接设置页面。
在 Connection tags (连接标签) 下，在 Key (键) 和 Value (值) 列下查看连接的标签。

查看主机的标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择 Host (主机) 选项卡。
选择要查看的主机。
在 Host tags (主机标签) 下，在 Key (键) 和 Value (值) 列下查看主机的标签。

编辑连接资源的标签（控制台）

您可以使用控制台来编辑已添加到连接资源的标签。

编辑连接的标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择连接选项卡。
选择要编辑的连接。此时将显示连接设置页面。
在 Connection tags (连接标记) 下，选择 Edit (编辑)。Connection tags (连接标记) 页面随即显示。
在键和值字段中，根据需要更新每个字段的值。例如，对于 Project 键，在值中，将 ProjectA 更改为 ProjectB。
选择 Submit (提交)。

编辑主机的标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择 Host (主机) 选项卡。
选择要编辑的主机。此时将显示主机设置页面。
在 Host tags (主机标签) 下，选择 Edit (编辑)。Host tags (主机标签) 页面随即显示。
在键和值字段中，根据需要更新每个字段的值。例如，对于 Project 键，在值中，将 ProjectA 更改为 ProjectB。
选择 Submit (提交)。

从连接资源中删除标签（控制台）

您可以使用控制台从连接资源中删除标签。当您移除关联资源的标签时，对应标签会被删除。

删除连接的标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择连接选项卡。
选择要编辑的连接。此时将显示连接设置页面。
在 Connection tags (连接标记) 下，选择 Edit (编辑)。Connection tags (连接标记) 页面随即显示。
接下来，对于您要删除的每个标签的键和值，选择删除标签。
选择提交。

删除主机的标签

登录到控制台。从导航窗格中，选择设置。
在 Settings (设置) 下，选择 Connections (连接)。选择 Host (主机) 选项卡。
选择要编辑的主机。此时将显示主机设置页面。
在 Host tags (主机标签) 下，选择 Edit (编辑)。Host tags (主机标签) 页面随即显示。
接下来，对于您要删除的每个标签的键和值，选择删除标签。
选择提交。

标记资源 (CLI)

您可以使用查看、添加、更新或移除连接资源上的标签。CLI

主题

为连接资源添加标签 (CLI)
查看连接资源的标签 (CLI)
编辑连接资源的标签 (CLI)
从连接资源中移除标签 (CLI)

为连接资源添加标签 (CLI)

您可以使用 AWS CLI 来标记连接中的资源。

在终端或命令行运行tag-resource命令，指定要在其中添加标签的资源的 Amazon 资源名称 (ARN) 以及要添加的标签的键和值。您可以添加多个标签。

为连接添加标签

获取ARN适合您资源的资源。使用中所示列出连接的list-connections命令获取连接ARN。
在终端或命令行中，运行 tag-resource 命令。

例如，使用以下命令使用两个标签（一个名为的标签密钥）来标记连接 Project 标签值为 ProjectA，以及一个名为的标签密钥 ReadOnly 标签值为 true.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
如果成功，该命令不返回任何内容。

为主机添加标签

获取ARN适合您资源的资源。使用中所示的list-hosts命令列出主机获取主机ARN。
在终端或命令行中，运行 tag-resource 命令。

例如，使用以下命令为主机添加两个标签，一个名为的标签密钥 Project 标签值为 ProjectA，以及一个名为的标签密钥 IscontainerBased 标签值为 true.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
如果成功，该命令不返回任何内容。

查看连接资源的标签 (CLI)

您可以使用 AWS CLI 来查看连接资源的 AWS 标签。如果尚未添加标签，则返回的列表为空。使用 list-tags-for-resource 命令查看已添加到连接或主机的标签。

查看连接的标签

获取ARN适合您资源的资源。使用中所示列出连接的list-connections命令获取连接ARN。

在终端或命令行中，运行 list-tags-for-resource 命令。例如，使用以下命令可查看连接的标签键和标签值列表。


aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

此命令返回与资源关联的标签。此示例显示了为连接返回的两个“键-值”对。


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

查看主机的标签

获取ARN适合您资源的资源。使用中所示的list-hosts命令列出主机获取主机ARN。

在终端或命令行中，运行 list-tags-for-resource 命令。例如，使用以下命令可查看主机的标签键和标签值列表。


aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605

此命令返回与资源关联的标签。此示例显示了为主机返回的两个“键-值”对。


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

编辑连接资源的标签 (CLI)

您可以使用 AWS CLI 来编辑资源的标签。您可以更改现有键的值或添加另一个键。

在终端或命令行运行tag-resource命令，指定要更新标签ARN的资源，并指定要更新的标签键和标签值。

编辑标签时，任何未指定的标签键都将被保留，而具有相同键和新值的任何标签键都将被更新。通过编辑命令添加的新键将作为新的键-值对添加。

编辑连接的标签

获取ARN适合您资源的资源。使用中所示列出连接的list-connections命令获取连接ARN。
在终端或命令行中，运行 tag-resource 命令。

在此示例中，键 Project 的值将更改为 ProjectB。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
```
如果成功，该命令不返回任何内容。要验证与连接关联的标签，请运行 list-tags-for-resource 命令。

编辑主机的标签

获取ARN适合您资源的资源。使用中所示的list-hosts命令列出主机获取主机ARN。
在终端或命令行中，运行 tag-resource 命令。

在此示例中，键 Project 的值将更改为 ProjectB。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
```
如果成功，该命令不返回任何内容。要验证与主机关联的标签，请运行 list-tags-for-resource 命令。

从连接资源中移除标签 (CLI)

按照以下步骤使用 AWS CLI 从资源中移除标签。当您移除关联资源的标签时，对应标签会被删除。

注意

如果删除连接资源，则会从删除的资源中删除所有标签关联。在删除连接资源之前，无需删除标签。

在终端或命令行运行untag-resource命令，指定要移除标签的资源以及要删除的标签的标签密钥。ARN例如，使用标签键删除连接上的多个标签 Project 以及 ReadOnly，请使用以下命令。


aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys Project ReadOnly

如果成功，该命令不返回任何内容。要验证与资源关联的标签，请运行 list-tags-for-resource 命令。输出将显示所有已删除的标签。


{
    "Tags": []
}

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

删除连接

查看连接详细信息