File Storage for Classic の管理
IBM Cloud® File Storage for Classic ボリュームは、IBM Cloud® コンソールと CLI を使って管理することができます。
コンソールで File Storage for Classic ボリュームのリストを表示する
ボリュームは、リソースリストから、または File Storage for Classic のボリュームのリストにアクセスして確認できます。
- IBM Cloud® コンソールに移動します。 メニューから、インフラストラクチャ
>クラシックインフラストラチャをク選択します。
- 「ストレージ 」をクリックし、 File Storage for Classic、
CLIから File Storage for Classic ボリュームのリストを表示する
開始する前に、使用する CLI クライアントを決定します。
- IBM Cloud CLI をインストールし、
ibmcloud plugin install sl
を使用して SL プラグインをインストールすることができます。 詳しくは、 プラグインを使用した IBM Cloud CLI の拡張 を参照してください。 - あるいは、 SLCLIをインストールすることもできます。
IBMCLOUD CLI からのボリュームのリストの表示
IBMCLOUD CLI から File Storage for Classic のリストを取得するには、 ibmcloud sl file volume-list
コマンドを使用します。 以下の例では、 dal13 にある現在のアカウントのすべての耐久ボリュームをリストし、容量別にソートしている。
ibmcloud sl file volume-list -d dal13 -t endurance --sortby capacity_gb
id username datacenter storage_type capacity_gb bytes_used IOPs ip_addr lunId active_transactions rep_partner_count notes
20973781 IBM02SEL1575811-1 dal13 endurance_file_storage 100 - 4 - 3 - 0 -
22030583 IBM02SEL1575811-3 dal13 endurance_file_storage 20 - 4 - 0 - 0 -
このコマンドで使用可能なすべてのパラメータの詳細については 、ibmcloud sl file volume-list を参照してください。
SL CLI からのボリュームのリストの表示
SL CLI から File Storage for Classic のリストを取得するには、 slcli file volume-list
コマンドを使用します。
$ slcli file volume-list --help
Usage: slcli file volume-list [OPTIONS]
List file storage.
Example::
slcli file volume-list -d dal10 --storage-type endurance --sortby capacity_gb
┌────┬────────────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ -u │ --username │ Volume username │
│ -d │ --datacenter │ Datacenter shortname │
│ -o │ --order │ Filter by ID of the order that purchased the block storage │
│ │ --storage-type │ Type of storage volume Choices: performance, endurance │
│ │ --sortby │ Column to sort by │
│ │ --columns │ Columns to display. Options: id, username, datacenter, storage_type, capacity_gb, bytes_used, ip_addr, active_transactions, mount_addr, rep_partner_count, created_by, notes │
│ -h │ --help │ Show this message and exit. │
└────┴────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
File Storage for Classic へのアクセスをホストに許可する
「許可された」ホストとは、特定のボリュームへのアクセスを許可されたホストのことである。 ホストの許可がなければ、システムからストレージにアクセスすることも、ストレージを使用することもできません。 ホストにボリュームへのアクセスを許可すると、ユーザー名とパスワードが生成されます。
ご使用のストレージと同じデータ・センターにあるホストを許可および接続できます。 複数のアカウントを持つことはできますが、あるアカウントのホストから別のアカウントのストレージへのアクセスを許可することはできません。
最大 64 台のサーバーにファイル共有へのアクセスを許可することができます。 この制限には、すべてのサブネット、ホスト、および IP 許可の組み合わせが含まれます。 この制限を増やす方法について詳しくは、 FAQ を参照してください。
ホストが認証された後、ファイル共有をマウントし、新しいフォルダ構造とファイルの所有者を割り当てることができます。 Linux では、 chown
と chmod
コマンドを使用して、個々のユーザーやグループに読み取り、書き込み、実行の権限を割り当てることで、アクセス制御をさらに厳密にすることができます。 詳細については、 Red Hat Linux® での File Storage for Classic のマウント」 および 「 Ubuntu での File Storage for Classic のマウント」を 参照してください。
コンソールでホストが File Storage for Classic にアクセスすることを許可する
-
IBM Cloud® コンソールに移動します。 メニューから、インフラストラクチャ
>クラシックインフラストラチャをク選択します。
-
「ストレージ」 > **「File Storage for Classic」とクリックして、使用する「ボリューム名」**をクリックします。
-
ページの**「許可ホスト」**セクションまでスクロールします。
-
右にある**「ホストの許可」**をクリックします。
-
デバイス・タイプ、サブネット、または IP アドレスを選択して、使用可能なホスト・リストにフィルターを掛けます。
サブネットに基づいてリストにフィルターを掛けた場合、表示されるサブネットは、ストレージ・ボリュームと同じデータ・センター内のサブスクライブ・サブネットです。
-
リストから 1 つ以上のホストを選択して、**「保存」**をクリックします。
ホストがCLIから File Storage for Classic
IBMCLOUD CLI からのホストの許可
ibmcloud sl file access-authorize
コマンドを使用して、ホストがファイル共有にアクセスすることを許可します。 以下の例では、仮想サーバー・インスタンス 87654321
がファイル共有 12345678
をマウントすることを許可します。
ibmcloud sl file access-authorize 12345678 --virtual-id 87654321
このコマンドで使用可能なすべてのパラメーターについて詳しくは、 ibmcloud sl file access-authorizeを参照してください。
SLCLI からのホストの許可
ホストにボリュームへのアクセスを許可するには、 slcli file access-authorize
コマンドを使用します。
$ slcli file access-authorize --help
Usage: slcli file access-authorize [OPTIONS] VOLUME_ID
Options:
-h, --hardware-id TEXT The ID of one hardware server to authorize.
-v, --virtual-id TEXT The ID of one virtual server to authorize.
-i, --ip-address-id TEXT The ID of one IP address to authorize.
-p, --ip-address TEXT An IP address to authorize.
-s, --subnet-id TEXT An ID of one subnet to authorize.
--help Show this message and exit.
Terraform を使用したホストの許可
コンピュート・ホストに共有へのアクセスを許可するには、 ibm_storage_file
リソースを使用して、仮想サーバーの場合は allowed_virtual_guest_ids
、ベアメタル・サーバーの場合は allowed_hardware_ids
を指定します。 ストレージにアクセスできる IP アドレスを定義するには、 allowed_ip_addresses
を指定します。
以下の例では、ID 28961689
の仮想サーバーが 10.146.139.64/26
サブネットおよび 10.146.139.84
アドレスからボリュームにアクセスできることを定義します。
resource "ibm_storage_file" "fs_endurance" {
type = "Endurance"
datacenter = "dal09"
capacity = 20
iops = 0.25
allowed_virtual_guest_ids = ["28961689"]
allowed_subnets = ["10.146.139.64/26"]
allowed_ip_addresses = ["10.146.139.84"]
snapshot_capacity = 10
hourly_billing = true
}
ストレージ・リソースが作成されると、 hostname
属性と volumename
属性にアクセスできます。これらの属性を使用して、後でマウント・ターゲットを判別することができます。 例えば、 hostname
引数が nfsdal0901a.service.softlayer.com
に設定され、 volumename
引数が IBM01SV278685_7
に設定された File Storage ・リソースには、マウント・ポイント nfsdal0901a.service.softlayer.com:-IBM01SV278685_7
があります。
引数および属性について詳しくは、 ibm_storage_fileを参照してください。
コンソールで File Storage for Classic ボリュームへのアクセスが許可されているホストのリストを表示する
- IBM Cloud® コンソールに移動します。 メニューから、インフラストラクチャ
>クラシックインフラストラチャをク選択します。
- 「ストレージ」 > **「File Storage for Classic」とクリックして、使用する「ボリューム名」**をクリックします。
- **「許可ホスト」**をクリックして、ご使用のファイル・シェアへのアクセス権があるコンピュート・インスタンスを表示します。
- 楕円形の
をクリックし、View host details を選択します。 サイドパネルに、デバイス名、IPアドレス、ユーザー名、パスワードなどの詳細が表示されます。 アクセス・コントロール・リスト・セクションも表示される。 アクセス制御リストセクションでは、サブネットの追加や削除が可能です。
ターゲット・アドレスは、**「ストレージの詳細」**ページにリストされます。 NFS の場合、ターゲット・アドレスは DNS 名として示され、iSCSI の場合は「ターゲット ポータルの探索」の IP アドレスとして示されます。
CLI から File Storage for Classic ボリュームへのアクセスが許可されているホストのリストを表示する
IBMCLOUD CLI からの許可されたホストのリストの表示
ibmcloud sl file access-list
コマンドを使用して、ファイル共有へのアクセスが許可されているホストをリストできます。 以下の例では、ファイル共有 12345678
をマウントできるホストをリストし、それらの ID でソートします。
ibmcloud sl file access-list 12345678 --sortby id
このコマンドで使用可能なすべてのパラメーターについて詳しくは、 ibmcloud sl file access-listを参照してください。
SLCLI からの許可されたホストのリストの表示
認可されたホストのリストを表示するには、以下のコマンドを使用します。
$ slcli file access-list --help
Usage: slcli file access-list [OPTIONS] VOLUME_ID
Options:
--sortby TEXT Column to sort by
--columns TEXT Columns to display. Options: id, name, type,
private_ip_address, source_subnet, host_iqn, username,
password, allowed_host_id
-h, --help Show this message and exit.
ホストが認可されている File Storage for Classic ボリュームをコンソールで表示する
接続に必要な情報(ボリューム名、ストレージタイプ、ターゲットアドレス、容量、場所)を含め、ホストがアクセスできるボリュームを表示できます。
- IBM Cloud® コンソールに移動します。
- メニューから、インフラストラクチャ
>クラシックインフラストラチャをク選択します。
- 「デバイス」 > **「デバイス・リスト」**をクリックします。
- 目的のデバイスをクリックします。
- 「ストレージ」タブを選択します。
この特定のホストがアクセス権を持っているストレージ・ボリュームのリストが表示されます。いずれも、ストレージ・タイプ (ブロック、ファイル、その他) ごとにグループ化されています。 それぞれの**「アクション」**メニューから、他のストレージを許可したり、アクセス権を削除したりできます。
コンソールでホストの File Storage for Classic へのアクセス権を剥奪する
ホストから特定のストレージ・ボリュームへのアクセスを停止する場合は、アクセス権を取り消すことができます。 アクセス権が取り消されると、ホスト接続はボリュームから除去されます。 オペレーティング・システムとアプリケーションはそのボリュームと通信できなくなります。
ホスト側の問題を防止するために、アクセス権を取り消す前にオペレーティング・システムからストレージ・ボリュームをアンマウントして、ドライブの欠落やデータ破損を回避してください。
「デバイス・リスト」ビューまたは「ストレージ」ビューの「ストレージ」からアクセス権を取り消すことができます。
コンソールのデバイスリストからアクセスを取り消す
- IBM Cloud® コンソールに移動します。
- メニューから、インフラストラクチャ
>クラシックインフラストラチャをク選択します。
- 「デバイス」 > **「デバイス・リスト」**をクリックします。
- 該当するデバイスをダブルクリックします。
- **「ストレージ」**タブを選択します。
- この特定のホストがアクセス権を持っているストレージ・ボリュームのリストが表示されます。いずれも、ストレージ・タイプ (ブロック、ファイル、その他) ごとにグループ化されています。 アクセス権を取り消すボリュームの隣にある、それぞれの**「アクション」メニューを選択して、「アクセスの取り消し」**をクリックします。
- このアクションは元に戻せないので、ボリュームのアクセス権を取り消してよいかどうかを確認します。 ボリュームへのアクセス権を取り消すには**「はい (Yes)」を、アクションをキャンセルするには「いいえ (No)」**をクリックします。
特定のホストから複数のボリュームを切断する場合は、各ボリュームに対して「アクセス権の取り消し」アクションを繰り返す必要があります。
コンソールのストレージビューからアクセスを取り消す
- IBM Cloud® コンソールに移動します。
- メニューから、インフラストラクチャ
>クラシックインフラストラチャをク選択します。
- 「ストレージ」 > **「File Storage for Classic」とクリックし、アクセス権を取り消す「ボリューム」**を選択します。
- **「許可ホスト」**をクリックして、ご使用のファイル・シェアへのアクセス権があるコンピュート・インスタンスを表示します。
- アクセス権を失効させるホストの横にある 「Actions」
「Actions」をクリックし、「 Revoke Access 」を選択します。
- このアクションは元に戻せないので、ボリュームのアクセス権を取り消してよいかどうかを確認します。 ボリュームへのアクセス権を取り消すには**「はい (Yes)」を、アクションをキャンセルするには「いいえ (No)」**をクリックします。
特定のボリュームから複数のホストを切断する場合は、ホストごとに「アクセス権の取り消し」アクションを繰り返す必要があります。
CLIからホストの File Storage for Classic
IBMCLOUD CLI からのホスト許可の取り消し
ibmcloud sl file access-revoke
コマンドを使用して、ホストから許可を除去することができます。 次のコマンドは、仮想サーバー・インスタンス 87654321
がファイル共有 12345678
をマウントすることを許可しません。
ibmcloud sl file access-revoke 12345678 --virtual-id 87654321
このコマンドで使用可能なすべてのパラメーターについて詳しくは、 ibmcloud sl file access-revokeを参照してください。
SLCLI からのホスト許可の取り消し
SLCLI で次のコマンドを使用します。
$ slcli file access-revoke --help
Usage: slcli file access-revoke [OPTIONS] VOLUME_ID
Options:
-h, --hardware-id TEXT The ID of one hardware server to revoke authorization.
-v, --virtual-id TEXT The ID of one virtual server to revoke authorization.
-i, --ip-address-id TEXT The ID of one IP address to revoke authorization.
-p, --ip-address TEXT An IP address to revoke authorization.
-s, --subnet-id TEXT An ID of one subnet to revoke authorization.
--help Show this message and exit.
特定のボリュームから複数のホストを切断する場合は、ホストごとに「アクセス権の取り消し」アクションを繰り返す必要があります。
コンソールでストレージボリュームを削除する
特定のボリュームが不要になった場合は、そのファイル・シェアを削除することができます。 ストレージ・ボリュームをキャンセルするには、最初にすべてのホストのアクセス権を取り消す必要があります。
-
IBM Cloud® コンソールに移動します。 メニューから、インフラストラクチャ
>クラシックインフラストラチャをク選択します。
-
「ストレージ」 > **「File Storage for Classic」**をクリックします。
-
キャンセルするボリュームの 「アクション」
をクリックし、 「削除」 File Storage for Classic を選択します。
-
ボリュームを直ちに削除するか、ボリュームがプロビジョニングされた記念日に削除するかを確認します。
応当日にボリュームをキャンセルするオプションを選択した場合は、応当日の前にキャンセル要求を無効にすることができます。
-
**「次へ進む (Continue)」または「閉じる」**をクリックします。
-
確認チェックボックスをクリックし、「 確認 」をクリックします。
ボリュームが取り消されると、要求の後に 24 時間の再利用待機期間が続きます。 その 24 時間の間は、コンソールにボリュームが表示されています。 ボリュームの請求は即時に停止します。 再要求の期間が期限切れになると、データは破棄されて、ボリュームもコンソールから除去されます。 詳細については、よくある質問を参照してください。
アクティブなレプリカおよび従属複製があると、ストレージ・ボリュームの再利用処理がブロックされます。 そのボリュームがマウントされなくなったこと、ホストの許可が取り消されたこと、複製がキャンセルされたこと、および従属した複製が存在しないことを確認してから、元のボリュームの削除を試みてください。
CLIからストレージボリュームを削除する
ボリュームが取り消されると、要求の後に 24 時間の再利用待機期間が続きます。 その 24 時間の間は、コンソールにボリュームが表示されています。 ボリュームの請求は即時に停止します。 再要求の期間が期限切れになると、データは破棄されて、ボリュームもコンソールから除去されます。 詳細については、よくある質問を参照してください。
アクティブなレプリカおよび従属複製があると、ストレージ・ボリュームの再利用処理がブロックされます。 そのボリュームがマウントされなくなったこと、ホストの許可が取り消されたこと、複製がキャンセルされたこと、および従属した複製が存在しないことを確認してから、元のボリュームの削除を試みてください。
IBMCLOUD CLIからストレージボリュームを削除する
ibmcloud sl file volume-cancel
コマンドを使用して、ファイル共有を取り消すことができます。 以下の例では、即時にファイル共有 12345678
を取り消します。
ibmcloud sl file volume-cancel 12345678 --immediate -f
このコマンドで使用可能なすべてのパラメーターについて詳しくは、 ibmcloud sl file volume-cancelを参照してください。
ストレージ・ボリュームの削除 (SLCLI を使用)
ストレージ・ボリュームを削除するために、次のコマンドを使用することができます。
$ slcli file volume-cancel --help
Usage: slcli file volume-cancel [OPTIONS] VOLUME_ID
Options:
--reason TEXT An optional reason for cancellation.
--immediate Cancels the File Storage volume immediately instead of on the
billing anniversary.
-h, --help Show this message and exit.
Terraform を使用したストレージ・ボリュームの削除
terraform destroy
コマンドを使用すると、単一のファイル共有などのリモートオブジェクトを簡単に削除できます。 次の例は、IDが ibm_file_share.example.id
のファイル共有をキャンセルします。
terraform destroy --target ibm_file_share.example.id
詳しくは、 terraform destroyを参照してください。
ボリュームが取り消されると、要求の後に 24 時間の再利用待機期間が続きます。 その 24 時間の間は、コンソールにボリュームが表示されています。 ボリュームの請求は即時に停止します。 再要求の期間が期限切れになると、データは破棄されて、ボリュームもコンソールから除去されます。 詳細については、よくある質問を参照してください。
アクティブなレプリカおよび従属複製があると、ストレージ・ボリュームの再利用処理がブロックされます。 そのボリュームがマウントされなくなったこと、ホストの許可が取り消されたこと、複製がキャンセルされたこと、および従属した複製が存在しないことを確認してから、元のボリュームの削除を試みてください。