3.8.0-rc 3.7.0 (latest) 3.6.0 3.5.0 3.4.0 3.3.0 3.2.0 2.48.0-rc 2.47.1 2.46.0 2.45.0 2.44.0 2.43.0 2.42.0 2.41.0 2.40.0 2.39.0 2.38.0 2.37.0 2.36.0 2.35.0 2.34.0 2.33.0 2.32.0 2.31.0 2.30.0 2.29.0 2.28.0 2.27.0 2.26.0 2.25.1 2.24.0 2.23.0 2.22.1 2.21.0 2.20.0 2.19.0 2.18.0 2.17.0 2.16.0 2.15.1 2.14.0 2.13.0 2.12.0 2.11.0 The `*Connection` object for [`AsyncClient`](https://docs.cloud.google.com/cpp/docs/reference/storage/latest/classgoogle_1_1cloud_1_1storage_1_1AsyncClient).
This interface defines virtual methods for each of the user-facing overload sets in [`AsyncClient`](https://docs.cloud.google.com/cpp/docs/reference/storage/latest/classgoogle_1_1cloud_1_1storage_1_1AsyncClient). This allows users to inject custom behavior (e.g., with a Google Mock object) when writing tests that use objects of type [`AsyncClient`](https://docs.cloud.google.com/cpp/docs/reference/storage/latest/classgoogle_1_1cloud_1_1storage_1_1AsyncClient).

To create a concrete instance, see `MakeAsyncConnection()`.

For mocking, see [`storage_mocks::MockAsyncConnection`](https://docs.cloud.google.com/cpp/docs/reference/storage/latest/classgoogle_1_1cloud_1_1storage__mocks_1_1MockAsyncConnection).

## Functions

### options() const

The options used to configure this connection, with any defaults applied.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `Options` |   |

### GetBucket(GetBucketParams)

Get bucket metadata.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `GetBucketParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< google::storage::v2::Bucket > >` |   |

### InsertObject(InsertObjectParams)

Insert a new object.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `InsertObjectParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< google::storage::v2::Object > >` |   |

### Open(OpenParams)

Open an object to perform multiple reads.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `OpenParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::shared_ptr< ObjectDescriptorConnection > > >` |   |

### ReadObject(ReadObjectParams)

Asynchronously create a stream to read object contents.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `ReadObjectParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::unique_ptr< AsyncReaderConnection > > >` |   |

### ReadObjectRange(ReadObjectParams)

Read a range from an object returning all the contents.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `ReadObjectParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< ReadPayload > >` |   |

### StartAppendableObjectUpload(AppendableUploadParams)

Start an appendable upload configured for persistent sources.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `AppendableUploadParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::unique_ptr< AsyncWriterConnection > > >` |   |

### ResumeAppendableObjectUpload(AppendableUploadParams)

Resume an appendable upload configured for persistent sources.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `AppendableUploadParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::unique_ptr< AsyncWriterConnection > > >` |   |

### StartUnbufferedUpload(UploadParams)

Start (or resume) an upload configured for persistent sources.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `UploadParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::unique_ptr< AsyncWriterConnection > > >` |   |

### StartBufferedUpload(UploadParams)

Start (or resume) an upload configured for streaming sources.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `UploadParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::unique_ptr< AsyncWriterConnection > > >` |   |

### ResumeUnbufferedUpload(ResumeUploadParams)

Resume an upload configured for persistent sources.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `ResumeUploadParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::unique_ptr< AsyncWriterConnection > > >` |   |

### ResumeBufferedUpload(ResumeUploadParams)

Resume an upload configured for streaming sources.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `ResumeUploadParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< std::unique_ptr< AsyncWriterConnection > > >` |   |

### ComposeObject(ComposeObjectParams)

Create a new object by composing (concatenating) the contents of existing objects.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `ComposeObjectParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< StatusOr< google::storage::v2::Object > >` |   |

### DeleteObject(DeleteObjectParams)

Delete an object.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `DeleteObjectParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `future< Status >` |   |

### RewriteObject(RewriteObjectParams)

Start an object rewrite.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `p` | `RewriteObjectParams` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `std::shared_ptr< AsyncRewriterConnection >` |   |