このトピックでは、Apsara File Storage NAS (NAS) でサポートされるAPI統合ソリューションについて説明します。
OpenAPI Explorerの概要
Alibaba Cloudは、さまざまなAlibaba CloudサービスのAPI操作を効率的に理解して使用するためのOpenAPI Explorerを提供しています。 OpenAPI Explorerは、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK取得、サンプルコード、エラー診断、呼び出し統計など、API操作の機能を統合しています。 OpenAPI Explorerでは、Alibaba CloudサービスのAPI操作を呼び出し、APIのリクエストとレスポンスを表示できます。 さらに、OpenAPI Explorerは、対応するSDKサンプルコードを自動的に生成し、Alibaba Cloudサービスの使用を容易にします。 詳細については、「」をご参照ください。APIとは何ですか?
バージョンの説明
Alibaba Cloud OpenAPI Explorerは、Alibaba CloudサービスAPIのバージョンをバージョン番号で管理します。 たとえば、NASは2017-06-26バージョンのAPIをサポートしています。 2017-06-26はAPIバージョン番号ですが、日付はありません。 ユーザーには、APIに関する最新の公開情報が提供されます。 2017-06-26は、Cloud Backup APIの最新バージョンです。
APIバージョン | 説明 |
推奨 |
オンラインデバッグ
NASは、OpenAPI ExplorerのAPIデバッグなどの機能を提供します。 API操作を呼び出す前に、NASが提供する次の情報 (バージョン、エンドポイント、および統合方法) を理解する必要があります。
デバッグページ
APIデバッグページのURLは 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内からのみアクセスできます。 これにより、より高いセキュリティとプライバシーが提供されます。
高速応答: 内部ネットワーク環境は、パブリックエンドポイントよりも高速な応答を提供します。 加えて、ネットワーク待ち時間および帯域幅制限などの問題を防止することができる。
低コスト: VPCエンドポイントは内部ネットワーク経由でアクセスされます。
詳細については、「エンドポイント」をご参照ください。
サポートされるユーザーID
ID | サポートされているかどうか |
必須 | |
RAMユーザー (推奨) | 必須 |
RAMロール (推奨) | 必須 |
RAM (Resource Access Management) ユーザーまたはRAMロールに十分な権限のみを付与し、RAMユーザーとして、またはRAMロールを引き受けて操作を呼び出すことを推奨します。
関連ドキュメント
統合方法
SDKはアプリケーションと簡単に統合でき、幅広い操作をカバーできます。 SDKを使用してAPI操作を呼び出すことを推奨します。
NASは、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は、データ署名ロジック、タイムアウトメカニズム、再試行メカニズムなど、さまざまな情報をカプセル化します。 SDKは、開発を容易にするために仕様に基づいて構造化応答オブジェクトを返します。 詳細は、「Alibaba Cloud SDK」をご参照ください。
Alibaba Cloud SDKを使用して、NASのAPI操作を呼び出すことができます。 サポートされている言語と依存関係の詳細については、 OpenAPIポータル。
Alibaba Cloud CLI
aliyunコマンドを実行して、Alibaba Cloudサービスと対話し、クラウドサービスリソースを管理できます。 詳細については、「」をご参照ください。Alibaba Cloud CLIとは
ROS
ROSは、クラウドコンピューティングリソースの管理を簡素化するAlibaba Cloudサービスです。 Elastic Compute Service (ECS) やApsaraDB RDSインスタンスなどの必要なクラウドコンピューティングリソース、およびリソース間の依存関係を記述するテンプレートを作成できます。 ROSは、テンプレートに基づいてすべてのリソースを自動的に作成および構成し、自動デプロイとO&Mを実装します。詳細については、「」をご参照ください。ROSとは何ですか?
ROSでサポートされているNASリソースの種類の詳細については、「ROSの使用」をご参照ください。
カスタムAPIカプセル化 (非推奨)
ネイティブHTTP呼び出しを行うには、カスタムリクエストを作成してリクエストに署名する必要があります。 署名メソッドの詳細については、「関数別の操作の一覧」および「リクエスト構文と署名メソッドV3」をご参照ください。
注意
API操作を呼び出した後にエラーが返された場合は、返されたエラーコードに基づいてリクエストパラメーターと値が有効かどうかを確認する必要があります。 エラーコードのリストについては、 サービスエラーコード
返されたリクエストIDまたはSDKエラー情報に基づいて、セルフサービス診断を実行することもできます。 OpenAPIの問題診断ページ。