HSM Image Types & アーキテクチャ概要 - Key Management Service (KMS) - Alibaba Cloud - Key Management Service

指定された条件を満たすイメージをクエリします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-hsm:ListImages

list

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
BackupId	string	必須	バックアップの ID です。	backup-fdb897sdf****
RegionId	string	必須	リージョンの ID です。	cn-hangzhou
PageSize	integer	必須	ページあたりのイメージ数。有効値：1～1000。	20
CurrentPage	integer	必須	ページ番号です。	1
Mode	string	任意	イメージの生成モード。有効な値は次のとおりです： PERIODIC：自動的に生成されます。 MANUAL：手動で生成されます。	MANUAL

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID です。	4C467B38-3910-447D-87BC-AC049166F216
TotalCount	integer	返されたイメージの総数です。	1000
PageSize	integer	ページあたりのイメージ数です。	20
CurrentPage	integer	ページ番号です。	1
Images	array<object>	返されたイメージのリストです。
	object	イメージの詳細です。
BackupId	string	バックアップの ID です。	backup-fdb897sdf****
ExportTime	integer	イメージが生成された時間。単位：ミリ秒。値は UNIX タイムスタンプです。	1782849566738
ImageId	string	イメージの ID です。	image-d79x4k11pmg19****
InstanceId	string	ハードウェアセキュリティモジュール (HSM) の ID です。	hsm-cn-6ja1xknf****
RegionId	string	リージョンの ID です。	cn-hangzhou
Remark	string	バックアップの説明です。	hsm-test
Status	string	イメージのステータス。有効な値は次のとおりです： NEW：無効です。 DELETED：削除済みです。 CREATING：作成中です。 NORMAL：作成済みです。	CREATING
Mode	string	イメージの生成モード。有効な値は次のとおりです： PERIODIC：自動的に生成されます。 MANUAL：手動で生成されます。	MANUAL
VsmDigest	string	HSM のダイジェストです。	3kGeHnmQzXwSsfF0Jk9eJYhe2gP6An0/HlYIiZh1****
SourceImageUid	string	ソースイメージの ID です。	image-ooopjygsn****
SourceBackupUid	string	ソースバックアップの ID です。	backup-hodfhaol****
SourceRegionId	string	ソースイメージが存在するリージョンの ID です。	cn-shanghai
SourceInstanceId	string	ソース HSM の ID です。	hsm-cn-wz9i2dmefudfxtmb****
CopyTime	string	イメージがコピーされた時間。単位：ミリ秒。値は UNIX タイムスタンプです。	1641275680000

例

成功レスポンス

JSONJSON

{
  "RequestId": "4C467B38-3910-447D-87BC-AC049166F216",
  "TotalCount": 1000,
  "PageSize": 20,
  "CurrentPage": 1,
  "Images": [
    {
      "BackupId": "backup-fdb897sdf****",
      "ExportTime": 1782849566738,
      "ImageId": "image-d79x4k11pmg19****",
      "InstanceId": "hsm-cn-6ja1xknf****",
      "RegionId": "cn-hangzhou",
      "Remark": "hsm-test",
      "Status": "CREATING",
      "Mode": "MANUAL",
      "VsmDigest": "3kGeHnmQzXwSsfF0Jk9eJYhe2gP6An0/HlYIiZh1****",
      "SourceImageUid": "image-ooopjygsn****",
      "SourceBackupUid": "backup-hodfhaol****",
      "SourceRegionId": "cn-shanghai",
      "SourceInstanceId": "hsm-cn-wz9i2dmefudfxtmb****",
      "CopyTime": "1641275680000"
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
403	NoPermission	caller has no permission
403	Backup.Deleted	Backup has been deleted.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。