服务器迁移中心SMC采用RPC风格API,支持GET和POST请求方式。本文介绍通过API URL调用SMC API的方法,一次API请求中,会涉及签名、参数设定以及身份验证等设置。

调用工具

您可以通过OpenAPI Explorer、阿里云CLI、Cloud Shell、SDK等开发工具调试、调用阿里云API。
  • OpenAPI开发者门户

    OpenAPI开发者门户是一款可视化的网页版API调用工具。您可以在OpenAPI开发者门户中调用阿里云开放的所有API,发起API请求并查看返回结果。

  • 阿里云CLI

    阿里云命令行工具(Alibaba Cloud Command Line Interface)是在阿里云GO SDK之上构建的开源工具。您可以通过阿里云CLI,管理您的阿里云资源。更多详情,请参见阿里云CLI使用指南

  • Cloud Shell

    云命令行(Cloud Shell)是网页版命令行工具。您可以在任意浏览器上运行云命令行管理阿里云资源。更多详情,请参见阿里云Cloud Shell使用指南

  • SMC SDK

    您可以在开发者门户SDK中心获取SMC SDK。

请求结构

本节介绍HTTP/HTTPS调用场景中,API请求的结构组成。以下是GET请求的URL格式:
http(s)://Endpoint/?Action=xx&Parameters
  • Endpoint:调用的云服务的接入点,如smc.aliyuncs.com
  • Action:当前请求需要执行的操作,如使用CreateReplicationJob创建一个迁移任务。
  • Parameters:代指请求参数,由公共请求参数和API自定义参数组成,参数之间使用&分隔。
以下是CreateReplicationJob接口的请求示例:
https://smc.aliyuncs.com/?Action=CreateReplicationJob
&SystemDiskSize=125
&公共请求参数

接入地址

服务器迁移中心SMC API的服务接入地址为:smc.aliyuncs.com。

公共参数

通过GET请求调用服务器迁移中心SMC API的公共参数,如下表所示。
名称类型是否必选示例值描述
ActionStringCreateReplicationJobAPI的名称。取值请参见API 概览
AccessKeyIdStringLTAIp4********fjx访问密钥ID。更多详情,请参见创建AccessKey
SignatureStringOLeaidS1JvxuMvnyHOwuJ%2BuX5qY%3D您的签名。RPC风格API的签名机制,请参见签名机制
SignatureMethodStringHMAC-SHA1签名方式。取值:HMAC-SHA1。
SignatureVersionString1.0签名算法版本。取值:1.0。
SignatureNonceString3ee8c1b8-****-44af-****-4e0ad82fd6cf签名唯一随机数。用于防止网络重放攻击,建议您每一次请求都使用不同的随机数。
TimestampString2018-01-01T12:00:00Z请求的时间戳。按照ISO8601标准表示,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ
VersionString2019-06-01API的版本号,格式为YYYY-MM-DD。取值:2019-06-01。
FormatStringjson返回参数的语言类型。取值:json | xml。

默认值:json。

RAM鉴权

部分SMC API的鉴权规则如下表所示。资源ARN格式说明,请参见RAM基本概念
Action资源ARN取值
DeleteSourceServeracs:smc:$regionid:$accountid:sourceServer/$sourceId
DescribeSourceServersacs:smc:$regionid:$accountid:sourceServer/*
ModifySourceServerAttributeacs:smc:$regionid:$accountid:sourceServer/$sourceId
CreateReplicationJob
  • acs:smc:$regionid:$accountid:sourceServer/$sourceId
  • acs:smc:$regionid:$accountid:replicationJob/*
DeleteReplicationJobacs:smc:$regionid:$accountid:replicationJob/$jobId
DescribeReplicationJobsacs:smc:$regionid:$accountid:replicationJob/*
ModifyReplicationJobAttributeacs:smc:$regionid:$accountid:replicationJob/$jobId
StartReplicationJobacs:smc:$regionid:$accountid:replicationJob/$jobId
StopReplicationJobacs:smc:$regionid:$accountid:replicationJob/$jobId