検出のためにファイルをクラウドにプッシュします。
操作説明
検出のためにファイルをクラウドにプッシュします。
ファイルアップロードメソッド
事前アップロードとダウンロード URL の 2 つのファイルアップロードメソッドがサポートされています。
事前アップロードメソッドを使用する場合は、この操作の呼び出し前にファイルがアップロードされていることを確認してください。ファイルのアップロード方法の詳細については、 CreateFileDetectUploadUrl 操作を参照してください。
ダウンロード URL メソッドを使用する場合は、DownloadUrl パラメーターを使用してパブリックネットワークアクセスをサポートするダウンロード URL を渡します。
一意のファイル識別子
すべてのファイル検出操作には HashKey パラメーターが含まれており、検出対象ファイルの一意の識別子を指定し、検出結果のクエリに使用されます。
この操作の呼び出し前に HashKey を計算してください。完全なファイルコンテンツの MD5 または SHA-256 ハッシュのみがサポートされています。
ファイルコンテンツの MD5 または SHA-256 ハッシュを計算するには、次の手順を実行します。
-
MD5 または SHA-256 アルゴリズムを使用してデータを暗号化する。これにより、128 ビットまたは 256 ビットのハッシュ値を生成します。利用可能なライブラリには、Java の MessageDigest や Python の hashlib などがあります。
-
生成されたハッシュ値を 16 進数文字列としてエンコードします。利用可能なライブラリには、Java の Codec や Python の hex 関数などがあります。最終的な文字列が数字と小文字の組み合わせであることを確認してください。MD5 ハッシュは 32 文字、SHA-256 ハッシュは 64 文字です。
単一の検出に対するプッシュ操作とクエリ操作では、同じ HashKey を使用する必要があります。そうしないと、検出を正しくプッシュできず、結果をクエリできません。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
yundun-sas:CreateFileDetect |
create |
*すべてのリソース。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| SourceIp |
string |
任意 |
アクセスソースの IP アドレス。 |
115.213.XX.XX |
| Type |
integer |
必須 |
検出対象ファイルのタイプ。有効な値:
|
0 |
| HashKey |
string |
任意 |
ファイルの一意の識別子。このパラメーターは必須であり、ファイルの MD5 または SHA-256 ハッシュである必要があります。 |
0a212417e65c26ff133cfff28f6c**** |
| OssKey |
string |
任意 |
OSS バケット内のファイルのストレージキー。 DownloadUrl を使用して検出用にファイルをプッシュする場合、このパラメーターは任意です。このパラメーターは、 CreateFileDetectUploadUrl 操作を呼び出すことで取得できます。 注意: Type が 0 に設定されており、DownloadUrl が指定されていない場合、このパラメーターは必須であり、CreateFileDetectUploadUrl 操作を呼び出して取得する必要があります。 |
1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8**** |
| DownloadUrl |
string |
任意 |
ファイルのダウンロード URL。ファイルのダウンロード URL (パブリック URL) を渡すことで、事前にファイルをアップロードせずにファイル検出を直接トリガーできます。 |
https://xxxxxxxx.oss-cn-hangzhou-1.aliyuncs.com/xxxxx/xxxxxxxxxxxxxx?Expires=1671448125&OSSAccessKeyId=xxx |
| Decompress |
boolean |
任意 |
圧縮ファイルを識別して解凍するかどうかを指定します。有効な値:
|
false |
| DecompressMaxLayer |
integer |
任意 |
圧縮ファイルが圧縮パッケージ内に入れ子になっている場合の解凍レイヤーの最大数。最大値: 5。 Decompress が true に設定されている場合、このパラメーターは必須です。 |
1 |
| DecompressMaxFileCount |
integer |
任意 |
解凍するファイルの最大数。最大値: 1000。 Decompress が true に設定されている場合、このパラメーターは必須です。 |
100 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。Alibaba Cloud によってリクエストに対して生成される一意の識別子です。この ID を使用して問題のトラブルシューティングができます。 |
7E0618A9-D5EF-4220-9471-C42B5E92719F |
| HashKey |
string |
ファイル識別子。 |
0a212417e65c26ff133cfff28f6c**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "7E0618A9-D5EF-4220-9471-C42B5E92719F",
"HashKey": "0a212417e65c26ff133cfff28f6c****"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | RequestTooFrequently | Request too frequently, please try again later | |
| 400 | GetFileError | Get file error, please check input params and file size, and make sure upload file success. | |
| 400 | InvalidDownloadUrl | Invalid file download URL. | |
| 400 | FileSizeOverLimit | File size over limit. | |
| 500 | ServerError | ServerError | |
| 500 | SystemBusy | System busy, please try again later. | |
| 403 | NoPermission | caller has no permission |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。