1VM::EC2::SecurityGroup:U:sGerrouCpoPnetrrmiibsuVstMie:od:nE(PC3e2pr:ml:)SDeoccuurmietnytGartoiuopn::GroupPermission(3pm)
2
3
4

NAME

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

SYNOPSIS

10         $ec2      = VM::EC2->new(...);
11         $sg       = $ec2->describe_security_groups(-name=>'My Group');
12         @rules = $sg->ipPermissions;
13         $rule  = $rules[0];
14
15         @groups = $rule->groups;
16         for my $g (@groups) {
17           $userId = $g->userId;
18           $name   = $g>groupName;
19           $id     = $g->groupId;
20           $group_object = $g->security_group;
21         }
22

DESCRIPTION

24       This object describes a security group whose instances are granted
25       permission to exchange data traffic with another group of instances. It
26       is returned by the groups() method of
27       VM::EC2::SecurityGroup::ipPermission.
28
29       Note that this object is not the same as a bona fide
30       VM::EC2::SecurityGroup, which has access to the group's firewall rules.
31       This object contains just the name, id and owner of a group used within
32       a firewall rule. For groups that belong to you, you can get the full
33       VM::EC2::SecurityGroup object by calling the security_group() method.
34       These details are not available to groups that belong to other
35       accounts.
36

METHODS

38   $id = $group->groupId
39       Return the group's unique ID.
40
41   $id = $group->userId
42       Return the account ID of the owner of this group.
43
44   $id = $group->groupName
45       Return this group's name.
46
47   $string = $group->short_name
48       Return a string for use in string overloading. See "STRING
49       OVERLOADING".
50
51   $sg = $group->security_group
52       For groups that belong to the current account, calls
53       VM::EC2->describe_security_groups() to turn the group name into a
54       VM::EC2::SecurityGroup. For groups that belong to a different account,
55       will return undef, since describe_security_groups() on other accounts
56       is not allowed by Amazon.
57

STRING OVERLOADING

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

SEE ALSO

65       VM::EC2 VM::EC2::Generic VM::EC2::SecurityGroup
66       VM::EC2::SecurityGroup::IpPermission
67

AUTHOR

69       Lincoln Stein <lincoln.stein@gmail.com>.
70
71       Copyright (c) 2011 Ontario Institute for Cancer Research
72
73       This package and its accompanying libraries is free software; you can
74       redistribute it and/or modify it under the terms of the GPL (either
75       version 1, or at your option, any later version) or the Artistic
76       License 2.0.  Refer to LICENSE for the full license text. In addition,
77       please see DISCLAIMER.txt for disclaimers of warranty.
78
79
80
81perl v5.38.0                      2V0M2:3:-E0C72-:2:1SecurityGroup::GroupPermission(3pm)
Impressum