開始前に

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。

IBM Cloud® にログインしてください。

ibmcloud login --sso -a cloud.ibm.com

このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。 ブラウザーでその URL にアクセスしてログインします。 成功すると、ワンタイム・パスコードが表示されます。 そのパスコードをコピーし、プロンプトに応答として貼り付けます。 認証に成功すると、アカウントを選択するプロンプトが表示されます。 複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。 残りのプロンプトにすべて応答して、ログインを完了します。

始める前に、以下の情報を収集する：

• スナップショットの固有の名前。 共有スナップショット名は、共有レベルで一意でなければならない。 スナップショットの命名方法について詳しくは、スナップショットの名前についてを参照してください。
• ソース共有の名前またはID。
• スナップショットに付けたいタグ。

以下のCLIコマンドを使用して、必要な情報を収集する。

• ibmcloud is shares- このコマンドは、選択した地域で利用可能なすべての共有を一覧表示します。 リストで共有を見つけ、ステータス( available )を確認する。
• ibmcloud is share SHARE_ID- 共有の詳細を確認するには、前のコマンドの出力から共有 ID を指定してこのコマンドを使用します。 共有が利用可能で、インスタンスにアタッチされ、ビジーでないことを出力が示している場合、スナップショットを作成できます。

APIでスナップショットを作成するための前提条件

VPC API を呼び出すことにより、スナップショットを作成できます。 始める前に、以下の情報を収集する：

• スナップショットの固有の名前。 共有スナップショット名は、共有レベルで一意でなければならない。 スナップショットの命名方法について詳しくは、スナップショットの名前についてを参照してください。
• ソース共有のID。
• スナップショットに付けたいタグ。

API を使用したスナップショットの作成

shares/{share-id}/snapshots APIメソッドを呼び出すことで、ファイル共有のスナップショットをプログラムで作成できます。 次の例では、共有IDを使用して共有のスナップショットを作成し、 バックアップポリシー に関連付けることができるユーザータグを指定します。

curl -X POST \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
  "name": "my-first-share-snapshot",
  "user_tags": [
    "env:test"
  ]
}'

正常な応答は、次の例のようになります。 スナップショットが作成されている間、スナップショットのライフサイクル状態は pending です。 作成に成功すると、ステータスが「 stable 」に変わります。

{
  "captured_at": "2024-12-10T01:21:12.000Z",
  "created_at": "2024-12-10T01:59:46.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "lifecycle_state": "pending",
  "minimum_size": 10,
  "name": "my-first-share-snapshot",
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "share_snapshot",
  "status": "available",
  "status_reasons": [],
  "user_tags": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

地域ファイル共有のスナップショットの場合、CLIとAPIの両方の応答でゾーンの値は空白になります。