華為云計(jì)算 云知識(shí) 創(chuàng)建安全組規(guī)則CreateSecurityGroupRule
創(chuàng)建安全組規(guī)則CreateSecurityGroupRule

 

功能介紹

創(chuàng)建安全組規(guī)則。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

POST /v1/{project_id}/security-group-rules

請(qǐng)求參數(shù)

表1 請(qǐng)求參數(shù)

名稱

是否必選

參數(shù)類型

說明

security_group_rule

security_group_rule object

安全組規(guī)則對(duì)象,請(qǐng)參見表2。

表2 security_group_rule字段說明

名稱

是否必選

參數(shù)類型

說明

security_group_id

String

所屬安全組ID

description

String

  • 功能說明:安全組規(guī)則描述
  • 取值范圍:0-255個(gè)字符,支持?jǐn)?shù)字、字母、中文字符

direction

String

  • 功能說明:安全組規(guī)則出入控制方向
  • 取值范圍:
    • egress:出方向
    • ingress:入方向

ethertype

String

  • 功能說明:IP地址協(xié)議類型
  • 取值范圍:IPv4,IPv6
  • 約束:不填默認(rèn)值為IPv4

protocol

String

  • 功能說明:協(xié)議類型
  • 取值范圍:icmp、tcp、udp、icmpv6或IP協(xié)議號(hào)(0~255)
  • 約束:為空表示支持所有協(xié)議。協(xié)議為icmpv6時(shí),網(wǎng)絡(luò)類型應(yīng)該為IPv6;協(xié)議為icmp時(shí),網(wǎng)絡(luò)類型應(yīng)該為IPv4

port_range_min

Integer

port_range_max

Integer

remote_ip_prefix

String

  • 功能說明:遠(yuǎn)端IP地址,當(dāng)direction是egress時(shí)為虛擬機(jī)訪問端的地址,當(dāng)direction是ingress時(shí)為訪問虛擬機(jī)的地址
  • 取值范圍:IP地址,或者cidr格式
  • 約束:和remote_group_id,remote_address_group_id互斥

remote_group_id

String

  • 功能說明:對(duì)端安全組id
  • 約束:和remote_ip_prefix,remote_address_group_id互斥

remote_address_group_id

String

  • 功能說明:遠(yuǎn)端IP地址組ID。您可以登錄管理控制臺(tái),在IP地址組頁面查看該ID。
  • 約束:和remote_ip_prefix,remote_group_id互斥

請(qǐng)求示例

  • 創(chuàng)建一條入方向安全組規(guī)則,所在安全組id為a7734e61-b545-452d-a3cd-0189cbd9747a。
    POST https://{Endpoint}/v1/{project_id}/security-group-rules
    
    {
        "security_group_rule": {
            "direction": "ingress", 
            "port_range_min": "80", 
            "ethertype": "IPv4", 
            "port_range_max": "80", 
            "protocol": "tcp", 
            "remote_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", 
            "security_group_id": "a7734e61-b545-452d-a3cd-0189cbd9747a"
        }
    }

響應(yīng)參數(shù)

表3 響應(yīng)參數(shù)

名稱

參數(shù)類型

說明

security_group_rule

security_group_rule object

安全組規(guī)則對(duì)象,請(qǐng)參見表4

表4 security_group_rule對(duì)象

名稱

參數(shù)類型

說明

id

String

安全組規(guī)則標(biāo)識(shí)

description

String

  • 功能說明:安全組規(guī)則描述
  • 取值范圍:0-255個(gè)字符,支持?jǐn)?shù)字、字母、中文字符

security_group_id

String

安全組標(biāo)識(shí)

direction

String

  • 功能說明:出入控制方向
  • 取值范圍:
    • egress:出方向
    • ingress:入方向

ethertype

String

  • 功能說明:IP協(xié)議類型
  • 取值范圍:IPv4,IPv6

protocol

String

  • 功能說明:協(xié)議類型
  • 取值范圍:icmp、tcp、udp、icmpv6等
  • 約束:為空表示支持所有協(xié)議

port_range_min

Integer

port_range_max

Integer

remote_ip_prefix

String

  • 功能說明:遠(yuǎn)端IP地址,當(dāng)direction是egress時(shí)為虛擬機(jī)訪問端的地址,當(dāng)direction是ingress時(shí)為訪問虛擬機(jī)的地址
  • 取值范圍:IP地址,或者cidr格式
  • 約束:和remote_group_id,remote_address_group_id互斥

remote_group_id

String

  • 功能說明:對(duì)端安全組id
  • 約束:和remote_ip_prefix,remote_address_group_id互斥

remote_address_group_id

String

  • 功能說明:遠(yuǎn)端IP地址組ID
  • 約束:和remote_ip_prefix,remote_group_id互斥

tenant_id

String

  • 功能說明:安全組規(guī)則所屬項(xiàng)目ID

響應(yīng)示例

{
    "security_group_rule": {
        "direction": "ingress",
        "ethertype": "IPv4",
        "id": "2bc0accf-312e-429a-956e-e4407625eb62",
        "description": "",
        "port_range_max": 80,
        "port_range_min": 80,
        "protocol": "tcp",
        "remote_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
        "remote_ip_prefix": null,
        "security_group_id": "a7734e61-b545-452d-a3cd-0189cbd9747a",
        "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
        "remote_address_group_id": null
    }
}

狀態(tài)碼

請(qǐng)參見狀態(tài)碼

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。