Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Create Security Group operation


The Create Security Group operation enables you to create a new security group. The security group name must be unique for each Amazon EC2 account.

The following figure shows the sample <items> XML element for the Create Security Group operation. 

Sample <items> XML element for the Create Security Group operation

 <items>
   <item>
       <parameters>
           <group-name></group-name>
       <group-description></group-description>
       </parameters>
   </item>
</items>

The following table shows the adapter request elements for this request. 

Adapter request elements for the Create Security Group operation

Element

Definition

Required

<wsdl-location>

Specifies the target Web Service Description Language (WSDL) URL for Amazon EC2

Examples:

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<endpoint-address>

Specifies the web service endpoint for the adapter to use while performing operations on Amazon EC2 instances across different regions
Default value: US East region: http://us-east-1.ec2.amazonaws.com/

No

<signature-properties>

Specifies the mode for signing the adapter request

Conditional:

  • Required if not specified in the configuration
  • If <signature-properties mode = "key-files">, requires <private-key-file>
     and <certificate-file>
  • If <signature-properties mode = "key-data">, requires <private-key-data> and <certificate-data>
<operation-name>

Contains the name of the operation: create-security-group

Yes

<group-name>

Specifies the name of the security group

Valid values: alphanumeric characters, spaces, dashes, underscores

Yes

<group-description>

Specifies the description for the security group

Valid values: alphanumeric characters, spaces, dashes, underscores

Yes

The following figure shows a sample adapter request for the Create Security Group operation. 

Sample adapter request for the Create Security Group operation

<amazon-ec2-request>
   <wsdl-location>http://ec2.amazonaws.com/doc/2009-11-30/</wsdl-location>
   <endpoint-address>http://us-east-1.ec2.amazonaws.com/</endpoint-address>
   <signature-properties mode = "key-files">
       <private-key-file>C:\Security\
pk-MJ5GIUNLM2XJ3VRJSYTKOFDWILELDQHB.PEM</private-key-file>
       <certificate-file>C:\Security\
cert-MJ5GIUNLM2XJ3VRJSYTKOFDWILELDQHB.PEM</certificate-file>
   </signature-properties>
   <operation-name>create-security-group</operation-name>
   <parameters>
       <group-name>TestAPISecurityGroup</group-name>
       <group-description>Test API SecurityGroup</group-description>
   </parameters>
</amazon-ec2-request>

The following figure shows the sample adapter response for the Create Security Group operation. 

Sample adapter response for the Create Security Group operation

<amazon-ec2-response>
   <metadata>
       <status>success</status>
   </metadata>
   <CreateSecurityGroupResponse>
       <requestId>dedeb30e-93f0-4ad6-9071-1a92b07c06bc</requestId>
       <return>true</return>
   </CreateSecurityGroupResponse>
</amazon-ec2-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*