# quilt3.Bucket
Bucket interface for Quilt.
**\_\_init\_\_**
Creates a Bucket object.
**Arguments**
* **bucket\_uri(str)**: URI of bucket to target. Must start with 's3://'
**Returns**
A new Bucket
## Bucket.search(self, query: Union\[str, dict], limit: int = 10) -> List\[dict]
Execute a search against the configured search endpoint.
**Arguments**
* **query**: query string to query if passed as `str`, DSL query body if passed as `dict`
* **limit**: maximum number of results to return. Defaults to 10
Query Syntax: [Query String Query](https://www.elastic.co/guide/en/elasticsearch/reference/7.10/query-dsl-query-string-query.html) [Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/7.10/query-dsl.html)
Index schemas and search examples can be found in the [Quilt Search documentation](https://docs.quilt.bio/quilt-platform-catalog-user/search).
**Returns**
search results
## Bucket.put\_file(self, key, path)
Stores file at path to key in bucket.
**Arguments**
* **key(str)**: key in bucket to store file at
* **path(str)**: string representing local path to file
**Returns**
None
**Raises**
* if no file exists at path
* if copy fails
## Bucket.put\_dir(self, key, directory)
Stores all files in the `directory` under the prefix `key`.
**Arguments**
* **key(str)**: prefix to store files under in bucket
* **directory(str)**: path to directory to grab files from
**Returns**
None
**Raises**
* if writing to bucket fails
## Bucket.keys(self)
Lists all keys in the bucket.
**Returns**
List of strings
## Bucket.delete(self, key)
Deletes a key from the bucket.
**Arguments**
* **key(str)**: key to delete
**Returns**
None
**Raises**
* if delete fails
## Bucket.delete\_dir(self, path)
Delete a directory and all of its contents from the bucket.
**Arguments**
* **path (str)**: path to the directory to delete
## Bucket.ls(self, path=None, recursive=False)
List data from the specified path.
**Arguments**
* **path (str)**: bucket path to list
* **recursive (bool)**: show subdirectories and their contents as well
**Returns**
`list`: Return value structure has not yet been permanently decided Currently, it's a `tuple` of `list` objects, containing the `following`: (directory info, file/object info, delete markers).
## Bucket.fetch(self, key, path)
Fetches file (or files) at `key` to `path`.
If `key` ends in '/', then all files with the prefix `key` will match and will be stored in a directory at `path`.
Otherwise, only one file will be fetched and it will be stored at `path`.
**Arguments**
* **key(str)**: key in bucket to fetch
* **path(str)**: path in local filesystem to store file or files fetched
**Returns**
None
**Raises**
* if path doesn't exist
* if download fails
## Bucket.select(self, key, query, raw=False)
Selects data from an S3 object.
**Arguments**
* **key(str)**: key to query in bucket
* **query(str)**: query to execute (SQL by default)
* **query\_type(str)**: other query type accepted by S3 service
* **raw(bool)**: return the raw (but parsed) response
**Returns**
`pandas.DataFrame`: results of query
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.quilt.bio/quilt-python-sdk/api-reference/bucket.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.