CreateSite - Edge Security Acceleration - Alibaba Cloud ドキュメントセンター

サイトを作成します。

操作説明

サイトを作成する前に、アクティブなプランインスタンスが必要です。
加速エリアが中国本土のみまたはグローバルにセットされている場合、サイトのドメイン名はインターネットコンテンツプロバイダー (ICP) 登録が完了している必要があります。
各ユーザーはこの操作を 1 時間あたり最大 100 回呼び出しできます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

esa:CreateSite

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SiteName	string	必須	サイト名。	example.com
Coverage	string	必須	加速リージョン。有効な値: domestic: 中国本土のみ。 global: グローバル。 overseas: グローバル (中国本土を除く)。列挙値: domestic : 中国本土のみ。 global : グローバル。 overseas : グローバル（中国本土を除く）。	domestic
AccessType	string	必須	サイトのアクセスタイプ。有効な値: NS: マネージド NS を使用したアクセス。 CNAME: CNAME レコードを設定したアクセス。列挙値: NS : マネージド NS。 CNAME : CNAME ドメイン名設定。	NS
InstanceId	string	必須	インスタンス ID。 ListUserRatePlanInstances 操作を呼び出してインスタンス ID を取得できます。インスタンス ID とサイト ID のうち少なくとも 1 つを指定する必要があります。両方を指定した場合、インスタンス ID が優先されます。	dbaudit-cn-nwy349jdb03
ResourceGroupId	string	任意	リソースグループ ID。このパラメーターを指定しない場合、システムはデフォルトのリソースグループ ID を自動的に使用します。	rg-acfmw4znnok****

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE
SiteId	integer	サイト ID。	1234567890123
NameServerList	string	サイトに割り当てられたネームサーバーのリスト。カンマ (,) で区切られます。このフィールドは、サイトのアクセスタイプが NS の場合に値を持ちます。サイトの DNS サーバをこれらのネームサーバーに変更する必要があります。その後、サイトの所有権を確認してサイトをアクティブ化できます。	ns1.example.com,ns2.example.com
VerifyCode	string	サイトの検証コード。サイトのアクセスタイプが CNAME の場合、サイトの DNS サーバに Record 名 _esaauth.[サイト名] で Record 値を検証コードにセットした TXT レコードを追加する必要があります。その後、サイトの所有権を確認してサイトをアクティブ化できます。	verify_aah9dioasmov****

例

成功レスポンス

JSONJSON

{
  "RequestId": "CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE",
  "SiteId": 1234567890123,
  "NameServerList": "ns1.example.com,ns2.example.com",
  "VerifyCode": "verify_aah9dioasmov****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。