Skip to main content

vserver services name-service unix-user load-from-uri

Load one or more local UNIX users from a URI

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description​

The vserver services name-service unix-user load-from-uri command loads one or more UNIX users from a universal resource identifier (URI). The URI must contain user information in the UNIX /etc/passwd format: user_name:password:user_ID:group_ID:full_name:home_directory:shell. The command discards the value of the password field and of the fields after the full_name field ( home_directory and shell).

Parameters​

-vserver <vserver> - Vserver
This specifies the Vserver on which the local UNIX user or users are to be located.
-uri {(ftp|http)://(hostname|IPv4 Address|'['IPv6 Address']')...} - URI to Load From
This specifies the URI from which user information is to be loaded. The URI scheme must be either ftp(s) or http(s).
[-overwrite {true|false}] - Overwrite Entries
This optionally specifies whether user information from the URI overwrites existing user information. The default setting is false.
[-skip-name-validation {true|false}] - Skip Name Validation

By default, Data ONTAP validates the name to ensure it complies with the following rules:

  • The name contains only valid characters: 0 through 9, A through Z, a through z, "_", ".", and "-"
  • The name does not start with "-"
  • The name does not contain "$" except as the last character

If the parameter is set to true, the name validation is skipped.

[-foreground {true|false}] - Load Unix Users file in the Foreground
If this parameter is set to false, the operation runs as a job in the background. Otherwise, the command does not return until the operation is complete. The default value is true.

Examples​

The following example loads user information from the URI ftp://ftp.example.com/users onto a Vserver named vs0: 

node::> vserver services name-service unix-user load-from-uri -vserver vs0 -uri ftp://ftp.example.com/users