快速開(kāi)始
本文為您介紹如何安裝.NET環(huán)境并提供安裝步驟、示例代碼及API使用方法，幫助您快速上手構(gòu)建云服務(wù)，實(shí)現(xiàn)API調(diào)用和服務(wù)集成。
環(huán)境準(zhǔn)備
環(huán)境要求
最低要求.NET Framework 4.5。.NET下載地址
.NET Standard 2.0 及其以上版本。
C# 4.0 及其以上版本。
已下載代碼編輯器，本文以Visual Studio為例。Visual Studio下載地址
已創(chuàng)建AccessKey。在調(diào)用阿里云API時(shí)您需要使用AccessKey完成身份驗(yàn)證。AccessKey包括AccessKey ID和AccessKey Secret。關(guān)于如何創(chuàng)建和獲取AccessKey，請(qǐng)參見(jiàn)創(chuàng)建AccessKey。
驗(yàn)證版本
打開(kāi)終端，輸入
dotnet --version，查看 .NET 版本。
運(yùn)行示例代碼
步驟一：下載SDK完整工程
在頂部導(dǎo)航欄，單擊選擇云產(chǎn)品，在彈出面板中根據(jù)需要選擇云產(chǎn)品。
在云產(chǎn)品OpenAPI 主頁(yè)，點(diǎn)擊右上角去調(diào)試（圖1），會(huì)彈出OpenAPI 調(diào)試頁(yè)面（圖2）。
圖1
圖2
左側(cè)分欄選擇您需要使用的接口，中間分欄填入接口需要的參數(shù)，右側(cè)分欄選擇SDK示例頁(yè)簽。
選擇SDK版本為V2.0，選擇所使用的語(yǔ)言。
說(shuō)明部分產(chǎn)品可能不支持選擇SDK版本。請(qǐng)?jiān)诓襟E3的圖1中查看云產(chǎn)品支持的SDK版本。
單擊下載完整工程按鈕，下載示例代碼。
如果想要生成泛化調(diào)用代碼，請(qǐng)勾選Common模式生成示例。更多信息請(qǐng)參見(jiàn)泛化調(diào)用與特化調(diào)用。
步驟二：配置環(huán)境變量
環(huán)境變量配置完成之后，需要重啟您的所使用的開(kāi)發(fā)工具（若不重啟可能會(huì)無(wú)法正常讀取環(huán)境變量）。
Linux和macOS系統(tǒng)配置方法
創(chuàng)建
.bash_profile文件說(shuō)明如果是第一次設(shè)置環(huán)境變量，可以使用
touch ~/.bash_profile創(chuàng)建一個(gè)配置文件，如果已經(jīng)存在配置文件，則使用vim ~/.bash_profile命令直接編輯文件。touch ~/.bash_profile vim ~/.bash_profile配置
.bash_profile文件# 將以下命令中的<ACCESS_KEY_ID>和<ACCESS_KEY_SECRET>替換為您自己的AccessKey ID和AccessKey Secret。 # 變量名稱可以根據(jù)實(shí)際情況進(jìn)行替換，例如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，則說(shuō)明配置成功。
Windows系統(tǒng)配置方法
通過(guò)圖形用戶界面GUI
操作步驟
以下為Windows 10中通過(guò)圖形用戶界面設(shè)置環(huán)境變量的步驟。
在桌面右鍵單擊此電腦，選擇屬性>高級(jí)系統(tǒng)設(shè)置>環(huán)境變量>系統(tǒng)變量/用戶變量>新建，完成以下配置：
變量
示例值
AccessKey ID
變量名：ALIBABA_CLOUD_ACCESS_KEY_ID
變量值：LTAI4GDty8ab9W4Y1D****
AccessKey Secret
變量名：ALIBABA_CLOUD_ACCESS_KEY_SECRET
變量值：IrVTNZNy5yQelTETg0cZML3TQn****
測(cè)試設(shè)置是否成功
單擊開(kāi)始（或快捷鍵：Win+R）> 運(yùn)行（輸入 cmd）> 確定（或按 Enter 鍵），打開(kāi)命令提示符，執(zhí)行
echo %ALIBABA_CLOUD_ACCESS_KEY_ID%、echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%命令。若返回正確的AccessKey，則說(shuō)明配置成功。
通過(guò)命令行提示符CMD
操作步驟
以管理員身份打開(kāi)命令提示符，并使用以下命令在系統(tǒng)中新增環(huán)境變量。
setx ALIBABA_CLOUD_ACCESS_KEY_ID3 LTAI4GDty8ab9W4Y1D**** /M setx ALIBABA_CLOUD_ACCESS_KEY_SECRET IrVTNZNy5yQelTETg0cZML3TQn**** /M其中
/M表示系統(tǒng)級(jí)環(huán)境變量，設(shè)置用戶級(jí)環(huán)境變量時(shí)可以不攜帶該參數(shù)。測(cè)試設(shè)置是否成功
單擊開(kāi)始（或快捷鍵：Win+R）> 運(yùn)行（輸入 cmd）> 確定（或按 Enter 鍵），打開(kāi)命令提示符，執(zhí)行
echo %ALIBABA_CLOUD_ACCESS_KEY_ID%、echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%命令。若返回正確的AccessKey，則說(shuō)明配置成功。
通過(guò)Windows PowerShell
在PowerShell中，設(shè)置新的環(huán)境變量（對(duì)所有新會(huì)話都有效）：
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::User) [System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::User)為所有用戶設(shè)置環(huán)境變量（需要管理員權(quán)限）：
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::Machine) [System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::Machine)設(shè)置臨時(shí)的環(huán)境變量（僅當(dāng)前會(huì)話有效）：
$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "LTAI4GDty8ab9W4Y1D****" $env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "IrVTNZNy5yQelTETg0cZML3TQn****"在PowerShell中，執(zhí)行
Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID、Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET命令。若返回正確的AccessKey，則說(shuō)明配置成功。
步驟三：運(yùn)行代碼
在Visual Studio中運(yùn)行代碼。查看控制臺(tái)日志body中返回的相關(guān)信息和
requestId。如果調(diào)用的是創(chuàng)建實(shí)例的接口，還會(huì)返回實(shí)例ID，您可以根據(jù)返回的實(shí)例ID去該產(chǎn)品的控制臺(tái)驗(yàn)證。