CloudHSM CLI で HSM を一覧表示する - AWS CloudHSM
ユーザータイプSyntax例関連トピック

CloudHSM CLI で HSM を一覧表示する

CloudHSM CLI の cluster hsm-info コマンドを使用して、AWS CloudHSM クラスター内のハードウェアセキュリティモジュール (HSM) を一覧表示します。このコマンドは、CloudHSM CLI にログインしていなくても実行できます。

注記

HSM を追加または削除した場合は、AWS CloudHSM クライアント、および、コマンドラインツールが使用する設定ファイルを更新してください。そうしないと、クラスター内のすべての HSM で変更が有効にならない場合があります。

ユーザータイプ

このコマンドは、次のタイプのユーザーが実行できます。

  • すべてのユーザー。このコマンドは、ログインしていなくても実行できます。

Syntax

aws-cloudhsm > help cluster hsm-info
List info about each HSM in the cluster

Usage: cloudhsm-cli cluster hsm-info [OPTIONS]

Options:
      --cluster-id <CLUSTER_ID>  Unique Id to choose which of the clusters in the config file to run the operation against. If not provided, will fall back to the value provided when interactive mode was started, or error
  -h, --help                     Print help

例

このコマンドは、AWS CloudHSM クラスターに存在する HSM を一覧表示します。

aws-cloudhsm > cluster hsm-info
{
  "error_code": 0,
  "data": {
    "hsms": [
      {
        "vendor": "Marvell Semiconductors, Inc.",
        "model": "NITROX-III CNN35XX-NFBE",
        "serial-number": "5.3G1941-ICM000590",
        "hardware-version-major": "5",
        "hardware-version-minor": "3",
        "firmware-version-major": "2",
        "firmware-version-minor": "6",
        "firmware-build-number": "16",
        "firmware-id": "CNN35XX-NFBE-FW-2.06-16"
        "fips-state": "2 [FIPS mode with single factor authentication]"
      },
      {
        "vendor": "Marvell Semiconductors, Inc.",
        "model": "NITROX-III CNN35XX-NFBE",
        "serial-number": "5.3G1941-ICM000625",
        "hardware-version-major": "5",
        "hardware-version-minor": "3",
        "firmware-version-major": "2",
        "firmware-version-minor": "6",
        "firmware-build-number": "16",
        "firmware-id": "CNN35XX-NFBE-FW-2.06-16"
        "fips-state": "2 [FIPS mode with single factor authentication]"
      },
      {
        "vendor": "Marvell Semiconductors, Inc.",
        "model": "NITROX-III CNN35XX-NFBE",
        "serial-number": "5.3G1941-ICM000663",
        "hardware-version-major": "5",
        "hardware-version-minor": "3",
        "firmware-version-major": "2",
        "firmware-version-minor": "6",
        "firmware-build-number": "16",
        "firmware-id": "CNN35XX-NFBE-FW-2.06-16"
        "fips-state": "2 [FIPS mode with single factor authentication]"
      }
    ]
  }
}

出力には以下の属性があります。

  • Vendor: HSM のベンダー名。

  • Model: HSM のモデル番号。

  • Serial-number: デバイスのシリアル番号。置換により変更される場合があります。

  • Hardware-version-major: ハードウェアのメジャーバージョン。

  • Hardware-version-minor: ハードウェアのマイナーバージョン。

  • Firmware-version-major: メジャーファームウェアバージョン。

  • Firmware-version-minor: マイナーファームウェアバージョン。

  • Firmware-build-number: ファームウェアビルド番号。

  • Firmware-id: ファームウェア ID。ビルドに加えてメジャーバージョンとマイナーバージョンが含まれます。

  • FIPS-state: クラスターとその中の HSM の FIPS モード。FIPS モードの場合、出力は「2 [単一要素認証の FIPS モード]」です。非 FIPS モードの場合、出力は「0 [単一要素認証の非 FIPS モード]」です。

関連トピック