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)