1VM::EC2::REST::placemenUts_egrroCuopn(t3r)ibuted Perl DoVcMu:m:eEnCt2a:t:iRoEnST::placement_group(3)
2
3
4
7 use VM::EC2 ':hpc'
8
10 Placement groups provide low latency and high-bandwidth connectivity
11 between cluster instances within a single Availability Zone. Create a
12 placement group and then launch cluster instances into it. Instances
13 launched within a placement group participate in a full-bisection
14 bandwidth cluster appropriate for HPC applications.
15
16 Implemented:
17 CreatePlacementGroup
18 DeletePlacementGroup
19 DescribePlacementGroups
20
21 @groups = $ec2->describe_placement_groups(@group_names)
22 @groups = $ec2->describe_placement_groups(\%filters)
23 @groups =
24 $ec2->describe_placement_groups(-group_name=>\@ids,-filter=>\%filters)
25 This method will return information about cluster placement groups as a
26 list of VM::EC2::PlacementGroup objects.
27
28 Optional arguments:
29
30 -group_name -- Scalar or arrayref of placement group names.
31
32 -filter -- Tags and other filters to apply.
33
34 The filters available are described fully at:
35 http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribePlacementGroups.html
36
37 group-name
38 state
39 strategy
40
41 $success = $ec2->create_placement_group($group_name)
42 $success =
43 $ec2->create_placement_group(-group_name=>$name,-strategy=>$strategy)
44 Creates a placement group that cluster instances are launched into.
45
46 Required arguments:
47 -group_name -- The name of the placement group to create
48
49 Optional:
50 -strategy -- As of 2012-12-23, the only available option is
51 'cluster'
52 so the parameter defaults to that.
53
54 Returns true on success.
55
56 $success = $ec2->delete_placement_group($group_name)
57 $success = $ec2->delete_placement_group(-group_name=>$group_name)
58 Deletes a placement group from the account.
59
60 Required arguments:
61 -group_name -- The name of the placement group to delete
62
63 Returns true on success.
64
66 VM::EC2
67
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.34.0 2021-07-27 VM::EC2::REST::placement_group(3)