本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 標記 Amazon Bedrock 資源
<a name="tagging"></a>

為協助您管理 Amazon Bedrock 資源，您可以將中繼資料當做標籤將指派給每個資源。標籤是您指派給 AWS 資源的標籤。每個標籤皆包含索引鍵與值。

標籤可讓您以不同的方式分類 AWS 資源，例如依用途、擁有者或應用程式。如需標記的最佳實務和限制，請參閱[標記您的 AWS 資源](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)。

標籤可協助您執行以下操作：
+ 識別和組織您的 AWS 資源。許多 AWS 資源都支援標記，因此您可以將相同的標籤指派給不同服務中的資源，以指出資源是相同的。
+ 配置成本。您可以在 AWS 帳單與成本管理 儀表板上啟用標籤。 AWS 會使用標籤來分類您的成本，並為您提供每月成本分配報告。如需詳細資訊，請參閱 *AWS 帳單與成本管理 使用者指南*中的[使用成本配置標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
+ 控制對資源的存取。您可以搭配 Amazon Bedrock 使用標籤建立政策，以控制對 Amazon Bedrock 資源的存取。這些政策可連接至 IAM 角色或使用者，以啟用標籤型存取控制。

**Topics**
+ [在`bedrock-runtime`端點上標記資源](#tagging-runtime)
+ [在`bedrock-mantle`端點上標記資源](#tagging-mantle)

## 在`bedrock-runtime`端點上標記資源
<a name="tagging-runtime"></a>

透過`bedrock-runtime`控制平面建立的資源 （例如客服人員、知識庫、自訂模型、佈建輸送量和流程） 會使用專用標記 API 操作進行標記。

### 使用主控台
<a name="tagging-console"></a>

您可以在建立或編輯支援的資源時，隨時新增、修改和移除標籤。

### 使用 API
<a name="tagging-api"></a>

若要執行標記作業，您需要的是要對其執行標記作業的資源的 Amazon Resource Name (ARN)。有兩組標記作業，視要新增標籤或管理標籤的資源而定。

下表摘要說明不同的使用案例及相應的標記操作：


****  

| 使用案例 | 使用 [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) API 操作建立的資源 | 使用 [Amazon Bedrock 代理人](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) API 操作建立的資源 | 使用 Amazon Bedrock Data Automation API 建立的資源 | 
| --- | --- | --- | --- | 
| 標記資源 |  +  如果尚未建立資源，請在建立資源時使用 `tags` 欄位。 <br />+  如果已建立資源，請使用 [Amazon Bedrock 控制平面端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)提出 [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_TagResource.html) 請求。   |  +  如果尚未建立資源，請在建立資源時使用 `tags` 欄位。 <br />+  如果已建立資源，請使用 [Amazon Bedrock 代理人建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)提出 [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.html) 請求。   |  +  如果尚未建立資源，請在建立資源時使用 `tags` 欄位。 <br />+  如果已建立資源，請使用 Amazon Bedrock Data Automation 建置時期端點提出 TagResource 請求。   | 
| 取消標記資源 | 使用 [Amazon Bedrock 控制平面端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)提出 [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html) 請求。 | 使用 [Amazon Bedrock 代理人建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)提出 [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html) 請求。 | 使用 Amazon Bedrock Data Automation 建置時期端點提出 UntagResource 請求。 | 
| 列出資源的標籤 | 使用 [Amazon Bedrock 控制平面端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)提出 [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html) 請求。 | 使用 [Amazon Bedrock 代理人建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)提出 [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html) 請求。 | 使用 Amazon Bedrock Data Automation 建置時期端點提出 ListTagsForResource 請求。 | 

**注意**  
在 CloudTrail 中檢視這些操作時，您可以透過檢查事件詳細資訊中的請求參數，來識別要標記的特定資源。

選擇索引標籤以透過介面或語言查看程式碼範例。

------
#### [ AWS CLI ]

將兩個標籤新增至代理程式。以空格分隔鍵/值對。

```
aws bedrock-agent tag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tags key=department,value=billing key=facing,value=internal
```

從代理程式移除標籤。使用空格分隔索引鍵。

```
aws bedrock-agent untag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tag-keys key=department facing
```

列出代理程式的標籤。

```
aws bedrock-agent list-tags-for-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"
```

------
#### [ Python (Boto) ]

新增兩個標籤給代理程式。

```
import boto3

bedrock = boto3.client(service_name='bedrock-agent')

tags = [
    {
        'key': 'department',
        'value': 'billing'
    },
    {
        'key': 'facing',
        'value': 'internal'
    }
]

bedrock.tag_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', tags=tags)
```

從代理程式移除標籤。

```
bedrock.untag_resource(
    resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', 
    tagKeys=['department', 'facing']
)
```

列出代理程式的標籤。

```
bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')
```

------

## 在`bedrock-mantle`端點上標記資源
<a name="tagging-mantle"></a>

`bedrock-mantle` 端點支援標記專案、自訂模型和保留。與`bedrock-runtime`控制平面不同， `bedrock-mantle`不會公開專用 `TagResource`、 `UntagResource`或 `ListTagsForResource` API 操作。反之，您可以透過資源 APIs 內嵌設定和讀取標籤。

### 設定標籤
<a name="tagging-mantle-setting"></a>


****  

| Action | API 呼叫 | 標籤欄位 | 
| --- | --- | --- | 
| 使用標籤建立專案 | POST /v1/organization/projects | tags | 
| 在現有專案上新增或移除標籤 | POST /v1/organization/projects/{project\_id} | add\_tags, remove\_tag\_keys, tags | 
| 建立具有標籤的自訂模型 | 自訂模型建立端點 | tags | 
| 更新自訂模型上的標籤 | 自訂模型更新端點 | add\_tags, remove\_tag\_keys | 
| 使用標籤建立保留 | 保留建立端點 | tags | 
| 更新保留的標籤 | 保留更新端點 | add\_tags, remove\_tag\_keys | 

標籤會在取得和列出這些資源的回應上內嵌傳回。

### IAM 動作
<a name="tagging-mantle-iam"></a>

雖然沒有專用標記端點，但當您在`bedrock-mantle`資源上設定、變更或讀取標籤時，會評估下列 IAM 動作。您可以使用這些動作名稱和 `aws:RequestTag`、 和 `aws:ResourceTag`條件索引鍵來撰寫 IAM 政策`aws:TagKeys`，以控制標籤型存取。
+ `bedrock-mantle:TagResource`
+ `bedrock-mantle:UntagResource`
+ `bedrock-mantle:ListTagsForResource`

### 範例
<a name="tagging-mantle-example"></a>

下列範例使用 建立具有兩個標籤的專案`curl`：

```
curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "billing-experiments",
      "tags": {
        "department": "billing",
        "facing": "internal"
      }
    }'
```

下列範例會新增一個標籤，並從現有專案中移除另一個標籤：

```
curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "add_tags": { "owner": "alice" },
      "remove_tag_keys": ["facing"]
    }'
```