| 1 | package Paws::ResourceGroups; | ||
| 2 | use Moose; | ||
| 3 | sub service { 'resource-groups' } | ||
| 4 | sub signing_name { 'resource-groups' } | ||
| 5 | sub version { '2017-11-27' } | ||
| 6 | sub flattened_arrays { 0 } | ||
| 7 | has max_attempts => (is => 'ro', isa => 'Int', default => 5); | ||
| 8 | has retry => (is => 'ro', isa => 'HashRef', default => sub { | ||
| 9 | { base => 'rand', type => 'exponential', growth_factor => 2 } | ||
| 10 | }); | ||
| 11 | has retriables => (is => 'ro', isa => 'ArrayRef', default => sub { [ | ||
| 12 | ] }); | ||
| 13 | |||
| 14 | with 'Paws::API::Caller', 'Paws::API::EndpointResolver', 'Paws::Net::V4Signature', 'Paws::Net::RestJsonCaller'; | ||
| 15 | |||
| 16 | |||
| 17 | sub CreateGroup { | ||
| 18 | my $self = shift; | ||
| 19 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::CreateGroup', @_); | ||
| 20 | return $self->caller->do_call($self, $call_object); | ||
| 21 | } | ||
| 22 | sub DeleteGroup { | ||
| 23 | my $self = shift; | ||
| 24 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::DeleteGroup', @_); | ||
| 25 | return $self->caller->do_call($self, $call_object); | ||
| 26 | } | ||
| 27 | sub GetGroup { | ||
| 28 | my $self = shift; | ||
| 29 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::GetGroup', @_); | ||
| 30 | return $self->caller->do_call($self, $call_object); | ||
| 31 | } | ||
| 32 | sub GetGroupConfiguration { | ||
| 33 | my $self = shift; | ||
| 34 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::GetGroupConfiguration', @_); | ||
| 35 | return $self->caller->do_call($self, $call_object); | ||
| 36 | } | ||
| 37 | sub GetGroupQuery { | ||
| 38 | my $self = shift; | ||
| 39 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::GetGroupQuery', @_); | ||
| 40 | return $self->caller->do_call($self, $call_object); | ||
| 41 | } | ||
| 42 | sub GetTags { | ||
| 43 | my $self = shift; | ||
| 44 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::GetTags', @_); | ||
| 45 | return $self->caller->do_call($self, $call_object); | ||
| 46 | } | ||
| 47 | sub GroupResources { | ||
| 48 | my $self = shift; | ||
| 49 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::GroupResources', @_); | ||
| 50 | return $self->caller->do_call($self, $call_object); | ||
| 51 | } | ||
| 52 | sub ListGroupResources { | ||
| 53 | my $self = shift; | ||
| 54 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::ListGroupResources', @_); | ||
| 55 | return $self->caller->do_call($self, $call_object); | ||
| 56 | } | ||
| 57 | sub ListGroups { | ||
| 58 | my $self = shift; | ||
| 59 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::ListGroups', @_); | ||
| 60 | return $self->caller->do_call($self, $call_object); | ||
| 61 | } | ||
| 62 | sub PutGroupConfiguration { | ||
| 63 | my $self = shift; | ||
| 64 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::PutGroupConfiguration', @_); | ||
| 65 | return $self->caller->do_call($self, $call_object); | ||
| 66 | } | ||
| 67 | sub SearchResources { | ||
| 68 | my $self = shift; | ||
| 69 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::SearchResources', @_); | ||
| 70 | return $self->caller->do_call($self, $call_object); | ||
| 71 | } | ||
| 72 | sub Tag { | ||
| 73 | my $self = shift; | ||
| 74 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::Tag', @_); | ||
| 75 | return $self->caller->do_call($self, $call_object); | ||
| 76 | } | ||
| 77 | sub UngroupResources { | ||
| 78 | my $self = shift; | ||
| 79 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::UngroupResources', @_); | ||
| 80 | return $self->caller->do_call($self, $call_object); | ||
| 81 | } | ||
| 82 | sub Untag { | ||
| 83 | my $self = shift; | ||
| 84 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::Untag', @_); | ||
| 85 | return $self->caller->do_call($self, $call_object); | ||
| 86 | } | ||
| 87 | sub UpdateGroup { | ||
| 88 | my $self = shift; | ||
| 89 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::UpdateGroup', @_); | ||
| 90 | return $self->caller->do_call($self, $call_object); | ||
| 91 | } | ||
| 92 | sub UpdateGroupQuery { | ||
| 93 | my $self = shift; | ||
| 94 | my $call_object = $self->new_with_coercions('Paws::ResourceGroups::UpdateGroupQuery', @_); | ||
| 95 | return $self->caller->do_call($self, $call_object); | ||
| 96 | } | ||
| 97 | |||
| 98 | sub ListAllGroupResources { | ||
| 99 | my $self = shift; | ||
| 100 | |||
| 101 | my $callback = shift @_ if (ref($_[0]) eq 'CODE'); | ||
| 102 | my $result = $self->ListGroupResources(@_); | ||
| 103 | my $next_result = $result; | ||
| 104 | |||
| 105 | if (not defined $callback) { | ||
| 106 | while ($next_result->NextToken) { | ||
| 107 | $next_result = $self->ListGroupResources(@_, NextToken => $next_result->NextToken); | ||
| 108 | push @{ $result->ResourceIdentifiers }, @{ $next_result->ResourceIdentifiers }; | ||
| 109 | push @{ $result->Resources }, @{ $next_result->Resources }; | ||
| 110 | } | ||
| 111 | return $result; | ||
| 112 | } else { | ||
| 113 | while ($result->NextToken) { | ||
| 114 | $callback->($_ => 'ResourceIdentifiers') foreach (@{ $result->ResourceIdentifiers }); | ||
| 115 | $callback->($_ => 'Resources') foreach (@{ $result->Resources }); | ||
| 116 | $result = $self->ListGroupResources(@_, NextToken => $result->NextToken); | ||
| 117 | } | ||
| 118 | $callback->($_ => 'ResourceIdentifiers') foreach (@{ $result->ResourceIdentifiers }); | ||
| 119 | $callback->($_ => 'Resources') foreach (@{ $result->Resources }); | ||
| 120 | } | ||
| 121 | |||
| 122 | return undef | ||
| 123 | } | ||
| 124 | sub ListAllGroups { | ||
| 125 | my $self = shift; | ||
| 126 | |||
| 127 | my $callback = shift @_ if (ref($_[0]) eq 'CODE'); | ||
| 128 | my $result = $self->ListGroups(@_); | ||
| 129 | my $next_result = $result; | ||
| 130 | |||
| 131 | if (not defined $callback) { | ||
| 132 | while ($next_result->NextToken) { | ||
| 133 | $next_result = $self->ListGroups(@_, NextToken => $next_result->NextToken); | ||
| 134 | push @{ $result->GroupIdentifiers }, @{ $next_result->GroupIdentifiers }; | ||
| 135 | push @{ $result->Groups }, @{ $next_result->Groups }; | ||
| 136 | } | ||
| 137 | return $result; | ||
| 138 | } else { | ||
| 139 | while ($result->NextToken) { | ||
| 140 | $callback->($_ => 'GroupIdentifiers') foreach (@{ $result->GroupIdentifiers }); | ||
| 141 | $callback->($_ => 'Groups') foreach (@{ $result->Groups }); | ||
| 142 | $result = $self->ListGroups(@_, NextToken => $result->NextToken); | ||
| 143 | } | ||
| 144 | $callback->($_ => 'GroupIdentifiers') foreach (@{ $result->GroupIdentifiers }); | ||
| 145 | $callback->($_ => 'Groups') foreach (@{ $result->Groups }); | ||
| 146 | } | ||
| 147 | |||
| 148 | return undef | ||
| 149 | } | ||
| 150 | sub SearchAllResources { | ||
| 151 | my $self = shift; | ||
| 152 | |||
| 153 | my $callback = shift @_ if (ref($_[0]) eq 'CODE'); | ||
| 154 | my $result = $self->SearchResources(@_); | ||
| 155 | my $next_result = $result; | ||
| 156 | |||
| 157 | if (not defined $callback) { | ||
| 158 | while ($next_result->NextToken) { | ||
| 159 | $next_result = $self->SearchResources(@_, NextToken => $next_result->NextToken); | ||
| 160 | push @{ $result->ResourceIdentifiers }, @{ $next_result->ResourceIdentifiers }; | ||
| 161 | } | ||
| 162 | return $result; | ||
| 163 | } else { | ||
| 164 | while ($result->NextToken) { | ||
| 165 | $callback->($_ => 'ResourceIdentifiers') foreach (@{ $result->ResourceIdentifiers }); | ||
| 166 | $result = $self->SearchResources(@_, NextToken => $result->NextToken); | ||
| 167 | } | ||
| 168 | $callback->($_ => 'ResourceIdentifiers') foreach (@{ $result->ResourceIdentifiers }); | ||
| 169 | } | ||
| 170 | |||
| 171 | return undef | ||
| 172 | } | ||
| 173 | |||
| 174 | |||
| 175 | sub operations { qw/CreateGroup DeleteGroup GetGroup GetGroupConfiguration GetGroupQuery GetTags GroupResources ListGroupResources ListGroups PutGroupConfiguration SearchResources Tag UngroupResources Untag UpdateGroup UpdateGroupQuery / } | ||
| 176 | |||
| 177 | 1; | ||
| 178 | |||
| 179 | ### main pod documentation begin ### | ||
| 180 | |||
| 181 | =head1 NAME | ||
| 182 | |||
| 183 | Paws::ResourceGroups - Perl Interface to AWS AWS Resource Groups | ||
| 184 | |||
| 185 | =head1 SYNOPSIS | ||
| 186 | |||
| 187 | use Paws; | ||
| 188 | |||
| 189 | my $obj = Paws->service('ResourceGroups'); | ||
| 190 | my $res = $obj->Method( | ||
| 191 | Arg1 => $val1, | ||
| 192 | Arg2 => [ 'V1', 'V2' ], | ||
| 193 | # if Arg3 is an object, the HashRef will be used as arguments to the constructor | ||
| 194 | # of the arguments type | ||
| 195 | Arg3 => { Att1 => 'Val1' }, | ||
| 196 | # if Arg4 is an array of objects, the HashRefs will be passed as arguments to | ||
| 197 | # the constructor of the arguments type | ||
| 198 | Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ], | ||
| 199 | ); | ||
| 200 | |||
| 201 | =head1 DESCRIPTION | ||
| 202 | |||
| 203 | AWS Resource Groups | ||
| 204 | |||
| 205 | AWS Resource Groups lets you organize AWS resources such as Amazon EC2 | ||
| 206 | instances, Amazon Relational Database Service databases, and Amazon S3 | ||
| 207 | buckets into groups using criteria that you define as tags. A resource | ||
| 208 | group is a collection of resources that match the resource types | ||
| 209 | specified in a query, and share one or more tags or portions of tags. | ||
| 210 | You can create a group of resources based on their roles in your cloud | ||
| 211 | infrastructure, lifecycle stages, regions, application layers, or | ||
| 212 | virtually any criteria. Resource Groups enable you to automate | ||
| 213 | management tasks, such as those in AWS Systems Manager Automation | ||
| 214 | documents, on tag-related resources in AWS Systems Manager. Groups of | ||
| 215 | tagged resources also let you quickly view a custom console in AWS | ||
| 216 | Systems Manager that shows AWS Config compliance and other monitoring | ||
| 217 | data about member resources. | ||
| 218 | |||
| 219 | To create a resource group, build a resource query, and specify tags | ||
| 220 | that identify the criteria that members of the group have in common. | ||
| 221 | Tags are key-value pairs. | ||
| 222 | |||
| 223 | For more information about Resource Groups, see the AWS Resource Groups | ||
| 224 | User Guide | ||
| 225 | (https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html). | ||
| 226 | |||
| 227 | AWS Resource Groups uses a REST-compliant API that you can use to | ||
| 228 | perform the following types of operations. | ||
| 229 | |||
| 230 | =over | ||
| 231 | |||
| 232 | =item * | ||
| 233 | |||
| 234 | Create, Read, Update, and Delete (CRUD) operations on resource groups | ||
| 235 | and resource query entities | ||
| 236 | |||
| 237 | =item * | ||
| 238 | |||
| 239 | Applying, editing, and removing tags from resource groups | ||
| 240 | |||
| 241 | =item * | ||
| 242 | |||
| 243 | Resolving resource group member ARNs so they can be returned as search | ||
| 244 | results | ||
| 245 | |||
| 246 | =item * | ||
| 247 | |||
| 248 | Getting data about resources that are members of a group | ||
| 249 | |||
| 250 | =item * | ||
| 251 | |||
| 252 | Searching AWS resources based on a resource query | ||
| 253 | |||
| 254 | =back | ||
| 255 | |||
| 256 | |||
| 257 | For the AWS API documentation, see L<https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27> | ||
| 258 | |||
| 259 | |||
| 260 | =head1 METHODS | ||
| 261 | |||
| 262 | =head2 CreateGroup | ||
| 263 | |||
| 264 | =over | ||
| 265 | |||
| 266 | =item Name => Str | ||
| 267 | |||
| 268 | =item [Configuration => ArrayRef[L<Paws::ResourceGroups::GroupConfigurationItem>]] | ||
| 269 | |||
| 270 | =item [Description => Str] | ||
| 271 | |||
| 272 | =item [ResourceQuery => L<Paws::ResourceGroups::ResourceQuery>] | ||
| 273 | |||
| 274 | =item [Tags => L<Paws::ResourceGroups::Tags>] | ||
| 275 | |||
| 276 | |||
| 277 | =back | ||
| 278 | |||
| 279 | Each argument is described in detail in: L<Paws::ResourceGroups::CreateGroup> | ||
| 280 | |||
| 281 | Returns: a L<Paws::ResourceGroups::CreateGroupOutput> instance | ||
| 282 | |||
| 283 | Creates a resource group with the specified name and description. You | ||
| 284 | can optionally include a resource query, or a service configuration. | ||
| 285 | For more information about constructing a resource query, see Create a | ||
| 286 | tag-based group in Resource Groups | ||
| 287 | (https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag). | ||
| 288 | For more information about service configurations, see Service | ||
| 289 | configurations for resource groups | ||
| 290 | (https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html). | ||
| 291 | |||
| 292 | B<Minimum permissions> | ||
| 293 | |||
| 294 | To run this command, you must have the following permissions: | ||
| 295 | |||
| 296 | =over | ||
| 297 | |||
| 298 | =item * | ||
| 299 | |||
| 300 | C<resource-groups:CreateGroup> | ||
| 301 | |||
| 302 | =back | ||
| 303 | |||
| 304 | |||
| 305 | |||
| 306 | =head2 DeleteGroup | ||
| 307 | |||
| 308 | =over | ||
| 309 | |||
| 310 | =item [Group => Str] | ||
| 311 | |||
| 312 | =item [GroupName => Str] | ||
| 313 | |||
| 314 | |||
| 315 | =back | ||
| 316 | |||
| 317 | Each argument is described in detail in: L<Paws::ResourceGroups::DeleteGroup> | ||
| 318 | |||
| 319 | Returns: a L<Paws::ResourceGroups::DeleteGroupOutput> instance | ||
| 320 | |||
| 321 | Deletes the specified resource group. Deleting a resource group does | ||
| 322 | not delete any resources that are members of the group; it only deletes | ||
| 323 | the group structure. | ||
| 324 | |||
| 325 | B<Minimum permissions> | ||
| 326 | |||
| 327 | To run this command, you must have the following permissions: | ||
| 328 | |||
| 329 | =over | ||
| 330 | |||
| 331 | =item * | ||
| 332 | |||
| 333 | C<resource-groups:DeleteGroup> | ||
| 334 | |||
| 335 | =back | ||
| 336 | |||
| 337 | |||
| 338 | |||
| 339 | =head2 GetGroup | ||
| 340 | |||
| 341 | =over | ||
| 342 | |||
| 343 | =item [Group => Str] | ||
| 344 | |||
| 345 | =item [GroupName => Str] | ||
| 346 | |||
| 347 | |||
| 348 | =back | ||
| 349 | |||
| 350 | Each argument is described in detail in: L<Paws::ResourceGroups::GetGroup> | ||
| 351 | |||
| 352 | Returns: a L<Paws::ResourceGroups::GetGroupOutput> instance | ||
| 353 | |||
| 354 | Returns information about a specified resource group. | ||
| 355 | |||
| 356 | B<Minimum permissions> | ||
| 357 | |||
| 358 | To run this command, you must have the following permissions: | ||
| 359 | |||
| 360 | =over | ||
| 361 | |||
| 362 | =item * | ||
| 363 | |||
| 364 | C<resource-groups:GetGroup> | ||
| 365 | |||
| 366 | =back | ||
| 367 | |||
| 368 | |||
| 369 | |||
| 370 | =head2 GetGroupConfiguration | ||
| 371 | |||
| 372 | =over | ||
| 373 | |||
| 374 | =item [Group => Str] | ||
| 375 | |||
| 376 | |||
| 377 | =back | ||
| 378 | |||
| 379 | Each argument is described in detail in: L<Paws::ResourceGroups::GetGroupConfiguration> | ||
| 380 | |||
| 381 | Returns: a L<Paws::ResourceGroups::GetGroupConfigurationOutput> instance | ||
| 382 | |||
| 383 | Returns the service configuration associated with the specified | ||
| 384 | resource group. For details about the service configuration syntax, see | ||
| 385 | Service configurations for resource groups | ||
| 386 | (https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html). | ||
| 387 | |||
| 388 | B<Minimum permissions> | ||
| 389 | |||
| 390 | To run this command, you must have the following permissions: | ||
| 391 | |||
| 392 | =over | ||
| 393 | |||
| 394 | =item * | ||
| 395 | |||
| 396 | C<resource-groups:GetGroupConfiguration> | ||
| 397 | |||
| 398 | =back | ||
| 399 | |||
| 400 | |||
| 401 | |||
| 402 | =head2 GetGroupQuery | ||
| 403 | |||
| 404 | =over | ||
| 405 | |||
| 406 | =item [Group => Str] | ||
| 407 | |||
| 408 | =item [GroupName => Str] | ||
| 409 | |||
| 410 | |||
| 411 | =back | ||
| 412 | |||
| 413 | Each argument is described in detail in: L<Paws::ResourceGroups::GetGroupQuery> | ||
| 414 | |||
| 415 | Returns: a L<Paws::ResourceGroups::GetGroupQueryOutput> instance | ||
| 416 | |||
| 417 | Retrieves the resource query associated with the specified resource | ||
| 418 | group. For more information about resource queries, see Create a | ||
| 419 | tag-based group in Resource Groups | ||
| 420 | (https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag). | ||
| 421 | |||
| 422 | B<Minimum permissions> | ||
| 423 | |||
| 424 | To run this command, you must have the following permissions: | ||
| 425 | |||
| 426 | =over | ||
| 427 | |||
| 428 | =item * | ||
| 429 | |||
| 430 | C<resource-groups:GetGroupQuery> | ||
| 431 | |||
| 432 | =back | ||
| 433 | |||
| 434 | |||
| 435 | |||
| 436 | =head2 GetTags | ||
| 437 | |||
| 438 | =over | ||
| 439 | |||
| 440 | =item Arn => Str | ||
| 441 | |||
| 442 | |||
| 443 | =back | ||
| 444 | |||
| 445 | Each argument is described in detail in: L<Paws::ResourceGroups::GetTags> | ||
| 446 | |||
| 447 | Returns: a L<Paws::ResourceGroups::GetTagsOutput> instance | ||
| 448 | |||
| 449 | Returns a list of tags that are associated with a resource group, | ||
| 450 | specified by an ARN. | ||
| 451 | |||
| 452 | B<Minimum permissions> | ||
| 453 | |||
| 454 | To run this command, you must have the following permissions: | ||
| 455 | |||
| 456 | =over | ||
| 457 | |||
| 458 | =item * | ||
| 459 | |||
| 460 | C<resource-groups:GetTags> | ||
| 461 | |||
| 462 | =back | ||
| 463 | |||
| 464 | |||
| 465 | |||
| 466 | =head2 GroupResources | ||
| 467 | |||
| 468 | =over | ||
| 469 | |||
| 470 | =item Group => Str | ||
| 471 | |||
| 472 | =item ResourceArns => ArrayRef[Str|Undef] | ||
| 473 | |||
| 474 | |||
| 475 | =back | ||
| 476 | |||
| 477 | Each argument is described in detail in: L<Paws::ResourceGroups::GroupResources> | ||
| 478 | |||
| 479 | Returns: a L<Paws::ResourceGroups::GroupResourcesOutput> instance | ||
| 480 | |||
| 481 | Adds the specified resources to the specified group. | ||
| 482 | |||
| 483 | B<Minimum permissions> | ||
| 484 | |||
| 485 | To run this command, you must have the following permissions: | ||
| 486 | |||
| 487 | =over | ||
| 488 | |||
| 489 | =item * | ||
| 490 | |||
| 491 | C<resource-groups:GroupResources> | ||
| 492 | |||
| 493 | =back | ||
| 494 | |||
| 495 | |||
| 496 | |||
| 497 | =head2 ListGroupResources | ||
| 498 | |||
| 499 | =over | ||
| 500 | |||
| 501 | =item [Filters => ArrayRef[L<Paws::ResourceGroups::ResourceFilter>]] | ||
| 502 | |||
| 503 | =item [Group => Str] | ||
| 504 | |||
| 505 | =item [GroupName => Str] | ||
| 506 | |||
| 507 | =item [MaxResults => Int] | ||
| 508 | |||
| 509 | =item [NextToken => Str] | ||
| 510 | |||
| 511 | |||
| 512 | =back | ||
| 513 | |||
| 514 | Each argument is described in detail in: L<Paws::ResourceGroups::ListGroupResources> | ||
| 515 | |||
| 516 | Returns: a L<Paws::ResourceGroups::ListGroupResourcesOutput> instance | ||
| 517 | |||
| 518 | Returns a list of ARNs of the resources that are members of a specified | ||
| 519 | resource group. | ||
| 520 | |||
| 521 | B<Minimum permissions> | ||
| 522 | |||
| 523 | To run this command, you must have the following permissions: | ||
| 524 | |||
| 525 | =over | ||
| 526 | |||
| 527 | =item * | ||
| 528 | |||
| 529 | C<resource-groups:ListGroupResources> | ||
| 530 | |||
| 531 | =item * | ||
| 532 | |||
| 533 | C<cloudformation:DescribeStacks> | ||
| 534 | |||
| 535 | =item * | ||
| 536 | |||
| 537 | C<cloudformation:ListStackResources> | ||
| 538 | |||
| 539 | =item * | ||
| 540 | |||
| 541 | C<tag:GetResources> | ||
| 542 | |||
| 543 | =back | ||
| 544 | |||
| 545 | |||
| 546 | |||
| 547 | =head2 ListGroups | ||
| 548 | |||
| 549 | =over | ||
| 550 | |||
| 551 | =item [Filters => ArrayRef[L<Paws::ResourceGroups::GroupFilter>]] | ||
| 552 | |||
| 553 | =item [MaxResults => Int] | ||
| 554 | |||
| 555 | =item [NextToken => Str] | ||
| 556 | |||
| 557 | |||
| 558 | =back | ||
| 559 | |||
| 560 | Each argument is described in detail in: L<Paws::ResourceGroups::ListGroups> | ||
| 561 | |||
| 562 | Returns: a L<Paws::ResourceGroups::ListGroupsOutput> instance | ||
| 563 | |||
| 564 | Returns a list of existing resource groups in your account. | ||
| 565 | |||
| 566 | B<Minimum permissions> | ||
| 567 | |||
| 568 | To run this command, you must have the following permissions: | ||
| 569 | |||
| 570 | =over | ||
| 571 | |||
| 572 | =item * | ||
| 573 | |||
| 574 | C<resource-groups:ListGroups> | ||
| 575 | |||
| 576 | =back | ||
| 577 | |||
| 578 | |||
| 579 | |||
| 580 | =head2 PutGroupConfiguration | ||
| 581 | |||
| 582 | =over | ||
| 583 | |||
| 584 | =item [Configuration => ArrayRef[L<Paws::ResourceGroups::GroupConfigurationItem>]] | ||
| 585 | |||
| 586 | =item [Group => Str] | ||
| 587 | |||
| 588 | |||
| 589 | =back | ||
| 590 | |||
| 591 | Each argument is described in detail in: L<Paws::ResourceGroups::PutGroupConfiguration> | ||
| 592 | |||
| 593 | Returns: a L<Paws::ResourceGroups::PutGroupConfigurationOutput> instance | ||
| 594 | |||
| 595 | Attaches a service configuration to the specified group. This occurs | ||
| 596 | asynchronously, and can take time to complete. You can use | ||
| 597 | GetGroupConfiguration to check the status of the update. | ||
| 598 | |||
| 599 | B<Minimum permissions> | ||
| 600 | |||
| 601 | To run this command, you must have the following permissions: | ||
| 602 | |||
| 603 | =over | ||
| 604 | |||
| 605 | =item * | ||
| 606 | |||
| 607 | C<resource-groups:PutGroupConfiguration> | ||
| 608 | |||
| 609 | =back | ||
| 610 | |||
| 611 | |||
| 612 | |||
| 613 | =head2 SearchResources | ||
| 614 | |||
| 615 | =over | ||
| 616 | |||
| 617 | =item ResourceQuery => L<Paws::ResourceGroups::ResourceQuery> | ||
| 618 | |||
| 619 | =item [MaxResults => Int] | ||
| 620 | |||
| 621 | =item [NextToken => Str] | ||
| 622 | |||
| 623 | |||
| 624 | =back | ||
| 625 | |||
| 626 | Each argument is described in detail in: L<Paws::ResourceGroups::SearchResources> | ||
| 627 | |||
| 628 | Returns: a L<Paws::ResourceGroups::SearchResourcesOutput> instance | ||
| 629 | |||
| 630 | Returns a list of AWS resource identifiers that matches the specified | ||
| 631 | query. The query uses the same format as a resource query in a | ||
| 632 | CreateGroup or UpdateGroupQuery operation. | ||
| 633 | |||
| 634 | B<Minimum permissions> | ||
| 635 | |||
| 636 | To run this command, you must have the following permissions: | ||
| 637 | |||
| 638 | =over | ||
| 639 | |||
| 640 | =item * | ||
| 641 | |||
| 642 | C<resource-groups:SearchResources> | ||
| 643 | |||
| 644 | =item * | ||
| 645 | |||
| 646 | C<cloudformation:DescribeStacks> | ||
| 647 | |||
| 648 | =item * | ||
| 649 | |||
| 650 | C<cloudformation:ListStackResources> | ||
| 651 | |||
| 652 | =item * | ||
| 653 | |||
| 654 | C<tag:GetResources> | ||
| 655 | |||
| 656 | =back | ||
| 657 | |||
| 658 | |||
| 659 | |||
| 660 | =head2 Tag | ||
| 661 | |||
| 662 | =over | ||
| 663 | |||
| 664 | =item Arn => Str | ||
| 665 | |||
| 666 | =item Tags => L<Paws::ResourceGroups::Tags> | ||
| 667 | |||
| 668 | |||
| 669 | =back | ||
| 670 | |||
| 671 | Each argument is described in detail in: L<Paws::ResourceGroups::Tag> | ||
| 672 | |||
| 673 | Returns: a L<Paws::ResourceGroups::TagOutput> instance | ||
| 674 | |||
| 675 | Adds tags to a resource group with the specified ARN. Existing tags on | ||
| 676 | a resource group are not changed if they are not specified in the | ||
| 677 | request parameters. | ||
| 678 | |||
| 679 | Do not store personally identifiable information (PII) or other | ||
| 680 | confidential or sensitive information in tags. We use tags to provide | ||
| 681 | you with billing and administration services. Tags are not intended to | ||
| 682 | be used for private or sensitive data. | ||
| 683 | |||
| 684 | B<Minimum permissions> | ||
| 685 | |||
| 686 | To run this command, you must have the following permissions: | ||
| 687 | |||
| 688 | =over | ||
| 689 | |||
| 690 | =item * | ||
| 691 | |||
| 692 | C<resource-groups:Tag> | ||
| 693 | |||
| 694 | =back | ||
| 695 | |||
| 696 | |||
| 697 | |||
| 698 | =head2 UngroupResources | ||
| 699 | |||
| 700 | =over | ||
| 701 | |||
| 702 | =item Group => Str | ||
| 703 | |||
| 704 | =item ResourceArns => ArrayRef[Str|Undef] | ||
| 705 | |||
| 706 | |||
| 707 | =back | ||
| 708 | |||
| 709 | Each argument is described in detail in: L<Paws::ResourceGroups::UngroupResources> | ||
| 710 | |||
| 711 | Returns: a L<Paws::ResourceGroups::UngroupResourcesOutput> instance | ||
| 712 | |||
| 713 | Removes the specified resources from the specified group. | ||
| 714 | |||
| 715 | B<Minimum permissions> | ||
| 716 | |||
| 717 | To run this command, you must have the following permissions: | ||
| 718 | |||
| 719 | =over | ||
| 720 | |||
| 721 | =item * | ||
| 722 | |||
| 723 | C<resource-groups:UngroupResources> | ||
| 724 | |||
| 725 | =back | ||
| 726 | |||
| 727 | |||
| 728 | |||
| 729 | =head2 Untag | ||
| 730 | |||
| 731 | =over | ||
| 732 | |||
| 733 | =item Arn => Str | ||
| 734 | |||
| 735 | =item Keys => ArrayRef[Str|Undef] | ||
| 736 | |||
| 737 | |||
| 738 | =back | ||
| 739 | |||
| 740 | Each argument is described in detail in: L<Paws::ResourceGroups::Untag> | ||
| 741 | |||
| 742 | Returns: a L<Paws::ResourceGroups::UntagOutput> instance | ||
| 743 | |||
| 744 | Deletes tags from a specified resource group. | ||
| 745 | |||
| 746 | B<Minimum permissions> | ||
| 747 | |||
| 748 | To run this command, you must have the following permissions: | ||
| 749 | |||
| 750 | =over | ||
| 751 | |||
| 752 | =item * | ||
| 753 | |||
| 754 | C<resource-groups:Untag> | ||
| 755 | |||
| 756 | =back | ||
| 757 | |||
| 758 | |||
| 759 | |||
| 760 | =head2 UpdateGroup | ||
| 761 | |||
| 762 | =over | ||
| 763 | |||
| 764 | =item [Description => Str] | ||
| 765 | |||
| 766 | =item [Group => Str] | ||
| 767 | |||
| 768 | =item [GroupName => Str] | ||
| 769 | |||
| 770 | |||
| 771 | =back | ||
| 772 | |||
| 773 | Each argument is described in detail in: L<Paws::ResourceGroups::UpdateGroup> | ||
| 774 | |||
| 775 | Returns: a L<Paws::ResourceGroups::UpdateGroupOutput> instance | ||
| 776 | |||
| 777 | Updates the description for an existing group. You cannot update the | ||
| 778 | name of a resource group. | ||
| 779 | |||
| 780 | B<Minimum permissions> | ||
| 781 | |||
| 782 | To run this command, you must have the following permissions: | ||
| 783 | |||
| 784 | =over | ||
| 785 | |||
| 786 | =item * | ||
| 787 | |||
| 788 | C<resource-groups:UpdateGroup> | ||
| 789 | |||
| 790 | =back | ||
| 791 | |||
| 792 | |||
| 793 | |||
| 794 | =head2 UpdateGroupQuery | ||
| 795 | |||
| 796 | =over | ||
| 797 | |||
| 798 | =item ResourceQuery => L<Paws::ResourceGroups::ResourceQuery> | ||
| 799 | |||
| 800 | =item [Group => Str] | ||
| 801 | |||
| 802 | =item [GroupName => Str] | ||
| 803 | |||
| 804 | |||
| 805 | =back | ||
| 806 | |||
| 807 | Each argument is described in detail in: L<Paws::ResourceGroups::UpdateGroupQuery> | ||
| 808 | |||
| 809 | Returns: a L<Paws::ResourceGroups::UpdateGroupQueryOutput> instance | ||
| 810 | |||
| 811 | Updates the resource query of a group. For more information about | ||
| 812 | resource queries, see Create a tag-based group in Resource Groups | ||
| 813 | (https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag). | ||
| 814 | |||
| 815 | B<Minimum permissions> | ||
| 816 | |||
| 817 | To run this command, you must have the following permissions: | ||
| 818 | |||
| 819 | =over | ||
| 820 | |||
| 821 | =item * | ||
| 822 | |||
| 823 | C<resource-groups:UpdateGroupQuery> | ||
| 824 | |||
| 825 | =back | ||
| 826 | |||
| 827 | |||
| 828 | |||
| 829 | |||
| 830 | |||
| 831 | =head1 PAGINATORS | ||
| 832 | |||
| 833 | Paginator methods are helpers that repetively call methods that return partial results | ||
| 834 | |||
| 835 | =head2 ListAllGroupResources(sub { },[Filters => ArrayRef[L<Paws::ResourceGroups::ResourceFilter>], Group => Str, GroupName => Str, MaxResults => Int, NextToken => Str]) | ||
| 836 | |||
| 837 | =head2 ListAllGroupResources([Filters => ArrayRef[L<Paws::ResourceGroups::ResourceFilter>], Group => Str, GroupName => Str, MaxResults => Int, NextToken => Str]) | ||
| 838 | |||
| 839 | |||
| 840 | If passed a sub as first parameter, it will call the sub for each element found in : | ||
| 841 | |||
| 842 | - ResourceIdentifiers, passing the object as the first parameter, and the string 'ResourceIdentifiers' as the second parameter | ||
| 843 | |||
| 844 | - Resources, passing the object as the first parameter, and the string 'Resources' as the second parameter | ||
| 845 | |||
| 846 | If not, it will return a a L<Paws::ResourceGroups::ListGroupResourcesOutput> instance with all the C<param>s; andC<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. | ||
| 847 | |||
| 848 | |||
| 849 | =head2 ListAllGroups(sub { },[Filters => ArrayRef[L<Paws::ResourceGroups::GroupFilter>], MaxResults => Int, NextToken => Str]) | ||
| 850 | |||
| 851 | =head2 ListAllGroups([Filters => ArrayRef[L<Paws::ResourceGroups::GroupFilter>], MaxResults => Int, NextToken => Str]) | ||
| 852 | |||
| 853 | |||
| 854 | If passed a sub as first parameter, it will call the sub for each element found in : | ||
| 855 | |||
| 856 | - GroupIdentifiers, passing the object as the first parameter, and the string 'GroupIdentifiers' as the second parameter | ||
| 857 | |||
| 858 | - Groups, passing the object as the first parameter, and the string 'Groups' as the second parameter | ||
| 859 | |||
| 860 | If not, it will return a a L<Paws::ResourceGroups::ListGroupsOutput> instance with all the C<param>s; andC<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. | ||
| 861 | |||
| 862 | |||
| 863 | =head2 SearchAllResources(sub { },ResourceQuery => L<Paws::ResourceGroups::ResourceQuery>, [MaxResults => Int, NextToken => Str]) | ||
| 864 | |||
| 865 | =head2 SearchAllResources(ResourceQuery => L<Paws::ResourceGroups::ResourceQuery>, [MaxResults => Int, NextToken => Str]) | ||
| 866 | |||
| 867 | |||
| 868 | If passed a sub as first parameter, it will call the sub for each element found in : | ||
| 869 | |||
| 870 | - ResourceIdentifiers, passing the object as the first parameter, and the string 'ResourceIdentifiers' as the second parameter | ||
| 871 | |||
| 872 | If not, it will return a a L<Paws::ResourceGroups::SearchResourcesOutput> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. | ||
| 873 | |||
| 874 | |||
| 875 | |||
| 876 | |||
| 877 | |||
| 878 | =head1 SEE ALSO | ||
| 879 | |||
| 880 | This service class forms part of L<Paws> | ||
| 881 | |||
| 882 | =head1 BUGS and CONTRIBUTIONS | ||
| 883 | |||
| 884 | The source code is located here: L<https://github.com/pplu/aws-sdk-perl> | ||
| 885 | |||
| 886 | Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues> | ||
| 887 | |||
| 888 | =cut | ||
| 889 |