describe_subnet_groups

describe_subnet_groups(**kwargs)

Returns a list of subnet group descriptions. If a subnet group name is specified, the list contains only the description of that group.

See also: AWS API Documentation

Request Syntax

response = client.describe_subnet_groups(
    SubnetGroupName='string',
    MaxResults=123,
    NextToken='string'
)

Parameters

• SubnetGroupName (string) -- The name of the subnet group to return details for.
• MaxResults (integer) -- The maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
• NextToken (string) -- An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'SubnetGroups': [
        {
            'Name': 'string',
            'Description': 'string',
            'VpcId': 'string',
            'Subnets': [
                {
                    'Identifier': 'string',
                    'AvailabilityZone': {
                        'Name': 'string'
                    }
                },
            ],
            'ARN': 'string'
        },
    ]
}

Response Structure

• (dict) --

  • NextToken (string) --

    An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

  • SubnetGroups (list) --

    A list of subnet groups. Each element in the list contains detailed information about one group.

    • (dict) --

      Represents the output of one of the following operations:

      • CreateSubnetGroup
      • UpdateSubnetGroup

      A subnet group is a collection of subnets (typically private) that you can designate for your clusters running in an Amazon Virtual Private Cloud (VPC) environment.

      • Name (string) --

        The name of the subnet group

      • Description (string) --

        A description of the subnet group

      • VpcId (string) --

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

      • Subnets (list) --

        A list of subnets associated with the 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 MemoryDB.

          • Identifier (string) --

            The unique identifier for the subnet.

          • AvailabilityZone (dict) --

            The Availability Zone where the subnet resides

            • Name (string) --

              The name of the Availability Zone.

      • ARN (string) --

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

Exceptions

• MemoryDB.Client.exceptions.SubnetGroupNotFoundFault
• MemoryDB.Client.exceptions.ServiceLinkedRoleNotFoundFault