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 NodeGroupIds 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 NodeGroupIds 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).

SEE ALSO

This class forms part of Paws, documenting arguments for method ModifyReplicationGroupShardConfiguration in Paws::ElastiCache

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