本文為您介紹CPFS通用版支援的整合方案。
OpenAPI介紹
為了能夠讓開發人員快速高效的學習和使用雲產品OpenAPI，阿里雲為使用者提供OpenAPI網站。它是一款集OpenAPI智能搜尋、文檔、線上調試、SDK擷取、CodeSample、調用出錯診斷、調用統計為一體的產品。您可以在OpenAPI門戶中調用阿里雲各雲產品開放的OpenAPI，查看OpenAPI請求和返回結果。此外，OpenAPI門戶會自動產生相應的SDK調用樣本，協助您快速使用阿里雲產品。更多資訊，請參見什麼是OpenAPI。
版本說明
阿里雲OpenAPI通過版本號碼管控各時期雲產品大版本的API列表，例如檔案儲存體CPFS目前支援2017-06-26版本的API列表，2017-06-26代表的是API版本號碼而非時間概念，所展示的都是最新的API公開資料，並非自2017-06-26之後就未更新。
因檔案儲存體CPFS與Apsara File Storage NAS共用一套SDK，所以使用Apsara File Storage NAS的服務地址和SDK。
版本說明 | 說明 |
推薦使用 |
線上調試
檔案儲存體CPFS在OpenAPI門戶提供API調試等功能。在調用前，您需要瞭解檔案儲存體CPFS提供的版本、存取點說明、整合方式等資訊。
調試入口
調試API入口為：檔案儲存體CPFS
存取點說明
根據相關資源所在地區，選擇對應的服務存取點地址，以獲得最低延遲。例如華北6（烏蘭察布）的檔案儲存體CPFS公網接入地址為nas.cn-wulanchabu.aliyuncs.com，VPC接入地址為nas-vpc.cn-wulanchabu.aliyuncs.com。
公網接入地址在全球都可訪問。
VPC接入地址只有在阿里雲對應的地區內，且是VPC網路類型才可訪問。VPC地址的優勢：
高安全性：VPC服務地址只能在VPC內部訪問，提供更高的安全性和隱私性。
更快的響應速度：由於VPC服務地址在VPC內部網路中運行，其響應速度通常比公網服務更快，且可以避免公網延遲和頻寬節流設定等問題。
更低的成本：VPC服務地址可以使用內部網路通訊。
CPFS通用版支援的存取點地區與地址如下表所示。
地區名稱 | 地區ID | 公網接入地址 | VPC接入地址 |
華北1（青島） | cn-qingdao | nas.cn-qingdao.aliyuncs.com | nas-vpc.cn-qingdao.aliyuncs.com |
華北2（北京） | cn-beijing | nas.cn-beijing.aliyuncs.com | nas-vpc.cn-beijing.aliyuncs.com |
華北3（張家口） | cn-zhangjiakou | nas.cn-zhangjiakou.aliyuncs.com | nas-vpc.cn-zhangjiakou.aliyuncs.com |
華北5（呼和浩特） | cn-huhehaote | nas.cn-huhehaote.aliyuncs.com | nas-vpc.cn-huhehaote.aliyuncs.com |
華北6（烏蘭察布） | cn-wulanchabu | nas.cn-wulanchabu.aliyuncs.com | nas-vpc.cn-wulanchabu.aliyuncs.com |
華東1（杭州） | cn-hangzhou | nas.cn-hangzhou.aliyuncs.com | nas-vpc.cn-hangzhou.aliyuncs.com |
華東2（上海） | cn-shanghai | nas.cn-shanghai.aliyuncs.com | nas-vpc.cn-shanghai.aliyuncs.com |
華南1（深圳） | cn-shenzhen | nas.cn-shenzhen.aliyuncs.com | nas-vpc.cn-shenzhen.aliyuncs.com |
華南2（河源） | cn-heyuan | nas.cn-heyuan.aliyuncs.com | nas-vpc.cn-heyuan.aliyuncs.com |
西南1（成都） | cn-chengdu | nas.cn-chengdu.aliyuncs.com | nas-vpc.cn-chengdu.aliyuncs.com |
新加坡 | ap-southeast-1 | nas.ap-southeast-1.aliyuncs.com | nas-vpc.ap-southeast-1.aliyuncs.com |
支援的使用者身份
使用者身份 | 支援情況 |
支援 | |
RAM 使用者（推薦） | 支援 |
RAM角色（推薦） | 支援 |
推薦您使用RAM使用者或RAM角色，根據業務的實際情況按需分配許可權後進行介面調用。
更多資訊
整合方式
SDK是最易於整合，且支援度最好的OpenAPI調用方式，推薦您選擇使用SDK。
檔案儲存體CPFS提供SDK、CLI、Terraform、ROS等多種整合方式，您可以根據業務的實際需要進行選擇。
阿里雲SDK
阿里雲為開發人員提供了多種程式設計語言（Java、C#、Go、Python、Node.js/TypeScript、PHP、C++ 等）的SDK。開發人員只需要整合SDK，通過SDK暴露的方法直接調用OpenAPI 。SDK統一封裝了簽名邏輯、逾時機制、重試機制，並根據文檔返回結構化Response對象，易於開發。更多關於阿里雲SDK的介紹，請參見阿里雲SDK。
支援在OpenAPI通過阿里雲SDK調用檔案儲存體CPFS。支援的語言及依賴安裝方法，請參見Apsara File Storage NAS SDK。
阿里雲CLI
阿里雲命令列工具可以幫您在使用命令列終端時，使用aliyun命令與阿里雲服務進行互動，管理雲端服務資源。有關阿里雲CLI的更多詳細資料，請參見什麼是阿里雲CLI。
自訂封裝API（不推薦）
原生HTTP調用需要您自己實現簽名演算法，並構建自訂請求，發起HTTP調用。有關簽名機制的更多詳細資料，請參見API參考指南和V3版本請求體&簽名機制。
注意事項
如果調用API後返回錯誤，您需要根據返回的錯誤碼提示檢查傳入的請求參數及其取值是否正確，更多資訊請參見錯誤碼中心。
您也可以記錄下調用返回的RequestID或SDK報錯資訊，通過阿里雲OpenAPI診斷平台進行自助診斷。