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)