NAME

Paws::ElastiCache::ModifyReplicationGroupShardConfiguration - Arguments for method ModifyReplicationGroupShardConfiguration on Paws::ElastiCache

DESCRIPTION

This class represents the parameters used for calling the method ModifyReplicationGroupShardConfiguration on the Amazon ElastiCache service. Use the attributes of this class as arguments to method ModifyReplicationGroupShardConfiguration.

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

SYNOPSIS

    my $elasticache = Paws->service('ElastiCache');
    my $ModifyReplicationGroupShardConfigurationResult =
      $elasticache->ModifyReplicationGroupShardConfiguration(
      ApplyImmediately   => 1,
      NodeGroupCount     => 1,
      ReplicationGroupId => 'MyString',
      NodeGroupsToRemove => [
        'MyAllowedNodeGroupId', ...    # min: 1, max: 4
      ],    # OPTIONAL
      NodeGroupsToRetain => [
        'MyAllowedNodeGroupId', ...    # min: 1, max: 4
      ],    # OPTIONAL
      ReshardingConfiguration => [
        {
          NodeGroupId                => 'MyAllowedNodeGroupId', # min: 1, max: 4
          PreferredAvailabilityZones => [ 'MyString', ... ],    # OPTIONAL
        },
        ...
      ],    # OPTIONAL
      );
    # Results:
    my $ReplicationGroup =
      $ModifyReplicationGroupShardConfigurationResult->ReplicationGroup;

# Returns a Paws::ElastiCache::ModifyReplicationGroupShardConfigurationResult 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/elasticache/ModifyReplicationGroupShardConfiguration>

ATTRIBUTES

REQUIRED ApplyImmediately => Bool

Indicates that the shard reconfiguration process begins immediately. At present, the only permitted value for this parameter is "true".

Value: true

REQUIRED NodeGroupCount => Int

The number of node groups (shards) that results from the modification of the shard configuration.

NodeGroupsToRemove => ArrayRef[Str|Undef]

If the value of "NodeGroupCount" is less than the current number of node groups (shards), then either "NodeGroupsToRemove" or "NodeGroupsToRetain" is required. "NodeGroupsToRemove" is a list of "NodeGroupId"s to remove from the cluster.

ElastiCache for Redis will attempt to remove all node groups listed by "NodeGroupsToRemove" from the cluster.

NodeGroupsToRetain => ArrayRef[Str|Undef]

If the value of "NodeGroupCount" is less than the current number of node groups (shards), then either "NodeGroupsToRemove" or "NodeGroupsToRetain" is required. "NodeGroupsToRetain" is a list of "NodeGroupId"s to retain in the cluster.

ElastiCache for Redis will attempt to remove all node groups except those listed by "NodeGroupsToRetain" from the cluster.

REQUIRED ReplicationGroupId => Str

The name of the Redis (cluster mode enabled) cluster (replication group) on which the shards are to be configured.

ReshardingConfiguration => ArrayRef[Paws::ElastiCache::ReshardingConfiguration]

Specifies the preferred availability zones for each node group in the cluster. If the value of "NodeGroupCount" is greater than the current number of node groups (shards), you can use this parameter to specify the preferred availability zones of the cluster's shards. If you omit this parameter ElastiCache selects availability zones for you.

You can specify this parameter only if the value of "NodeGroupCount" is greater than the current number of node groups (shards).

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>