url (DDNS policy view)

Function

The url command specifies the URL in DDNS update requests.

The undo url command deletes the URL in DDNS update requests.

By default, no URL is specified in DDNS update requests on the device.

Format

undo url

Parameters

Parameter	Description	Value
request-url	Specifies the URL in DDNS update requests.	The value is a string case-sensitive characters without spaces and ranges from 20 to 256 characters. For example, when the device uses TCP to communicate with www.oray.cn, the URL format of the DDNS update request is oray://<username>:<password>@phddnsdev.oray.net (<username>:<password> is the fixed value. The user name and password are specified by username and password, and the password configuration is displayed in cipher text).
username username password password	Specifies the user name and password for logging in to the DDNS server. NOTE: To ensure password security, you are advised to run the username username password password command to configure a user name and password. The password information in the configuration file is displayed in cipher text.	username: The value is a string of 1 to 32 case-sensitive characters without spaces. password: The value is a string of 1 to 32 case-sensitive characters in explicit text or 48 to 68 case-sensitive characters in cipher text without spaces.

Parameter

Description

Value

request-url

Specifies the URL in DDNS update requests.

The value is a string case-sensitive characters without spaces and ranges from 20 to 256 characters.

For example, when the device uses TCP to communicate with www.oray.cn, the URL format of the DDNS update request is oray://<username>:<password>@phddnsdev.oray.net (<username>:<password> is the fixed value. The user name and password are specified by username and password, and the password configuration is displayed in cipher text).

username username password password

Specifies the user name and password for logging in to the DDNS server.

NOTE:

To ensure password security, you are advised to run the username username password password command to configure a user name and password. The password information in the configuration file is displayed in cipher text.

username: The value is a string of 1 to 32 case-sensitive characters without spaces.
password: The value is a string of 1 to 32 case-sensitive characters in explicit text or 48 to 68 case-sensitive characters in cipher text without spaces.

Views

DDNS policy view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a DDNS policy is created, enter the URL and specify a DDNS server in the URL.

Where,

The URL uses the default port number. The default port number of the DDNS server provided at www.oray.cn is 6060, the default HTTP port number is 80 and the default HTTPS port number is 443.
The FQDN and IP address cannot be specified in the URL for the DDNS server provided at www.oray.cn. You can specify the FQDN when applying a DDNS policy on an interface. The IP address in the URL is the primary IP address of the interface to which a DDNS policy is applied.

To prevent configuration errors, you are advised not to change <h> or <a> in the URL. The device automatically fills in <h> and <a> based on the FQDN specified when a DDNS policy is bound to the interface.

If you run the url command multiple times, only the latest configuration takes effect.

Precautions

In a URL, the user name and password are separated using :, the password and domain name are separated using @, and the domain name ends with /. Pay attention to the following points when using special characters in a URL.

The user name and password cannot contain spaces and the following special characters: ~ ' ! @ # $ % ^ & * ( ) + = \ | [ ] { } : ; ' ? , / " . Otherwise, the URL is invalid and a configuration error is reported. The domain name cannot contain the following special characters: @ : ? Otherwise, the URL is invalid and a configuration error message is displayed. The domain name also cannot contain the special character /. Otherwise, the domain name is split when being parsed.
You must put the whole URL in double quotation marks ("") if ? exists in the URL.
The head of a URL cannot contain double quotation marks (""). However, the head of a URL can contain double quotation marks ("") if the URL contains the special character ?.

Example

# Specify the URL of the DDNS update request, in which the password is displayed in cipher text.

<sysname> system-view
[sysname] ddns policy mypolicy
[sysname-ddns-policy-mypolicy] url "http://<username>:<password>@members.3322.org/dyndns/update?system=dyndns&hostname=<h>&ip=<a>" username steven password nevets

# Delete the specified URL of the DDNS update request.

<sysname> system-view
[sysname] ddns policy mypolicy
[sysname-ddns-policy-mypolicy] undo url