Registering a Source Server with SMS_Source Server Management_API_API Reference

Function

This API is automatically called by the Agent to report the basic information about a source server to SMS. After the source server is registered successfully, you can view the source server information on the SMS console.

Calling Method

For details, see Calling APIs.

URI

POST /v3/sources

Request Parameters

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. The token can be obtained by calling the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the user token. Minimum: 1 Maximum: 16384

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
id	No	String	The ID of the source server in the SMS database. Minimum: 0 Maximum: 255
ip	No	String	IP address of the source server. The value must be in the standard IP address format. Either the IP address or IPv6 address must be specified. Minimum: 0 Maximum: 255
ipv6	No	String	IP address of the source server. The value must be in the standard IPv6 address format. Either the IP address or IPv6 address must be specified. Minimum: 0 Maximum: 255
name	Yes	String	The source server name in SMS. Minimum: 1 Maximum: 64
hostname	No	String	Source server name. Minimum: 1 Maximum: 64
os_type	Yes	String	The OS type of the source server, which can be Windows or Linux. This parameter is mandatory for source server registration and optional for source server updates. Minimum: 0 Maximum: 255 Enumeration values: WINDOWS LINUX
os_version	Yes	String	The OS version. This parameter is mandatory for registration and optional for updates. Minimum: 0 Maximum: 255
linux_block_check	No	String	The Linux block-level check. Minimum: 0 Maximum: 255
firmware	No	String	The boot mode of the source server, which can be BIOS or UEFI. Minimum: 0 Maximum: 255 Enumeration values: BIOS UEFI
cpu_quantity	No	Integer	The number of vCPUs. Minimum: 0 Maximum: 65535
memory	No	Long	The memory size, in MB. Minimum: 0 Maximum: 9223372036854775807
disks	No	Array of ServerDisk objects	The information about source server disks. Array Length: 0 - 50
btrfs_list	No	Array of BtrfsFileSystem objects	Btrfs information of the source end. If the source end does not have Btrfs, the value is []. This parameter is mandatory in the Linux scenario. Otherwise, the subsequent environment check will fail. Array Length: 0 - 65535
networks	Yes	Array of NetWork objects	The information about NICs on the source server. Array Length: 1 - 50
domain_id	No	String	The tenant domain ID. Minimum: 0 Maximum: 255
has_rsync	No	Boolean	Whether the rsync component is installed. This parameter is mandatory in the Linux scenario. Otherwise, the subsequent environment check will fail.
paravirtualization	No	Boolean	Whether the source end is paravirtualized. This parameter is mandatory in the Linux scenario. Otherwise, the subsequent environment check will fail.
raw_devices	No	String	Raw device list. This parameter is mandatory in the Linux scenario. Otherwise, the subsequent environment check will fail. Minimum: 0 Maximum: 255
driver_files	No	Boolean	Whether the driver file is missing. This parameter is mandatory in the Windows scenario. Otherwise, the subsequent environment check will fail.
system_services	No	Boolean	Whether there are abnormal services. This parameter is mandatory in the Windows scenario. Otherwise, the subsequent environment check will fail.
account_rights	No	Boolean	Whether the permission meets the requirements. This parameter is mandatory in the Windows scenario. Otherwise, the subsequent environment check will fail.
boot_loader	No	String	System boot type. Only the value GRUB is allowed. This parameter is mandatory in the Linux scenario. Otherwise, the subsequent environment check will fail. Minimum: 0 Maximum: 255
system_dir	No	String	System directory. This parameter is mandatory in the Windows scenario. Otherwise, the subsequent environment check will fail. Minimum: 0 Maximum: 255
volume_groups	No	Array of VolumeGroups objects	Volume group. If no volume group is available, enter []. This parameter is mandatory in the Linux scenario. Otherwise, the subsequent environment check will fail. Array Length: 0 - 50
agent_version	Yes	String	Agent version Minimum: 0 Maximum: 255
kernel_version	No	String	The kernel version. Minimum: 0 Maximum: 255
migration_cycle	No	String	The migration stage. cutovering (target server being launched) cutovered (target server launched) checking setting replicating syncing Enumeration values: cutovering cutovered checking setting replicating syncing
state	No	String	Status of the source server. unavailable: The environment verification fails. waiting init: Initializing. replicate: Replicating. syncing stopping stopped skipping deleting clearing: Clearing snapshot resources. cleared: Snapshot resources cleared. clearfailed: Failed to clear snapshot resources. premigready: Ready for migration drill. premiging: Performing migration drill. premiged: Migration drill completed. premigfailed: Migration drill failed. cloning cutovering: Starting the target server. finished: Target server started. error Minimum: 0 Maximum: 255 Enumeration values: unavailable waiting initialize replicate syncing stopping stopped skipping deleting clearing cleared clearfailed premigready premiged premigfailed cloning cutovering finished error
oem_system	No	Boolean	Indicates whether the OS is an OEM OS (Windows).
start_type	No	String	Boot mode. The value can be MANUAL, MGC, or empty. No verification is performed. Minimum: 0 Maximum: 255
io_read_wait	No	Double	The disk read latency (in ms). Minimum: 0.0 Maximum: 10000.0
has_tc	No	Boolean	Whether the tc component is installed. This parameter is mandatory in the Linux scenario. Otherwise, the subsequent environment check will fail.
platform	No	String	Platform information: hw: Huawei ali: Alibaba aws: Amazon azure: Microsoft Azure gcp: Google Cloud tencent: Tencent Cloud vmware: VMware hyperv: Hyper-V other: Others default: default Enumeration values: hw ali aws azure gcp tencent vmware hyperv other default

**Table 3** ServerDisk
Parameter	Mandatory	Type	Description
name	No	String	The disk name. Minimum: 0 Maximum: 255
partition_style	No	String	Disk partition type. This parameter is mandatory when the source server is added. Otherwise, the subsequent environment check will fail. Options (required by EVS): MBR: Master Boot Record GPT: GUID Partition Table Partition Table For details, see the description of differences between MBR and GPT in the EVS API document. Minimum: 0 Maximum: 255**
device_use	No	String	Disk type. This is not mandatory and can be left blank. The common values are as follows: NORMAL OS: system device BOOT VOLUME_GROUP BTRFS Minimum: 0 Maximum: 255
size	No	Long	The disk size, in bytes. Minimum: 0 Maximum: 9223372036854775807
used_size	No	Long	The used disk space, in bytes. Minimum: 0 Maximum: 9223372036854775807
physical_volumes	No	Array of PhysicalVolume objects	The information about physical partitions on the disk. Array Length: 0 - 50
os_disk	No	Boolean	Indicates whether the disk is the system disk.
relation_name	No	String	The name of the paired disk on the Linux target ECS server. Minimum: 0 Maximum: 255
inode_size	No	Integer	The inode size. Minimum: 0 Maximum: 2147483647

**Table 4** PhysicalVolume
Parameter	Mandatory	Type	Description
device_use	No	String	Disk type. This is not mandatory and can be left blank. The common values are as follows: NORMAL OS: system device BOOT VOLUME_GROUP BTRFS Minimum: 0 Maximum: 255
file_system	No	String	The file system type. Minimum: 0 Maximum: 255
index	No	Integer	The serial number. Minimum: 0 Maximum: 2147483647
mount_point	No	String	The mount point. Minimum: 0 Maximum: 255
name	No	String	The volume name. In Windows, it indicates the drive letter, and in Linux, it indicates the device ID. Minimum: 0 Maximum: 255
size	No	Long	The size. Minimum: 0 Maximum: 9223372036854775807
used_size	No	Long	The used space. Minimum: 0 Maximum: 9223372036854775807
inode_size	No	Integer	The number of inodes. Minimum: 0 Maximum: 2147483647
inode_nums	No	Long	The number of inodes. Minimum: 0 Maximum: 9223372036854775807
uuid	No	String	The GUID, which can be obtained from the source server. Minimum: 0 Maximum: 255
size_per_cluster	No	Integer	The size of each cluster. Minimum: 0 Maximum: 2147483647

**Table 5** BtrfsFileSystem
Parameter	Mandatory	Type	Description
name	No	String	The file system name. Minimum: 0 Maximum: 255
label	No	String	The file system tags. If no tag exists, the value is an empty string. Minimum: 0 Maximum: 255
uuid	No	String	The file system UUID. Minimum: 0 Maximum: 255
device	No	String	The device names of the Btrfs file system. Minimum: 0 Maximum: 255
size	No	Long	The space occupied by the file system data. Minimum: 0 Maximum: 9223372036854775807
nodesize	No	Long	The Btrfs node size. Minimum: 0 Maximum: 9223372036854775807
sectorsize	No	Integer	The sector size. Minimum: 0 Maximum: 2147483647
data_profile	No	String	The data profile (RAD). Minimum: 0 Maximum: 255
system_profile	No	String	The file system profile (RAD). Minimum: 0 Maximum: 255
metadata_profile	No	String	The metadata profile (RAD). Minimum: 0 Maximum: 255
global_reserve1	No	String	The Btrfs file system information. Minimum: 0 Maximum: 255
g_vol_used_size	No	Long	The used space of the Btrfs volume. Minimum: 0 Maximum: 9223372036854775807
default_subvolid	No	String	The ID of the default subvolume. Minimum: 0 Maximum: 255
default_subvol_name	No	String	The name of the default subvolume. Minimum: 0 Maximum: 255
default_subvol_mountpath	No	String	The mount path of the default subvolume or Btrfs file system. Minimum: 0 Maximum: 255
subvolumn	No	Array of BtrfsSubvolumn objects	The subvolume information. Array Length: 0 - 65535

**Table 6** BtrfsSubvolumn
Parameter	Mandatory	Type	Description
uuid	No	String	The UUID of the parent volume. Minimum: 0 Maximum: 255
is_snapshot	No	String	Indicates whether the subvolume is a snapshot. Minimum: 0 Maximum: 255
subvol_id	No	String	The subvolume ID. Minimum: 0 Maximum: 255
parent_id	No	String	The parent volume ID. Minimum: 0 Maximum: 255
subvol_name	No	String	The subvolume name. Minimum: 0 Maximum: 255
subvol_mount_path	No	String	The mount path of the subvolume. Minimum: 0 Maximum: 255

**Table 7** NetWork
Parameter	Mandatory	Type	Description
name	No	String	The NIC name. Minimum: 0 Maximum: 255
ip	No	String	The IP address bound to the NIC. Minimum: 0 Maximum: 255
ipv6	No	String	The IPv6 address. Minimum: 0 Maximum: 255
netmask	No	String	The subnet mask. Minimum: 0 Maximum: 255
gateway	No	String	Gateway. Minimum: 0 Maximum: 255
mtu	No	Integer	The NIC MTU. This parameter is mandatory for Linux. Minimum: 0 Maximum: 2147483647
mac	Yes	String	The first MAC address in the list must not be empty. Minimum: 0 Maximum: 255
id	No	String	The database record ID. Minimum: 0 Maximum: 255

**Table 8** VolumeGroups
Parameter	Mandatory	Type	Description
components	No	String	The physical volume information. Minimum: 0 Maximum: 255
free_size	No	Long	The available space. Minimum: 0 Maximum: 9223372036854775807
logical_volumes	No	Array of LogicalVolumes objects	The logical volume information. Array Length: 0 - 50
name	No	String	Name. Minimum: 0 Maximum: 255
size	No	Long	Size. Minimum: 0 Maximum: 9223372036854775807

**Table 9** LogicalVolumes
Parameter	Mandatory	Type	Description
block_count	No	Integer	The number of blocks. Minimum: 0 Maximum: 2147483647 Default: 0
block_size	No	Long	Block size. Minimum: 0 Maximum: 1048576 Default: 0
file_system	No	String	The file system. Minimum: 0 Maximum: 255
inode_size	No	Integer	The number of inodes. Minimum: 0 Maximum: 2147483647
inode_nums	No	Long	The number of inodes. Minimum: 0 Maximum: 9223372036854775807
device_use	No	String	Partition type. This is not mandatory and can be left blank. The common values are as follows: NORMAL OS: system device BOOT VOLUME_GROUP BTRFS Minimum: 0 Maximum: 255
mount_point	No	String	The mount point. Minimum: 0 Maximum: 256
name	No	String	Name. Minimum: 0 Maximum: 1024
size	No	Long	The size. Minimum: 0 Maximum: 9223372036854775807
used_size	No	Long	The used space. Minimum: 0 Maximum: 9223372036854775807
free_size	No	Long	The available space. Minimum: 0 Maximum: 9223372036854775807

Response Parameters

Status code: 200

**Table 10** Response body parameters
Parameter	Type	Description
id	String	The source server ID. Minimum: 0 Maximum: 255

Status code: 403

**Table 11** Response body parameters
Parameter	Type	Description
error_code	String	The error code. Minimum: 0 Maximum: 255
error_msg	String	The error message. Minimum: 0 Maximum: 255
encoded_authorization_message	String	The encrypted authorization information. Minimum: 0 Maximum: 65535
error_param	Array of strings	Error parameters. Minimum: 0 Maximum: 65535 Array Length: 1 - 20
details	Array of details objects	The error details. Array Length: 1 - 20

**Table 12** details
Parameter	Type	Description
error_code	String	The SMS error code. Minimum: 0 Maximum: 65535
error_msg	String	The SMS error message. Minimum: 0 Maximum: 65535

Example Requests

This example reports the information about a source server to SMS. The source server runs Linux SUSE12_64BIT_SP2, with the name of host-192-168-136-xxx, the IP address of 192.168.136.xxx, the BOOT system disk named /dev/vda, and the system disk size of 42,949,672,960 bytes. After the source server is reported, you can view the source server information on the SMS console.

POST https://{endpoint}/v3/sources

{
  "os_type" : "LINUX",
  "name" : "host-192-168-136-xxx",
  "os_version" : "SUSE12_64BIT_SP2",
  "linux_block_check" : "{\"release_type\": \"SUSE\", \"release_version\": \"12.2\", \"kernel_simplification\": \"4.4.21\", \"architecture\": \"x86_64\", \"kernel_version\": \"4.4.21-69-default\"}",
  "kernel_version" : "4.4.21-69-default",
  "paravirtualization" : true,
  "firmware" : "BIOS",
  "has_rsync" : true,
  "io_read_wait" : 3.4,
  "boot_loader" : "GRUB",
  "disks" : [ {
    "name" : "/dev/vda",
    "device_use" : "BOOT",
    "size" : 42949672960,
    "partition_style" : "MBR",
    "used_size" : 42948624384,
    "physical_volumes" : [ {
      "name" : "/dev/vda1",
      "size" : 2153775104,
      "device_use" : "NORMAL",
      "used_size" : 2153775104,
      "inode_size" : 0,
      "inode_nums" : 0,
      "file_system" : "swap",
      "mount_point" : ""
    }, {
      "name" : "/dev/vda2",
      "size" : 16862150656,
      "device_use" : "BTRFS",
      "used_size" : 16862150656,
      "inode_size" : 0,
      "inode_nums" : 0,
      "file_system" : "btrfs",
      "mount_point" : ""
    }, {
      "name" : "/dev/vda3",
      "size" : 23932698624,
      "device_use" : "NORMAL",
      "used_size" : 33988608,
      "inode_size" : 0,
      "inode_nums" : 12345,
      "file_system" : "xfs",
      "mount_point" : "/home"
    } ]
  }, {
    "name" : "/dev/vdb",
    "device_use" : "NORMAL",
    "size" : 21474836480,
    "partition_style" : "MBR",
    "used_size" : 21473787904,
    "physical_volumes" : [ {
      "name" : "/dev/vdb1",
      "size" : 21473787904,
      "device_use" : "VOLUME_GROUP",
      "used_size" : 21473787904,
      "inode_size" : 0,
      "inode_nums" : 0,
      "file_system" : "LVM2_member",
      "mount_point" : ""
    } ]
  }, {
    "name" : "/dev/vdc",
    "device_use" : "VOLUME_GROUP",
    "size" : 21474836480,
    "partition_style" : "MBR",
    "used_size" : 0,
    "physical_volumes" : [ ]
  } ],
  "volume_groups" : [ {
    "name" : "vg1",
    "size" : 42948624384,
    "components" : "/dev/vdb1;/dev/vdc",
    "logical_volumes" : [ {
      "name" : "/dev/mapper/vg1-lv1",
      "device_use" : "NORMAL",
      "size" : 10737418240,
      "free_size" : 10713837568,
      "used_size" : 23580672,
      "file_system" : "ext4",
      "mount_point" : "/mnt/lv1",
      "inode_nums" : 12345,
      "inode_size" : "256"
    } ]
  } ],
  "btrfs_list" : [ {
    "name" : "/dev/vda2",
    "label" : "none",
    "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
    "device" : "/dev/vda2",
    "size" : "3.30GiB",
    "nodesize" : "16384",
    "sectorsize" : "4096",
    "data_profile" : "single",
    "system_profile" : "single",
    "metadata_profile" : "single",
    "global_reserve1" : "single",
    "g_vol_used_size" : "3894038528",
    "default_subvolid" : "259",
    "default_subvol_name" : "@/.snapshots/1/snapshot",
    "default_subvol_mountpath" : "/",
    "subvolumn" : [ {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "257",
      "parent_id" : "5",
      "subvol_name" : "@",
      "subvol_mount_path" : "null"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "258",
      "parent_id" : "257",
      "subvol_name" : "@/.snapshots",
      "subvol_mount_path" : "/.snapshots"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "true",
      "subvol_id" : "259",
      "parent_id" : "258",
      "subvol_name" : "@/.snapshots/1/snapshot",
      "subvol_mount_path" : "/"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "260",
      "parent_id" : "257",
      "subvol_name" : "@/boot/grub2/i386-pc",
      "subvol_mount_path" : "/boot/grub2/i386-pc"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "261",
      "parent_id" : "257",
      "subvol_name" : "@/boot/grub2/x86_64-efi",
      "subvol_mount_path" : "/boot/grub2/x86_64-efi"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "262",
      "parent_id" : "257",
      "subvol_name" : "@/opt",
      "subvol_mount_path" : "/opt"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "263",
      "parent_id" : "257",
      "subvol_name" : "@/srv",
      "subvol_mount_path" : "/srv"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "264",
      "parent_id" : "257",
      "subvol_name" : "@/tmp",
      "subvol_mount_path" : "/tmp"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "265",
      "parent_id" : "257",
      "subvol_name" : "@/usr/local",
      "subvol_mount_path" : "/usr/local"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "266",
      "parent_id" : "257",
      "subvol_name" : "@/var/cache",
      "subvol_mount_path" : "/var/cache"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "267",
      "parent_id" : "257",
      "subvol_name" : "@/var/crash",
      "subvol_mount_path" : "/var/crash"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "268",
      "parent_id" : "257",
      "subvol_name" : "@/var/lib/libvirt/images",
      "subvol_mount_path" : "/var/lib/libvirt/images"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "269",
      "parent_id" : "257",
      "subvol_name" : "@/var/lib/machines",
      "subvol_mount_path" : "/var/lib/machines"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "270",
      "parent_id" : "257",
      "subvol_name" : "@/var/lib/mailman",
      "subvol_mount_path" : "/var/lib/mailman"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "271",
      "parent_id" : "257",
      "subvol_name" : "@/var/lib/mariadb",
      "subvol_mount_path" : "/var/lib/mariadb"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "272",
      "parent_id" : "257",
      "subvol_name" : "@/var/lib/mysql",
      "subvol_mount_path" : "/var/lib/mysql"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "273",
      "parent_id" : "257",
      "subvol_name" : "@/var/lib/named",
      "subvol_mount_path" : "/var/lib/named"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "274",
      "parent_id" : "257",
      "subvol_name" : "@/var/lib/pgsql",
      "subvol_mount_path" : "/var/lib/pgsql"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "275",
      "parent_id" : "257",
      "subvol_name" : "@/var/log",
      "subvol_mount_path" : "/var/log"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "276",
      "parent_id" : "257",
      "subvol_name" : "@/var/opt",
      "subvol_mount_path" : "/var/opt"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "277",
      "parent_id" : "257",
      "subvol_name" : "@/var/spool",
      "subvol_mount_path" : "/var/spool"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "false",
      "subvol_id" : "278",
      "parent_id" : "257",
      "subvol_name" : "@/var/tmp",
      "subvol_mount_path" : "/var/tmp"
    }, {
      "uuid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
      "is_snapshot" : "true",
      "subvol_id" : "282",
      "parent_id" : "258",
      "subvol_name" : "@/.snapshots/2/snapshot",
      "subvol_mount_path" : "null"
    } ]
  } ],
  "cpu_quantity" : 1,
  "memory" : 934752256,
  "networks" : [ {
    "name" : "eth0",
    "ip" : "192.168.136.xxx",
    "netmask" : "netmask",
    "gateway" : "gateway",
    "mac" : "1a9660eb8a3ffcf4df6d7865b52eb54f7b0cd194029e0eadd8e2c7f1267d80c0"
  } ],
  "ip" : "192.168.136.xxx",
  "agent_version" : "2.2.1",
  "platform" : "hw"
}

Example Responses

Status code: 200

The source server was registered with SMS.

{
  "id" : "xxxxxxxxxxxxxxxxxxxxxxxx00000001"
}

Status code: 403

Authentication failed.

{
  "error_code" : "SMS.9004",
  "error_msg" : "The current account does not have the permission to execute policy. You do not have permission to perform action XXX on resource XXX.",
  "encoded_authorization_message" : "XXXXXX",
  "error_param" : [ "You do not have permission to perform action XXX on resource XXX." ],
  "details" : [ {
    "error_code" : "SMS.9004",
    "error_msg" : "You do not have permission to perform action XXX on resource XXX."
  } ]
}

Status Codes

Status Code	Description
200	The source server was registered with SMS.
403	Authentication failed.

Error Codes

See Error Codes.

Registering a Source Server with SMS