Merge pull request #47 from Azure-Samples/kaihuis-cognitiveservices-samples

add cognitiveservices samples

Author: 00Kai0

samples/cognitiveservices/README.md

@@ -0,0 +1,85 @@
+---
+page_type: sample
+languages:
+- python
+products:
+- azure
+description: "These code samples will show you how to manage Cognitive Services using Azure SDK for Python."
+urlFragment: cognitiveservices
+---
+
+# Getting started - Managing Cognitive Services using Azure Python SDK
+
+These code samples will show you how to manage Cognitive Services using Azure SDK for Python.
+
+## Features
+
+This project framework provides examples for the following services:
+
+### Storage
+* Using the Azure SDK for Python - Cognitive Services Manamgement Library [azure-mgmt-cognitiveservices](https://pypi.org/project/azure-mgmt-cognitiveservices/) for the [Cognitive Services API](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/)
+
+## Getting Started
+
+### Prerequisites
+
+1. Before we run the samples, we need to make sure we have setup the credentials. Follow the instructions in [register a new application using Azure portal](https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal) to obtain `subscription id`,`client id`,`client secret`, and `application id`
+
+2. Store your credentials an environment variables.
+For example, in Linux-based OS, you can do
+```bash
+export AZURE_TENANT_ID="xxx"
+export AZURE_CLIENT_ID="xxx"
+export AZURE_CLIENT_SECRET="xxx"
+export SUBSCRIPTION_ID="xxx"
+```
+
+### Installation
+
+1.  If you don't already have it, [install Python](https://www.python.org/downloads/).
+
+    This sample (and the SDK) is compatible with Python 2.7, 3.3, 3.4, 3.5 and 3.6.
+
+2.  General recommendation for Python development is to use a Virtual Environment.
+    For more information, see https://docs.python.org/3/tutorial/venv.html
+
+    Install and initialize the virtual environment with the "venv" module on Python 3 (you must install [virtualenv](https://pypi.python.org/pypi/virtualenv) for Python 2.7):
+
+    ```
+    python -m venv mytestenv # Might be "python3" or "py -3.6" depending on your Python installation
+    cd mytestenv
+    source bin/activate      # Linux shell (Bash, ZSH, etc.) only
+    ./scripts/activate       # PowerShell only
+    ./scripts/activate.bat   # Windows CMD only
+    ```
+
+### Quickstart
+
+1.  Clone the repository.
+
+    ```
+    git clone https://github.com/Azure-Samples/azure-samples-python-management.git
+    ```
+
+2.  Install the dependencies using pip.
+
+    ```
+    cd azure-samples-python-management/samples/cognitiveservices
+    pip install -r requirements.txt
+    ```
+
+## Demo
+
+A demo app is included to show how to use the project.
+
+To run the complete demo, execute `python example.py`
+
+To run each individual demo, point directly to the file. For example (i.e. not complete list):
+
+1. `python manage_account.py`
+
+Each file is a separate code sample that no dependency on other files. You can look at whichever code sample you're interested in
+
+## Resources
+
+- https://github.com/Azure/azure-sdk-for-python

samples/cognitiveservices/manage_account.py

@@ -0,0 +1,92 @@
+# --------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# --------------------------------------------------------------------------
+
+import os
+
+from azure.identity import DefaultAzureCredential
+from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
+from azure.mgmt.resource import ResourceManagementClient
+
+
+def main():
+
+    SUBSCRIPTION_ID = os.environ.get("SUBSCRIPTION_ID", None)
+    GROUP_NAME = "testgroupx"
+    ACCOUNT = "accountxxyyzz"
+
+    # Create client
+    # # For other authentication approaches, please see: https://pypi.org/project/azure-identity/
+    resource_client = ResourceManagementClient(
+        credential=DefaultAzureCredential(),
+        subscription_id=SUBSCRIPTION_ID
+    )
+    cognitiveservices_client = CognitiveServicesManagementClient(
+        credential=DefaultAzureCredential(),
+        subscription_id=SUBSCRIPTION_ID
+    )
+
+    # Create resource group
+    resource_client.resource_groups.create_or_update(
+        GROUP_NAME,
+        {"location": "eastus"}
+    )
+
+    # Create account
+    account = cognitiveservices_client.accounts.create(
+        GROUP_NAME,
+        ACCOUNT,
+        {
+          "location": "West US",
+          "kind": "CognitiveServices",
+          "sku": {
+            "name": "S0"
+          },
+          "identity": {
+            "type": "SystemAssigned"
+          }
+        }
+    )
+    print("Create account:\n{}".format(account))
+
+    # Get account
+    account = cognitiveservices_client.accounts.get_properties(
+        GROUP_NAME,
+        ACCOUNT
+    )
+    print("Get account:\n{}".format(account))
+
+    # Update account
+    account = cognitiveservices_client.accounts.update(
+        GROUP_NAME,
+        ACCOUNT,
+        {
+          "location": "West US",
+          "kind": "CognitiveServices",
+          "sku": {
+            "name": "S0"
+          },
+          "identity": {
+            "type": "SystemAssigned"
+          }
+        }
+    )
+    print("Update account:\n{}".format(account))
+    
+    # Delete account
+    account = cognitiveservices_client.accounts.delete(
+        GROUP_NAME,
+        ACCOUNT
+    )
+    print("Delete account.\n")
+
+    # Delete Group
+    resource_client.resource_groups.begin_delete(
+        GROUP_NAME
+    ).result()
+
+
+if __name__ == "__main__":
+    main()

samples/cognitiveservices/requirements.txt

@@ -0,0 +1,3 @@
+azure-identity
+azure-mgmt-cognitiveserivces==11.0.0b1
+azure-mgmt-resource==15.0.0