Skip to main content

Get a security group by its identifier

GET 
/projects/:projectId/zones/:zoneName/securitygroups/:securityGroupId

Get the Security Group resource with its id in the path.

Request​

Path Parameters

    projectId stringrequired

    Project Identifier

    zoneName stringrequired

    Zone name

    securityGroupId stringrequired

    Security Group Identifier

Header Parameters

    X-API-Key string

    Your SIU token if you use this API through Orange Developer.

    Authorization string

    Bearer access token authentication if you use this API through Orange Developer or Orange Developer Inside.

    X-Requester-Id string

    Your SIU Id if you use this API through Orange Developer Inside.

Responses​

Ok

Schema

    name stringrequired

    Possible values: <= 40 characters, Value must match regular expression [A-Za-z0-9-]

    Unique resource name. This attribute can not be updated.

    description string

    Resource description

    tags

    object

    Tags associated with the resource

    property name* string
    id uuidrequired

    Resource identifier.

    hRef urirequired

    Hypertext reference of the resource.

    createdDate date-timerequired

    Creation date of the resource.

    lastModifiedDate date-timerequired

    Date of the last modification of the resource.

    lastRequesterId stringrequired

    Identifier of the user of the last create/update/delete operation requested on the resource.

    provisioningState BasicStateEnum (string)required

    Possible values: [creating, updating, deleting, active, error]

    Provisioning state of the resource. Possible state:

    • creating: resource creation in progress
    • updating: resource update in progress
    • deleting: resource deletion in progress
    • active: resource created/updated successfully
    • error: resource in error because the last creation/update/deletion failed

    securityRules

    object[]

    required

    Possible values: >= 1

    List of IP filtering rules of the security group. NB: temporary impact on modification.

  • Array [

    • hRef urirequired

    Hypertext reference to the Security Rule details.

    name stringrequired

    Possible values: <= 40 characters, Value must match regular expression [-_a-zA-Z0-9]

    Name of the security rule. Must be unique within the Security Group. Cannot be updated.

    description string

    Description of the security rule.

    matchRemoteIpSubnets string[]required

    Possible values: >= 1, <= 10

    List of remote IP subnets to match, in CIDR format.

    matchDirections SecurityRuleDirectionEnum (string)[]required

    Possible values: [ingress, egress], >= 1, <= 9

    List of directions to match.

    matchProtocols string[]

    Possible values: <= 9

    List of protocols to match. Possible values: ah, dccp, egp, esp, gre, icmp, igmp, ipip, ipv6-encap, ipv6-frag, ipv6-icmp, ipv6-nonxt, ipv6-opts, ipv6-route, ospf, pgm, rsvp, sctp, tcp, udp, udplite, vrrp... or numerical values.

    matchPortRanges string[]

    Possible values: <= 10

    List of port ranges to match. Item format : ["port_range_min-port_range_max"]. For ICMP protocol, use port_range_min for the ICMP type and port_range_max for the ICMP code.

  • ]

Loading...