すべてのプロダクト
Search
ドキュメントセンター

Security Center:GetAuthSummary

最終更新日:Aug 20, 2026

権限付与の統計情報を取得します。

今すぐお試しください

この 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-sas:GetAuthSummary

get

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

リクエストパラメーターは必要ありません。

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエストの ID。Alibaba Cloud は各リクエストに一意の識別子を生成します。この ID を使用して問題のトラブルシューティングを行えます。

0B48AB3C-***-B9270EF46038

DefaultAuthToAll

integer

すべてのアセットがデフォルトで権限付与されているかどうかを示します。有効な値:

  • 0: いいえ。

  • 1: はい。

1

AllowPartialBuy

integer

初回購入時にオンデマンド権限付与の購入が許可されているかどうかを示します。有効な値:

  • 0: 許可されていません。

  • 1: 許可されています。

1

AllowUpgradePartialBuy

integer

スペックアップ時にオンデマンド権限付与へのアップグレードが許可されているかどうかを示します。有効な値:

  • 0: 許可されていません。

  • 1: 許可されています。

1

HasPreBindSetting

boolean

事前バインドのアセット構成が存在するかどうかを示します。事前バインドとは、購入時に事前に選択されたアセットバインド構成を指します。有効な値:

  • 0: 存在しません。

  • 1: 存在します。

1

IsMultiVersion

integer

複数のバージョンが存在するかどうかを示します。有効な値:

  • 0: いいえ。

  • 1: はい。

1

AutoBind

integer

ホストおよびコンテナセキュリティのサブスクリプションサービスが有効化された際に、新規サブスクリプションアセットが自動的にバインドされるかどうかを示します。有効な値:

  • 0: 無効。

  • 1: 有効。

1

HighestVersion

integer

購入済みの Security Center の最上位エディション。有効な値:

  • 1: 無料版。

  • 3: Enterprise Edition。

  • 5: Premium Edition。

  • 6: ウイルス対策版。

  • 7: Ultimate Edition。

  • 10: 付加価値サービスのみ。

説明

単一のエディションを購入した場合、この値は該当するエディションを示します。複数のエディションを購入した場合、この値は最上位のサブエディションを示します。

1

Machine

object

アセットの権限付与統計情報。

RiskCoreCount

integer

セキュリティリスクがあるアセットのコア数。

10

BindCoreCount

integer

権限付与にバインドされているアセットのコア数。

10

TotalEcsCount

integer

アセットの総数。

10

BindEcsCount

integer

バインド済みアセットの数。

10

TotalCoreCount

integer

アセットの合計コア数。

10

RiskEcsCount

integer

セキュリティリスクがあるアセットの数。

10

UnBindEcsCount

integer

未バインドのアセットの数。

10

UnBindCoreCount

integer

未バインドのアセットのコア数。

10

PostPaidBindCoreCount

integer

従量課金制の権限付与にバインドされているアセットのコア数。

10

PostPaidBindEcsCount

integer

従量課金制の権限付与にバインドされているアセットの数。

10

VersionSummary

array<object>

権限付与の使用量統計情報。

object

権限付与の使用量統計情報。

Index

integer

現在のエディションのインデックス。値が大きいほど上位のエディションであることを示します。このフィールドはソートに使用されます。有効な値:

  • 1: 無料版。

  • 2: ウイルス対策版。

  • 3: Premium Edition。

  • 4: Enterprise Edition。

  • 5: Ultimate Edition。

1

Version

integer

購入済みの Security Center のエディション。有効な値:

  • 1: 無料版。

  • 3: Enterprise Edition。

  • 5: Premium Edition。

  • 6: ウイルス対策版。

  • 7: Ultimate Edition。

  • 8: マルチバージョン。

  • 10: 付加価値サービスのみ。

3

UsedCoreCount

integer

使用済みの権限付与済みコア数。

説明

このパラメーターは、AuthBindType が CORE または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

UnUsedCount

integer

未使用の権限付与済みアセット数。

説明

このパラメーターは、AuthBindType が ASSET または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

UsedEcsCount

integer

使用済みの権限付与済みアセット数。

説明

このパラメーターは、AuthBindType が ASSET または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

TotalCount

integer

現在のエディションの権限付与済みアセットの総数。

説明

このパラメーターは、AuthBindType が ASSET または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

TotalEcsAuthCount

integer

権限付与済みアセットの総数。

説明

このパラメーターは、AuthBindType が ASSET または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

TotalCoreAuthCount

integer

権限付与済みコアの総数。

説明

このパラメーターは、AuthBindType が CORE または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

UnusedEcsAuthCount

integer

未使用の権限付与済みアセット数。

説明

このパラメーターは、AuthBindType が ASSET または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

UnusedCoreAuthCount

integer

未使用の権限付与済みコア数。

説明

このパラメーターは、AuthBindType が CORE または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

AuthBindType

string

バインド時に消費される権限付与のタイプ。有効な値:

  • ASSET: 権限付与済みアセット数を消費します。

  • CORE: 権限付与済みコア数を消費します。

  • ASSET_AND_CORE: 権限付与済みアセット数と権限付与済みコア数の両方を消費します。

ASSET

AllowUserUnbind

integer

バインド済みのすべてのアセットの即時バインド解除が許可されているかどうかを示します。有効な値:

  • 0: いいえ。

  • 1: はい。

1

PostPaidVersionSummary

array<object>

ホストおよびコンテナセキュリティの従量課金制サービスのサービス認可統計情報。

object

AuthBindType

string

バインド時に消費される権限付与のタイプ。有効な値:

  • ASSET: 権限付与済みアセット数を消費します。

  • CORE: 権限付与済みコア数を消費します。

  • ASSET_AND_CORE: 権限付与済みアセット数と権限付与済みコア数の両方を消費します。

ASSET

Version

integer

ホストアセットにバインドされている従量課金制のエディション。有効な値:

  • 1: 無料版。

  • 3: Enterprise Edition。

  • 5: Premium Edition。

  • 6: ウイルス対策版。

  • 7: Ultimate Edition。

3

Index

integer

現在のエディションのインデックス。値が大きいほど上位のエディションであることを示します。このフィールドはソートに使用されます。有効な値:

  • 1: 無料版。

  • 2: ウイルス対策版。

  • 3: Premium Edition。

  • 4: Enterprise Edition。

  • 5: Ultimate Edition。

1

UsedCoreCount

integer

使用済みの権限付与済みコア数。

説明

このパラメーターは、AuthBindType が CORE または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

UsedEcsCount

integer

使用済みの権限付与済みアセット数。

説明

このパラメーターは、AuthBindType が ASSET または ASSET_AND_CORE に設定されている場合にのみ有効です。

10

FreeType

string

FreeEcsCount

integer

FreeCoreCount

integer

PostPaidHostAutoBind

string

ホストおよびコンテナセキュリティの従量課金制サービスで、新規ホストの自動バインドが有効になっているかどうかを示します。有効な値:

  • 0: 無効。

  • 1: 有効。

1

PostPaidHostAutoBindVersion

string

ホストおよびコンテナセキュリティの従量課金制サービスで、新規アセットが自動的にバインドされるエディション。有効な値:

  • 1: 無料版。

  • 3: Enterprise Edition。

  • 5: Premium Edition。

  • 6: ウイルス対策版。

  • 7: Ultimate Edition。

7

PostPaidHighestVersion

string

ホストおよびコンテナセキュリティの従量課金制サービスの保護エディション。これは、バインドされているすべてのホストの中で最上位の保護エディションです。有効な値:

  • 1: 無料版。

  • 3: Enterprise Edition。

  • 5: Premium Edition。

  • 6: ウイルス対策版。

  • 7: Ultimate Edition。

7

InvalidBindStatus

string

バインドの有効性ステータス。有効な値:

  • NORMAL: 有効。

  • INVALID_NODE_VERSION: 無効。

INVALID_NODE_VERSION

ClusterNodeCheck

integer

クラスターノードでエージェントのバージョン確認が必要かどうかを示します。有効な値:

  • 0: 不要。

  • 1: 必須。

1

EdrSummary

object

BoundCount

string

PostPaidAutoBind

string

HybridPaidAutoBind

string

例

成功レスポンス

JSONJSON

{
  "RequestId": "0B48AB3C-***-B9270EF46038",
  "DefaultAuthToAll": 1,
  "AllowPartialBuy": 1,
  "AllowUpgradePartialBuy": 1,
  "HasPreBindSetting": true,
  "IsMultiVersion": 1,
  "AutoBind": 1,
  "HighestVersion": 1,
  "Machine": {
    "RiskCoreCount": 10,
    "BindCoreCount": 10,
    "TotalEcsCount": 10,
    "BindEcsCount": 10,
    "TotalCoreCount": 10,
    "RiskEcsCount": 10,
    "UnBindEcsCount": 10,
    "UnBindCoreCount": 10,
    "PostPaidBindCoreCount": 10,
    "PostPaidBindEcsCount": 10
  },
  "VersionSummary": [
    {
      "Index": 1,
      "Version": 3,
      "UsedCoreCount": 10,
      "UnUsedCount": 10,
      "UsedEcsCount": 10,
      "TotalCount": 10,
      "TotalEcsAuthCount": 10,
      "TotalCoreAuthCount": 10,
      "UnusedEcsAuthCount": 10,
      "UnusedCoreAuthCount": 10,
      "AuthBindType": "ASSET"
    }
  ],
  "AllowUserUnbind": 1,
  "PostPaidVersionSummary": [
    {
      "AuthBindType": "ASSET",
      "Version": 3,
      "Index": 1,
      "UsedCoreCount": 10,
      "UsedEcsCount": 10,
      "FreeType": "",
      "FreeEcsCount": 0,
      "FreeCoreCount": 0
    }
  ],
  "PostPaidHostAutoBind": "1",
  "PostPaidHostAutoBindVersion": "7",
  "PostPaidHighestVersion": "7",
  "InvalidBindStatus": "INVALID_NODE_VERSION",
  "ClusterNodeCheck": 1,
  "EdrSummary": {
    "BoundCount": "",
    "PostPaidAutoBind": "",
    "HybridPaidAutoBind": ""
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

500 ServerError ServerError
403 NoPermission caller has no permission

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

変更履歴

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