Validate_merge
POST v1/groups/id/actions/validate_merge
Description
Perform group merge validation.
Normal Response Codes
200
HTTP Error Codes
400 401 403 404 409 500 503
Detail Codes
SM_auth
SM_encryption_master_key_missing
SM_encryption_needed
SM_group_merge_busy
SM_group_merge_db_load
SM_merge_conflict
SM_passphrase_auth
SM_passphrase_inval
SM_session_create
SM_srv_unreach
SM_too_many
SM_vvol_acl_grp_merge
Request
| Parameter | Type | JSON Type | Description | Mandatory |
|---|---|---|---|---|
| id | NsObjectID | string | ID of the group. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | true |
| src_group_name | NsGroupName | string | Name of the source group. String of up to 64 alphanumeric characters, - is allowed after first character. Example: 'g1-exchange'. | true |
| src_group_ip | NsIPAddress | string | IP address of the source group. Four numbers in the range [0,255] separated by periods. Example: '128.0.0.1'. | true |
| src_username | NsUserName | string | Username of the source group. String of up to 80 alphanumeric characters, beginning with a letter. For Active Directory users, it can include backslash (\), dash (-), period (.), underscore (_) and space. Example: 'user1', 'companydomain\user1'. | true |
| src_password | NsPassword | string | Password of the source group. String of 8 to 255 printable characters excluding ampersand and ;[]`. Example: 'password-91'. | true |
| src_passphrase | NsPassphrase | string | Source group encryption passphrase. Encryption passphrase. String with size from 8 to 64 printable characters. Example: 'passphrase-91'. | false |
JSON Request
{}
Response
Type: NsGroupMergeReturn
| Member | Type | JSON Type | Description |
|---|---|---|---|
| online_vols | NsObjectNameList | array | List of volumes which are online. A list of object names. |
| online_snaps | NsVolAndSnapNameList | array | List of snapshots which are online. List of snapshots which are online. |
| active_partners | NsObjectNameList | array | List of partners on groupB which are not paused/stopped. A list of object names. |
| dst_nat_partners | NsObjectNameList | array | List of partners on groupA that think we are behind a NAT. A list of object names. |
| src_throttles | NsObjectNameList | array | List of partner throttles on groupB. A list of object names. |
| dst_throttles | NsObjectNameList | array | List of partner throttles on groupA. A list of object names. |
| repl_objs | NsReplPairListWithObjectTypeList | array | List of volumes which have the same UID (replicated). List of replicated objects. |
| name_conflicts | NsObjectNameListWithTypeList | array | List of objects with conflicting names. List of replicated objects. |
| name_conflicts_manual_resolve | NsObjectNameListWithTypeList | array | List of objects with conflicting names. These object need to be resolved manually. List of replicated objects. |
| serial_conflicts | NsObjectNameListWithTypeList | array | List of objects with conflicting serial numbers. List of replicated objects. |
| app_uuid_conflicts | NsObjectNameListWithTypeList | array | List of objects with conflicting app_uuid. List of replicated objects. |
| name_conflicts_and_owners | NsObjectOwnerPairWithType | object | List of objects with conflicting names and their owners. List of objects of a given type along with their owners. |
| limit_violations | NsObjectLimitList | array | List of object types whose total number limit would be violated. List of limits (Max total number of objects) for object of a given type. |
| snap_retain_limit_violations | NsSnapRetainLimitList | array | List of snapshot retainment param limit violations. List of snapshot retainment param limit violations. |
| network_error_list | NsErrorWithArgumentsList | array | List of validation errors with details. List of error codes with details. |
| error_list | NsErrorWithArgumentsList | array | List of validation errors. List of error codes with details. |
| alias_conflicts | NsAliasConflictPairList | array | List of WWPN/alias conflicts (same initiator WWPN, but different aliases). List of alias conflict (same initiator WWPN, but different aliases). |
| online_fc_intfs | NsFibreChannelInterfaceFullNameList | array | List of Fibre Channel interfaces which are online. List of Fibre Channel interfaces which are online. |
| lun_conflicts | NsLunConflictPairList | array | List of LUN conflicts. List of LUN conflicts. |
| src_sid | NsString | string | Session ID for source group. Plain string. |
| src_group_name | NsObjectName | string | Name of the group we are merging with. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'. |
| dst_group_name | NsObjectName | string | Name of the destination group. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'. |
| dst_group_swversion | NsSoftwareVersion | string | Software version of the destination group. Software version of storage array or group. |
| validation_error | NsErrorWithArguments | object | Umbrella error code for group merge validation. Non-negative integer in range [0,9000]. |
| validation_error_msg | NsString | string | Detailed error message. Plain string. |
JSON Response
{}
