CSS Command Reference (Software Version 7.40)
URQL Configuration Mode Commands
Downloads: This chapterpdf (PDF - 61.0KB) The complete bookPDF (PDF - 5.06MB) | Feedback

URQL Configuration Mode Commands

Table Of Contents

URQL Configuration Mode Commands

(config-urql) active

(config-urql) description

(config-urql) domain

(config-urql) no

(config-urql) suspend

(config-urql) url


URQL Configuration Mode Commands

URQL configuration mode allows you to configure a Uniform Resource Locator qualifier list (URQL). A URQL is a group of URLs for content requests associated with one or more content rules. The CSS uses this list to identify which requests to send to a service.

To access URQL configuration mode, use the urql command from any configuration mode except ACL, boot, DQL, group, keepalive, NQL, and owner configuration modes. The prompt changes to (config-urql [name]). You can also use this command from URQL mode to access another URQL. For information about commands available in this mode, see the following commands.

In global configuration mode, use the no form of this command to delete an existing URQL.

urql urql_name

(config) no urql existing_urql_name

Syntax Description

urql_name

Name of a new URQL you want to create or of an existing list. Enter an unquoted text string with no spaces and a maximum length of 31 characters. To see a list of existing URQL names, enter:

urql ?

Usage Guidelines

When you create a URQL, you must activate it with the (config-urql) active command.

Related Commands

show urql
(config-owner-content) url

(config-urql) active

To activate a suspended URQL, use the active command. By default, the URQL is initially suspended.

active

Usage Guidelines

Before you can activate a URQL, you must assign the domain for the URLs. See the (config-urql) domain command.

Related Commands

show urql
(config-owner-content) url
(config-urql) domain
(config-urql) suspend

(config-urql) description

To provide a description for the URL qualifier list (URQL), use the description command. Use the no form of this command to clear a description for the URQL.

description "text"

no description

Syntax Description

"text"

Description for the URQL. Enter a quoted text string with a maximum length of 64 characters.


(config-urql) domain

To assign the domain name or address of the URLs to the URQL, use the domain command.

domain "name_or_ip"

Syntax Description

"name_or_ip"

Name or address for the domain. Enter a quoted text string containing either:

The domain name in mnemonic host-name format (for example, myhost.mydomain.com) with a maximum of 63 characters

A valid address for the domain in dotted-decimal IP notation (for example, 192.168.11.1)


Usage Guidelines

You must assign a domain before you can activate a URQL. To change the domain address on an existing URQL, suspend the URQL, and then change the domain.

Related Commands

show urql
(config-urql) active
(config-urql) suspend

(config-urql) no

To negate a command or set it to its default, use the no command. For information on general no commands you can use in this mode, see the general no command. The following options are available in URQL mode.

Syntax Description

no acl index

Deletes an ACL

no description

Clears a description for the URQL

no owner existing_owner_name

Deletes an existing owner

no url number index_number

Deletes a URL entry from the URQL

no url number index_number url

Removes a URL from the URL entry

no url number index_number description

Clears the description for the URL entry


(config-urql) suspend

To deactivate a URQL on all currently assigned content rules, use the suspend command.

suspend

Usage Guidelines

To reactivate the URQL, use the (config-urql) active command.

Related Commands

show urql
(config-urql) active

(config-urql) url

To include the URL for content requests you want as part of the URQL, and optionally provide a description, use the url command. Use the no form of this command to remove a URL entry from a URQL, a URL from a URL number, or a description about the URL.

url number {url "name"|description "description"}

no url number {url |description}

Syntax Description

number

Number for the URL entry in the URQL. Enter a number from 1 to 1000.

url "name"

Defines the URL that appears on the content request. Enter a quoted text string with a maximum length of 252 characters.

The URL must match the URL GET request exactly. Wildcards, partial URL paths, and a trailing "/" character in the URL are not allowed in a URQL URL entry.

description "description"

Provides a description about the URL. Enter a quoted text string with a maximum length of 64 characters.


Usage Guidelines

You must create the URL index entry before you can associate the URL name or a description to it.

Before you can reassign a different URL name to an existing URL entry, you must remove the previously assigned URL.

Related Commands

show urql
(config-owner-content) url