Neptune Parameters API - Amazon Neptune

Neptune Parameters API

Structures:

Actions:

Parameter (structure)

Specifies a parameter.

Fields

  • AllowedValues – UTF-8 string.

    Specifies the valid range of values for the parameter.

  • ApplyMethod – UTF-8 string (valid values: immediate="" | pending-reboot="").

    Indicates when to apply parameter updates.

  • ApplyType – UTF-8 string.

    Specifies the engine specific parameters type.

  • DataType – UTF-8 string.

    Specifies the valid data type for the parameter.

  • Description – UTF-8 string.

    Provides a description of the parameter.

  • IsModifiable – Boolean.

    Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

  • MinimumEngineVersion – UTF-8 string.

    The earliest engine version to which the parameter can apply.

  • ParameterName – UTF-8 string.

    Specifies the name of the parameter.

  • ParameterValue – UTF-8 string.

    Specifies the value of the parameter.

  • Source – UTF-8 string.

    Indicates the source of the parameter value.

DBParameterGroup (structure)

Contains the details of an Amazon Neptune DB parameter group.

This data type is used as a response element in the DescribeDBParameterGroups (action) action.

Fields

  • DBParameterGroupArn – UTF-8 string.

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

  • DBParameterGroupFamily – UTF-8 string.

    Provides the name of the DB parameter group family that this DB parameter group is compatible with.

  • DBParameterGroupName – UTF-8 string.

    Provides the name of the DB parameter group.

  • Description – UTF-8 string.

    Provides the customer-specified description for this DB parameter group.

DBParameterGroup is used as the response element for:

DBClusterParameterGroup (structure)

Contains the details of an Amazon Neptune DB cluster parameter group.

This data type is used as a response element in the DescribeDBClusterParameterGroups (action) action.

Fields

  • DBClusterParameterGroupArn – UTF-8 string.

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

  • DBClusterParameterGroupName – UTF-8 string.

    Provides the name of the DB cluster parameter group.

  • DBParameterGroupFamily – UTF-8 string.

    Provides the name of the DB parameter group family that this DB cluster parameter group is compatible with.

  • Description – UTF-8 string.

    Provides the customer-specified description for this DB cluster parameter group.

DBClusterParameterGroup is used as the response element for:

DBParameterGroupStatus (structure)

The status of the DB parameter group.

This data type is used as a response element in the following actions:

Fields

  • DBParameterGroupName – UTF-8 string.

    The name of the DP parameter group.

  • ParameterApplyStatus – UTF-8 string.

    The status of parameter updates.

CopyDBParameterGroup (action)

        The AWS CLI name for this API is: copy-db-parameter-group,  and the Python name is: copy_db_parameter_group.

Copies the specified DB parameter group.

Request

  • SourceDBParameterGroupIdentifier  (in the CLI: --source-db-parameter-group-identifier,  or in Python: source_db_parameter_group_identifier) – Required: UTF-8 string.

    The identifier or ARN for the source DB parameter group. For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

    Constraints:

    • Must specify a valid DB parameter group.

    • Must specify a valid DB parameter group identifier, for example my-db-param-group, or a valid ARN.

  • Tags  (in the CLI: --tags,  or in Python: tags) – An array of Tag Tag objects.

    The tags to be assigned to the copied DB parameter group.

  • TargetDBParameterGroupDescription  (in the CLI: --target-db-parameter-group-description,  or in Python: target_db_parameter_group_description) – Required: UTF-8 string.

    A description for the copied DB parameter group.

  • TargetDBParameterGroupIdentifier  (in the CLI: --target-db-parameter-group-identifier,  or in Python: target_db_parameter_group_identifier) – Required: UTF-8 string.

    The identifier for the copied DB parameter group.

    Constraints:

    • Cannot be null, empty, or blank.

    • Must contain from 1 to 255 letters, numbers, or hyphens.

    • First character must be a letter.

    • Cannot end with a hyphen or contain two consecutive hyphens.

    Example: my-db-parameter-group

Response

Contains the details of an Amazon Neptune DB parameter group.

This data type is used as a response element in the DescribeDBParameterGroups (action) action.

  • DBParameterGroupArn  (in the CLI: --db-parameter-group-arn,  or in Python: db_parameter_group_arn) – UTF-8 string.

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

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – UTF-8 string.

    Provides the name of the DB parameter group family that this DB parameter group is compatible with.

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – UTF-8 string.

    Provides the name of the DB parameter group.

  • Description  (in the CLI: --description,  or in Python: description) – UTF-8 string.

    Provides the customer-specified description for this DB parameter group.

CopyDBClusterParameterGroup (action)

        The AWS CLI name for this API is: copy-db-cluster-parameter-group,  and the Python name is: copy_db_cluster_parameter_group.

Copies the specified DB cluster parameter group.

Request

  • SourceDBClusterParameterGroupIdentifier  (in the CLI: --source-db-cluster-parameter-group-identifier,  or in Python: source_db_cluster_parameter_group_identifier) – Required: UTF-8 string.

    The identifier or Amazon Resource Name (ARN) for the source DB cluster parameter group. For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

    Constraints:

    • Must specify a valid DB cluster parameter group.

    • If the source DB cluster parameter group is in the same AWS Region as the copy, specify a valid DB parameter group identifier, for example my-db-cluster-param-group, or a valid ARN.

    • If the source DB parameter group is in a different AWS Region than the copy, specify a valid DB cluster parameter group ARN, for example arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1.

  • Tags  (in the CLI: --tags,  or in Python: tags) – An array of Tag Tag objects.

    The tags to be assigned to the copied DB cluster parameter group.

  • TargetDBClusterParameterGroupDescription  (in the CLI: --target-db-cluster-parameter-group-description,  or in Python: target_db_cluster_parameter_group_description) – Required: UTF-8 string.

    A description for the copied DB cluster parameter group.

  • TargetDBClusterParameterGroupIdentifier  (in the CLI: --target-db-cluster-parameter-group-identifier,  or in Python: target_db_cluster_parameter_group_identifier) – Required: UTF-8 string.

    The identifier for the copied DB cluster parameter group.

    Constraints:

    • Cannot be null, empty, or blank

    • Must contain from 1 to 255 letters, numbers, or hyphens

    • First character must be a letter

    • Cannot end with a hyphen or contain two consecutive hyphens

    Example: my-cluster-param-group1

Response

Contains the details of an Amazon Neptune DB cluster parameter group.

This data type is used as a response element in the DescribeDBClusterParameterGroups (action) action.

  • DBClusterParameterGroupArn  (in the CLI: --db-cluster-parameter-group-arn,  or in Python: db_cluster_parameter_group_arn) – UTF-8 string.

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

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – UTF-8 string.

    Provides the name of the DB cluster parameter group.

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – UTF-8 string.

    Provides the name of the DB parameter group family that this DB cluster parameter group is compatible with.

  • Description  (in the CLI: --description,  or in Python: description) – UTF-8 string.

    Provides the customer-specified description for this DB cluster parameter group.

CreateDBParameterGroup (action)

        The AWS CLI name for this API is: create-db-parameter-group,  and the Python name is: create_db_parameter_group.

Creates a new DB parameter group.

A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.

Important

After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon Neptune to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

Request

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – Required: UTF-8 string.

    The DB parameter group family name. A DB parameter group can be associated with one and only one DB parameter group family, and can be applied only to a DB instance running a database engine and engine version compatible with that DB parameter group family.

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – Required: UTF-8 string.

    The name of the DB parameter group.

    Constraints:

    • Must be 1 to 255 letters, numbers, or hyphens.

    • First character must be a letter

    • Cannot end with a hyphen or contain two consecutive hyphens

    Note

    This value is stored as a lowercase string.

  • Description  (in the CLI: --description,  or in Python: description) – Required: UTF-8 string.

    The description for the DB parameter group.

  • Tags  (in the CLI: --tags,  or in Python: tags) – An array of Tag Tag objects.

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

Response

Contains the details of an Amazon Neptune DB parameter group.

This data type is used as a response element in the DescribeDBParameterGroups (action) action.

  • DBParameterGroupArn  (in the CLI: --db-parameter-group-arn,  or in Python: db_parameter_group_arn) – UTF-8 string.

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

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – UTF-8 string.

    Provides the name of the DB parameter group family that this DB parameter group is compatible with.

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – UTF-8 string.

    Provides the name of the DB parameter group.

  • Description  (in the CLI: --description,  or in Python: description) – UTF-8 string.

    Provides the customer-specified description for this DB parameter group.

CreateDBClusterParameterGroup (action)

        The AWS CLI name for this API is: create-db-cluster-parameter-group,  and the Python name is: create_db_cluster_parameter_group.

Creates a new DB cluster parameter group.

Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.

A DB cluster parameter group is initially created with the default parameters for the database engine used by instances in the DB cluster. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBClusterParameterGroup (action). Once you've created a DB cluster parameter group, you need to associate it with your DB cluster using ModifyDBCluster (action). When you associate a new DB cluster parameter group with a running DB cluster, you need to reboot the DB instances in the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.

Important

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon Neptune to fully complete the create action before the DB cluster parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBClusterParameters (action) command to verify that your DB cluster parameter group has been created or modified.

Request

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – Required: UTF-8 string.

    The name of the DB cluster parameter group.

    Constraints:

    • Must match the name of an existing DBClusterParameterGroup.

    Note

    This value is stored as a lowercase string.

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – Required: UTF-8 string.

    The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.

  • Description  (in the CLI: --description,  or in Python: description) – Required: UTF-8 string.

    The description for the DB cluster parameter group.

  • Tags  (in the CLI: --tags,  or in Python: tags) – An array of Tag Tag objects.

    The tags to be assigned to the new DB cluster parameter group.

Response

Contains the details of an Amazon Neptune DB cluster parameter group.

This data type is used as a response element in the DescribeDBClusterParameterGroups (action) action.

  • DBClusterParameterGroupArn  (in the CLI: --db-cluster-parameter-group-arn,  or in Python: db_cluster_parameter_group_arn) – UTF-8 string.

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

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – UTF-8 string.

    Provides the name of the DB cluster parameter group.

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – UTF-8 string.

    Provides the name of the DB parameter group family that this DB cluster parameter group is compatible with.

  • Description  (in the CLI: --description,  or in Python: description) – UTF-8 string.

    Provides the customer-specified description for this DB cluster parameter group.

DeleteDBParameterGroup (action)

        The AWS CLI name for this API is: delete-db-parameter-group,  and the Python name is: delete_db_parameter_group.

Deletes a specified DBParameterGroup. The DBParameterGroup to be deleted can't be associated with any DB instances.

Request

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – Required: UTF-8 string.

    The name of the DB parameter group.

    Constraints:

    • Must be the name of an existing DB parameter group

    • You can't delete a default DB parameter group

    • Cannot be associated with any DB instances

Response

  • No Response parameters.

DeleteDBClusterParameterGroup (action)

        The AWS CLI name for this API is: delete-db-cluster-parameter-group,  and the Python name is: delete_db_cluster_parameter_group.

Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.

Request

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – Required: UTF-8 string.

    The name of the DB cluster parameter group.

    Constraints:

    • Must be the name of an existing DB cluster parameter group.

    • You can't delete a default DB cluster parameter group.

    • Cannot be associated with any DB clusters.

Response

  • No Response parameters.

ModifyDBParameterGroup (action)

        The AWS CLI name for this API is: modify-db-parameter-group,  and the Python name is: modify_db_parameter_group.

Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Note

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance associated with the parameter group before the change can take effect.

Important

After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon Neptune to fully complete the modify action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

Request

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – Required: UTF-8 string.

    The name of the DB parameter group.

    Constraints:

    • If supplied, must match the name of an existing DBParameterGroup.

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – Required: An array of Parameter Parameter objects.

    An array of parameter names, values, and the apply method for the parameter update. At least one parameter name, value, and apply method must be supplied; subsequent arguments are optional. A maximum of 20 parameters can be modified in a single request.

    Valid Values (for the application method): immediate | pending-reboot

    Note

    You can use the immediate value with dynamic parameters only. You can use the pending-reboot value for both dynamic and static parameters, and changes are applied when you reboot the DB instance without failover.

Response

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – UTF-8 string.

    Provides the name of the DB parameter group.

ModifyDBClusterParameterGroup (action)

        The AWS CLI name for this API is: modify-db-cluster-parameter-group,  and the Python name is: modify_db_cluster_parameter_group.

Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Note

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB cluster associated with the parameter group before the change can take effect.

Important

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon Neptune to fully complete the create action before the parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBClusterParameters (action) command to verify that your DB cluster parameter group has been created or modified.

Request

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – Required: UTF-8 string.

    The name of the DB cluster parameter group to modify.

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – Required: An array of Parameter Parameter objects.

    A list of parameters in the DB cluster parameter group to modify.

Response

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – UTF-8 string.

    The name of the DB cluster parameter group.

    Constraints:

    • Must be 1 to 255 letters or numbers.

    • First character must be a letter

    • Cannot end with a hyphen or contain two consecutive hyphens

    Note

    This value is stored as a lowercase string.

ResetDBParameterGroup (action)

        The AWS CLI name for this API is: reset-db-parameter-group,  and the Python name is: reset_db_parameter_group.

Modifies the parameters of a DB parameter group to the engine/system default value. To reset specific parameters, provide a list of the following: ParameterName and ApplyMethod. To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request.

Request

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – Required: UTF-8 string.

    The name of the DB parameter group.

    Constraints:

    • Must match the name of an existing DBParameterGroup.

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – An array of Parameter Parameter objects.

    To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. To reset specific parameters, provide a list of the following: ParameterName and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

    Valid Values (for Apply method): pending-reboot

  • ResetAllParameters  (in the CLI: --reset-all-parameters,  or in Python: reset_all_parameters) – Boolean.

    Specifies whether (true) or not (false) to reset all parameters in the DB parameter group to default values.

    Default: true

Response

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – UTF-8 string.

    Provides the name of the DB parameter group.

ResetDBClusterParameterGroup (action)

        The AWS CLI name for this API is: reset-db-cluster-parameter-group,  and the Python name is: reset_db_cluster_parameter_group.

Modifies the parameters of a DB cluster parameter group to the default value. To reset specific parameters submit a list of the following: ParameterName and ApplyMethod. To reset the entire DB cluster parameter group, specify the DBClusterParameterGroupName and ResetAllParameters parameters.

When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance (action) request. You must call RebootDBInstance (action) for every DB instance in your DB cluster that you want the updated static parameter to apply to.

Request

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – Required: UTF-8 string.

    The name of the DB cluster parameter group to reset.

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – An array of Parameter Parameter objects.

    A list of parameter names in the DB cluster parameter group to reset to the default values. You can't use this parameter if the ResetAllParameters parameter is set to true.

  • ResetAllParameters  (in the CLI: --reset-all-parameters,  or in Python: reset_all_parameters) – Boolean.

    A value that is set to true to reset all parameters in the DB cluster parameter group to their default values, and false otherwise. You can't use this parameter if there is a list of parameter names specified for the Parameters parameter.

Response

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – UTF-8 string.

    The name of the DB cluster parameter group.

    Constraints:

    • Must be 1 to 255 letters or numbers.

    • First character must be a letter

    • Cannot end with a hyphen or contain two consecutive hyphens

    Note

    This value is stored as a lowercase string.

DescribeDBParameters (action)

        The AWS CLI name for this API is: describe-db-parameters,  and the Python name is: describe_db_parameters.

Returns the detailed parameter list for a particular DB parameter group.

Request

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – Required: UTF-8 string.

    The name of a specific DB parameter group to return details for.

    Constraints:

    • If supplied, must match the name of an existing DBParameterGroup.

  • Filters  (in the CLI: --filters,  or in Python: filters) – An array of Filter Filter objects.

    This parameter is not currently supported.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeDBParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

  • MaxRecords  (in the CLI: --max-records,  or in Python: max_records) – Number (integer).

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

    Default: 100

    Constraints: Minimum 20, maximum 100.

  • Source  (in the CLI: --source,  or in Python: source) – UTF-8 string.

    The parameter types to return.

    Default: All parameter types returned

    Valid Values: user | system | engine-default

Response

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – An array of Parameter Parameter objects.

    A list of Parameter (structure) values.

DescribeDBParameterGroups (action)

        The AWS CLI name for this API is: describe-db-parameter-groups,  and the Python name is: describe_db_parameter_groups.

Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, the list will contain only the description of the specified DB parameter group.

Request

  • DBParameterGroupName  (in the CLI: --db-parameter-group-name,  or in Python: db_parameter_group_name) – UTF-8 string.

    The name of a specific DB parameter group to return details for.

    Constraints:

    • If supplied, must match the name of an existing DBClusterParameterGroup.

  • Filters  (in the CLI: --filters,  or in Python: filters) – An array of Filter Filter objects.

    This parameter is not currently supported.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeDBParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

  • MaxRecords  (in the CLI: --max-records,  or in Python: max_records) – Number (integer).

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

    Default: 100

    Constraints: Minimum 20, maximum 100.

Response

  • DBParameterGroups  (in the CLI: --db-parameter-groups,  or in Python: db_parameter_groups) – An array of DBParameterGroup DBParameterGroup objects.

    A list of DBParameterGroup (structure) instances.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

DescribeDBClusterParameters (action)

        The AWS CLI name for this API is: describe-db-cluster-parameters,  and the Python name is: describe_db_cluster_parameters.

Returns the detailed parameter list for a particular DB cluster parameter group.

Request

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – Required: UTF-8 string.

    The name of a specific DB cluster parameter group to return parameter details for.

    Constraints:

    • If supplied, must match the name of an existing DBClusterParameterGroup.

  • Filters  (in the CLI: --filters,  or in Python: filters) – An array of Filter Filter objects.

    This parameter is not currently supported.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

  • MaxRecords  (in the CLI: --max-records,  or in Python: max_records) – Number (integer).

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

    Default: 100

    Constraints: Minimum 20, maximum 100.

  • Source  (in the CLI: --source,  or in Python: source) – UTF-8 string.

    A value that indicates to return only parameters for a specific source. Parameter sources can be engine, service, or customer.

Response

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – An array of Parameter Parameter objects.

    Provides a list of parameters for the DB cluster parameter group.

DescribeDBClusterParameterGroups (action)

        The AWS CLI name for this API is: describe-db-cluster-parameter-groups,  and the Python name is: describe_db_cluster_parameter_groups.

Returns a list of DBClusterParameterGroup descriptions. If a DBClusterParameterGroupName parameter is specified, the list will contain only the description of the specified DB cluster parameter group.

Request

  • DBClusterParameterGroupName  (in the CLI: --db-cluster-parameter-group-name,  or in Python: db_cluster_parameter_group_name) – UTF-8 string.

    The name of a specific DB cluster parameter group to return details for.

    Constraints:

    • If supplied, must match the name of an existing DBClusterParameterGroup.

  • Filters  (in the CLI: --filters,  or in Python: filters) – An array of Filter Filter objects.

    This parameter is not currently supported.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

  • MaxRecords  (in the CLI: --max-records,  or in Python: max_records) – Number (integer).

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

    Default: 100

    Constraints: Minimum 20, maximum 100.

Response

  • DBClusterParameterGroups  (in the CLI: --db-cluster-parameter-groups,  or in Python: db_cluster_parameter_groups) – An array of DBClusterParameterGroup DBClusterParameterGroup objects.

    A list of DB cluster parameter groups.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

DescribeEngineDefaultParameters (action)

        The AWS CLI name for this API is: describe-engine-default-parameters,  and the Python name is: describe_engine_default_parameters.

Returns the default engine and system parameter information for the specified database engine.

Request

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – Required: UTF-8 string.

    The name of the DB parameter group family.

  • Filters  (in the CLI: --filters,  or in Python: filters) – An array of Filter Filter objects.

    Not currently supported.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeEngineDefaultParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

  • MaxRecords  (in the CLI: --max-records,  or in Python: max_records) – Number (integer).

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

    Default: 100

    Constraints: Minimum 20, maximum 100.

Response

Contains the result of a successful invocation of the DescribeEngineDefaultParameters (action) action.

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – UTF-8 string.

    Specifies the name of the DB parameter group family that the engine default parameters apply to.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous EngineDefaults request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – An array of Parameter Parameter objects.

    Contains a list of engine default parameters.

DescribeEngineDefaultClusterParameters (action)

        The AWS CLI name for this API is: describe-engine-default-cluster-parameters,  and the Python name is: describe_engine_default_cluster_parameters.

Returns the default engine and system parameter information for the cluster database engine.

Request

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – Required: UTF-8 string.

    The name of the DB cluster parameter group family to return engine parameter information for.

  • Filters  (in the CLI: --filters,  or in Python: filters) – An array of Filter Filter objects.

    This parameter is not currently supported.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous DescribeEngineDefaultClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

  • MaxRecords  (in the CLI: --max-records,  or in Python: max_records) – Number (integer).

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

    Default: 100

    Constraints: Minimum 20, maximum 100.

Response

Contains the result of a successful invocation of the DescribeEngineDefaultParameters (action) action.

  • DBParameterGroupFamily  (in the CLI: --db-parameter-group-family,  or in Python: db_parameter_group_family) – UTF-8 string.

    Specifies the name of the DB parameter group family that the engine default parameters apply to.

  • Marker  (in the CLI: --marker,  or in Python: marker) – UTF-8 string.

    An optional pagination token provided by a previous EngineDefaults request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

  • Parameters  (in the CLI: --parameters,  or in Python: parameters) – An array of Parameter Parameter objects.

    Contains a list of engine default parameters.