sys url-db url-category

sys url-db url-category(1)    BIG-IP TMSH Manual    sys url-db url-category(1)



NAME
       url-category - Configures URL categories for URL classification and
       filtering

MODULE
       sys url-db

SYNTAX
       Configure a url-category component within the  module using
       the syntax shown in the following sections.

   CREATE/MODIFY
       Each url-category consists of the object name
       (/Common/Business_and_Economy), a display-name ("Business and Economy")
       which is a more user-friendly category name, and a category number. The
       hundreds and thousands of URLs under a url-category are stored in a
       database. You can create your own url-category (custom category) and
       you can add more URLs to an existing category (recategorization).

	create url-db url-category [name]
	  options:
	    display-name [string]
	    description [string]
	    initial-disposition [integer]
	    is-security-category [string]
	    parent-cat-number [integer]
	    severity-level [integer]
	    urls [add | delete | modify | replace-all-with] {
		[string]
	    }

	modify url-db url-category [name]
	    initial-disposition [integer]
	    is-security-category [string]
	    parent-cat-number [integer]
	    severity-level [integer]
	    urls [add | delete | modify | replace-all-with] {
		[string]
	    }

   DISPLAY
	list url-category
	list url-category [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties
	    one-line
	    partition

DESCRIPTION
       Configures a url-category

       NOTE: When you create a new url-category, you must provide a display-
       name. However, after creation it cannot be changed to another value.
       The system will provide a cat-number for your newly created url-
       category. The number is an integer greater than 1900. The url-category
       you create is considered to be a custom URL category, and so the is-
       custom flag will be set to true.

       NOTE: The only change you can make to a system provided url-category is
       to add one or more URLs to its list of URLs. This is called
       recategorization, and the is-recategory flag will be set to true. You
       need to do this if the URL does not already exist in the database.

EXAMPLES
       create url-category my-own-url-cat display-name "My Own URL Category"
       urls add { http://a.url.com http://www.another.url.org }

       Creates a new url-category. The new url-category you create is known as
       a custom category, as opposed to a system provided url-category. In
       this case, you must specify the display-name and at least one URL.

       modify url-category my-own-url initial-disposition 4 parent-category 0

       Modify the initial-disposition and parent-category in a customized url-
       category.

       modify url-category Business_and_Economy urls add {
       http://www.theneomarxist.com }

       Modify a system provided url-category by adding a URL to it. This
       action is called recategorization. The url-category is recategorized.

OPTIONS
       cat-number
	    Shows a unique category number. Custom URL categories have numbers
	    greater than 1900. This is a read-only attribute.

       description
	    Specifies a unique description for the URL category.

       display-name
	    Specifies a user-friendly name that describes what the URL
	    category represents. This attribute cannot be changed after
	    creation.

       initial-disposition
	    Specifies the action to be taken when a certain URL category is
	    not listed in any url-filter.

       is-custom
	    This flag is set by the system when you create your own URL
	    category. This attribute is read-only.

       is-security-category
	    This flag is not being used. This attribute is read-only.

       parent-cat-number
	    Specifies the category number of a parent url-category. 0 denotes
	    no parent.

       severity-level
	    Specifies the severity level.

SEE ALSO
       sys url-db download-result sys url-db download-schedule and apm url-
       filter

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 2011, 2013, 2016. All rights
       reserved.



BIG-IP				  2016-03-14	    sys url-db url-category(1)