modified documentation

Srinath Narayanan · Srinath Narayanan · commit 6288effdf3e7 · 2019-09-18T15:21:13.000-07:00
diff --git a/sdk/cosmos/azure-cosmos/azure/cosmos/cosmos_client.py b/sdk/cosmos/azure-cosmos/azure/cosmos/cosmos_client.py
@@ -257,7 +257,9 @@ def create_database_if_not_exists(  # pylint: disable=redefined-builtin
         """
         Create the database if it does not exist already.
 
-        If the database already exists, it is returned.
+        If the database already exists, the existing settings are returned.
+        Note: it does not check or update the existing database settings or offer throughput
+        if they differ from what was passed into the method.
 
         :param id: ID (name) of the database to read or create.
         :param str session_token: Token for use with Session consistency.
diff --git a/sdk/cosmos/azure-cosmos/azure/cosmos/database.py b/sdk/cosmos/azure-cosmos/azure/cosmos/database.py
@@ -239,7 +239,9 @@ def create_container_if_not_exists(
         """
         Create the container if it does not exist already.
 
-        If the container already exists, it is returned.
+        If the container already exists, the existing settings are returned.
+        Note: it does not check or update the existing container settings or offer throughput
+        if they differ from what was passed into the method.
 
         :param id: ID (name) of container to read or create.
         :param partition_key: The partition key to use for the container.
