讓使用者建立一個新的站點。
介面說明
建立站點之前，您必須擁有可用的套餐執行個體。
如果加速區域選擇的是僅中國內地或者全球，則站點網域必須已完成備案。
每個使用者每小時最多呼叫 100 次。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
esa:CreateSite |
create |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| SiteName |
string |
是 |
站點名稱。 |
example.com |
| Coverage |
string |
是 |
加速區域。取值：
|
domestic |
| AccessType |
string |
是 |
站點的接入類型。取值：
|
NS |
| InstanceId |
string |
是 |
執行個體 ID，可透過呼叫 ListUserRatePlanInstances 介面取得。執行個體 ID 和站點 ID 至少填寫一個，若兩者都填，則以執行個體 ID 為準進行查詢。 |
dbaudit-cn-nwy349jdb03 |
| ResourceGroupId |
string |
否 |
資源群組 ID。不傳該參數時，系統自動補齊預設資源群組 ID。 |
rg-acfmw4znnok**** |
| ResourceOwner |
integer |
否 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| NameServerList |
string |
為站點分配的 NS 清單，用半形逗號（,）分隔。當站點的接入方式為 NS 接入時，該欄位有值，需要將站點的 DNS 伺服器修改為這些 NS。隨後即可驗證站點的歸屬權，啟用站點。 |
ns1.example.com,ns2.example.com |
| RequestId |
string |
請求 ID。 |
CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE |
| SiteId |
integer |
站點 ID。 |
1234567890123 |
| VerifyCode |
string |
站點的驗證碼。當站點的接入方式為 CNAME 接入時，需要在站點的 DNS 伺服器下設定一筆記錄名稱為 _esaauth.[站點名稱] 、記錄值為 驗證碼 的 TXT 記錄。隨後即可驗證站點的歸屬權，啟用站點。 |
verify_aah9dioasmov**** |
樣本
正常返回樣本
JSON格式
{
"NameServerList": "ns1.example.com,ns2.example.com",
"RequestId": "CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE",
"SiteId": 1234567890123,
"VerifyCode": "verify_aah9dioasmov****"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | ServiceInvokeFailed | The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details. | 呼叫服務失敗，請稍後重試或聯絡客服諮詢詳情。 |
| 400 | InternalException | Failed to call the service. Try again later or contact technical support. | 呼叫服務失敗，請稍後重試或聯絡客服諮詢詳情。 |
| 400 | InvalidParameter | The specified parameter is invalid. | 輸入參數規範校驗失敗。 |
| 400 | Instance.NotOnline | Your plan is unavailable due to an overdue payment. Complete the payment first. | 您的套餐執行個體因欠費目前處於未上線狀態，請先完成續費操作以繼續使用。 |
| 400 | InvalidParameter.SiteName | Invalid website name. Specify a valid name that contains letters and digits and does not contain special characters. | 站點名稱無效，請重新輸入站點名稱，可包含字母和數字，不能包含特殊字元。 |
| 400 | QuotaExceed.SiteCount | The maximum number of websites associated with your plan has been reached. | 站點數量超出配額限制。 |
| 400 | Site.Conflict | Duplicate website names exist across multiple accounts. Rename or delete one and try again. | 站點衝突，多個帳號下存在相同名稱的站點，請刪除或更名後重試。 |
| 400 | Site.AlreadyExist | The website name you specified already exists. Try with another name. | 您輸入的站點已存在，請您重新設定。 |
| 400 | SubSiteUnavailable | Subdomains are allowed only in Enterprise plans. Upgrade your plan to add a subdomain to ESA. | 您的方案不支援以子網域建立站點，請升級您的方案。 |
| 400 | Site.InvalidCoverage | The selected location is unavailable in your plan. Change the location to one that is covered by the plan and try again. | 您選擇的加速區域不在目前方案支援範圍內，請更換為方案支援的加速區域後重試。 |
| 400 | InvalidSiteICP | The specified website does not have an ICP filing or the filing information is invalid. Make sure your website is filed and try again. | 您配置的站點未備案或ICP備案資訊不合法，請確保站點已完成備案後重試。 |
| 400 | InvalidSiteName | Invalid website name. Check and try again. | 您配置的站點名稱不正確，請確保傳入正確的站點名稱後重試。 |
| 400 | Site.InBlacklist | The site name is in the blacklist. | 站點名稱在黑名單中。 |
| 400 | NoPermission | You do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user. | 沒有權限。 |
| 400 | NotInternationalRealIdentity | Real-name registration is required for services offered in Mainland China. | 根據中華人民共和國法律規定，在中國境內購買使用資訊服務的使用者需要進行實名登記。 |
| 400 | ICPCheckFailed | The ICP filing verification service is temporarily unavailable. Please try again later. | 備案查詢服務異常，請稍後重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。