CreateFileDetectUploadUrl を呼び出して検出用ファイルのアップロードパラメータを取得 - Security Center

ファイル検出用のアップロードに必要なパラメーターを照会します。

操作説明

この API オペレーションを呼び出して、ファイル検出用のアップロードに必要なパラメーターを照会できます。レスポンスパラメーター FileExist の値が true の場合、検出対象のファイルは既にクラウド上に存在します。この場合は、ファイルを直接プッシュして検出を実行できます。一方、FileExist の値が false の場合、本オペレーションのレスポンスパラメーターに基づき、指定された Object Storage Service (OSS) バケットに対してフォームアップロード方式でファイルをアップロードする必要があります。

フォームアップロード方式は OSS が提供する機能です。詳細については、「フォームアップロード」をご参照ください。

HashKey パラメーターは、ファイル検出機能に関連するすべての API オペレーションに含まれます。これはファイルの固有識別子であり、MD5 ハッシュ値のみがサポートされます。本オペレーションを呼び出す前に、対象ファイルの MD5 ハッシュ値を事前に計算してください。

今すぐお試しください

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

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
HashKeyList	array	任意	ファイルの識別子。MD5 ハッシュ値のみがサポートされます。説明 HashKeyList または HashKeyContextList のいずれか 1 つ以上を指定する必要があります。	CreateFileDetectUploadUrl
	string	任意	ファイルの識別子。MD5 ハッシュ値のみがサポートされます。	0a212417e65c26ff133cfff28f6c****
Type	integer	必須	ファイルの種類。有効な値は以下のとおりです。 0：不明なファイル 1：バイナリファイル 2：Web シェルファイル 4：スクリプトファイル説明ファイルの種類が不明な場合は、このパラメーターを 0 に設定してください。	0
HashKeyContextList	array<object>	任意	ファイルのハッシュ値。説明 HashKeyList または HashKeyContextList のいずれか 1 つ以上を指定する必要があります。
	object	任意
HashKey	string	任意	ファイルのハッシュ値。	30319dd5cee8f894766e479cac170da0
FileSize	integer	任意	ファイルサイズ（単位：バイト）。	2698557

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。問題の特定およびトラブルシューティングに使用されます。	09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F
UploadUrlList	array<object>	ファイルアップロードに必要なパラメーターを含む配列。
	array<object>
PublicUrl	string	ファイルをアップロードする URL のパブリックエンドポイント。	http://example.com
InternalUrl	string	ファイルをアップロードする URL の内部エンドポイント。	http://example.com
Expire	string	パラメーターの有効期限が切れるタイムスタンプ（単位：ミリ秒）。	1658562101370
Context	object	署名情報。
AccessId	string	OSS バケットへのアクセスに使用される AccessKey ID。	yourAccessKeyID
Policy	string	ファイルアップロードに制限を課すポリシー（例：ファイルサイズの制限など）。	eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****
Signature	string	ファイルアップロードに使用される署名。	wDhPgVdnY/bkKFYcYFl+4crl****
OssKey	string	ファイルが OSS バケットにアップロードされた後に使用されるファイルキー。	1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****
FileExist	boolean	ファイルがクラウド上に存在するかどうかを示します。有効な値は以下のとおりです。 true：ファイルがクラウド上に存在します。ファイルのアップロードは不要です。 false：ファイルがクラウド上に存在しません。ファイルをアップロードする必要があります。	false
HashKey	string	ファイルの識別子。	0a212417e65c26ff133cfff28f6c****
Code	string	返された状態コード。状態コード 200 はリクエストが成功したことを示します。その他の状態コードはリクエストが失敗したことを示し、状態コードから失敗の原因を特定できます。	200
Message	string	返されたエラーメッセージ。	successful

例

成功レスポンス

JSONJSON

{
  "RequestId": "09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F",
  "UploadUrlList": [
    {
      "PublicUrl": "http://example.com",
      "InternalUrl": "http://example.com",
      "Expire": "1658562101370",
      "Context": {
        "AccessId": "yourAccessKeyID",
        "Policy": "eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****",
        "Signature": "wDhPgVdnY/bkKFYcYFl+4crl****",
        "OssKey": "1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****"
      },
      "FileExist": false,
      "HashKey": "0a212417e65c26ff133cfff28f6c****",
      "Code": "200",
      "Message": "successful"
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	RequestTooFrequently	Request too frequently, please try again later
400	InvalidApiDetectType	Unsupported Api Detect Type.
500	ServerError	ServerError
500	SystemBusy	System busy, please try again later.
403	NoPermission	caller has no permission

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

変更履歴

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