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

承認済みの MaxCompute、RDS、および OSS データ資産インスタンスのリストを取得します。

操作説明

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

QPS 制限

この操作に対する単一ユーザーの 1 秒あたりのクエリ数 (QPS) 制限は、1 秒あたり 10 回の呼び出しです。この制限を超えると、API 呼び出しがスロットルされます。これはビジネスに影響を与える可能性があります。呼び出しを適切に計画してください。

今すぐお試しください

この 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

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
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	データ資産インスタンスのデータ総量。たとえば、データ資産が RDS インスタンスの場合、このパラメーターはインスタンス内のテーブルの総数を示します。	231
InstanceDescription	string	データ資産インスタンスの説明です。	instance dscription
RuleName	string	データ資産インスタンスがヒットした機密データ検出ルールの名前。	*** rule
Sensitive	boolean	データ資産インスタンスに機密データが含まれているかどうかを示します。有効な値： true: はい false: いいえ	true
RiskLevelName	string	データ資産インスタンスの脅威レベルの名前。	S1
OdpsRiskLevelName	string	このパラメーターは廃止されました。	1
SensitiveCount	integer	データ資産インスタンス内の機密データの総量です。たとえば、データ資産が RDS インスタンスの場合、このパラメーターはインスタンス内の機密テーブルの総数を示します。	123
Id	integer	Data Security Center に記録されているデータ資産インスタンスの一意の 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"
    }
  ]
}

エラーコード

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

変更履歴

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