Virtual Private Cloud API, gRPC: SecurityGroupService.Get
Returns the specified SecurityGroup resource.
To get the list of all available SecurityGroup resources, make a List request.
gRPC request
rpc Get (GetSecurityGroupRequest) returns (SecurityGroup)
GetSecurityGroupRequest
{
"securityGroupId": "string"
}
Field |
Description |
securityGroupId |
string Required field. ID of the Security Group resource to return. |
SecurityGroup
{
"id": "string",
"folderId": "string",
"createdAt": "google.protobuf.Timestamp",
"name": "string",
"description": "string",
"labels": "string",
"networkId": "string",
"status": "Status",
"rules": [
{
"id": "string",
"description": "string",
"labels": "string",
"direction": "Direction",
"ports": {
"fromPort": "int64",
"toPort": "int64"
},
"protocolName": "string",
"protocolNumber": "int64",
// Includes only one of the fields `cidrBlocks`, `securityGroupId`, `predefinedTarget`
"cidrBlocks": {
"v4CidrBlocks": [
"string"
],
"v6CidrBlocks": [
"string"
]
},
"securityGroupId": "string",
"predefinedTarget": "string"
// end of the list of possible fields
}
],
"defaultForNetwork": "bool"
}
Field |
Description |
id |
string ID of the security group. |
folderId |
string ID of the folder that the security group belongs to. |
createdAt |
Creation timestamp in RFC3339 |
name |
string Name of the security group. |
description |
string Description of the security group. 0-256 characters long. |
labels |
string Resource labels as |
networkId |
string ID of the network that the security group belongs to. |
status |
enum Status Security group status.
|
rules[] |
List of the security group rules. |
defaultForNetwork |
bool Flag that indicates that the security group is the default for the network. |
SecurityGroupRule
Field |
Description |
id |
string ID of the rule. |
description |
string Description of the rule. 0-256 characters long. |
labels |
string Resource labels as |
direction |
enum Direction Required field. The direction of network traffic allowed by this rule.
|
ports |
The range of ports that allow traffic to pass through. Null value means any. |
protocolName |
string Protocol name. Null value means any protocol. |
protocolNumber |
int64 Protocol number from IANA protocol numbers |
cidrBlocks |
CIDR blocks to allow to recieve or send traffic. Includes only one of the fields |
securityGroupId |
string ID of the security group to add rule to. Includes only one of the fields |
predefinedTarget |
string Predefined target. See security groups rules for more information. Includes only one of the fields |
PortRange
Field |
Description |
fromPort |
int64 The lowest port in the range. |
toPort |
int64 The highest port in the range. |
CidrBlocks
Field |
Description |
v4CidrBlocks[] |
string IPv4 CIDR blocks to allow traffic to. |
v6CidrBlocks[] |
string IPv6 CIDR blocks to allow traffic to. |