Bir koruma şablonu oluşturur.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
yundun-waf:CreateDefenseTemplate |
create |
*All Resource
|
|
None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
WAF örneğinin kimliği. Not
Geçerli WAF örneğinin kimliğini almak için DescribeInstance API'sini çağırabilirsiniz. |
waf_cdnsdf3**** |
| TemplateName |
string |
Yes |
Oluşturulacak koruma şablonunun adı. Ad 1 ila 255 karakter uzunluğunda olmalı ve Çince karakterler, harfler, rakamlar, alt çizgiler (_), noktalar (.) ve tireler (-) içerebilir. Not
Şablon adları aynı koruma senaryosu (DefenseScene) içinde benzersiz olmalıdır. |
test221 |
| TemplateType |
string |
Yes |
Oluşturulacak koruma şablonunun şablon türü. Geçerli değerler:
|
user_default |
| TemplateStatus |
integer |
Yes |
Oluşturulacak koruma şablonunun durumu. Geçerli değerler:
|
1 |
| DefenseScene |
string |
Yes |
Koruma senaryosu. Daha fazla bilgi için CreateDefenseRule API'sindeki DefenseScene parametresine bakın. |
waf_group |
| TemplateOrigin |
string |
Yes |
Oluşturulacak koruma şablonunun kaynağı. Değeri, kullanıcı tanımlı olduğunu belirten custom olarak ayarlayın. |
custom |
| DefenseSubScene |
string |
No |
Koruma şablonunun alt senaryosu. Bu parametre yalnızca gelişmiş bot yönetimi senaryosu için desteklenir. Valid values:
|
web |
| Description |
string |
No |
Oluşturulacak koruma şablonunun açıklaması. |
test |
| RegionId |
string |
No |
JSON biçimli bir dize olan ayrıntılı şablon bilgileri. Farklı anahtar-değer çiftleri, korunan nesnenin farklı özniteliklerini temsil eder. Daha fazla bilgi için Detail açıklamasına bakın. Not
Bu parametre yalnızca temel korumanın yeni sürümü (waf_base) ve bot yönetiminin yeni sürümü (bot_manager) koruma senaryoları için geçerlidir. Bu parametre, bot yönetiminin yeni sürümü (bot_manager) koruma senaryosu için gereklidir. |
{"trafficFeature":"{\"global\":0,\"excludeStatus\":1,\"conditions\":[{\"key\":\"URL\",\"opValue\":\"not-contain\",\"values\":\"test\"}]}"} |
| ResourceManagerResourceGroupId |
string |
No |
Deneme çalıştırması modunun etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametreyi belirtmezseniz normal bir istek gönderilir. Geçerli değerler:
|
false |
| UnbindResources |
array |
No |
WAF örneğinin bulunduğu bölge. Geçerli değerler:
|
cn-hangzhou |
|
string |
No |
The protected object to unbind. |
abc |
|
| UnbindResourceGroups |
array |
No |
Alibaba Cloud kaynak grubunun kimliği. |
rg-acfm***q |
|
string |
No |
The protected object group to unbind. |
group1 |
Detail parametre açıklaması
Detail parametresinin içeriği, koruma şablonunun koruma senaryosuna (DefenseScene) bağlı olarak değişir.
Web temel korumasının yeni sürümü (waf_base)
Parametre açıklaması
| Ad | Tür | Gerekli | Örnek | Açıklama |
| aiWhitelistStatus | integer | Hayır | 1 | Temel korumanın yeni sürümü için akıllı beyaz listeye alma motorunun durumu. Geçerli değerler: - 0 (varsayılan): Devre dışı. - 1: Etkin. |
Örnek
{
"aiWhitelistStatus": 1
}
Bot yönetiminin yeni sürümü (bot_manager)
Parametre açıklaması
| Ad | Tür | Gerekli | Örnek | Açıklama |
| trafficFeature | String | Hayır | {"global":1,"excludeStatus":1,"staticFile":".css,.js,.jpg,……"} | Bot yönetimi koruma şablonunun JSON dizesi biçiminde açıklanan koruma kapsamı parametre ayarları. Bu parametre, koruma senaryosu (DefenseScene) bot_manager olduğunda gereklidir. Daha fazla bilgi için trafficFeature ayrıntılı parametre ayarları konusuna bakın. |
trafficFeature ayrıntılı parametre ayarları
| Ad | Tür | Gerekli | Örnek | Açıklama |
| global | Integer | Evet | 1 | Koruma kapsamının tüm siteyi kapsayıp kapsamadığını belirtir. Geçerli değerler: - 0: Özel koruma kapsamı. Etkili olacak trafik özelliklerini belirtmek için conditions kullanın. - 1: Küresel koruma. Şablon, korunan nesneye yönelik tüm isteklerde etkili olur. |
| excludeStatus | Integer | Hayır | 1 | Statik kaynakların hariç tutulup tutulmayacağını belirtir. staticFile içinde belirtilen statik dosya son ekleriyle eşleşen istekler bot korumasına girmez. Geçerli değerler: - 0: Statik kaynaklar hariç tutulmaz. - 1: Statik kaynaklar hariç tutulur. Hariç tutulacak statik dosya son eklerini belirtmek için staticFile kullanın. |
| staticFile | String | Hayır | .7z,.aac,.css,.js,.jpg,.png,.pdf,.zip,…… | Virgülle (,) ayrılmış bir dize olarak temsil edilen, hariç tutulacak statik dosya son eklerinin listesi. Her son ek bir nokta (.) ile başlar. Bu parametreyi yalnızca excludeStatus değeri 1 olarak ayarlandığında yapılandırın. |
| conditions | Array | Hayır | [{"key":"URL","opValue":"not-contain","values":"test"}] | JSON dizesi biçiminde açıklanan, özel koruma kapsamı için trafik özellikleri. Bu parametre yalnızca global değeri 0 olarak ayarlandığında yapılandırılabilir. Daha fazla bilgi için Koruma kuralı parametre ayarları konusundaki conditions parametre ayarlarına bakın. |
Örnek
{
"trafficFeature": "{\"global\":0,\"excludeStatus\":1,\"conditions\":[{\"key\":\"URL\",\"opValue\":\"not-contain\",\"values\":\"test\"}]}"
}
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Yanıt yapısı. |
||
| RequestId |
string |
İstek kimliği. |
F48ABDF7-D777-5F26-892A-57349765D7A9 |
| TemplateId |
integer |
Koruma şablonunun kimliği. |
2212 |
Examples
Success response
JSON format
{
"RequestId": "F48ABDF7-D777-5F26-892A-57349765D7A9",
"TemplateId": 2212
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.