REST API Reference Version 4.4.0.0Search

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_eaccess

SM_eexist

SM_einval

SM_enoent

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

SM_invalid_arg_value

SM_invalid_path_variable

SM_invalid_query_param

SM_malformed_url

SM_missing_arg

SM_no_action_found

SM_no_method_for_URL_pattern

SM_no_operation_found

SM_no_path_found

SM_unexpected_arg

SM_unexpected_child

SM_unexpected_query_param

SM_version_name

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

            
            
            {}