このトピックでは、CPFS 汎用型でサポートされている統合ソリューションについて説明します。
OpenAPI の概要
Alibaba Cloud は、さまざまな Alibaba Cloud サービスの API 操作を効率的に理解して使用するための OpenAPI Explorer を提供します。OpenAPI Explorer は、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK のダウンロード、サンプルコード、呼び出しエラー診断、呼び出し統計など、API 操作に関連する複数の機能を統合しています。OpenAPI Explorer では、Alibaba Cloud サービスの API 操作を呼び出し、リクエストと応答を表示できます。OpenAPI Explorer は、対応する SDK サンプルコードも自動的に生成し、Alibaba Cloud サービスの利用を容易にします。詳細については、「API とは」をご参照ください。
バージョン
Alibaba Cloud OpenAPI Explorer は、Alibaba Cloud サービス API のバージョンをバージョン番号で管理します。たとえば、CPFS はバージョン 2017-06-26 の API をサポートしています。2017-06-26 は日付ではなく API のバージョン番号です。2017-06-26 は API の最新バージョンであり、API に関する最新の公開情報を提供します。
CPFS と Apsara File Storage NAS (NAS) は同じ SDK を共有しているため、CPFS には NAS のエンドポイントと SDK が使用されます。
バージョン番号 | 説明 |
推奨 |
オンラインデバッグ
CPFS は、OpenAPI Explorer で API デバッグなどの機能を提供します。API 操作を呼び出す前に、CPFS が提供する次の情報に注意してください: バージョン、エンドポイント、および統合方法。
デバッグページ
デバッグページの URL は File Storage NAS です。
エンドポイントの説明
レイテンシを最小限に抑えるには、リソースが配置されているリージョンに対応するエンドポイントを選択します。たとえば、中国 (ウランチャブ) リージョンの CPFS のインターネットエンドポイントは nas.cn-wulanchabu.aliyuncs.com で、VPC エンドポイントは nas-vpc.cn-wulanchabu.aliyuncs.com です。
インターネットエンドポイントはグローバルにアクセス可能です。
VPC エンドポイントは、対応する Alibaba Cloud リージョン内の VPC からのみアクセス可能です。VPC エンドポイントの利点:
高いセキュリティ: VPC エンドポイントは VPC 内からのみアクセスできるため、セキュリティとプライバシーが強化されます。
高速な応答: VPC エンドポイントは内部 VPC ネットワーク内で動作するため、通常、インターネットエンドポイントよりも高速な応答時間を提供し、インターネットのレイテンシや帯域幅制限などの問題を回避するのに役立ちます。
低コスト: VPC エンドポイントは内部ネットワーク通信を使用します。
次の表に、CPFS 汎用型でサポートされているリージョンとエンドポイントを示します。
リージョン名 | リージョン ID | パブリックエンドポイント | VPC エンドポイント |
中国 (青島) | cn-qingdao | nas.cn-qingdao.aliyuncs.com | nas-vpc.cn-qingdao.aliyuncs.com |
中国 (北京) | cn-beijing | nas.cn-beijing.aliyuncs.com | nas-vpc.cn-beijing.aliyuncs.com |
中国 (張家口) | cn-zhangjiakou | nas.cn-zhangjiakou.aliyuncs.com | nas-vpc.cn-zhangjiakou.aliyuncs.com |
中国 (フフホト) | cn-huhehaote | nas.cn-huhehaote.aliyuncs.com | nas-vpc.cn-huhehaote.aliyuncs.com |
中国 (ウランチャブ) | cn-wulanchabu | nas.cn-wulanchabu.aliyuncs.com | nas-vpc.cn-wulanchabu.aliyuncs.com |
中国 (杭州) | cn-hangzhou | nas.cn-hangzhou.aliyuncs.com | nas-vpc.cn-hangzhou.aliyuncs.com |
中国 (上海) | cn-shanghai | nas.cn-shanghai.aliyuncs.com | nas-vpc.cn-shanghai.aliyuncs.com |
中国 (深圳) | cn-shenzhen | nas.cn-shenzhen.aliyuncs.com | nas-vpc.cn-shenzhen.aliyuncs.com |
中国 (河源) | cn-heyuan | nas.cn-heyuan.aliyuncs.com | nas-vpc.cn-heyuan.aliyuncs.com |
中国 (成都) | 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 |
ユーザー ID
ユーザー ID | 説明 |
サポートされています | |
RAM ユーザー (推奨) | サポートされています |
RAM ロール (推奨) | サポートされています |
Resource Access Management (RAM) ユーザーまたは RAM ロールとして API 操作を呼び出すことをお勧めします。RAM ユーザーまたは RAM ロールとして API 操作を呼び出す前に、ビジネス要件に基づいて RAM ユーザーまたは RAM ロールに必要な権限を付与してください。
リファレンス
統合方法
SDK は OpenAPI を呼び出すための最も簡単で最もサポートされている方法です。統合には SDK を使用することをお勧めします。
Cloud Parallel File Storage (CPFS) は、SDK、コマンドラインインターフェイス (CLI)、Terraform、Resource Orchestration Service (ROS) など、複数の統合方法を提供します。必要に応じて方法を選択できます。
Alibaba Cloud SDK
Alibaba Cloud は、Java、C#、Go、Python、Node.js/TypeScript、PHP、C++ など、複数のプログラミング言語用の SDK を提供しています。SDK をアプリケーションに統合して、API 操作を直接呼び出すことができます。SDK は、署名ロジック、タイムアウトメカニズム、リトライメカニズムなどの情報をカプセル化し、仕様に基づいて構造化された応答オブジェクトを返します。これにより、開発が容易になります。Alibaba Cloud SDK の詳細については、「Alibaba Cloud SDK」をご参照ください。
Alibaba Cloud SDK を使用して、OpenAPI Explorer で CPFS 操作を呼び出すことができます。サポートされているプログラミング言語と依存関係の詳細については、「」および「File Storage NAS SDK」をご参照ください。
Alibaba Cloud CLI
Alibaba Cloud CLI を使用すると、コマンドラインターミナルで aliyun コマンドを使用して、クラウドサービスリソースを管理し、Alibaba Cloud サービスと対話できます。Alibaba Cloud CLI の詳細については、「Alibaba Cloud CLI とは」をご参照ください。
カスタム API カプセル化 (非推奨)
ネイティブ HTTP 呼び出しを行うには、カスタムリクエストを作成し、自分でリクエストに署名する必要があります。署名メカニズムの詳細については、「機能別の操作リスト」および「v3 リクエストボディと署名メカニズム」をご参照ください。
使用上の注意
API 操作を呼び出した後にエラーが返された場合は、返されたエラーコードに基づいてリクエストパラメーターの値が有効かどうかを確認する必要があります。詳細については、「エラーコードセンター」をご参照ください。
返されたリクエスト ID または SDK エラー情報に基づいて、OpenAPI 問題診断でセルフサービス診断を実行できます。