すべてのプロダクト
Search

このプロダクト

    Security Center:PublicCreateImageScanTask

    ドキュメントセンター

    Security Center:PublicCreateImageScanTask

    最終更新日:Jun 16, 2026

    単一のプライマリタスクに制限されないイメージスキャンタスクを作成します。

    操作説明

    この操作を呼び出す前に、 PublicPreCheckImageScanTask 操作を呼び出して、イメージスキャンノードがカバーするコンテナイメージの数と消費される認可数をクエリしてください。これにより、イメージスキャンノードに十分な認可があることを確認し、認可不足によるイメージスキャンノードの中断を防止できます。

    今すぐお試しください

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

    none

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    SourceIp

    string

    任意

    アクセスソースの IP アドレス。

    192.168..XX.XX
    RegistryTypes

    string

    任意

    イメージレジストリのタイプ。複数のタイプはカンマ（,）で区切ります。有効な値:

    • acr

    • harbor

    • quay。

    acr
    RegionIds

    string

    任意

    イメージのリージョン ID。複数のリージョン ID はカンマ（,）で区切ります。

    cn-hangzhou
    InstanceIds

    string

    任意

    Container Registry（ACR）インスタンスの ID。複数の ID はカンマ（,）で区切ります。

    i-uf6j8vq9l4r5ntht****
    RepoNamespaces

    string

    任意

    イメージレジストリの名前空間。複数の名前空間はカンマ（,）で区切ります。

    hanghai-namespace
    RepoIds

    string

    任意

    イメージレジストリの ID。複数の ID はカンマ（,）で区切ります。

    crr-vridcl4****
    RepoNames

    string

    任意

    イメージレジストリの名前。複数の名前はカンマ（,）で区切ります。

    centos
    Digests

    string

    任意

    イメージの SHA256 ダイジェスト値。複数の SHA256 値はカンマ（,）で区切ります。

    6a5e103187b31a94592a47a5858617f7a6c
    Tags

    string

    任意

    イメージのタグ。複数のタグはカンマ（,）で区切ります。

    0.2

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ。

    RequestId

    string

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

    F9353221-40F4-5F98-B73C-2803DC804033
    Data

    object

    操作が成功した場合に返されるデータ。

    TaskId

    string

    スキャンタスクの ID。

    a410bb3e68c217a3368bc0238c66886d
    TotalCount

    integer

    スキャンするイメージの総数。

    5
    FinishCount

    integer

    スキャン済みのイメージの数。

    5
    CollectTime

    integer

    イメージ情報が収集された時間のタイムスタンプ（ミリ秒単位）。

    1644286364150
    ExecTime

    integer

    スキャンタスクが実行中になった時間のタイムスタンプ（ミリ秒単位）。

    1644286364150
    Status

    string

    スキャンタスクのステータス。有効な値:

    • INIT: 初期化中。

    • PRE_ANALYZER: 事前分析中。

    • SUCCESS: 成功。

    • FAIL: 失敗した。

    SUCCESS
    Progress

    integer

    スキャンタスクの進捗率。

    100
    Result

    string

    スキャンタスクの実行結果。有効な値:

    • SUCCESS: スキャンタスクが成功しました。

    • TASK_NOT_SUPPORT_REGION: イメージがスキャンをサポートしていないリージョンにあります。

    説明

    イメージセキュリティスキャンをサポートするリージョンについては、この Topic の応答パラメーターテーブルの後にあるサポートされるリージョンの表を参照してください。

    SUCCESS
    CanCreate

    boolean

    追加のスキャンタスクを作成できるかどうかを示します。有効な値:

    • true: 追加のスキャンタスクを作成できます。

    • false: 追加のスキャンタスクを作成できません。

    説明

    デフォルトでは、同時間に最大 10 個のスキャンタスクが存在できます。スキャンタスクの数が 10 を超えると、この操作を呼び出してスキャンタスクを作成しても失敗します。既存のスキャンタスクが完了するまで待ってから、新しいスキャンタスクを作成してください。

    true

    イメージセキュリティスキャンをサポートするリージョン。

    リージョン都市リージョン ID
    中国（杭州）杭州cn-hangzhou
    中国（上海）上海cn-shanghai
    中国（深圳）深圳cn-shenzhen
    中国（青島）青島cn-qingdao
    中国（北京）北京cn-beijing
    中国（張家口）張家口cn-zhangjiakou
    中国（フフホト）フフホトcn-huhehaote
    中国（香港）香港cn-hongkong
    日本（東京）東京ap-northeast-1
    インドネシア（ジャカルタ）ジャカルタap-southeast-5
    米国（シリコンバレー）シリコンバレーus-west-1
    米国（バージニア）バージニアus-east-1
    ドイツ（フランクフルト）フランクフルトeu-central-1
    英国（ロンドン）ロンドンeu-west-1

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "F9353221-40F4-5F98-B73C-2803DC804033",
  "Data": {
    "TaskId": "a410bb3e68c217a3368bc0238c66886d",
    "TotalCount": 5,
    "FinishCount": 5,
    "CollectTime": 1644286364150,
    "ExecTime": 1644286364150,
    "Status": "SUCCESS",
    "Progress": 100,
    "Result": "SUCCESS",
    "CanCreate": true
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 BeyondQuata Please check the scan quota
    400 TaskNumEmpty Create task quantity is empty.
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    変更履歴

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