Create On Demand Security Group

Provision a new on-demand security group

Request

URI

POST

https://vra-interop-222-139.lvn.broadcom.net/iaas/api/security-groups

COPY

Query Parameters

string

apiVersion

Optional

The version of the API in yyyy-MM-dd format (UTC). For versioning information refer to /iaas/api/about

Request Body

Security group Specification instance

SecurityGroupSpecification of type(s) application/json

Required

Show optional properties

{
    "name": "string",
    "projectId": "e058"
}

{
    "name": "string",
    "projectId": "e058",
    "deploymentId": "123e4567-e89b-12d3-a456-426655440000",
    "customProperties": {
        "customProperties": "string"
    },
    "description": "string",
    "rules": [
        {
            "name": "5756f7e2",
            "protocol": "ANY, TCP, UDP",
            "service": "HTTPS, SSH",
            "ipRangeCidr": "66.170.99.2/32",
            "ports": "443, 1-655535",
            "access": "Allow",
            "direction": "Outbound"
        }
    ],
    "tags": [
        {
            "key": "group",
            "value": "ssh"
        }
    ]
}

string

name

Required

A human-friendly name used as an identifier in APIs that support this option.

string

projectId

Required

The id of the project the current user belongs to.

string

deploymentId

Optional

The id of the deployment that is associated with this resource

object

customProperties

Optional

Additional custom properties that may be used to extend this resource.

string

description

Optional

A human-friendly description.

array of object

rules

Optional

List of security rules.

array of object

tags

Optional

A set of tag keys and optional values that should be set on any resource that is produced from this specification.

Authentication

This operation uses the following authentication methods.

Authorization

Responses

202

Accepted

Returns RequestTracker of type(s) application/json

"RequestTracker Object"

integer As int32 As int32

progress

Required

Progress of the request as percentage.

string

message

Optional

Status message of the request.

string

status

Required

Status of the request.

Possible values are : FINISHED, INPROGRESS, FAILED,

array of string

resources

Optional

Collection of resources.

string

name

Optional

Name of the operation.

string

Required

ID of this request.

string

selfLink

Required

Self link of this request.

string

deploymentId

Optional

ID of the deployment, this request is connected to.

400

Invalid request - bad data

Returns ServiceErrorResponse of type(s) application/json

"ServiceErrorResponse Object"

string

message

Optional

message

string

messageId

Optional

messageId

array of string

stackTrace

Optional

stackTrace

integer As int32 As int32

statusCode

Optional

statusCode

integer As int32 As int32

errorCode

Optional

errorCode

array of string

details

Optional

details

string

serverErrorId

Optional

serverErrorId

string

documentKind

Optional

documentKind

integer As int32 As int32

internalErrorCode

Optional

internalErrorCode

403

Forbidden

Returns ServiceErrorResponse of type(s) application/json

"ServiceErrorResponse Object"

string

message

Optional

message

string

messageId

Optional

messageId

array of string

stackTrace

Optional

stackTrace

integer As int32 As int32

statusCode

Optional

statusCode

integer As int32 As int32

errorCode

Optional

errorCode

array of string

details

Optional

details

string

serverErrorId

Optional

serverErrorId

string

documentKind

Optional

documentKind

integer As int32 As int32

internalErrorCode

Optional

internalErrorCode

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"name:"string","projectId:"string"}' https://{api_host}/iaas/api/security-groups

On This Page

Description

Request

Query Parameters

Request Body

Authentication

Response

202 Response Body

Errors

Security Group Operations

POST

Reconfigure Security Group