edits

Author: v-geberr

articles/cosmos-db/nosql/how-to-javascript-create-container.md

@@ -55,6 +55,41 @@ const { statusCode, container} = await database.containers.create({ id: containe
 
 The statusCode is an HTTP response code. A successful response is in the 200-299 range.
 
+## Access a container
+
+A container is accessed from the [Container](/javascript/api/@azure/cosmos/container) object either directly or chained from the [CosmosClient](/javascript/api/@azure/cosmos/cosmosclient) or [Database](/javascript/api/@azure/cosmos/database) objects.
+
+```javascript
+const databaseName = 'myDb';
+const containerName = 'myContainer';
+
+// Chained - assumes database and container already exis
+const { container, statusCode } = await client.database(databaseName).container(containerName);
+
+// Direct - assumes database and container already exist
+const { database, statusCode } = await database(databaseName);
+if(statusCode < 400){
+    const { container, statusCode } = await database.container(containerName);
+}
+
+// Query - assumes database and container already exist
+const { resources } = await client.database(databaseName).containers
+.query({
+    query: `SELECT * FROM root r where r.id =@containerId`,
+    parameters: [
+    {
+        name: '@containerId',
+        value: containerName
+    }
+    ]
+})
+.fetchAll();
+```
+
+> [!TIP]
+> [Containers](/javascript/api/@azure/cosmos/containerss) (plural): create or query containers
+> [Container](/javascript/api/@azure/cosmos/container) (singular): delete container, work with items
+
 ## Delete a container
 
 Once you get the [Container](/javascript/api/@azure/cosmos/container) object, you can use the Container object to [delete](/javascript/api/@azure/cosmos/container#@azure-cosmos-container-delete) the container:

articles/cosmos-db/nosql/how-to-javascript-create-database.md

@@ -55,6 +55,34 @@ const {statusCode, database } = await client.databases.create({ id: databaseName
 
 The statusCode is an HTTP response code. A successful response is in the 200-299 range.
 
+## Access a database
+
+A database is accessed from the [Database](/javascript/api/@azure/cosmos/database) object either directly or through a query result from the [CosmosClient](/javascript/api/@azure/cosmos/cosmosclient).
+
+```javascript
+const databaseName = 'myDb';
+
+// Direct - assumes database already exists
+const { database, statusCode } = await client.database(databaseName);
+
+// Query - assumes database already exists   
+const { resources } = await client.databases
+.query({
+    query: `SELECT * FROM root r where r.id =@dbId`,
+    parameters: [
+    {
+        name: '@dbId',
+        value: databaseName
+    }
+    ]
+})
+.fetchAll();
+```
+
+> [!TIP]
+> [Databases](/javascript/api/@azure/cosmos/databases) (plural): Used for creating new databases, or querying/reading all databases.
+> [Database](/javascript/api/@azure/cosmos/database) (singular): Used for reading, updating, or deleting a existing database by id or accessing containers belonging to that database.
+
 ## Delete a database
 
 Once you get the [Database](/javascript/api/@azure/cosmos/database) object, you can use the Database object to [delete](/javascript/api/@azure/cosmos/database#@azure-cosmos-database-delete) the database:

articles/cosmos-db/nosql/how-to-javascript-create-item.md

@@ -70,6 +70,19 @@ const { statusCode, item, resource, activityId, etag} = await container.items.cr
     });
 ```
 
+## Access an item
+
+Access an item through the [Item](/javascript/api/@azure/cosmos/item) object. This can accessed from the [Container](/javascript/api/@azure/cosmos/container) object or changed from either the [Database](/javascript/api/@azure/cosmos/database) or [CosmosClient](javascript/api/@azure/cosmos/cosmosclient) objects.
+
+```javascript
+// Chained, then use a method of the Item object such as `read`
+const { statusCode, item, resource, activityId, etag} = await client.database(databaseId).container(containerId).item(itemId).read();
+```
+
+> [!TIP]
+> [Items](/javascript/api/@azure/cosmos/items) (plural): Create, batch, watch change feed, read all, upsert, or query items.
+> [Item](/javascript/api/@azure/cosmos/item) (singular): Read, patch, replace, or delete an item.
+
 ## Replace an item
 
 Replace the data with the [Item](/javascript/api/@azure/cosmos/item) object with the [replace](/javascript/api/@azure/cosmos/item#@azure-cosmos-item-replace) method.