ElastiCache / Client / modify_cache_subnet_group

modify_cache_subnet_group#

ElastiCache.Client.modify_cache_subnet_group(**kwargs)#

Modifies an existing cache subnet group.

See also: AWS API Documentation

Request Syntax

response = client.modify_cache_subnet_group(
    CacheSubnetGroupName='string',
    CacheSubnetGroupDescription='string',
    SubnetIds=[
        'string',
    ]
)
Parameters:
  • CacheSubnetGroupName (string) –

    [REQUIRED]

    The name for the cache subnet group. This value is stored as a lowercase string.

    Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

    Example: mysubnetgroup

  • CacheSubnetGroupDescription (string) – A description of the cache subnet group.

  • SubnetIds (list) –

    The EC2 subnet IDs for the cache subnet group.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'CacheSubnetGroup': {
        'CacheSubnetGroupName': 'string',
        'CacheSubnetGroupDescription': 'string',
        'VpcId': 'string',
        'Subnets': [
            {
                'SubnetIdentifier': 'string',
                'SubnetAvailabilityZone': {
                    'Name': 'string'
                },
                'SubnetOutpost': {
                    'SubnetOutpostArn': 'string'
                },
                'SupportedNetworkTypes': [
                    'ipv4'|'ipv6'|'dual_stack',
                ]
            },
        ],
        'ARN': 'string',
        'SupportedNetworkTypes': [
            'ipv4'|'ipv6'|'dual_stack',
        ]
    }
}

Response Structure

  • (dict) –

    • CacheSubnetGroup (dict) –

      Represents the output of one of the following operations:

      • CreateCacheSubnetGroup

      • ModifyCacheSubnetGroup

      • CacheSubnetGroupName (string) –

        The name of the cache subnet group.

      • CacheSubnetGroupDescription (string) –

        The description of the cache subnet group.

      • VpcId (string) –

        The Amazon Virtual Private Cloud identifier (VPC ID) of the cache subnet group.

      • Subnets (list) –

        A list of subnets associated with the cache subnet group.

        • (dict) –

          Represents the subnet associated with a cluster. This parameter refers to subnets defined in Amazon Virtual Private Cloud (Amazon VPC) and used with ElastiCache.

          • SubnetIdentifier (string) –

            The unique identifier for the subnet.

          • SubnetAvailabilityZone (dict) –

            The Availability Zone associated with the subnet.

            • Name (string) –

              The name of the Availability Zone.

          • SubnetOutpost (dict) –

            The outpost ARN of the subnet.

            • SubnetOutpostArn (string) –

              The outpost ARN of the subnet.

          • SupportedNetworkTypes (list) –

            Either ipv4 | ipv6 | dual_stack. IPv6 is supported for workloads using Redis OSS engine version 6.2 onward or Memcached engine version 1.6.6 on all instances built on the Nitro system.

            • (string) –

      • ARN (string) –

        The ARN (Amazon Resource Name) of the cache subnet group.

      • SupportedNetworkTypes (list) –

        Either ipv4 | ipv6 | dual_stack. IPv6 is supported for workloads using Redis OSS engine version 6.2 onward or Memcached engine version 1.6.6 on all instances built on the Nitro system.

        • (string) –

Exceptions

  • ElastiCache.Client.exceptions.CacheSubnetGroupNotFoundFault

  • ElastiCache.Client.exceptions.CacheSubnetQuotaExceededFault

  • ElastiCache.Client.exceptions.SubnetInUse

  • ElastiCache.Client.exceptions.InvalidSubnet

  • ElastiCache.Client.exceptions.SubnetNotAllowedFault

Examples

Modifies an existing ElastiCache subnet group.

response = client.modify_cache_subnet_group(
    CacheSubnetGroupName='my-sn-grp',
    SubnetIds=[
        'subnet-bcde2345',
    ],
)

print(response)

Expected Output:

{
    'CacheSubnetGroup': {
        'CacheSubnetGroupDescription': 'My subnet group.',
        'CacheSubnetGroupName': 'my-sn-grp',
        'Subnets': [
            {
                'SubnetAvailabilityZone': {
                    'Name': 'us-east-1c',
                },
                'SubnetIdentifier': 'subnet-a1b2c3d4',
            },
            {
                'SubnetAvailabilityZone': {
                    'Name': 'us-east-1e',
                },
                'SubnetIdentifier': 'subnet-1a2b3c4d',
            },
            {
                'SubnetAvailabilityZone': {
                    'Name': 'us-east-1e',
                },
                'SubnetIdentifier': 'subnet-bcde2345',
            },
            {
                'SubnetAvailabilityZone': {
                    'Name': 'us-east-1c',
                },
                'SubnetIdentifier': 'subnet-1234abcd',
            },
            {
                'SubnetAvailabilityZone': {
                    'Name': 'us-east-1b',
                },
                'SubnetIdentifier': 'subnet-abcd1234',
            },
        ],
        'VpcId': 'vpc-91280df6',
    },
    'ResponseMetadata': {
        '...': '...',
    },
}