Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

A newer version of this documentation is available.

View Latest

Buckets and Clusters

  • concept
    +
    The Couchbase .NET SDK provides an API for managing a Couchbase cluster programmatically.

    The primary means for managing clusters is through the Couchbase Web UI which provides an easy to use interface for adding, removing, monitoring, and modifying buckets. In some instances you may wish to have a programmatic interface. For example, if you wish to manage a cluster from a setup script, or if you are setting up buckets in test scaffolding.

    The SDK also comes with some convenience functionality for common Couchbase management requests — see the Provisioning Cluster Resources guide.

    Management operations in the .NET SDK may be performed through several interfaces depending on the object:

    Creating and Removing Buckets

    To create or delete a bucket, first get an IBucketManager instance from the Buckets property on the cluster:

    IBucketManager manager = cluster.Buckets;

// create a bucket
var bucketSettings = new BucketSettings();
bucketSettings.Name = "mynewbucket";
bucketSettings.BucketType = BucketType.Couchbase;
bucketSettings.RamQuotaMB = 100;
await manager.CreateBucketAsync(bucketSettings);

// delete a bucket
await manager.DropBucketAsync("mynewbucket");

    IBucketManager is also used to expose information about an existing bucket (manager.GetBucketAsync(string)) or to update an existing bucket (manager.UpdateBucketAsync(BucketSettings)).