快速上手阿里雲.NET SDK安裝和使用 - Alibaba Cloud SDK

本文為您介紹如何安裝.NET環境並提供安裝步驟、範例程式碼及API使用方法，協助您快速上手構建雲端服務，實現API調用和服務整合。

環境準備

環境要求

最低要求.NET Framework 4.5。.NET下載地址
.NET Standard 2.0 及其以上版本。
C# 4.0 及其以上版本。
已下載代碼編輯器，本文以Visual Studio為例。Visual Studio下載地址
已建立AccessKey。在調用阿里雲API時您需要使用AccessKey完成身分識別驗證。AccessKey包括AccessKey ID和AccessKey Secret。關於如何建立和擷取AccessKey，請參見建立AccessKey。
驗證版本
開啟終端，輸入dotnet --version，查看 .NET 版本。

運行範例程式碼

步驟一：下載SDK完整工程

登入OpenAPI 門戶。
在頂部導覽列，單擊選擇雲產品，在彈出面板中根據需要選擇雲產品。
在雲產品OpenAPI 首頁，點擊右上方去調試（圖1），會彈出OpenAPI 調試頁面（圖2）。
圖1
圖2
左側分欄選擇您需要使用的介面，中間分欄填入介面需要的參數，右側分欄選擇SDK樣本頁簽。
選擇SDK版本為V2.0，選擇所使用的語言。
說明
部分產品可能不支援選擇SDK版本。請在步驟3的圖1中查看雲產品支援的SDK版本。
單擊下載完整工程按鈕，下載範例程式碼。
如果想要產生泛化調用代碼，請勾選Common模式產生樣本。更多資訊請參見泛化調用與特化調用。

步驟二：配置環境變數

配置環境變數ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。

重要

環境變數配置完成之後，需要重啟您的所使用的開發工具（若不重啟可能會無法正常讀取環境變數）。

Linux和macOS系統配置方法

建立.bash_profile檔案
說明
如果是第一次設定環境變數，可以使用touch ~/.bash_profile建立一個設定檔，如果已經存在設定檔，則使用vim ~/.bash_profile命令直接編輯檔案。
```
touch ~/.bash_profile
vim ~/.bash_profile
```

配置.bash_profile檔案

# 將以下命令中的<ACCESS_KEY_ID>和<ACCESS_KEY_SECRET>替換為您自己的AccessKey ID和AccessKey Secret。
# 變數名稱可以根據實際情況進行替換，例如OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET。
export ALIBABA_CLOUD_ACCESS_KEY_ID=<ACCESS_KEY_ID>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<ACCESS_KEY_SECRET>

編輯完成後儲存退出。

使用.bash_profile檔案

# 使設定檔生效
source ~/.bash_profile
# 顯示配置是否生效
echo $ALIBABA_CLOUD_ACCESS_KEY_ID

若返回正確的AccessKey ID，則說明配置成功。

Windows系統配置方法

通過圖形化使用者介面GUI

操作步驟

以下為Windows 10中通過圖形化使用者介面設定環境變數的步驟。

在案頭按右鍵此電腦，選擇屬性>進階系統設定>環境變數>系統變數/使用者變數>建立，完成以下配置：

變數	樣本值
AccessKey ID	變數名：ALIBABA_CLOUD_ACCESS_KEY_ID 變數值：LTAI4GDty8ab9W4Y1D****
AccessKey Secret	變數名：ALIBABA_CLOUD_ACCESS_KEY_SECRET 變數值：IrVTNZNy5yQelTETg0cZML3TQn****

測試設定是否成功
單擊開始（或快速鍵：Win+R）> 運行（輸入 cmd）> 確定（或按 Enter 鍵），開啟命令提示字元，執行echo %ALIBABA_CLOUD_ACCESS_KEY_ID%、echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%命令。若返回正確的AccessKey，則說明配置成功。

通過命令列提示符CMD

操作步驟
以管理員身份開啟命令提示字元，並使用以下命令在系統中新增環境變數。
```
setx ALIBABA_CLOUD_ACCESS_KEY_ID LTAI4GDty8ab9W4Y1D**** /M
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET IrVTNZNy5yQelTETg0cZML3TQn**** /M
```
其中/M表示系統級環境變數，設定使用者級環境變數時可以不攜帶該參數。
測試設定是否成功
單擊開始（或快速鍵：Win+R）> 運行（輸入 cmd）> 確定（或按 Enter 鍵），開啟命令提示字元，執行echo %ALIBABA_CLOUD_ACCESS_KEY_ID%、echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%命令。若返回正確的AccessKey，則說明配置成功。

通過Windows PowerShell

在PowerShell中，設定新的環境變數（對所有新會話都有效）：

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::User)

為所有使用者佈建環境變數（需要管理員權限）：

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::Machine)

設定臨時的環境變數（僅當前會話有效）：

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "LTAI4GDty8ab9W4Y1D****"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "IrVTNZNy5yQelTETg0cZML3TQn****"

在PowerShell中，執行Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID、Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET命令。若返回正確的AccessKey，則說明配置成功。

步驟三：運行代碼

在Visual Studio中運行代碼。查看控制台日誌body中返回的相關資訊和requestId。
如果調用的是建立執行個體的介面，還會返回執行個體ID，您可以根據返回的執行個體ID去該產品的控制台驗證。