CloudStackSecurityGroupExtension (Apache jclouds 1.7.3 API)

java.lang.Object
- org.jclouds.cloudstack.compute.extensions.CloudStackSecurityGroupExtension

All Implemented Interfaces:

SecurityGroupExtension
```
public class CloudStackSecurityGroupExtension
extends Object
implements SecurityGroupExtension
```
An extension to compute service to allow for the manipulation of SecurityGroups. Implementation is optional by providers.

Author:

Andrew Bayer

Field Summary

Fields
Modifier and Type	Field and Description
`protected CloudStackApi`	`api`
`protected BlockUntilJobCompletesAndReturnResult`	`blockUntilJobCompletesAndReturnResult`
`protected com.google.common.base.Function<SecurityGroup,SecurityGroup>`	`groupConverter`
`protected com.google.common.cache.LoadingCache<ZoneAndName,SecurityGroup>`	`groupCreator`
`protected com.google.common.base.Predicate<String>`	`jobComplete`
`protected com.google.common.base.Supplier<Set<? extends Location>>`	`locations`
`protected GroupNamingConvention.Factory`	`namingConvention`

Constructor Summary

Constructors
Constructor and Description
`CloudStackSecurityGroupExtension(CloudStackApi api, com.google.common.base.Function<SecurityGroup,SecurityGroup> groupConverter, com.google.common.cache.LoadingCache<ZoneAndName,SecurityGroup> groupCreator, GroupNamingConvention.Factory namingConvention, com.google.common.base.Supplier<Set<? extends Location>> locations, BlockUntilJobCompletesAndReturnResult blockUntilJobCompletesAndReturnResult, com.google.common.base.Predicate<String> jobComplete)`

Method Summary

Methods
Modifier and Type	Method and Description
`SecurityGroup`	`addIpPermission(IpPermission ipPermission, SecurityGroup group)` Add a @{link IpPermission} to an existing @{link SecurityGroup}.
`SecurityGroup`	`addIpPermission(IpProtocol protocol, int startPort, int endPort, com.google.common.collect.Multimap<String,String> tenantIdGroupNamePairs, Iterable<String> ipRanges, Iterable<String> groupIds, SecurityGroup group)` Add a @{link IpPermission} to an existing @{link SecurityGroup}, based on the parameters given.
`SecurityGroup`	`createSecurityGroup(String name, Location location)` Create a new @{link SecurityGroup} from the parameters given.
`SecurityGroup`	`getSecurityGroupById(String id)` Get a security group by id.
`Set<SecurityGroup>`	`listSecurityGroups()` List security groups.
`Set<SecurityGroup>`	`listSecurityGroupsForNode(String id)` List security groups for a given instance given the instance's ID.
`Set<SecurityGroup>`	`listSecurityGroupsInLocation(Location location)` Note that for the time being, security groups are not scoped by location in CloudStack, so this will simply return listSecurityGroups().
`SecurityGroup`	`removeIpPermission(IpPermission ipPermission, SecurityGroup group)` Remove a @{link IpPermission} from an existing @{link SecurityGroup}.
`SecurityGroup`	`removeIpPermission(IpProtocol protocol, int startPort, int endPort, com.google.common.collect.Multimap<String,String> tenantIdGroupNamePairs, Iterable<String> ipRanges, Iterable<String> groupIds, SecurityGroup group)` Remove a @{link IpPermission} from an existing @{link SecurityGroup}, based on the parameters given.
`boolean`	`removeSecurityGroup(String id)` Remove an existing @{link SecurityGroup}, and its permissions.
`boolean`	`supportsGroupIds()` Returns true if this SecurityGroupExtension supports group IDs.
`boolean`	`supportsPortRangesForGroups()` Returns true if this SecurityGroupExtension supports port ranges for group authorization.
`boolean`	`supportsTenantIdGroupIdPairs()` Returns true if this SecurityGroupExtension supports tenant ID + group ID pairs.
`boolean`	`supportsTenantIdGroupNamePairs()` Returns true if this SecurityGroupExtension supports tenant ID + group name pairs.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - api
```
protected final CloudStackApi api
```
  - groupConverter
```
protected final com.google.common.base.Function<SecurityGroup,SecurityGroup> groupConverter
```
  - groupCreator
```
protected final com.google.common.cache.LoadingCache<ZoneAndName,SecurityGroup> groupCreator
```
  - namingConvention
```
protected final GroupNamingConvention.Factory namingConvention
```
  - locations
```
protected final com.google.common.base.Supplier<Set<? extends Location>> locations
```
  - blockUntilJobCompletesAndReturnResult
```
protected final BlockUntilJobCompletesAndReturnResult blockUntilJobCompletesAndReturnResult
```
  - jobComplete
```
protected final com.google.common.base.Predicate<String> jobComplete
```
- Constructor Detail
  - CloudStackSecurityGroupExtension
```
@Inject
public CloudStackSecurityGroupExtension(CloudStackApi api,
                                       com.google.common.base.Function<SecurityGroup,SecurityGroup> groupConverter,
                                       com.google.common.cache.LoadingCache<ZoneAndName,SecurityGroup> groupCreator,
                                       GroupNamingConvention.Factory namingConvention,
                                       com.google.common.base.Supplier<Set<? extends Location>> locations,
                                       BlockUntilJobCompletesAndReturnResult blockUntilJobCompletesAndReturnResult,
                                       com.google.common.base.Predicate<String> jobComplete)
```
- Method Detail
  - listSecurityGroups
```
public Set<SecurityGroup> listSecurityGroups()
```
    Description copied from interface: SecurityGroupExtension
    
    List security groups.
    
    Specified by:
    
    listSecurityGroups in interface SecurityGroupExtension
    
    Returns:
    The set of @{link SecurityGroup}s we have access to.
  - listSecurityGroupsInLocation
```
public Set<SecurityGroup> listSecurityGroupsInLocation(Location location)
```
    Note that for the time being, security groups are not scoped by location in CloudStack, so this will simply return listSecurityGroups().
    
    Specified by:
    
    listSecurityGroupsInLocation in interface SecurityGroupExtension
    
    Parameters:
    location -
    
    Returns:
    security groups
  - listSecurityGroupsForNode
```
public Set<SecurityGroup> listSecurityGroupsForNode(String id)
```
    Description copied from interface: SecurityGroupExtension
    
    List security groups for a given instance given the instance's ID.
    
    Specified by:
    
    listSecurityGroupsForNode in interface SecurityGroupExtension
    
    Returns:
    The set of @{link SecurityGroup}s for the given instance..
  - getSecurityGroupById
```
public SecurityGroup getSecurityGroupById(String id)
```
    Description copied from interface: SecurityGroupExtension
    
    Get a security group by id.
    
    Specified by:
    
    getSecurityGroupById in interface SecurityGroupExtension
    
    Returns:
    The @{link SecurityGroup}, if it exists.
  - createSecurityGroup
```
public SecurityGroup createSecurityGroup(String name,
                                Location location)
```
    Description copied from interface: SecurityGroupExtension
    
    Create a new @{link SecurityGroup} from the parameters given.
    
    Specified by:
    
    createSecurityGroup in interface SecurityGroupExtension
    
    Parameters:
    name - The name of the security group
    location - The @{link Location} of the security group
    
    Returns:
    The SecurityGroup that has been created.
  - removeSecurityGroup
```
public boolean removeSecurityGroup(String id)
```
    Description copied from interface: SecurityGroupExtension
    
    Remove an existing @{link SecurityGroup}, and its permissions.
    
    Specified by:
    
    removeSecurityGroup in interface SecurityGroupExtension
    
    Parameters:
    id - The id of the SecurityGroup to delete.
    
    Returns:
    true if we were able to remove the group, false otherwise.
  - addIpPermission
```
public SecurityGroup addIpPermission(IpPermission ipPermission,
                            SecurityGroup group)
```
    Description copied from interface: SecurityGroupExtension
    
    Add a @{link IpPermission} to an existing @{link SecurityGroup}. Applies the permission to the security group on the provider.
    
    Specified by:
    
    addIpPermission in interface SecurityGroupExtension
    
    group - The SecurityGroup to add the permission to.
    
    Returns:
    The SecurityGroup with the new permission added, after the permission has been applied on the provider.
  - addIpPermission
```
public SecurityGroup addIpPermission(IpProtocol protocol,
                            int startPort,
                            int endPort,
                            com.google.common.collect.Multimap<String,String> tenantIdGroupNamePairs,
                            Iterable<String> ipRanges,
                            Iterable<String> groupIds,
                            SecurityGroup group)
```
    Description copied from interface: SecurityGroupExtension
    
    Add a @{link IpPermission} to an existing @{link SecurityGroup}, based on the parameters given. Applies the permission to the security group on the provider.
    
    Specified by:
    
    addIpPermission in interface SecurityGroupExtension
    
    Parameters:
    protocol - The @{link IpProtocol} for the permission.
    startPort - The first port in the range to be opened, or -1 for ICMP.
    endPort - The last port in the range to be opened, or -1 for ICMP.
    tenantIdGroupNamePairs - source of traffic allowed is on basis of another group in a tenant, as opposed to by cidr
    ipRanges - An Iterable of Strings representing the IP range(s) the permission should allow.
    groupIds - An Iterable of @{link SecurityGroup} IDs this permission should allow.
    group - The SecurityGroup to add the permission to.
    
    Returns:
    The SecurityGroup with the new permission added, after the permission has been applied on the provider.
  - removeIpPermission
```
public SecurityGroup removeIpPermission(IpPermission ipPermission,
                               SecurityGroup group)
```
    Description copied from interface: SecurityGroupExtension
    
    Remove a @{link IpPermission} from an existing @{link SecurityGroup}. Removes the permission from the security group on the provider.
    
    Specified by:
    
    removeIpPermission in interface SecurityGroupExtension
    
    group - The SecurityGroup to remove the permission from.
    
    Returns:
    The SecurityGroup with the permission removed, after the permission has been removed on the provider.
  - removeIpPermission
```
public SecurityGroup removeIpPermission(IpProtocol protocol,
                               int startPort,
                               int endPort,
                               com.google.common.collect.Multimap<String,String> tenantIdGroupNamePairs,
                               Iterable<String> ipRanges,
                               Iterable<String> groupIds,
                               SecurityGroup group)
```
    Description copied from interface: SecurityGroupExtension
    
    Remove a @{link IpPermission} from an existing @{link SecurityGroup}, based on the parameters given. Removes the permission from the security group on the provider.
    
    Specified by:
    
    removeIpPermission in interface SecurityGroupExtension
    
    Parameters:
    protocol - The @{link IpProtocol} for the permission.
    startPort - The first port in the range to be opened, or -1 for ICMP.
    endPort - The last port in the range to be opened, or -1 for ICMP.
    tenantIdGroupNamePairs - source of traffic allowed is on basis of another group in a tenant, as opposed to by cidr
    ipRanges - An Iterable of Strings representing the IP range(s) the permission should allow.
    groupIds - An Iterable of @{link SecurityGroup} IDs this permission should allow.
    group - The SecurityGroup to remove the permission from.
    
    Returns:
    The SecurityGroup with the permission removed, after the permission has been removed from the provider.
  - supportsTenantIdGroupNamePairs
```
public boolean supportsTenantIdGroupNamePairs()
```
    Description copied from interface: SecurityGroupExtension
    
    Returns true if this SecurityGroupExtension supports tenant ID + group name pairs.
    
    Specified by:
    
    supportsTenantIdGroupNamePairs in interface SecurityGroupExtension
  - supportsTenantIdGroupIdPairs
```
public boolean supportsTenantIdGroupIdPairs()
```
    Description copied from interface: SecurityGroupExtension
    
    Returns true if this SecurityGroupExtension supports tenant ID + group ID pairs.
    
    Specified by:
    
    supportsTenantIdGroupIdPairs in interface SecurityGroupExtension
  - supportsGroupIds
```
public boolean supportsGroupIds()
```
    Description copied from interface: SecurityGroupExtension
    
    Returns true if this SecurityGroupExtension supports group IDs.
    
    Specified by:
    
    supportsGroupIds in interface SecurityGroupExtension
  - supportsPortRangesForGroups
```
public boolean supportsPortRangesForGroups()
```
    Description copied from interface: SecurityGroupExtension
    
    Returns true if this SecurityGroupExtension supports port ranges for group authorization.
    
    Specified by:
    
    supportsPortRangesForGroups in interface SecurityGroupExtension

Class CloudStackSecurityGroupExtension

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

api

groupConverter

groupCreator

namingConvention

locations

blockUntilJobCompletesAndReturnResult

jobComplete

Constructor Detail

CloudStackSecurityGroupExtension

Method Detail

listSecurityGroups

listSecurityGroupsInLocation

listSecurityGroupsForNode

getSecurityGroupById

createSecurityGroup

removeSecurityGroup

addIpPermission

addIpPermission

removeIpPermission

removeIpPermission

supportsTenantIdGroupNamePairs

supportsTenantIdGroupIdPairs

supportsGroupIds

supportsPortRangesForGroups