File Storage NAS (NAS) は、SDK、CLI、Terraform、および直接の API 呼び出しなど、複数の連携方法をサポートしています。
OpenAPI
Alibaba Cloud は OpenAPI Portal を提供しています。これは、インテリジェントな API 検索、ドキュメント、オンラインデバッグ、SDK のダウンロード、コードサンプル、エラー診断、および呼び出し統計のためのオールインワンプラットフォームです。Alibaba Cloud サービスの API オペレーションを呼び出し、リクエストと応答を表示し、SDK 呼び出し例を生成できます。詳細については、「OpenAPI とは」をご参照ください。
バージョン
Alibaba Cloud OpenAPI は、バージョン番号を使用してクラウドプロダクトの API リストを管理します。NAS は現在、API バージョン 2017-06-26 をサポートしています。文字列 2017-06-26 はバージョン識別子であり、日付ではありません。表示される API データは常に最新のものであり、バージョン 2017-06-26 が公開されてから変更されている可能性があります。
|
バージョン |
説明 |
|
推奨 |
オンラインデバッグ
OpenAPI Portal は、NAS の API デバッグツールを提供します。API オペレーションを呼び出す前に、利用可能な API バージョン、エンドポイント、および連携方法をよく理解してください。
左側のナビゲーションウィンドウには、CreateFileSystem、DeleteFileSystem、DescribeFileSystems など、すべての NAS API オペレーションが一覧表示されます。API オペレーションを選択して、メインエリアで FileSystemType、ChargeType、StorageType、ZoneId などのパラメーターを設定します。右側のウィンドウには、API ドキュメント、SDK サンプル、および CLI サンプルが表示されます。パラメーターを設定した後、[Initiate Call] をクリックして API 呼び出しをテストします。
デバッグ URL
次の URL から API デバッグページにアクセスします: https://next.api.alibabacloud.com/api/NAS/2017-06-26/CreateFileSystem?tab=DOC
エンドポイント
最適なレイテンシーを得るには、リソースと同じリージョンにあるサービスエンドポイントを選択してください。たとえば、中国 (青島) リージョン内のリソースの場合、NAS のパブリックエンドポイントは nas.cn-qingdao.aliyuncs.com で、VPC エンドポイントは nas-vpc.cn-qingdao.aliyuncs.com です。
-
パブリックエンドポイントはグローバルにアクセス可能です。
-
VPC エンドポイントは、同じ Alibaba Cloud リージョン内の VPC ネットワークからのみアクセス可能です。これらにはいくつかの利点があります:
-
セキュリティの向上:VPC へのアクセスを制限することで、これらのエンドポイントはトラフィックをパブリックインターネットから分離します。
-
応答時間の短縮:VPC エンドポイントは内部 VPC ネットワーク内で動作するため、通常、パブリックエンドポイントよりも応答時間が速く、パブリックネットワークの遅延や帯域幅の制限を回避できます。
-
コストの削減:通信は内部ネットワークを介して行われるため、データ転送料金を削減または排除できます。
-
詳細については、「エンドポイント」をご参照ください。
サポートされるユーザー ID
|
ID |
サポート状況 |
|
はい |
|
|
RAM ユーザー (推奨) |
はい |
|
RAM ロール (推奨) |
はい |
API 呼び出しを行うには、最小限必要な権限を持つ RAM ユーザー または RAM ロール を使用することを推奨します。
関連情報
連携方法
SDK は、OpenAPI を呼び出すための最も簡単で、最もサポートされている方法です。
NAS は、SDK、Alibaba Cloud CLI、NAS オープンソースツールセット、Terraform、および Resource Orchestration Service (ROS) など、複数の連携方法をサポートしています。ニーズに最も適した方法を選択してください。
Alibaba Cloud SDK
-
Alibaba Cloud は、Java、C#、Go、Python、Node.js/TypeScript、PHP、および C++ 用の SDK を提供しています。SDK を使用すると、型付きメソッドを介して API オペレーションを呼び出すことができ、署名ロジック、タイムアウト、リトライが自動的に処理されます。構造化された応答オブジェクトが返されるため、開発が簡素化されます。Alibaba Cloud SDK の詳細については、「Alibaba Cloud SDK」をご参照ください。
-
Alibaba Cloud SDK を使用して NAS API を呼び出すことができます。サポートされている言語と依存関係のインストール方法については、「File Storage NAS SDK」をご参照ください。
Alibaba Cloud CLI
Alibaba Cloud CLI を使用すると、ターミナルで aliyun コマンドを実行して Alibaba Cloud サービスと対話し、クラウドリソースを管理できます。Alibaba Cloud CLI の詳細については、「Alibaba Cloud CLI とは」をご参照ください。
NAS オープンソースツールセット
Alibaba Cloud NAS は、GitHub で公式にサポートされているオープンソースツールセットを提供しており、性能テスト、マウント支援、容量分析のためのスクリプトとユーティリティが含まれています。
-
NAS 容量統計ツール (nas_stat_util)
NAS ファイルシステムのディレクトリレベルの容量使用状況を分析し、統計を収集します。さまざまなフィルタリング条件と出力フォーマットをサポートしています。
-
NAS/CPFS マウントツールキット (alinas-utils)
Alibaba Cloud NAS および CPFS ファイルシステムをマウントするためのツールキットです。
ツールと使用方法の完全なリストについては、GitHub プロジェクトページをご覧ください。
Resource Orchestration Service (ROS)
-
Resource Orchestration Service (ROS) は、クラウドリソース管理を簡素化します。テンプレートで Alibaba Cloud リソースとその依存関係を定義すると、ROS エンジンが自動的にそれらを作成および設定します。詳細については、「Resource Orchestration Service とは」をご参照ください。
-
ROS がサポートする NAS のリソースタイプについては、「ROS 連携の例」をご参照ください。
カスタム API のカプセル化
RAW HTTP 呼び出しを行うには、署名アルゴリズムを実装し、カスタムリクエストを構築する必要があります。署名メカニズムの詳細については、「API リファレンスガイド」および「V3 リクエストボディと署名メカニズム」をご参照ください。
トラブルシューティング
エラーコードによるトラブルシューティング
API 呼び出しでエラーが返された場合は、返されたエラーコードを使用して問題を診断します。詳細については、「エラーコードセンター」をご参照ください。
セルフサービス診断
API 応答または SDK エラー情報から RequestID を記録し、Alibaba Cloud OpenAPI 診断プラットフォームを使用してセルフサービス診断を行うこともできます。