本文為您介紹使用OpenAPI創建定向分組的完整示例。
查看OpenAPI文檔
閱讀API概覽，選擇創建定向分組的OpenAPI：AddDirectionalGroup 。請您根據文檔，了解調用該接口需要準備的數據和權限。
用戶身份管理
身份
您可以使用阿里云賬號（主賬號）、RAM用戶、RAM角色調用該接口，有關各種身份的差異，請參見概述。本案例中，使用RAM用戶進行接口調用。
登錄RAM訪問控制，創建一個僅允許API調用的RAM用戶，并記錄AccessKey信息。具體操作，請參見創建RAM用戶。
授權
訪問RAM用戶列表，單擊目標RAM用戶操作列的添加權限。
在選擇權限區塊中輸入關鍵字
linkcard進行搜索，選擇AliyunLinkCardFullAccess策略。說明AliyunLinkCardFullAccess：管理物聯網卡（LC）的權限。
AliyunLinkCardReadOnlyAccess：只讀管理物聯網卡（LC）的權限。
如何創建自定義權限，請參見授權信息。
單擊確定，完成授權操作。
憑證
在創建RAM用戶時會默認生成一個AccessKey，可直接使用。您也可以進入到對應的RAM用戶詳情頁面，在認證管理頁簽，單擊創建AccessKey，創建一個新的AccessKey。具體操作，請參見創建AccessKey。
調用OpenAPI
本文以Python語言為例，為您介紹OpenAPI的調用方法。
準備Python環境
下載并安裝Python。
Python 3的下載地址，請參見Python 3。
查看Python版本。
Linux和macOS系統
打開終端，輸入命令
python --version。Windows系統
在Python的安裝路徑下，雙擊python.exe。
打開命令提示符頁面。
通過鍵盤快捷鍵Win+R打開運行對話框，在輸入框中輸入命令python，單擊確定。
配置環境變量
為避免將AccessKey硬編碼到業務代碼中帶來的安全風險，本示例采用配置環境變量的方法管理AccessKey。
Linux和macOS系統
將以下命令中的
<access_key_id>和<access_key_secret>替換為您自己的AccessKey ID和AccessKey Secret，輸入到終端執行。
export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>Windows系統
新建環境變量文件，添加環境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET，并寫入已準備好的AccessKey ID和AccessKey Secret。然后重啟Windows系統。
安裝依賴
pip install alibabacloud_credentials
pip install alibabacloud_linkcard20210520==1.0.10
pip install alibabacloud_tea_console下載示例代碼
在OpenAPI門戶，訪問AddDirectionalGroup接口的調試地址。
輸入定向分組名稱，然后單擊發起調用。
調用成功后，單擊SDK示例頁簽，選擇Python語言，然后單擊下載完整工程，下載Python語言的SDK示例。
在本地解壓Python示例代碼包，并進入
alibabacloud_sample目錄。
運行代碼
執行以下命令。
python sample.py得到如下輸出結果：
{
"headers": {
"date": "Thu, 10 Aug 2023 09:32:36 GMT",
"content-type": "application/json;charset=utf-8",
"content-length": "108",
"connection": "keep-alive",
"keep-alive": "timeout=25",
"access-control-allow-origin": "*",
"access-control-expose-headers": "*",
"x-acs-request-id": "C378813C-FE74-5649-A36D-DE8F0******",
"x-acs-trace-id": "e8251c94f4931e03480ebd170******",
"etag": "1AoDYJ5m6Ox/nFKr4sa+M5g8"
},
"statusCode": 200,
"body": {
"Data": 10000004493,
"LocalizedMessage": "",
"RequestId": "C378813C-FE74-5649-A36D-DE8F08******",
"Success": true
}
}