pem quota-mgmt rating-group

pem quota-mgmt rating-group(1)				BIG-IP TMSH Manual			    pem quota-mgmt rating-group(1)

NAME
       rating-group - Configures a rating-group for quota management in Policy Enforcement Manager (PEM).

MODULE
       pem quota management

SYNTAX
       Modify the rating-group component within the pem quota-mgmt module using the syntax shown in the following sections.

   CREATE/MODIFY
	create rating-group [name]
	modify rating-group [name]
	  options:
	    app-service [[string] | none]
	    rating-group-id [integer]
	    description [string]
	    request-on-install [yes | no]
	    default-threshold [integer]
	    default-validity-time [integer]
	    default-quota-holding-time [integer]
	    initial-quota-request {
		interval [integer]
		volume {
		    input-octets
		    output-octets
		    total-octets
	       }
	    default-quota {
		interval [integer]
		volume {
		    input-octets
		    output-octets
		    total-octets
	       }
	       time {
		   usage-time
		   consumption-time
	       }
	    default-breach-action [terminate | allow | redirect]
	    default-forwarding-endpoint [name]

	edit rating-group [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties

   DISPLAY
	list rating-group
	list rating-group [ [ [name] | [glob] | [regex] ] ... ]
	show running-config rating-group
	show running-config rating-group [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties
	    one-line
	    partition

   DELETE
	delete rating-group [name]

       Note: You must remove all references to a rating-group object before you can delete it.

EXAMPLES
       create rating-group rg1 {
	   rating-group-id 1
	   initial-quota-request {
	       volume {
		    input-octets 1000		output-octets 1000	     total-octets 2000
	       }
	   }
	   default-quota {
	       volume {
		   input-octets 1000	      output-octets 1000	  total-octets 2000
	       }
	   }
	   request-on-install yes }

       Creates a PEM rating-group named rg1.

       delete rating-group rg1

       Deletes the rating-group named rg1.

       list rating-group rg1

       Displays the properties of the rating-group named rg1.

OPTIONS
       app-service
	    Specifies the name of the application service to which the object belongs. The default value is none. Note: If the
	    strict-updates option is enabled on the application service that owns the object, you cannot modify or delete the
	    object. Only the application service can modify or delete the object.

       rating-group-id
	    Specifies the rating-group-id that will be used by quota managing endpoint. For instance, this could be the rating
	    group in case of Gy endpoint.

       request-on-install
	    Specifies whether quota has to be requested from the quota managing endpoint (Eg : Gy) when policy referring to this
	    rating-group is installed for a subscriber or later when flow is initiated.

       default-threshold
	    Specifies the default threshold if the quota managing endpoint does not specify threshold.

       default-validity-time
	    Specifies the default validity time for the quota in seconds if OCS did not specify it.

       default-quota-holding-time
	    Specifies the default quota holding time in seconds for which quota is valid without any usage if not specified by
	    OCS.

       initial-quota-request
	    Specifies the initial quota, that will be requested from the quota managing endpoint. Could be either time or volume.

	    time Specifies the time in seconds.

	    volume
		 You can configure the following options for volume initial quota.

		 output-octets
		      Specifies the initial quota for downlink traffic.

		 total-octets
		      Specifies the initial quota for total uplink and downlink traffic.

		 input-octets
		      Specifies the initial quota for uplink traffic.

       default-quota
	    Specifies the default quota, that will be used if quota managing endpoint does not respond. Could be either time or
	    volume.

	    time Specifies the quota in time.

		 usage-time
		      Specifies the usage time in seconds.

		 consumption-time
		      Specifies the quota consumption time in seconds.

	    volume
		 You can configure the following options for volume default quota.

		 output-octets
		      Specifies the default quota for downlink traffic.

		 total-octets
		      Specifies the default quota for total uplink and downlink traffic.

		 input-octets
		      Specifies the default quota for uplink traffic.

SEE ALSO
       create, delete, edit, glob, list, modify, pem policy, show, tmsh

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or by any means, electronic or mechanical, including
       photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchaser's personal
       use, without the express written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2012-2013, 2015. All rights reserved.

BIG-IP							    2016-01-07				    pem quota-mgmt rating-group(1)