CPFS API 連携の概要 - Cloud Parallel File Storage - Alibaba Cloud ドキュメントセンター

このトピックでは、Lingjun 向けの Cloud Parallel File Storage (CPFS) でサポートされている連携ソリューションについて説明します。

OpenAPI Explorer

Alibaba Cloud は、開発者がクラウドサービスの API を迅速かつ効率的に理解して利用できるようにするため、OpenAPI Explorer を提供しています。OpenAPI Explorer は、インテリジェント API 検索、ドキュメント、オンラインデバッグ、SDK の取得、コードサンプル、エラー診断、呼び出し統計などの機能を統合しています。OpenAPI Explorer を使用して Alibaba Cloud サービスの API を呼び出し、API リクエストとレスポンスを確認できます。また、OpenAPI Explorer は SDK のサンプルコードを自動生成し、Alibaba Cloud サービスをすぐに利用開始できるよう支援します。詳細については、「What is OpenAPI?」をご参照ください。

バージョン

Alibaba Cloud OpenAPI は、バージョン番号を使用してサービスの API リリースを管理します。たとえば、Cloud Parallel File Storage (CPFS) は現在、API バージョン 2017-06-26 をサポートしています。この識別子は日付ではなく、バージョン番号です。これは API のデータ構造を表しており、API が 2017-06-26 以降変更されていないことを意味するものではありません。

説明

Cloud Parallel File Storage (CPFS) と Apsara File Storage NAS は同一の SDK を共有します。そのため、CPFS を使用する場合は、Apsara File Storage NAS のエンドポイントと SDK を使用してください。

バージョン	説明
2017-06-26	推奨

オンラインデバッグ

Cloud Parallel File Storage (CPFS) は、OpenAPI Explorer での API デバッグなどの機能を提供します。API を呼び出す前に、CPFS が提供するバージョン、エンドポイント、連携方法を理解してください。

OpenAPI Explorer のデバッグページでは、左側メニューに [CreateFileSystem]、[DeleteFileSystem]、[DescribeFileSystems] などのファイルシステム API が表示されます。中央のペインには、[CreateFileSystem] API のパラメータ設定フォームが表示されます。このフォームには、[FileSystemType] (有効な値：standard、extreme、cpfs)、[ChargeType] (有効な値：PayAsYouGo、Subscription)、[Duration]、[Capacity]、[Bandwidth]、[StorageType] (必須。赤いアスタリスクで示されます)、[ZoneId] などのフィールドが含まれます。China East 1 (Hangzhou) など、特定リージョンのエンドポイントを選択できます。ページ下部には [Send Request] ボタンがあります。

デバッグのエントリポイント

API をデバッグするには、クラウド並列ファイルストレージ (CPFS) に移動します。

エンドポイント

レイテンシーを最小化するため、リソースと同じリージョンのエンドポイントを選択してください。たとえば、China (Ulanqab) リージョンにおける Cloud Parallel File Storage (CPFS) のパブリックエンドポイントは nas.cn-wulanchabu.aliyuncs.com、VPC エンドポイントは nas-vpc.cn-wulanchabu.aliyuncs.com です。

パブリックエンドポイントはグローバルにアクセス可能です。
VPC エンドポイントは、対応する Alibaba Cloud リージョン内の Virtual Private Cloud (VPC) からのみアクセス可能です。VPC エンドポイントの利点は次のとおりです：
- 高いセキュリティ：VPC エンドポイントは VPC 内からのみアクセスできるため、セキュリティとプライバシーが向上します。
- 高速な応答：内部 VPC ネットワーク上で動作するため、VPC エンドポイントは通常、パブリックエンドポイントよりも応答が速く、パブリックネットワーク遅延や帯域幅制限の影響を受けません。
- 低コスト：内部ネットワークを使用することで、VPC エンドポイントはデータ転送コストの削減に役立ちます。

次の表に、Lingjun 向けの Cloud Parallel File Storage (CPFS) でサポートされているリージョンとエンドポイントを示します。

リージョン名	リージョン ID	パブリックエンドポイント	VPC エンドポイント
Singapore	ap-southeast-1	nas.ap-southeast-1.aliyuncs.com	nas-vpc.ap-southeast-1.aliyuncs.com

サポート対象のユーザーアイデンティティ

ユーザーアイデンティティ	サポート状況
Alibaba Cloud アカウント	サポート
RAM ユーザー (推奨)	サポート
RAM ロール (推奨)	サポート

API 呼び出しには RAM ユーザー または RAM ロール を使用し、ビジネス要件に基づいて権限を付与することを推奨します。

詳細情報

連携方法

説明

API を呼び出す方法としては、SDK の使用が最も簡単で、サポートも充実しています。そのため、SDK の使用を推奨します。

Lingjun 向けの Cloud Parallel File Storage (CPFS) は、SDK および Alibaba Cloud CLI による連携に対応しています。ビジネス要件に最適な方法を選択できます。

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 で Cloud Parallel File Storage (CPFS) API を呼び出すことができます。サポートされている言語および依存関係のインストール方法については、Apsara File Storage NAS SDK をご参照ください。

Alibaba Cloud CLI

Alibaba Cloud CLI を使用すると、aliyun コマンドを使用してコマンドラインから Alibaba Cloud サービスを操作し、クラウドリソースを管理できます。Alibaba Cloud CLI の詳細については、「What is Alibaba Cloud CLI」をご参照ください。

手動 API 呼び出し (非推奨)

ネイティブの HTTP 呼び出しを行うには、署名アルゴリズムを実装し、カスタムリクエストを構築する必要があります。署名メカニズムの詳細については、「API reference」および「V3 request body and signature mechanism」をご参照ください。

注意事項

API コールからエラーが返された場合は、返されたエラーコードを使用して、リクエストパラメーターと値が正しいか確認します。詳細については、「エラーコードセンター」をご参照ください。
また、呼び出しから返された RequestID または SDK エラーメッセージを記録し、Alibaba Cloud OpenAPI 診断プラットフォームを使用してセルフサービス診断を行うこともできます。