POST v1/core/accounts/{accId}/accessgroups

Create a new access group with default policy

Request Information

Parameters

Name	Description	Additional information
accId	the account id	Define this parameter in the request URI.
value	the new access group and default policy objects	Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:

{
  "Group": {
    "ID": 1,
    "AccountID": 2,
    "Name": "sample string 3",
    "Status": "Enabled|Disabled|Enabled|OutOfBand",
    "PrivateAccessMFA": "Disabled|Enabled|OutOfBand"
  },
  "Policy": {
    "AccessGroupID": 1,
    "Status": "Disabled|Enabled|OutOfBand",
    "AccessRate": 2,
    "UpstreamACL": {
      "ACLs": [
        {
          "RuleAction": "Deny|Permit|Permit",
          "ServiceProtocol": "TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE",
          "SourceAddress": "sample string 1",
          "SourceMask": "sample string 2",
          "SourceOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "SourceServiceStartPort": 3,
          "SourceServiceEndPort": 4,
          "DestinationAddress": "sample string 5",
          "DestinationMask": "sample string 6",
          "DestinationOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "DestinationServiceStartPort": 7,
          "DestinationServiceEndPort": 8
        },
        {
          "RuleAction": "Deny|Permit|Permit",
          "ServiceProtocol": "TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE",
          "SourceAddress": "sample string 1",
          "SourceMask": "sample string 2",
          "SourceOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "SourceServiceStartPort": 3,
          "SourceServiceEndPort": 4,
          "DestinationAddress": "sample string 5",
          "DestinationMask": "sample string 6",
          "DestinationOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "DestinationServiceStartPort": 7,
          "DestinationServiceEndPort": 8
        },
        {
          "RuleAction": "Deny|Permit|Permit",
          "ServiceProtocol": "TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE",
          "SourceAddress": "sample string 1",
          "SourceMask": "sample string 2",
          "SourceOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "SourceServiceStartPort": 3,
          "SourceServiceEndPort": 4,
          "DestinationAddress": "sample string 5",
          "DestinationMask": "sample string 6",
          "DestinationOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "DestinationServiceStartPort": 7,
          "DestinationServiceEndPort": 8
        }
      ]
    },
    "DownstreamACL": {
      "ACLs": [
        {
          "RuleAction": "Deny|Permit|Permit",
          "ServiceProtocol": "TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE",
          "SourceAddress": "sample string 1",
          "SourceMask": "sample string 2",
          "SourceOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "SourceServiceStartPort": 3,
          "SourceServiceEndPort": 4,
          "DestinationAddress": "sample string 5",
          "DestinationMask": "sample string 6",
          "DestinationOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "DestinationServiceStartPort": 7,
          "DestinationServiceEndPort": 8
        },
        {
          "RuleAction": "Deny|Permit|Permit",
          "ServiceProtocol": "TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE",
          "SourceAddress": "sample string 1",
          "SourceMask": "sample string 2",
          "SourceOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "SourceServiceStartPort": 3,
          "SourceServiceEndPort": 4,
          "DestinationAddress": "sample string 5",
          "DestinationMask": "sample string 6",
          "DestinationOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "DestinationServiceStartPort": 7,
          "DestinationServiceEndPort": 8
        },
        {
          "RuleAction": "Deny|Permit|Permit",
          "ServiceProtocol": "TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE",
          "SourceAddress": "sample string 1",
          "SourceMask": "sample string 2",
          "SourceOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "SourceServiceStartPort": 3,
          "SourceServiceEndPort": 4,
          "DestinationAddress": "sample string 5",
          "DestinationMask": "sample string 6",
          "DestinationOperation": "Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range",
          "DestinationServiceStartPort": 7,
          "DestinationServiceEndPort": 8
        }
      ]
    }
  }
}

text/javascript

Sample:

{"Group":{"ID":1,"AccountID":2,"Name":"sample string 3","Status":0,"PrivateAccessMFA":0},"Policy":{"AccessGroupID":1,"Status":0,"AccessRate":2,"UpstreamACL":{"ACLs":[{"RuleAction":0,"ServiceProtocol":0,"SourceAddress":"sample string 1","SourceMask":"sample string 2","SourceOperation":1,"SourceServiceStartPort":3,"SourceServiceEndPort":4,"DestinationAddress":"sample string 5","DestinationMask":"sample string 6","DestinationOperation":1,"DestinationServiceStartPort":7,"DestinationServiceEndPort":8},{"RuleAction":0,"ServiceProtocol":0,"SourceAddress":"sample string 1","SourceMask":"sample string 2","SourceOperation":1,"SourceServiceStartPort":3,"SourceServiceEndPort":4,"DestinationAddress":"sample string 5","DestinationMask":"sample string 6","DestinationOperation":1,"DestinationServiceStartPort":7,"DestinationServiceEndPort":8},{"RuleAction":0,"ServiceProtocol":0,"SourceAddress":"sample string 1","SourceMask":"sample string 2","SourceOperation":1,"SourceServiceStartPort":3,"SourceServiceEndPort":4,"DestinationAddress":"sample string 5","DestinationMask":"sample string 6","DestinationOperation":1,"DestinationServiceStartPort":7,"DestinationServiceEndPort":8}]},"DownstreamACL":{"ACLs":[{"RuleAction":0,"ServiceProtocol":0,"SourceAddress":"sample string 1","SourceMask":"sample string 2","SourceOperation":1,"SourceServiceStartPort":3,"SourceServiceEndPort":4,"DestinationAddress":"sample string 5","DestinationMask":"sample string 6","DestinationOperation":1,"DestinationServiceStartPort":7,"DestinationServiceEndPort":8},{"RuleAction":0,"ServiceProtocol":0,"SourceAddress":"sample string 1","SourceMask":"sample string 2","SourceOperation":1,"SourceServiceStartPort":3,"SourceServiceEndPort":4,"DestinationAddress":"sample string 5","DestinationMask":"sample string 6","DestinationOperation":1,"DestinationServiceStartPort":7,"DestinationServiceEndPort":8},{"RuleAction":0,"ServiceProtocol":0,"SourceAddress":"sample string 1","SourceMask":"sample string 2","SourceOperation":1,"SourceServiceStartPort":3,"SourceServiceEndPort":4,"DestinationAddress":"sample string 5","DestinationMask":"sample string 6","DestinationOperation":1,"DestinationServiceStartPort":7,"DestinationServiceEndPort":8}]}}}

application/xml, text/xml

Sample:

<AccessGroupandPolicy xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/pbnb_models">
  <Group>
    <AccountID>2</AccountID>
    <ID>1</ID>
    <Name>sample string 3</Name>
    <PrivateAccessMFA>Disabled|Enabled|OutOfBand</PrivateAccessMFA>
    <Status>Enabled|Disabled|Enabled|OutOfBand</Status>
  </Group>
  <Policy>
    <AccessGroupID>1</AccessGroupID>
    <AccessRate>2</AccessRate>
    <DownstreamACL>
      <ACLs>
        <IPACL.ACLRule>
          <DestinationAddress>sample string 5</DestinationAddress>
          <DestinationMask>sample string 6</DestinationMask>
          <DestinationOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</DestinationOperation>
          <DestinationServiceEndPort>8</DestinationServiceEndPort>
          <DestinationServiceStartPort>7</DestinationServiceStartPort>
          <RuleAction>Deny|Permit|Permit</RuleAction>
          <ServiceProtocol>TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE</ServiceProtocol>
          <SourceAddress>sample string 1</SourceAddress>
          <SourceMask>sample string 2</SourceMask>
          <SourceOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</SourceOperation>
          <SourceServiceEndPort>4</SourceServiceEndPort>
          <SourceServiceStartPort>3</SourceServiceStartPort>
        </IPACL.ACLRule>
        <IPACL.ACLRule>
          <DestinationAddress>sample string 5</DestinationAddress>
          <DestinationMask>sample string 6</DestinationMask>
          <DestinationOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</DestinationOperation>
          <DestinationServiceEndPort>8</DestinationServiceEndPort>
          <DestinationServiceStartPort>7</DestinationServiceStartPort>
          <RuleAction>Deny|Permit|Permit</RuleAction>
          <ServiceProtocol>TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE</ServiceProtocol>
          <SourceAddress>sample string 1</SourceAddress>
          <SourceMask>sample string 2</SourceMask>
          <SourceOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</SourceOperation>
          <SourceServiceEndPort>4</SourceServiceEndPort>
          <SourceServiceStartPort>3</SourceServiceStartPort>
        </IPACL.ACLRule>
        <IPACL.ACLRule>
          <DestinationAddress>sample string 5</DestinationAddress>
          <DestinationMask>sample string 6</DestinationMask>
          <DestinationOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</DestinationOperation>
          <DestinationServiceEndPort>8</DestinationServiceEndPort>
          <DestinationServiceStartPort>7</DestinationServiceStartPort>
          <RuleAction>Deny|Permit|Permit</RuleAction>
          <ServiceProtocol>TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE</ServiceProtocol>
          <SourceAddress>sample string 1</SourceAddress>
          <SourceMask>sample string 2</SourceMask>
          <SourceOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</SourceOperation>
          <SourceServiceEndPort>4</SourceServiceEndPort>
          <SourceServiceStartPort>3</SourceServiceStartPort>
        </IPACL.ACLRule>
      </ACLs>
    </DownstreamACL>
    <Status>Disabled|Enabled|OutOfBand</Status>
    <UpstreamACL>
      <ACLs>
        <IPACL.ACLRule>
          <DestinationAddress>sample string 5</DestinationAddress>
          <DestinationMask>sample string 6</DestinationMask>
          <DestinationOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</DestinationOperation>
          <DestinationServiceEndPort>8</DestinationServiceEndPort>
          <DestinationServiceStartPort>7</DestinationServiceStartPort>
          <RuleAction>Deny|Permit|Permit</RuleAction>
          <ServiceProtocol>TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE</ServiceProtocol>
          <SourceAddress>sample string 1</SourceAddress>
          <SourceMask>sample string 2</SourceMask>
          <SourceOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</SourceOperation>
          <SourceServiceEndPort>4</SourceServiceEndPort>
          <SourceServiceStartPort>3</SourceServiceStartPort>
        </IPACL.ACLRule>
        <IPACL.ACLRule>
          <DestinationAddress>sample string 5</DestinationAddress>
          <DestinationMask>sample string 6</DestinationMask>
          <DestinationOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</DestinationOperation>
          <DestinationServiceEndPort>8</DestinationServiceEndPort>
          <DestinationServiceStartPort>7</DestinationServiceStartPort>
          <RuleAction>Deny|Permit|Permit</RuleAction>
          <ServiceProtocol>TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE</ServiceProtocol>
          <SourceAddress>sample string 1</SourceAddress>
          <SourceMask>sample string 2</SourceMask>
          <SourceOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</SourceOperation>
          <SourceServiceEndPort>4</SourceServiceEndPort>
          <SourceServiceStartPort>3</SourceServiceStartPort>
        </IPACL.ACLRule>
        <IPACL.ACLRule>
          <DestinationAddress>sample string 5</DestinationAddress>
          <DestinationMask>sample string 6</DestinationMask>
          <DestinationOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</DestinationOperation>
          <DestinationServiceEndPort>8</DestinationServiceEndPort>
          <DestinationServiceStartPort>7</DestinationServiceStartPort>
          <RuleAction>Deny|Permit|Permit</RuleAction>
          <ServiceProtocol>TCP|UDP|ICMP|IP|AH|ESP|IPIP|GRE|UDP|ICMP|IP|AH|ESP|IPIP|GRE</ServiceProtocol>
          <SourceAddress>sample string 1</SourceAddress>
          <SourceMask>sample string 2</SourceMask>
          <SourceOperation>Equals|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range|LessThan|GreaterThan|Range</SourceOperation>
          <SourceServiceEndPort>4</SourceServiceEndPort>
          <SourceServiceStartPort>3</SourceServiceStartPort>
        </IPACL.ACLRule>
      </ACLs>
    </UpstreamACL>
  </Policy>
</AccessGroupandPolicy>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'AccessGroupandPolicy'.

application/bson

Sample:

(	GroupXIDAccountIDNamesample string 3StatusPrivateAccessMFAPolicy�AccessGroupIDStatusAccessRateUpstreamACL6ACLs+0_RuleActionServiceProtocolSourceAddresssample string 1SourceMasksample string 2SourceOperationSourceServiceStartPortSourceServiceEndPortDestinationAddresssample string 5DestinationMasksample string 6DestinationOperationDestinationServiceStartPortDestinationServiceEndPort1_RuleActionServiceProtocolSourceAddresssample string 1SourceMasksample string 2SourceOperationSourceServiceStartPortSourceServiceEndPortDestinationAddresssample string 5DestinationMasksample string 6DestinationOperationDestinationServiceStartPortDestinationServiceEndPort2_RuleActionServiceProtocolSourceAddresssample string 1SourceMasksample string 2SourceOperationSourceServiceStartPortSourceServiceEndPortDestinationAddresssample string 5DestinationMasksample string 6DestinationOperationDestinationServiceStartPortDestinationServiceEndPortDownstreamACL6ACLs+0_RuleActionServiceProtocolSourceAddresssample string 1SourceMasksample string 2SourceOperationSourceServiceStartPortSourceServiceEndPortDestinationAddresssample string 5DestinationMasksample string 6DestinationOperationDestinationServiceStartPortDestinationServiceEndPort1_RuleActionServiceProtocolSourceAddresssample string 1SourceMasksample string 2SourceOperationSourceServiceStartPortSourceServiceEndPortDestinationAddresssample string 5DestinationMasksample string 6DestinationOperationDestinationServiceStartPortDestinationServiceEndPort2_RuleActionServiceProtocolSourceAddresssample string 1SourceMasksample string 2SourceOperationSourceServiceStartPortSourceServiceEndPortDestinationAddresssample string 5DestinationMasksample string 6DestinationOperationDestinationServiceStartPortDestinationServiceEndPort

Response Information

The created access group

Response body formats

application/json, text/json

Sample:

{
  "Success": true,
  "Data": {
    "ID": 1,
    "AccountID": 2,
    "Name": "sample string 3",
    "Status": "Enabled|Disabled|OutOfBand",
    "PrivateAccessMFA": "Disabled|OutOfBand"
  },
  "ErrorCode": 2,
  "ErrorDescription": "sample string 3",
  "Meta": "sample string 4"
}

text/javascript

Sample:

{"Success":true,"Data":{"ID":1,"AccountID":2,"Name":"sample string 3","Status":0,"PrivateAccessMFA":0},"ErrorCode":2,"ErrorDescription":"sample string 3","Meta":"sample string 4"}

application/xml, text/xml

Sample:

<PBNBReturnOfAccessGroupCA1DLPoZ xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/pbnb_models">
  <Data>
    <AccountID>2</AccountID>
    <ID>1</ID>
    <Name>sample string 3</Name>
    <PrivateAccessMFA>Disabled|OutOfBand</PrivateAccessMFA>
    <Status>Enabled|Disabled|OutOfBand</Status>
  </Data>
  <ErrorCode>2</ErrorCode>
  <ErrorDescription>sample string 3</ErrorDescription>
  <Meta>sample string 4</Meta>
  <Success>true</Success>
</PBNBReturnOfAccessGroupCA1DLPoZ>

application/bson

Sample:

�SuccessDataXIDAccountIDNamesample string 3StatusPrivateAccessMFAErrorCodeErrorDescriptionsample string 3Metasample string 4