> For the complete documentation index, see [llms.txt](https://smallso.gitbook.io/tencent-cloud-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/class-and-method/function-trigger/use-object-storage-bucket.md).

# use\_object\_storage\_bucket 方法

## 简要

配置使用对象存储桶触发器。[什么是对象存储桶触发器？](https://cloud.tencent.com/document/product/583/9707)

```python
def use_object_storage_bucket(self,
    bucket_endpoint: str,
    bucket_requirement_context: dict
)
```

## 参数

该方法具有以下参数，其参数、参数类型和参数描述如下：

| 参数                           | 类型                                                                                                                                                                | 必选 | 描述                       |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- | ------------------------ |
| bucket\_endpoint             | str                                                                                                                                                               | 是  | 对象存储桶的 XML API 访问端点主机名。  |
| bucket\_requirement\_context | [ObjectStorageBucketTriggerFilter](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/data-types/object-storage-bucket-trigger-filter) | 是  | 包含对象存储桶触发器事件过滤描述结构的字典实例。 |

## 返回值

该方法返回当前代表触发器配置的 [FunctionTrigger](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/class-and-method/function-trigger) 类实例本身。

## 异常

该方法可能会主动引发的异常类型如下：

#### ValueError

参数值或类型不符合预期。

## 示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

```python
functions.FunctionTrigger.use_object_storage_bucket(
    bucket_endpoint = 'scf-code-1000000000.cos.ap-shanghai.myqcloud.com',
    bucket_requirement_context = {
        'event_id': 'cos:ObjectCreated:*'
    }
)
```

## 适用于

#### Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.1