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