tiered multitenancy docs

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/_description.md

@@ -0,0 +1,5 @@
+This code snippet creates a named shard with the name "default" in a Qdrant collection.
+Collection is required to be configured with `custom` sharding method to support named shards.
+Once created, named shard will receive all requests that specify its name in the shard key selector.
+
+If no named shard is specified in the request, request will be broadcasted to all shards in the collection.

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/csharp.md

@@ -0,0 +1,11 @@
+```csharp
+using Qdrant.Client;
+using Qdrant.Client.Grpc;
+
+var client = new QdrantClient("localhost", 6334);
+
+await client.CreateShardKeyAsync(
+    "{collection_name}",
+    new CreateShardKey { ShardKey = new ShardKey { Keyword = "default", } }
+    );
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/go.md

@@ -0,0 +1,16 @@
+```go
+import (
+	"context"
+
+	"github.com/qdrant/go-client/qdrant"
+)
+
+client, err := qdrant.NewClient(&qdrant.Config{
+	Host: "localhost",
+	Port: 6334,
+})
+
+client.CreateShardKey(context.Background(), "{collection_name}", &qdrant.CreateShardKey{
+	ShardKey: qdrant.NewShardKey("default"),
+})
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/http.md

@@ -0,0 +1,6 @@
+```http
+PUT /collections/{collection_name}/shards
+{
+  "shard_key": "default"
+}
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/java.md

@@ -0,0 +1,18 @@
+```java
+import static io.qdrant.client.ShardKeyFactory.shardKey;
+
+import io.qdrant.client.QdrantClient;
+import io.qdrant.client.QdrantGrpcClient;
+import io.qdrant.client.grpc.Collections.CreateShardKey;
+import io.qdrant.client.grpc.Collections.CreateShardKeyRequest;
+
+QdrantClient client =
+    new QdrantClient(QdrantGrpcClient.newBuilder("localhost", 6334, false).build());
+
+client.createShardKeyAsync(CreateShardKeyRequest.newBuilder()
+                .setCollectionName("{collection_name}")
+                .setRequest(CreateShardKey.newBuilder()
+                                .setShardKey(shardKey("default"))
+                                .build())
+                .build()).get();
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/python.md

@@ -0,0 +1,7 @@
+```python
+from qdrant_client import QdrantClient, models
+
+client = QdrantClient(url="http://localhost:6333")
+
+client.create_shard_key("{collection_name}", "default")
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/rust.md

@@ -0,0 +1,15 @@
+```rust
+use qdrant_client::qdrant::{
+    CreateShardKeyBuilder, CreateShardKeyRequestBuilder
+};
+use qdrant_client::Qdrant;
+
+let client = Qdrant::from_url("http://localhost:6334").build()?;
+
+client
+    .create_shard_key(
+        CreateShardKeyRequestBuilder::new("{collection_name}")
+            .request(CreateShardKeyBuilder::default().shard_key("default".to_string())),
+    )
+    .await?;
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-default/typescript.md

@@ -0,0 +1,9 @@
+```typescript
+import { QdrantClient } from "@qdrant/js-client-rest";
+
+const client = new QdrantClient({ host: "localhost", port: 6333 });
+
+client.createShardKey("{collection_name}", {
+    shard_key: "default"
+});
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/_description.md

@@ -0,0 +1,5 @@
+This code snippet creates a named shard with the name "user_1" in a Qdrant collection.
+This shard is intended to be used as a dedicated shard for a specific tenant or user, allowing for better data isolation and management. Creation of the shard specifies initial state as `Partial`, as it needs to be populated with data before it can serve requests.
+
+Collection is required to be configured with `custom` sharding method to support named shards.
+Once created, named shard will receive all requests that specify its name in the shard key selector.

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/csharp.md

@@ -0,0 +1,14 @@
+```csharp
+using Qdrant.Client;
+using Qdrant.Client.Grpc;
+
+var client = new QdrantClient("localhost", 6334);
+
+await client.CreateShardKeyAsync(
+    "{collection_name}",
+    new CreateShardKey { 
+        ShardKey = new ShardKey { Keyword = "default" },
+        InitialState = ReplicaState.Partial
+    }
+);
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/go.md

@@ -0,0 +1,21 @@
+```go
+import (
+	"context"
+
+	"github.com/qdrant/go-client/qdrant"
+)
+
+client, err := qdrant.NewClient(&qdrant.Config{
+	Host: "localhost",
+	Port: 6334,
+})
+
+client.CreateShardKey(
+	context.Background(),
+	"{collection_name}",
+	&qdrant.CreateShardKey{
+		ShardKey: qdrant.NewShardKey("default"),
+		InitialState: qdrant.ReplicaState_PARTIAL,
+	}
+)
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/http.md

@@ -0,0 +1,7 @@
+```http
+PUT /collections/{collection_name}/shards
+{
+  "shard_key": "user_1",
+  "initial_state": "Partial"
+}
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/java.md

@@ -0,0 +1,20 @@
+```java
+import static io.qdrant.client.ShardKeyFactory.shardKey;
+
+import io.qdrant.client.QdrantClient;
+import io.qdrant.client.QdrantGrpcClient;
+import io.qdrant.client.grpc.Collections.CreateShardKey;
+import io.qdrant.client.grpc.Collections.CreateShardKeyRequest;
+import io.qdrant.client.grpc.Collections.ReplicaState;
+
+QdrantClient client =
+    new QdrantClient(QdrantGrpcClient.newBuilder("localhost", 6334, false).build());
+
+client.createShardKeyAsync(CreateShardKeyRequest.newBuilder()
+                .setCollectionName("{collection_name}")
+                .setRequest(CreateShardKey.newBuilder()
+                                .setShardKey(shardKey("default"))
+                                .setInitialState(ReplicaState.PARTIAL)
+                                .build())
+                .build()).get();
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/python.md

@@ -0,0 +1,11 @@
+```python
+from qdrant_client import QdrantClient, models
+
+client = QdrantClient(url="http://localhost:6333")
+
+client.create_shard_key(
+    "{collection_name}",
+    shard_key="user_1",
+    initial_state=models.ReplicaState.PARTIAL
+)
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/rust.md

@@ -0,0 +1,20 @@
+```rust
+use qdrant_client::qdrant::{
+    CreateShardKeyBuilder, CreateShardKeyRequestBuilder
+};
+use qdrant_client::qdrant::ReplicaState;
+use qdrant_client::Qdrant;
+
+let client = Qdrant::from_url("http://localhost:6334").build()?;
+
+client
+    .create_shard_key(
+        CreateShardKeyRequestBuilder::new("{collection_name}")
+            .request(
+                CreateShardKeyBuilder::default()
+                    .shard_key("user_1".to_string())
+                    .initial_state(ReplicaState::Partial)
+            ),
+    )
+    .await?;
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard-for-promotion/typescript.md

@@ -0,0 +1,10 @@
+```typescript
+import { QdrantClient } from "@qdrant/js-client-rest";
+
+const client = new QdrantClient({ host: "localhost", port: 6333 });
+
+client.createShardKey("{collection_name}", {
+    shard_key: "default",
+    initial_state: "Partial"
+});
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/_description.md

@@ -0,0 +1,5 @@
+This code snippet creates a named shard in a Qdrant collection.
+Collection is required to be configured with `custom` sharding method to support named shards.
+Once created, named shard will receive all requests that specify its name in the shard key selector.
+
+If no named shard is specified in the request, request will be broadcasted to all shards in the collection.

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/csharp.md

@@ -0,0 +1,11 @@
+```csharp
+using Qdrant.Client;
+using Qdrant.Client.Grpc;
+
+var client = new QdrantClient("localhost", 6334);
+
+await client.CreateShardKeyAsync(
+    "{collection_name}",
+    new CreateShardKey { ShardKey = new ShardKey { Keyword = "{shard_key}", } }
+    );
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/go.md

@@ -0,0 +1,16 @@
+```go
+import (
+	"context"
+
+	"github.com/qdrant/go-client/qdrant"
+)
+
+client, err := qdrant.NewClient(&qdrant.Config{
+	Host: "localhost",
+	Port: 6334,
+})
+
+client.CreateShardKey(context.Background(), "{collection_name}", &qdrant.CreateShardKey{
+	ShardKey: qdrant.NewShardKey("{shard_key}"),
+})
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/http.md

@@ -0,0 +1,6 @@
+```http
+PUT /collections/{collection_name}/shards
+{
+  "shard_key": "{shard_key}"
+}
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/java.md

@@ -0,0 +1,18 @@
+```java
+import static io.qdrant.client.ShardKeyFactory.shardKey;
+
+import io.qdrant.client.QdrantClient;
+import io.qdrant.client.QdrantGrpcClient;
+import io.qdrant.client.grpc.Collections.CreateShardKey;
+import io.qdrant.client.grpc.Collections.CreateShardKeyRequest;
+
+QdrantClient client =
+    new QdrantClient(QdrantGrpcClient.newBuilder("localhost", 6334, false).build());
+
+client.createShardKeyAsync(CreateShardKeyRequest.newBuilder()
+                .setCollectionName("{collection_name}")
+                .setRequest(CreateShardKey.newBuilder()
+                                .setShardKey(shardKey("{shard_key}"))
+                                .build())
+                .build()).get();
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/python.md

@@ -0,0 +1,7 @@
+```python
+from qdrant_client import QdrantClient, models
+
+client = QdrantClient(url="http://localhost:6333")
+
+client.create_shard_key("{collection_name}", "{shard_key}")
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/rust.md

@@ -0,0 +1,15 @@
+```rust
+use qdrant_client::qdrant::{
+    CreateShardKeyBuilder, CreateShardKeyRequestBuilder
+};
+use qdrant_client::Qdrant;
+
+let client = Qdrant::from_url("http://localhost:6334").build()?;
+
+client
+    .create_shard_key(
+        CreateShardKeyRequestBuilder::new("{collection_name}")
+            .request(CreateShardKeyBuilder::default().shard_key("{shard_key}".to_string())),
+    )
+    .await?;
+```

qdrant-landing/content/documentation/headless/snippets/create-shard/create-named-shard/typescript.md

@@ -0,0 +1,9 @@
+```typescript
+import { QdrantClient } from "@qdrant/js-client-rest";
+
+const client = new QdrantClient({ host: "localhost", port: 6333 });
+
+client.createShardKey("{collection_name}", {
+    shard_key: "{shard_key}"
+});
+```