GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  VM::EC2::SECURITYGROUP::GROUPPERMISSION (3)

.ds Aq ’

NAME

VM::EC2::SecurityGroup::GroupPermission - Object describing an authorized group within a security group firewall rule

CONTENTS

SYNOPSIS



  $ec2      = VM::EC2->new(...);
  $sg       = $ec2->describe_security_groups(-name=>My Group);
  @rules = $sg->ipPermissions;
  $rule  = $rules[0];

  @groups = $rule->groups;
  for my $g (@groups) {
    $userId = $g->userId;
    $name   = $g>groupName;
    $id     = $g->groupId;
    $group_object = $g->security_group;
  }



DESCRIPTION

This object describes a security group whose instances are granted permission to exchange data traffic with another group of instances. It is returned by the groups() method of VM::EC2::SecurityGroup::ipPermission.

Note that this object is not the same as a bona fide VM::EC2::SecurityGroup, which has access to the group’s firewall rules. This object contains just the name, id and owner of a group used within a firewall rule. For groups that belong to you, you can get the full VM::EC2::SecurityGroup object by calling the security_group() method. These details are not available to groups that belong to other accounts.

METHODS

CW$id = CW$group->groupId

Return the group’s unique ID.

CW$id = CW$group->userId

Return the account ID of the owner of this group.

CW$id = CW$group->groupName

Return this group’s name.

CW$string = CW$group->short_name

Return a string for use in string overloading. See STRING OVERLOADING.

CW$sg = CW$group->security_group

For groups that belong to the current account, calls VM::EC2->describe_security_groups() to turn the group name into a VM::EC2::SecurityGroup. For groups that belong to a different account, will return undef, since describe_security_groups() on other accounts is not allowed by Amazon.

STRING OVERLOADING

When used in a string context, this object will interpolate the user id and group name in the form userId/groupName for groups that belong to other accounts, and the groupName alone in the case of groups that belong to you.

SEE ALSO

VM::EC2 VM::EC2::Generic VM::EC2::SecurityGroup VM::EC2::SecurityGroup::IpPermission

AUTHOR

Lincoln Stein <lincoln.stein@gmail.com>.

Copyright (c) 2011 Ontario Institute for Cancer Research

This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 VM::EC2::SECURITYGROUP::GROUPPERMISSION (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.