The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Paws::EC2::DescribePlacementGroups - Arguments for method DescribePlacementGroups on Paws::EC2

DESCRIPTION

This class represents the parameters used for calling the method DescribePlacementGroups on the Amazon Elastic Compute Cloud service. Use the attributes of this class as arguments to method DescribePlacementGroups.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to DescribePlacementGroups.

SYNOPSIS

    my $ec2 = Paws->service('EC2');
    my $DescribePlacementGroupsResult = $ec2->DescribePlacementGroups(
      DryRun  => 1,    # OPTIONAL
      Filters => [
        {
          Name   => 'MyString',    # OPTIONAL
          Values => [
            'MyString', ...        # OPTIONAL
          ],    # OPTIONAL
        },
        ...
      ],    # OPTIONAL
      GroupIds   => [ 'MyPlacementGroupId',   ... ],    # OPTIONAL
      GroupNames => [ 'MyPlacementGroupName', ... ],    # OPTIONAL
    );

    # Results:
    my $PlacementGroups = $DescribePlacementGroupsResult->PlacementGroups;

    # Returns a L<Paws::EC2::DescribePlacementGroupsResult> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/ec2/DescribePlacementGroups

ATTRIBUTES

DryRun => Bool

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Filters => ArrayRef[Paws::EC2::Filter]

The filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster | spread | partition).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources that have a tag with a specific key, regardless of the tag value.

GroupIds => ArrayRef[Str|Undef]

The IDs of the placement groups.

GroupNames => ArrayRef[Str|Undef]

The names of the placement groups.

Default: Describes all your placement groups, or only those otherwise specified.

SEE ALSO

This class forms part of Paws, documenting arguments for method DescribePlacementGroups in Paws::EC2

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues