AddCdnDomain - - Alibaba Cloud ドキュメントセンター

AddCdnDomain 操作を呼び出して、高速化ドメイン名を追加できます。

操作説明

ドメイン名を追加する前に、Alibaba Cloud CDN をアクティブ化する必要があります。詳細については、「Alibaba Cloud CDN のアクティブ化」をご参照ください。
高速化ドメイン名は、有効な ICP 登録が必要です。
一度に追加できる高速化ドメイン名は 1 つだけです。各アカウントは最大 50 のドメイン名を持つことができます。
オリジンサーバー上のコンテンツが Alibaba Cloud に保存されていない場合、コンテンツのレビューが必要です。レビューは翌営業日までに完了します。
各ユーザーのスロットリング制限は 1 秒あたり 30 回の呼び出しです。

使用方法

この操作を呼び出してドメイン名を追加した後、ドメイン名が有効になるまでに 3 ～ 5 分かかります。この期間中は、ドメイン名を構成しないでください。ドメインステータスがオンラインになるまで待ってから、他の構成を実行してください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cdn:AddCdnDomain

create

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

なし

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
CdnType	string	必須	高速化ドメイン名のビジネスタイプ。有効な値： web：画像と小さなファイル。 download：大きなファイルのダウンロード。 video：ビデオオンデマンド。	web
DomainName	string	必須	Alibaba Cloud CDN に追加する高速化ドメイン名。ワイルドカードドメイン名がサポートされています。ワイルドカードドメイン名は、.example.com のように、ピリオド (.) で始まる必要があります。	.example.com
ResourceGroupId	string	任意	リソースグループの ID。このパラメーターを指定しない場合、システムはデフォルトのリソースグループの ID を使用します。	rg-acfmyuji4b6r4**
Sources	string	必須	オリジンアドレスのリスト。	[ { "content": "192.0.2.0", "type": "ipaddr", "priority": "20", "port": 80, "weight": "15" } ]
CheckUrl	string	任意	ヘルスチェック URL。	www.example.com/test.html
Scope	string	任意	アクセラレーションリージョン。有効な値： domestic（デフォルト）：中国本土のみ。 overseas：グローバル（中国本土を除く）。 global：グローバル。	domestic
TopLevelDomain	string	任意	トップレベルドメイン。	example.com
Tag	array<object>	任意	タグのリスト。最大 20 個のタグを指定できます。
	object	任意
Key	string	任意	タグキー。	env
Value	string	任意	タグ値。	value

次の表は、Sources パラメーターのフィールドについて説明しています。

パラメーター	タイプ	必須	説明
type	文字列	はい	オリジンサーバーのタイプ。有効な値： ipaddr： IP アドレス。 domain：ドメイン名。 oss： OSS バケット。 fc_domain： Function Compute ドメイン名。
content	文字列	はい	オリジンサーバーのアドレス。 IP アドレスまたはドメイン名を指定できます。
port	整数	いいえ	ポート番号。ポート 443 または 80、あるいはカスタムポートを指定できます。デフォルト値： 80 。ポート 443 は HTTPS オリジンフェッチをサポートしています。
priority	文字列	いいえ	オリジンサーバーの優先順位。有効な値： 20 と 30 。デフォルト値： 20 。値 20 はプライマリオリジンサーバーを示し、値 30 はセカンダリオリジンサーバーを示します。
weight	文字列	いいえ	オリジンフェッチのためのオリジンサーバーの重み。有効な値は 0 ～ 100 です。デフォルト値： 10 。

レスポンスパラメーター

パラメーター	タイプ	説明	例
	object
RequestId	string	リクエスト ID。	15C66C7B-671A-4297-9187-2C4477247A74

例

成功レスポンス

JSONJSON

{
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidDomainName.Malformed	Specified DomainName is malformed.	不正なCDNドメイン形式
400	MissingParameter	The input parameter cdnType that is mandatory for processing this request is not supplied.
400	InvalidCdnType.Malformed	Specified CdnType is malformed.
400	InvalidSources.Malformed	Specified Sources is malformed.	不正な発信元サイトアドレス。
400	InvalidSourceType.Malformed	Specified CdnType is malformed.
400	InvalidSource.Priority.Malformed	The specified Source Priority is invalid.
400	InvalidTypeAndContent.MissMatch	The specified source type does not match the specified source content.
400	InvalidScope.Malformed	Specified Scope is malformed.
400	SourceIp.Exceed	The Certificate you provided is malformed
400	InvalidCertificate	The Certificate you provided is malformed
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length
400	InnerAddDomainDenied	Your account has not bind aoneId, can not add domain.
400	CheckSourceHealthFailed	sources ip or source domain check health failed,please input right source.
400	ExtensiveAndAllBothExist	Extensive domain and the domain begins with all. can not exist at the same time.
400	CdnTypeNotSupportExtensiveDomain	Extensive domain not supported for this cdn type.
400	ExtensiveAndSpecificDomainConflict	The number of wildcard domain names exceeds the limit.
400	InvalidResourceGroupId.Malformed	Specified ResourceGroupId is malformed.
400	DomainReserved	The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.
400	InvalidDomainNameLevel	Domain name suffixed with alicdn.com only support third level.
400	InvalidTopLevelDomain.Malformed	Specified TopLevelDomain is malformed.
400	TopLevelDomain.NotFound	TopLevelDomain is not exist.
400	EntityNotExists.ResourceGroup	The resource group does not exist.
400	EntityNotExist.ResourceGroup	The resource group does not exist.
400	InvalidStatus.ResourceGroup	It is not allowed to do this operation because of the current status of resource-group.
400	NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.
400	Abs.CheckUrl.Malformed	The CheckUrl you provided is malformed.
400	RecordCheckNotAvailable	The ICP filing interface is unavailable. Please try again later.
400	IcpBlack	The domain is on the ICP blacklist.
400	IspBlack	The domain is on the ISP blacklist.
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.
400	DomainInBlacklist	The domain is in the blacklist.
400	InvalidTagKey	The specified TagKey is invalid.
400	InvalidTagValue	The specified TagValue is invalid.
400	InvalidTagKey.Repeated	The specified TagKey is duplicated.
400	InvalidTag	The specified Tag is Invalid.
400	InvalidTagKey.OverLimit	The number of Tag can not over limit 20.
400	SourceInBlacklist	Source is in the blacklist.
400	ReservedTagKey	The tag key is used internally as a reserved field and is not allowed to be used.
400	DomainOverLimit	The maximum number of domains is exceeded.
400	DomainInRiskList	The domain you added may be at risk. If you have any questions, please submit a ticket.
400	RegionNoResource	Resource allocation failed. Please submit a work order to contact customer service.
403	AccountException	Account exception. Please open ticket to make an appeal.

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

変更履歴

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