功能介紹
查詢指定彈性 云服務(wù)器 的安全組。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v2.1/{project_id}/servers/{server_id}/os-security-groups
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請參見獲取項(xiàng)目ID。 |
|
server_id |
是 |
云服務(wù)器ID。 |
請求消息
無
響應(yīng)消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
description |
是 |
String |
安全組描述信息，長度0-255 |
|
id |
是 |
String |
安全組ID，UUID格式 |
|
name |
是 |
String |
安全組名字，長度0-255 |
|
rules |
是 |
Array of objects |
|
|
tenant_id |
是 |
String |
租戶ID或項(xiàng)目ID |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
parent_group_id |
是 |
String |
相關(guān)聯(lián)的安全組ID，UUID格式。 |
|
ip_protocol |
是 |
String |
協(xié)議類型或直接指定IP協(xié)議號，取值可為icmp，tcp，udp或IP協(xié)議號。 |
|
from_port |
是 |
Integer |
起始端口，范圍1-65535，且不大于to_port。 ip_protocol設(shè)置為icmp時(shí)，from_port表示type，范圍是0-255。 |
|
to_port |
是 |
Integer |
終止端口，范圍1-65535，且不小于from_port。 ip_protocol設(shè)置為icmp時(shí)，to_port表示code，范圍是0-255，且如果from_port為-1，to_port為-1表示任意ICMP報(bào)文。 |
|
ip_range |
是 |
Object |
ip_range或者group參數(shù)的值，必須有一個(gè)為空。 |
|
group |
是 |
Object |
ip_range或者group參數(shù)的值，必須有一個(gè)為空。 |
|
id |
是 |
String |
安全組規(guī)則ID，UUID格式。 |
請求示例
查詢指定云服務(wù)器的安全組。
GET https://{endpoint}/v2.1/e73621affb8f44e1bc01898747ca09d4/servers/65fae4c2-3a09-46c6-af12-3b04f1fdba1e/os-security-groups
響應(yīng)示例
{
"security_groups": [
{
"rules": [
{
"from_port": null,
"group": {
"tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
"name": "default"
},
"ip_protocol": null,
"to_port": null,
"parent_group_id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450",
"ip_range": {},
"id": "bb3cc988-e06a-49f6-b668-600e8bf193ee"
},
{
"from_port": null,
"group": {
"tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
"name": "default"
},
"ip_protocol": null,
"to_port": null,
"parent_group_id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450",
"ip_range": {},
"id": "f9371051-d7e1-4be4-8748-77b1e0913730"
}
],
"tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
"description": "default",
"id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450",
"name": "default"
},
{
"rules": [
{
"from_port": 200,
"group": {},
"ip_protocol": "tcp",
"to_port": 400,
"parent_group_id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5",
"ip_range": {
"cidr": "0.0.0.0/0"
},
"id": "3330120d-bbd1-4a73-bda9-0196a84d5670"
},
{
"from_port": 201,
"group": {},
"ip_protocol": "tcp",
"to_port": 400,
"parent_group_id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5",
"ip_range": {
"cidr": "0.0.0.0/0"
},
"id": "b550c9a6-970a-462d-984e-265e88020818"
}
],
"tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
"description": "desc-sg",
"id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5",
"name": "test-sg"
}
]
}
返回值
請參考通用請求返回值。
