Alibaba Cloud CLI で NAS リソースを設定・操作 - File Storage NAS

Alibaba Cloud Command Line Interface (CLI) は、Alibaba Cloud API に基づいて構築されたコマンドラインツールです。これを使用して、シェルから File Storage NAS リソースを管理します。このトピックでは、CLI のインストール、認証情報の設定、コマンド構文、および NAS リソース作成の例について説明します。

前提条件

Alibaba Cloud アカウント。セキュリティのため、API 呼び出しと定常的な運用保守には、ご利用の Alibaba Cloud アカウントの代わりに Resource Access Management (RAM) ユーザーを使用してください。
ご利用の RAM ユーザーに AliyunNASFullAccess ポリシーがアタッチされていること。
RAM ユーザー用に AccessKey ペア (AccessKey ID と AccessKey Secret) が作成されていること。詳細については、「AccessKey ペアの作成」をご参照ください。

重要

Alibaba Cloud アカウントには、すべての API 操作を呼び出す権限があります。Alibaba Cloud アカウントを使用して操作を実行することは高リスクです。API 呼び出しと定常的な運用保守には、RAM ユーザーを使用することを推奨します。

Alibaba Cloud CLI のインストール

ご利用のオペレーティングシステムに Alibaba Cloud CLI をインストールします。

または、Cloud Shell を使用して、ローカルインストールなしで CLI コマンドをデバッグできます。詳細については、「Cloud Shell とは」をご参照ください。

Alibaba Cloud CLI の詳細については、「Alibaba Cloud CLI とは」をご参照ください。

認証情報の設定

Alibaba Cloud CLI を使用する前に、AccessKey ペアとデフォルトのリージョン ID を設定します。Alibaba Cloud CLI は、さまざまな ID 認証情報の種類をサポートしています。詳細については、「ID 認証情報の種類」をご参照ください。次のステップでは、AccessKey 認証情報を使用します。

RAM ユーザーを作成し、適切な権限を付与します。詳細については、「RAM ユーザーの作成」および「RAM ユーザーに権限を付与」をご参照ください。
RAM ユーザー用に AccessKey ペアを作成します。次のステップのために AccessKey ID と AccessKey Secret を記録します。詳細については、「AccessKey ペアの作成」をご参照ください。
リージョン ID を指定します。Alibaba Cloud CLI は、指定されたリージョンで API 操作を呼び出します。利用可能なリージョンについては、「エンドポイント」をご参照ください。
AkProfile という名前の CLI プロファイルで AccessKey ペアを設定します。詳細については、「構成例」をご参照ください。

CLI 構文

次の構文で NAS コマンドを実行します。詳細については、「構文」をご参照ください。

aliyun <command> <subcommand> [options and parameters]

コマンドオプション

コマンドオプションは、コマンドの動作を変更したり、拡張機能を有効にしたりします。次のオプションが頻繁に使用されます。

--profile <profileName> -- デフォルトの認証情報と環境変数の構成を上書きします。指定されたプロファイルを使用してコマンドを実行します。
--help -- コマンドのヘルプ情報を表示します。詳細については、「ヘルプコマンドの使用」をご参照ください。

例

説明

次の例では、Windows のコマンドプロンプトを使用します。パラメーターのフォーマットは、オペレーティングシステムによって異なります。詳細については、「パラメーターのフォーマット」をご参照ください。

ファイルシステムの作成

CreateFileSystem 操作を呼び出して、従量課金制の汎用容量型 NAS ファイルシステムを NFS プロトコルで作成します。

aliyun nas CreateFileSystem ^
  --FileSystemType standard ^
  --ChargeType PayAsYouGo ^
  --StorageType Capacity ^
  --ProtocolType NFS

期待される出力:

{
    "FileSystemId": "6a2464****",
    "RequestId": "3879AB9C-1DED-5A49-A015-350138B23BF0"
}

応答は、ファイルシステムを一意に識別する FileSystemId を返します。

権限グループの作成

CreateAccessGroup 操作を呼び出して、vpc_test という名前の権限グループ (API では AccessGroup と呼ばれます) を作成します。

aliyun nas CreateAccessGroup ^
  --AccessGroupName vpc_test ^
  --AccessGroupType Vpc

期待される出力:

{
    "AccessGroupName": "vpc_test",
    "RequestId": "95CB3005-C251-5E11-A949-29CB2C7A9C54"
}

応答は、AccessGroupName フィールドで権限グループ名を確認します。

OpenAPI Portal からのコマンド生成

OpenAPI Portal を使用して、対話的に CLI コマンドを生成します。

OpenAPI Portal にログインし、[File Storage NAS] を選択します。
左側の検索ボックスで API 操作を検索します。
[パラメーター] タブで、必須パラメーターを指定します。
右側の [CLI 例] タブをクリックして、生成されたコマンドを表示します。

[CLI 例] タブから:

[コマンドの実行] アイコンをクリックして Cloud Shell を起動し、コマンドを直接実行します。
[コピー] アイコンをクリックして、コマンドをクリップボードにコピーします。

コマンドをコピーする際は、次の点に注意してください。

ローカルシェルに貼り付ける前に、パラメーターのフォーマットを確認してください。フォーマットはオペレーティングシステムによって異なります。詳細については、「パラメーターのフォーマット」をご参照ください。
生成されたコマンドには、デフォルトで --region オプションが含まれています。このオプションは、デフォルトの認証情報と環境変数内のリージョンよりも優先されます。要件に基づいて削除または保持してください。

エラー処理とトラブルシューティング

API 呼び出しがエラーを返した場合、返されたエラーコードに基づいて、リクエストパラメーターと値が有効であることを確認してください。

セルフサービス診断には、OpenAPI 問題診断ページで、返されたリクエスト ID または SDK エラー情報を使用してください。

次のステップ

NAS API エンドポイントで、NAS API エンドポイントの完全なリストを探索します。
Alibaba Cloud CLI でサポートされているID 認証情報の種類について学習します。
Cloud Shell を使用して、ローカルインストールなしで CLI コマンドを実行します。