The following request synchronizes the name of a host group (or the name of an iSCSI target) associated with the server corresponding to the specified server ID with the nickname of the server.
The host group name (or the iSCSI target name) used for synchronization with the server nickname varies depending on the following conditions:
- If the server nickname consists of 24 characters or fewer and the port
corresponding to the server nickname does not include a host group (or an iSCSI
target) with a name identical to the server nickname:
The host group name (or the iSCSI target name) is synchronized with the server nickname by using the server nickname as the host group name (or the iSCSI target name).
- If the server nickname consists of 24 characters or fewer and the port
corresponding to the server nickname includes a host group (or the iSCSI target)
with a name identical to the server nickname:
The host group name (or the iSCSI target name) is synchronized with the server nickname as follows: underscores (_) are appended to the server nickname up to the 25th character, and then a 7-character identifier is added as the 26th to 32nd characters. (This identifier prevents the new host group name (or iSCSI target name) from being identical to any other host group name (or iSCSI target name).)
Example: When the server nickname is abcdefghijklmnopqrst, the resulting host group name might be
abcdefghijklmnopqrst_____0001_AA.
- If the server nickname consists of 25 characters or more:
The host group name (or the iSCSI target name) is synchronized with the server nickname as follows: the first 24 characters of the server nickname are used without change (the remaining are truncated), an underscore (_) is appended as the 25th character of the truncated server name, and then a 7-character identifier is added as the 26th to 32nd characters. (This identifier prevents the new host group name (or iSCSI target name) from being identical to any other host group name (or iSCSI target name).)
Example: When the server nickname is abcdefghijklmnopqrstuvwxyz, the resulting host group name might be
abcdefghijklmnopqrstuvwx_0001_AA.
Execution permission
Storage Administrator (Provisioning)
Request line
POST base-URL/simple/v1/objects/servers/object-ID/actions/sync-host-group-names/invoke
Request message
Response message
- Body
-
Attribute
Type
Description
statusResource
string
URL used to obtain the execution results for the server with which the host group name (or the iSCSI target name) was synchronized
Note:Execute the API function for obtaining information about the status of the API function that performs asynchronous processing. For details, see Getting status information about an API function that performs asynchronous processing.
Status codes
See HTTP status codes.
Coding example
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/servers/10/actions/sync-host-group-names/invoke -d ""