シグネチャの作成
新しいシグネチャを作成します。
必要な権限
MEMBER以上のロールが必要です。
HTTPリクエスト
POST /api/sonar/signatures
cURL例
curl -H "Authorization: Bearer <API_KEY>" \
-d signature="sig" \
-d capecs="CAPEC-1" \
-X POST \
https://HOSTNAME/api/sonar/signatures
リクエストパラメータ
| キー | 必須 | 型 | 説明 | 備考 |
|---|---|---|---|---|
| guid | × | 文字列 | シグネチャ識別子 | 36文字GUID。未設定時はランダム生成 |
| signature | ○ | 文字列 | シグネチャコード | 最小1文字、最大255文字 |
| description | × | 文字列 | シグネチャ説明 | 最大2000文字 |
| app_code | × | 文字列 | アプリコード | 最小1文字、最大50文字 |
| capecs | ○ | 文字列一覧 | CAPEC ID一覧 | カンマ(,)区切りのCAPEC ID一覧 |
正常応答
{}
エラー応答
必須パラメータが不足している場合
HTTPステータスコード 400
{
"error_code": "null-argument",
"error_msg": "signature should be not null"
}
識別子がGUID形式ではない場合
HTTPステータスコード 400
{
"error_code": "invalid-param-type",
"error_msg": "guid should be guid type."
}
シグネチャコードの長さが超過した場合
HTTPステータスコード 400
{
"error_code": "invalid-argument",
"error_msg": "'signature' must be shorter than or equal to 255 characters."
}
CAPEC IDの形式が無効な場合
HTTPステータスコード 400
{
"error_code": "invalid-argument",
"error_msg": "invalid capec format: invalid-capec-id"
}
権限がない場合
HTTPステータスコード 500
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}