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

# 使用 CloudTrail 監控 `bedrock-mantle` API 呼叫
<a name="logging-cloudtrail-mantle"></a>

`bedrock-mantle.{{region}}.api.aws` 端點與 整合 AWS CloudTrail。CloudTrail 會將對 `bedrock-mantle` API 操作的呼叫記錄為事件，包括來自 的呼叫 AWS 管理主控台、 AWS CLI、OpenAI SDK、Anthropic SDK 和直接 HTTPS 呼叫。事件具有 `eventSource`的 `bedrock-mantle.amazonaws.com`。

如果您的應用程式透過 呼叫推論`bedrock-runtime.{{region}}.amazonaws.com`，請[使用 CloudTrail 監控 Amazon Bedrock API 呼叫](logging-using-cloudtrail.md)改為參閱 。

如需 CloudTrail 本身的背景，請參閱 [AWS CloudTrail 使用者指南](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)。

## 管理事件
<a name="mantle-cloudtrail-management-events"></a>

管理事件預設會記錄到您的 CloudTrail **事件歷史記錄**，無需額外費用。 會將下列操作`bedrock-mantle`記錄為管理事件。每個事件`requestParameters`的欄位也包含 `callWithBearerToken`（以及適用`bearerTokenType`時），由服務針對每個事件新增。


**  模型**  

| 事件名稱 | HTTP 路由 | 其他請求參數 | 
| --- | --- | --- | 
| ListModels | GET /v1/models | 無 | 
| GetModel | GET /v1/models/{model} | model | 


**微調**  

| 事件名稱 | HTTP 路由 | 其他請求參數 | 
| --- | --- | --- | 
| ListFineTuningJobs | GET /v1/fine\_tuning/jobs | 無 | 
| CreateFineTuningJob | POST /v1/fine\_tuning/jobs | model、trainingFile、metadata、、 validationFilemethod（結構物件，包括 type和 ，用於強化執行，grader.lambda.function) | 
| GetFineTuningJob | GET /v1/fine\_tuning/jobs/{id}, /events, /checkpoints | fineTuningJob | 
| CancelFineTuningJob | POST /v1/fine\_tuning/jobs/{id}/cancel | fineTuningJob | 


**專案**  

| 事件名稱 | HTTP 路由 | 其他請求參數 | 
| --- | --- | --- | 
| ListProjects | GET /v1/organization/projects | 無 | 
| CreateProject | POST /v1/organization/projects | name, tags | 
| GetProject | GET /v1/organization/projects/{project\_id} | project\_id | 
| UpdateProject | POST /v1/organization/projects/{project\_id} | project\_id, name, add\_tags, remove\_tag\_keys, tags | 
| ArchiveProject | POST /v1/organization/projects/{project\_id}/archive | project\_id | 

## 資料事件
<a name="mantle-cloudtrail-data-events"></a>

預設不會記錄資料事件，並產生額外的 CloudTrail 費用。 會將下列操作`bedrock-mantle`記錄為資料事件。若要擷取它們，請在您的線索或事件資料存放區上設定進階事件選取器，如[記錄資料事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html)中所述。


**Inference**  

| 事件名稱 | HTTP 路由 | 其他請求參數 | 
| --- | --- | --- | 
| CreateInference | POST /v1/responses | model, previousResponse, stream, service\_tier, metadata | 
| CreateInference | POST /v1/responses/compact | model, previous\_response\_id | 
| CreateInference | POST /v1/chat/completions | model, stream, service\_tier, metadata | 
| CreateInference | POST /v1/embeddings | model | 
| CreateInference | POST /anthropic/v1/messages | model, stream, max\_tokens | 
| GetInference | GET /v1/responses/{response\_id} | response, stream | 
| CancelInference | POST /v1/responses/{response\_id}/cancel | response | 
| DeleteInference | DELETE /v1/responses/{response\_id} | response | 
| CountTokens | POST /anthropic/v1/messages/count\_tokens | model | 


**檔案**  

| 事件名稱 | HTTP 路由 | 其他請求參數 | 
| --- | --- | --- | 
| ListFiles | GET /v1/files | limit, order, purpose, after | 
| CreateFile | POST /v1/files | purpose, filename, bytes | 
| GetFile | GET /v1/files/{file\_id}, /content | file | 
| DeleteFile | DELETE /v1/files/{file\_id} | file | 

**注意**  
客戶提供`metadata`的`CreateInference`呼叫會在 CloudTrail 中逐字記錄。`metadata` 如果您要擷取資料事件，請勿在 中包含秘密、登入資料或其他敏感值。

## 設定資料事件擷取
<a name="mantle-cloudtrail-configuring"></a>

下列範例會設定線索來擷取所有`bedrock-mantle`推論和檔案資料事件：

```
aws cloudtrail put-event-selectors \
    --trail-name <trailName> \
    --advanced-event-selectors '[
      {
        "Name": "Log Bedrock Mantle inference and file events",
        "FieldSelectors": [
          { "Field": "eventCategory", "Equals": ["Data"] },
          { "Field": "resources.type", "Equals": [
            "AWS::BedrockMantle::Project",
            "AWS::BedrockMantle::CustomizedModel",
            "AWS::BedrockMantle::Reservation"
          ]}
        ]
      }
    ]'
```

您也可以依 `eventName`和 進行篩選`resources.ARN`。如需進階事件選取器的詳細資訊，請參閱 [AdvancedFieldSelector](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html)。

## 資源類型
<a name="mantle-cloudtrail-resource-types"></a>

`bedrock-mantle` CloudTrail 事件參考下列資源類型：
+ `AWS::BedrockMantle::Project`
+ `AWS::BedrockMantle::Reservation`
+ `AWS::BedrockMantle::CustomizedModel`
+ `AWS::BedrockMantle::Environment`
+ `AWS::BedrockMantle::Runtime`
+ `AWS::BedrockMantle::Skill`

## 範例日誌項目
<a name="mantle-cloudtrail-example"></a>

```
{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AROAICFHPEXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/userxyz",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "userxyz"
    },
    "eventTime": "2026-05-30T14:32:11Z",
    "eventSource": "bedrock-mantle.amazonaws.com",
    "eventName": "CreateInference",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "192.0.2.0",
    "userAgent": "OpenAI/Python 1.50.0",
    "requestParameters": {
        "model": "anthropic.claude-opus-4-7",
        "stream": true,
        "service_tier": "default",
        "metadata": {"team": "platform"},
        "callWithBearerToken": true,
        "bearerTokenType": "ABSK"
    },
    "responseElements": null,
    "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": false,
    "recipientAccountId": "111122223333",
    "eventCategory": "Data",
    "resources": [
        {
            "accountId": "111122223333",
            "type": "AWS::BedrockMantle::Project",
            "ARN": "arn:aws:bedrock-mantle:us-east-1:111122223333:project/proj_abc123"
        }
    ],
    "tlsDetails": {
        "tlsVersion": "TLSv1.3",
        "cipherSuite": "TLS_AES_128_GCM_SHA256",
        "clientProvidedHostHeader": "bedrock-mantle.us-east-1.api.aws"
    }
}
```

## 與 `bedrock-runtime` CloudTrail 記錄的差異
<a name="mantle-cloudtrail-differences"></a>
+ **推論是 上的資料事件`bedrock-mantle`，是 上的管理事件`bedrock-runtime`。**`bedrock-runtime` 端點會將 [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html)、[ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)、[InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) 和 [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) 記錄為管理事件，無需額外費用。`bedrock-mantle` 端點日誌`CreateInference`和其他推論操作作為資料事件，這會產生 CloudTrail 資料事件費用。如果您需要在 上進行推論呼叫的稽核線索`bedrock-mantle`，則必須在線索或事件資料存放區上明確啟用資料事件擷取。
+ **不同的事件來源和資源類型。** `bedrock-mantle`事件使用 `eventSource`的 `bedrock-mantle.amazonaws.com`和參考`AWS::BedrockMantle::*`資源類型。CloudTrail Lake 查詢、Athena 檢視，以及依 篩選`bedrock.amazonaws.com`或`bedrock-runtime.amazonaws.com`不會擷取`bedrock-mantle`活動的偵測控制項。