DescribeInstances を使用したデータ資産インスタンスのクエリ方法 - DSC - Alibaba Cloud - Data Security Center

権限が付与された MaxCompute、ApsaraDB RDS、および OSS 接続のデータ資産インスタンスのリストを取得します。

操作説明

DescribeInstances 操作を呼び出す際、検索キーワードやデータ資産インスタンスのリスクレベルなどのパラメーターを設定して、指定された条件を満たすデータ資産インスタンスのリストを取得できます。

QPS 制限

この操作の単一ユーザー QPS 制限は、1 秒あたり 10 回の呼び出しです。呼び出し回数が制限を超えると速度制限がトリガーされ、ビジネスに影響を与える可能性があります。必要に応じてこの操作を呼び出してください。

今すぐお試しください

この 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-sddp:DescribeInstances

get

*すべてのリソース。

*

acs:ResourceGroupId

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Lang	string	任意	リクエストおよびレスポンスの言語。デフォルト値: zh_cn。有効な値: zh_cn: 簡体字中国語。 en_us: 英語 (米国)。	zh_cn
Name	string	任意	検索キーワード。あいまい一致がサポートされています。たとえば、「data」と入力すると、検索項目に「data」を含むすべてのデータエントリが返されます。	data
ProductId	integer	任意	データ資産インスタンスが属するプロダクトの ID。 DescribeDataAssets 操作を呼び出してプロダクト ID を取得できます。	1
RiskLevelId	integer	任意	データ資産インスタンスのリスクレベル ID。リスクレベル ID が大きいほど、より多くの機密データが検出されたことを示します。有効な値: 1: 機密データは検出されていません。リスクなし。 2: レベル 1 の機密データリスク。 3: レベル 2 の機密データリスク。 4: レベル 3 の機密データリスク。 5: レベル 4 の機密データリスク。 6: レベル 5 の機密データリスク。 7: レベル 6 の機密データリスク。 8: レベル 7 の機密データリスク。 9: レベル 8 の機密データリスク。 10: レベル 9 の機密データリスク。 11: レベル 10 の機密データリスク。	2
RuleId	integer	任意	データ資産インスタンスがヒットした機密データ検出ルールの ID。 DescribeRules 操作を呼び出し、Id レスポンスパラメーターからルール ID を取得できます。	1111111
ServiceRegionId	string	任意	データ資産インスタンスのリージョン。詳細については、「サポートされているリージョン」を参照してください。	cn-hangzhou
FeatureType	integer	任意	このパラメーターは非推奨です。	1
ProductCode	string	任意	データ資産インスタンスが属するプロダクトの名前 (MaxCompute、OSS、RDS など)。サポートされているプロダクト名については、「機密データを検出できるデータタイプ」を参照してください。	RDS
PageSize	integer	任意	ページングクエリで各ページに返されるデータ資産インスタンスの最大数。デフォルト値: 10。	10
CurrentPage	integer	任意	ページングクエリにおける現在のページのページ番号。デフォルト値: 1。	1

レスポンスフィールド

フィールド	型	説明	例
	object
CurrentPage	integer	現在のページのページ番号。	1
RequestId	string	リクエスト ID。	71064826-726F-4ADA-B879-05D8055476FB
PageSize	integer	各ページのデータ資産インスタンスの数。	10
TotalCount	integer	返されたデータ資産インスタンスの総数。	231
Items	array<object>	返されたデータ資産インスタンスの詳細。
	array<object>
CreationTime	integer	データ資産インスタンスが作成された時間。値は UNIX タイムスタンプです。単位: ミリ秒。	1637226782000
LastFinishTime	integer	データ資産インスタンスの直近のスキャンが完了した時間。値は UNIX タイムスタンプです。単位: ミリ秒。	1637622793000
Owner	string	データ資産インスタンスを所有する Alibaba Cloud アカウント。	dtdep-239-******
TenantName	string	テナントの名前。	tenant
Protection	boolean	データ資産インスタンスの保護ステータス。有効な値: true: 保護済み。 false: 未保護。	false
DepartName	string	データ資産インスタンスが属する部門の名前。	***DemoCenter
Labelsec	boolean	データ資産インスタンスのセキュリティステータス。有効な値: true: 安全。 false: 安全ではない。	true
RiskLevelId	integer	データ資産インスタンスのリスクレベル ID。リスクレベル ID が大きいほど、より多くの機密データが検出されたことを示します。 1: 機密データは検出されていません。リスクなし。 2: レベル 1 の機密データリスク。 3: レベル 2 の機密データリスク。 4: レベル 3 の機密データリスク。 5: レベル 4 の機密データリスク。 6: レベル 5 の機密データリスク。 7: レベル 6 の機密データリスク。 8: レベル 7 の機密データリスク。 9: レベル 8 の機密データリスク。 10: レベル 9 の機密データリスク。 11: レベル 10 の機密データリスク。	2
ProductId	string	データ資産インスタンスが属するプロダクトの ID。	5
Name	string	データ資産インスタンスの名前。	gxdata
TotalCount	integer	データ資産インスタンス内のデータ項目の総数。たとえば、データ資産が ApsaraDB RDS の場合、この値はインスタンスのデータベース内のテーブルの総数を示します。	231
InstanceDescription	string	データ資産インスタンスの説明。	instance dscription
RuleName	string	データ資産インスタンスがヒットした機密データ検出ルールの名前。	*** rule
Sensitive	boolean	データ資産インスタンスに機密データが含まれているかどうかを示します。有効な値: true: 機密データを含みます。 false: 機密データを含みません。	true
RiskLevelName	string	データ資産インスタンスのリスクレベル名。	S1
OdpsRiskLevelName	string	このパラメーターは非推奨です。	1
SensitiveCount	integer	データ資産インスタンス内の機密データ項目の総数。たとえば、データ資産が ApsaraDB RDS の場合、この値はインスタンスのデータベース内の機密テーブルの総数を示します。	123
Id	integer	データセキュリティセンターに記録されたデータ資産インスタンスの一意の ID。	11111
ProductCode	string	データ資産インスタンスが属するプロダクトの名前 (MaxCompute、OSS、RDS など)。サポートされているプロダクト名については、「機密データを検出できるデータタイプ」を参照してください。	RDS
ModelTags	array<object>	データタグのリスト。
	object	データタグオブジェクト。
Id	integer	データラベルの ID です。有効な値： 101: 個人情報（機密情報） 102: 個人情報 107: 一般情報	101
Name	string	データラベルの名前。有効な値：個人情報（機密情報）個人情報一般情報	personal sensitive data
MemberAliUid	string	管理アカウントでマルチアカウント管理が有効になっており、資産が別のメンバーアカウントに属している場合、このフィールドにはメンバーアカウントの UID が表示されます。	12567890126

例

成功レスポンス

JSONJSON

{
  "CurrentPage": 1,
  "RequestId": "71064826-726F-4ADA-B879-05D8055476FB",
  "PageSize": 10,
  "TotalCount": 231,
  "Items": [
    {
      "CreationTime": 1637226782000,
      "LastFinishTime": 1637622793000,
      "Owner": "dtdep-239-******",
      "TenantName": "tenant",
      "Protection": false,
      "DepartName": "***DemoCenter",
      "Labelsec": true,
      "RiskLevelId": 2,
      "ProductId": "5",
      "Name": "gxdata",
      "TotalCount": 231,
      "InstanceDescription": "instance dscription",
      "RuleName": "*** rule",
      "Sensitive": true,
      "RiskLevelName": "S1",
      "OdpsRiskLevelName": "1",
      "SensitiveCount": 123,
      "Id": 11111,
      "ProductCode": "RDS",
      "ModelTags": [
        {
          "Id": 101,
          "Name": "personal sensitive data"
        }
      ],
      "MemberAliUid": "12567890126"
    }
  ]
}

エラーコード

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

変更履歴

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