Merge pull request #1880 from MicrosoftDocs/main

4/8/2025 AM Publish

Author: Taojunshen

articles/cosmos-db/.openpublishing.redirection.cosmos-db.json

@@ -450,6 +450,16 @@
       "redirect_url": "/azure/cosmos-db/create-sql-api-dotnet",
       "redirect_document_id": true
     },
+    {
+      "source_path_from_root": "/articles/cosmos-db/nosql/cli-samples.md",
+      "redirect_url": "/azure/cosmos-db/nosql/samples-cli",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/cosmos-db/nosql/powershell-samples.md",
+      "redirect_url": "/azure/cosmos-db/nosql/samples-powershell",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/articles/cosmos-db/create-sql-api-dotnet-preview.md",
       "redirect_url": "/azure/cosmos-db/create-sql-api-dotnet",

articles/cosmos-db/cassandra/how-to-create-container.md

@@ -16,10 +16,10 @@ ms.custom: devx-track-csharp, devx-track-azurecli, devx-track-dotnet, devx-track
 
 This article explains the different ways to create a container in Azure Cosmos DB for Apache Cassandra. It shows how to create a container using Azure portal, Azure CLI, PowerShell, or supported SDKs. This article demonstrates how to create a container, specify the partition key, and provision throughput.
 
-This article explains the different ways to create a container in Azure Cosmos DB for Apache Cassandra. If you are using a different API, see [API for MongoDB](../mongodb/how-to-create-container.md), [API for Gremlin](../gremlin/how-to-create-container.md), [API for Table](../table/how-to-create-container.md), and [API for NoSQL](../how-to-create-container.md) articles to create the container.
+This article explains the different ways to create a container in Azure Cosmos DB for Apache Cassandra. If you're using a different API, see [API for MongoDB](../mongodb/how-to-create-container.md), [API for Gremlin](../gremlin/how-to-create-container.md), [API for Table](../table/how-to-create-container.md), and [API for NoSQL](../how-to-create-container.md) articles to create the container.
 
 > [!NOTE]
-> When creating containers, make sure you don’t create two containers with the same name but different casing. That’s because some parts of the Azure platform are not case-sensitive, and this can result in confusion/collision of telemetry and actions on containers with such names.
+> When creating containers, make sure you don’t create two containers with the same name but different casing. That’s because some parts of the Azure platform aren't case-sensitive, and this can result in confusion/collision of telemetry and actions on containers with such names.
 
 ## <a id="portal-cassandra"></a>Create using Azure portal
 
@@ -29,7 +29,7 @@ This article explains the different ways to create a container in Azure Cosmos D
 
 1. Open the **Data Explorer** pane, and select **New Table**. Next, provide the following details:
 
-   * Indicate whether you are creating a new keyspace, or using an existing one.
+   * Indicate whether you're creating a new keyspace, or using an existing one.
    * Enter a table name.
    * Enter the properties and specify a primary key.
    * Enter a throughput to be provisioned (for example, 1000 RUs).
@@ -52,14 +52,6 @@ session.Execute(CREATE TABLE myKeySpace.myTable(
 
 If you encounter timeout exception when creating a collection, do a read operation to validate if the collection was created successfully. The read operation throws an exception until the collection create operation is successful. For the list of status codes supported by the create operation see the [HTTP Status Codes for Azure Cosmos DB](/rest/api/cosmos-db/http-status-codes-for-cosmosdb) article.
 
-## <a id="cli-mongodb"></a>Create using Azure CLI
-
-[Create a Cassandra table with Azure CLI](../scripts/cli/cassandra/create.md). For a listing of all Azure CLI samples across all Azure Cosmos DB APIs see, [Azure CLI samples for Azure Cosmos DB](cli-samples.md).
-
-## Create using PowerShell
-
-[Create a Cassandra table with PowerShell](../scripts/powershell/cassandra/create.md). For a listing of all PowerShell samples across all Azure Cosmos DB APIs see, [PowerShell Samples](powershell-samples.md)
-
 ## Next steps
 
 * [Partitioning in Azure Cosmos DB](../partitioning-overview.md)

articles/cosmos-db/gremlin/how-to-create-container.md

@@ -1,6 +1,6 @@
 ---
 title: Create a container in Azure Cosmos DB for Gremlin
-description: Learn how to create a container in Azure Cosmos DB for Gremlin by using Azure portal, .NET and other SDKs.
+description: Learn how to create a container in Azure Cosmos DB for Gremlin by using Azure portal, .NET, and other SDKs.
 ms.service: azure-cosmos-db
 ms.subservice: apache-gremlin
 ms.topic: how-to
@@ -14,12 +14,12 @@ ms.custom: devx-track-csharp, devx-track-azurecli, devx-track-dotnet
 # Create a container in Azure Cosmos DB for Gremlin
 [!INCLUDE[Gremlin](../includes/appliesto-gremlin.md)]
 
-This article explains the different ways to create a container in Azure Cosmos DB for Gremlin. It shows how to create a container using Azure portal, Azure CLI, PowerShell, or supported SDKs. This article demonstrates how to create a container, specify the partition key, and provision throughput.
+This article explains the different ways to create a container in Azure Cosmos DB for Gremlin. It shows how to create a container using Azure portal, Azure CLI, PowerShell, or supported software development kits (SDKs). This article demonstrates how to create a container, specify the partition key, and provision throughput.
 
-This article explains the different ways to create a container in Azure Cosmos DB for Gremlin. If you are using a different API, see [API for MongoDB](../mongodb/how-to-create-container.md), [API for Cassandra](../cassandra/how-to-create-container.md), [API for Table](../table/how-to-create-container.md), and [API for NoSQL](../how-to-create-container.md) articles to create the container.
+This article explains the different ways to create a container in Azure Cosmos DB for Gremlin. If you're using a different API, see [API for MongoDB](../mongodb/how-to-create-container.md), [API for Cassandra](../cassandra/how-to-create-container.md), [API for Table](../table/how-to-create-container.md), and [API for NoSQL](../how-to-create-container.md) articles to create the container.
 
 > [!NOTE]
-> When creating containers, make sure you don’t create two containers with the same name but different casing. That’s because some parts of the Azure platform are not case-sensitive, and this can result in confusion/collision of telemetry and actions on containers with such names.
+> When creating containers, make sure you don’t create two containers with the same name but different casing. That’s because some parts of the Azure platform aren't case-sensitive, and this can result in confusion/collision of telemetry and actions on containers with such names.
 
 ## <a id="portal-gremlin"></a>Create using Azure portal
 
@@ -29,7 +29,7 @@ This article explains the different ways to create a container in Azure Cosmos D
 
 1. Open the **Data Explorer** pane, and select **New Graph**. Next, provide the following details:
 
-   * Indicate whether you are creating a new database, or using an existing one.
+   * Indicate whether you're creating a new database, or using an existing one.
    * Enter a Graph ID.
    * Select **Unlimited** storage capacity.
    * Enter a partition key for vertices.
@@ -54,14 +54,6 @@ await client.CreateDocumentCollectionAsync(
     new RequestOptions { OfferThroughput = 1000 });
 ```
 
-## <a id="cli-mongodb"></a>Create using Azure CLI
-
-[Create a Gremlin graph with Azure CLI](../scripts/cli/gremlin/create.md). For a listing of all Azure CLI samples across all Azure Cosmos DB APIs see, [Azure CLI samples for Azure Cosmos DB](cli-samples.md).
-
-## Create using PowerShell
-
-[Create a Gremlin graph with PowerShell](../scripts/powershell/gremlin/create.md). For a listing of all PowerShell samples across all Azure Cosmos DB APIs see, [PowerShell Samples](powershell-samples.md)
-
 ## Next steps
 
 * [Partitioning in Azure Cosmos DB](../partitioning-overview.md)

articles/cosmos-db/mongodb/how-to-create-container.md

@@ -14,15 +14,15 @@ ms.custom: devx-track-csharp, devx-track-azurecli, devx-track-arm-template, devx
 # Create a collection in Azure Cosmos DB for MongoDB
 [!INCLUDE[MongoDB](~/reusable-content/ce-skilling/azure/includes/cosmos-db/includes/appliesto-mongodb.md)]
 
-This article explains the different ways to create a collection in Azure Cosmos DB for MongoDB. It shows how to create a collection using Azure portal, Azure CLI, PowerShell, or supported SDKs. This article demonstrates how to create a collection, specify the partition key, and provision throughput.
+This article explains the different ways to create a collection in Azure Cosmos DB for MongoDB. It shows how to create a collection using Azure portal, Azure CLI, PowerShell, or supported software development kits (SDKs). This article demonstrates how to create a collection, specify the partition key, and provision throughput.
 
 >[!NOTE]
 > **Containers** and **collections** are similar to a table in a relational database. We refer to **containers** in the Azure Cosmos DB for NoSQL and throughout the Azure portal, while we use **collections** in the context of the Azure Cosmos DB for MongoDB to match the terminology used in MongoDB.
 
-This article explains the different ways to create a collection in Azure Cosmos DB for MongoDB. If you are using a different API, see [API for NoSQL](../how-to-create-container.md), [API for Cassandra](../cassandra/how-to-create-container.md), [API for Gremlin](../gremlin/how-to-create-container.md), and [API for Table](../table/how-to-create-container.md) articles to create the collection.
+This article explains the different ways to create a collection in Azure Cosmos DB for MongoDB. If you're using a different API, see [API for NoSQL](../how-to-create-container.md), [API for Cassandra](../cassandra/how-to-create-container.md), [API for Gremlin](../gremlin/how-to-create-container.md), and [API for Table](../table/how-to-create-container.md) articles to create the collection.
 
 > [!NOTE]
-> When creating collections, make sure you don’t create two collections with the same name but different casing. That’s because some parts of the Azure platform are not case-sensitive, and this can result in confusion/collision of telemetry and actions on collections with such names.
+> When creating collections, make sure you don’t create two collections with the same name but different casing. That’s because some parts of the Azure platform aren't case-sensitive, and this can result in confusion/collision of telemetry and actions on collections with such names.
 
 ## <a id="portal-mongodb"></a>Create using Azure portal
 
@@ -32,7 +32,7 @@ This article explains the different ways to create a collection in Azure Cosmos
 
 1. Open the **Data Explorer** pane, and select **New Container**. Next, provide the following details:
 
-   * Indicate whether you are creating a new database or using an existing one.
+   * Indicate whether you're creating a new database or using an existing one.
    * Enter a container ID.
    * Enter a shard key.
    * Enter a throughput to be provisioned (for example, 1000 RUs).
@@ -57,14 +57,6 @@ db.RunCommand(shellCommand);
 
 If you encounter timeout exception when creating a collection, do a read operation to validate if the collection was created successfully. The read operation throws an exception until the collection create operation is successful. For the list of status codes supported by the create operation see the [HTTP Status Codes for Azure Cosmos DB](/rest/api/cosmos-db/http-status-codes-for-cosmosdb) article.
 
-## <a id="cli-mongodb"></a>Create using Azure CLI
-
-[Create a collection for Azure Cosmos DB for API for MongoDB with Azure CLI](../scripts/cli/mongodb/create.md). For a listing of all Azure CLI samples across all Azure Cosmos DB APIs see, [Azure CLI samples for Azure Cosmos DB](cli-samples.md).
-
-## Create using PowerShell
-
-[Create a collection for Azure Cosmos DB for API for MongoDB with PowerShell](../scripts/powershell/mongodb/create.md). For a listing of all PowerShell samples across all Azure Cosmos DB APIs see, [PowerShell Samples](powershell-samples.md)
-
 ## Create a collection using Azure Resource Manager templates
 
 [Create a collection for Azure Cosmos DB for API for MongoDB with Resource Manager template](../manage-with-templates.md#azure-cosmos-account-with-standard-provisioned-throughput).
@@ -76,5 +68,5 @@ If you encounter timeout exception when creating a collection, do a read operati
 * [Provision throughput on containers and databases](../set-throughput.md)
 * [Work with Azure Cosmos DB account](../resource-model.md)
 * Trying to do capacity planning for a migration to Azure Cosmos DB? You can use information about your existing database cluster for capacity planning.
-    * If all you know is the number of vcores and servers in your existing database cluster, read about [estimating request units using vCores or vCPUs](../convert-vcore-to-request-unit.md) 
+    * If all you know is the number of vCores and servers in your existing database cluster, read about [estimating request units using vCores or vCPUs](../convert-vcore-to-request-unit.md) 
     * If you know typical request rates for your current database workload, read about [estimating request units using Azure Cosmos DB capacity planner](estimate-ru-capacity-planner.md)

articles/cosmos-db/nosql/TOC.yml

@@ -1070,12 +1070,12 @@
           href: samples-python.md
         - name: Go
           href: samples-go.md
-        - name: PowerShell
-          href: powershell-samples.md
+        - name: Azure CLI
+          href: samples-cli.yml
+        - name: Azure PowerShell
+          href: samples-powershell.yml
         - name: Azure CLI
           items:
-            - name: Overview
-              href: cli-samples.md
             - name: Create account, database, and container
               href: ../scripts/cli/nosql/create.md?context=/azure/cosmos-db/nosql/context/context
             - name: Create serverless
@@ -1104,8 +1104,6 @@
               href: ../scripts/cli/common/convert-to-autoscale.md?context=/azure/cosmos-db/nosql/context/context
         - name: Azure PowerShell
           items:
-            - name: Overview
-              href: powershell-samples.md
             - name: Create account, database, and container
               href: ../scripts/powershell/nosql/create.md?context=/azure/cosmos-db/nosql/context/context
             - name: Create with autoscale