Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

create_db_subnet_group

create_db_subnet_group(**kwargs)

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the Amazon Region.

See also: AWS API Documentation

Request Syntax

response = client.create_db_subnet_group(
    DBSubnetGroupName='string',
    DBSubnetGroupDescription='string',
    SubnetIds=[
        'string',
    ],
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters
  • DBSubnetGroupName (string) --

    [REQUIRED]

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

    Constraints: Must contain no more than 255 letters, numbers, periods, underscores, spaces, or hyphens. Must not be default.

    Example: mySubnetgroup

  • DBSubnetGroupDescription (string) --

    [REQUIRED]

    The description for the DB subnet group.

  • SubnetIds (list) --

    [REQUIRED]

    The EC2 Subnet IDs for the DB subnet group.

    • (string) --
  • Tags (list) --

    The tags to be assigned to the new DB subnet group.

    • (dict) --

      Metadata assigned to an Amazon Neptune resource consisting of a key-value pair.

      • Key (string) --

        A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and can't be prefixed with aws: or rds: . The string can only contain the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$").

      • Value (string) --

        A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can't be prefixed with aws: or rds: . The string can only contain the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$").

Return type

dict

Returns

Response Syntax

{
    'DBSubnetGroup': {
        'DBSubnetGroupName': 'string',
        'DBSubnetGroupDescription': 'string',
        'VpcId': 'string',
        'SubnetGroupStatus': 'string',
        'Subnets': [
            {
                'SubnetIdentifier': 'string',
                'SubnetAvailabilityZone': {
                    'Name': 'string'
                },
                'SubnetStatus': 'string'
            },
        ],
        'DBSubnetGroupArn': 'string'
    }
}

Response Structure

  • (dict) --

    • DBSubnetGroup (dict) --

      Contains the details of an Amazon Neptune DB subnet group.

      This data type is used as a response element in the DescribeDBSubnetGroups action.

      • DBSubnetGroupName (string) --

        The name of the DB subnet group.

      • DBSubnetGroupDescription (string) --

        Provides the description of the DB subnet group.

      • VpcId (string) --

        Provides the VpcId of the DB subnet group.

      • SubnetGroupStatus (string) --

        Provides the status of the DB subnet group.

      • Subnets (list) --

        Contains a list of Subnet elements.

        • (dict) --

          Specifies a subnet.

          This data type is used as a response element in the DescribeDBSubnetGroups action.

          • SubnetIdentifier (string) --

            Specifies the identifier of the subnet.

          • SubnetAvailabilityZone (dict) --

            Specifies the EC2 Availability Zone that the subnet is in.

            • Name (string) --

              The name of the availability zone.

          • SubnetStatus (string) --

            Specifies the status of the subnet.

      • DBSubnetGroupArn (string) --

        The Amazon Resource Name (ARN) for the DB subnet group.

Exceptions

  • Neptune.Client.exceptions.DBSubnetGroupAlreadyExistsFault
  • Neptune.Client.exceptions.DBSubnetGroupQuotaExceededFault
  • Neptune.Client.exceptions.DBSubnetQuotaExceededFault
  • Neptune.Client.exceptions.DBSubnetGroupDoesNotCoverEnoughAZs
  • Neptune.Client.exceptions.InvalidSubnet