AddCdnDomain オペレーションを呼び出して、CDN ドメインを追加できます。 リクエストごとに追加できる CDN ドメインは 1 つだけで、同じアカウントで最大 20 個のドメインを追加できます。
注
- CDN ドメインを追加する前に、CDN サービスを有効化する必要があります。 詳細については、「CDN の有効化」をご参照ください。
- ドメインには、インターネットコンテンツプロバイダ (ICP) ライセンスが必要です。
- オリジンコンテンツが Alibaba Cloud プラットフォームに保存されない場合は、コンテンツを確認する必要があります。 確認は申請書を提出した翌営業日の終わりまでに完了します。
デバッグ
API の使用を簡単にするため、Alibaba Cloud では、OpenAPI Explorer を提供しています。 OpenAPI Explorer を使用して、API の検索、API の呼び出し、および SDK サンプルコードの動的な生成を行うことができます。
リクエストパラメーター
| パラメーター | データ型 | 必須/省略可能 | 説明 |
|---|---|---|---|
| Action | String | 必須 | 実行する操作です。 このパラメーターを、AddCdnDomain に設定します。 |
| DomainName | String | 必須 | CDN で有効にするドメインの名前です。 ワイルドカードドメイン名がサポートされています。 ワイルドカードドメイン名は、ピリオド (.) で始まる必要があります。たとえば、.example.com などです。
|
| CdnType | String | 必須 | CDN ドメインのビジネスタイプです。 有効値:
|
| Sources | String | 必須 | オリジンアドレスのリストです。 |
| CheckUrl | String | 省略可能 | オリジンのアクセシビリティをテストするために使用される URL です。 |
| Scope | String | 省略可能 | 範囲です。 有効値:
|
| ResourceGroupId | String | 省略可能 | リソースグループの ID です。 このパラメーターを指定しない場合は、デフォルトのリソースグループの ID が使用されます。 |
| TopLevelDomain | String | 省略可能 | プライマリドメイン名です。 |
Sources 構文
[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80,"weight":"15"}]Sources のパラメーター
| パラメーター | データ型 | 必須/省略可能 | 説明 |
|---|---|---|---|
| type | String | 必須 | オリジンアドレスのタイプです。 有効値:
|
| content | String | 必須 | IP アドレスまたはドメイン名などのオリジンアドレスです。 |
| port | Integer | 省略可能 | ポート番号です。 ポート 443 または 80 を指定できます。 ポート番号をカスタマイズすることもできます。 デフォルト値: 80 。 ポート 443 を指定すると、CDN は HTTPS を使用してオリジンと通信します。 |
| priority | String | 省略可能 | 複数のオリジンが指定されている場合のオリジンの優先度です。 デフォルト値: 20 。 |
| weight | String | 省略可能 | 複数のオリジンが指定されている場合のオリジンの重みです。 デフォルト値: 10 。 |
レスポンスパラメーター
| パラメーター | データ型 | 説明 |
|---|---|---|
| RequestID | String | リクエストの ID です。 |
例
リクエストの例
http://cdn.aliyuncs.com?Action=AddCdnDomain&CdnType=web&DomainName=example.com&Sources=[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]&<Common request parameters>成功したレスポンスの例
JSON 形式
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}エラーコード
| エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
|---|---|---|---|
| InvalidDomainName.Malformed | Specified end time is malformed. | 400 | 指定された DomainName パラメーターが無効のため、エラーメッセージが返されました。 |
| InvalidCdnType.Malformed | Specified CdnType is malformed. | 400 | 指定された CdnType パラメーターが無効のため、エラーメッセージが返されました。 |
| InvalidSourceType.Malformed | Specified start time is malformed. | 400 | 指定された SourceType パラメーターが無効のため、エラーメッセージが返されました。 |
| InvalidSources.Malformed | Specified Sources is malformed. | 400 | 指定されたオリジンアドレスがオリジンのタイプと一致しないため、エラーメッセージが返されました。 |
| InvalidScope.Malformed | Specified end time is malformed. | 400 | 指定された Scope パラメーターが無効であるため、エラーメッセージが返されました。 |
| InvaildParameter | The Certificate you provided is malformed! | 400 | 指定された証明書が無効であるため、エラーメッセージが返されました。 |
| BusinessExist | Business exist do not repeated submission | 400 | 指定されたドメインが追加中であるため、エラーメッセージが返されました。 操作を繰り返さないで下さい。 |
| DomainAlreadyExist | This domain name is exist already | 400 | 指定されたドメインが既に追加されているため、エラーメッセージが返されました。 |
| DomainOverLimit | The Number of Domain is over the limit | 403 | CDN ドメインの最大数を超えたため、エラーメッセージが返されました。 |
| DomainNotRegistration | The Domain name is not registered | 404 | 指定されたドメインに ICP ライセンスがないため、エラーメッセージが返されました。 |
| IllegalOperation | Illegal domain, operation is not permitted. | 403 | この操作を実行する権限がないため、エラーメッセージが返されました。 |
| ServiceBusy | The specified Domain is configuring, please retry later. | 403 | 指定されたドメイン名が設定中のため、エラーメッセージが返されました。 後でもう一度やり直してください。 |
| InvalidDomain.NotFound | The domain provided does not belong to you. | 404 | 指定されたドメイン名が存在しないか、ユーザーに属していないため、エラーメッセージが返されました。 |
| InnerAddDomainDenied | Your account haven't bind aoneId, can not add domain. | 400 | 内部アカウントが Aone ID にバインドされていないため、エラーメッセージが返されました。 |
| ExtensiveAndAllBothExist | Extensive domain and the domain begins with 'all.' can not exist at the same time. | 400 | "all." で始まるワイルドカードドメイン名とドメイン名が同時に存在できないため、エラーメッセージが返されました。 |
| CdnTypeNotSupportExtensiveDomain | Extensive domain not supported for this cdn type. | 400 | ワイルドカードドメイン名がこのビジネスタイプでサポートされていないため、エラーメッセージが返されました。 |
| ExtensiveAndSpecificDomainConflict | Extensive domain and corresponding specific domain are mutually exclusive. | 400 | ワイルドカードドメイン名が対応するレベルのドメイン名と完全に一致するため、エラーメッセージが返されました。 ワイルドカードドメイン名は、完全に一致するドメイン名と相互に排他的です。 |
| InvalidParameter | Add live region parameters have error. | 400 | システムが、ライブストリーミングメディアの region パラメーターの指定に失敗したため、エラーメッセージが返されました。 |
| InvalidRegion.Malformed | Specified Region is malformed. | 400 | 指定された region パラメーターが無効であるため、エラーメッセージが返されました。 |
| Abs.resourceGroupId.Malformed | Specified ResourceGroupId is malformed. | 400 | 指定されたリソースグループ ID が無効であるため、エラーメッセージが返されました。 |
| InvalidTopLevelDomain.Malformed | Specified TopLevelDomain is malformed. | 400 | 指定された TopLevelDomain パラメーターが無効のため、エラーメッセージが返されました。 |
| TopLevelDomain.NotFound | TopLevelDomain is not exist. | 400 | 指定されたTopLevelDomain パラメーターが存在しないため、エラーメッセージが返されました。 |
| InvalidResourceGroupId.Malformed | Specified ResourceGroupId is malformed. | 400 | 指定された ResourceGroupId パラメーターが無効のため、エラーメッセージが返されました。 |
| EntityNotExists.ResourceGroup | The resource group does not exist. | 400 | 指定されたリソースグループ ID が存在しないため、エラーメッセージが返されました。 |
| InvalidStatus.ResourceGroup | It's now allowed to do this operation because of the current status of resource-group. | 400 | 指定されたリソースグループが無効な状態にあるため、エラーメッセージが返されました。 |
| InvalidPriorities.Malformed | The length of priorities is not the same with source. | 400 | 優先度の設定数がオリジンの数と一致しないため、エラーメッセージが返されました。 |
| NotInternationRealIdentity | You need to do real name authentication when you use Chinese mainland resources. | 400 | 中国本土のリソースを使用するために必要な実名認証を完了していないため、エラーメッセージが返されました。 |
| DomainReserved | The root domain of your domain is reserved by another account. Submit a ticket to contact customer support. | 400 | ルートドメインが既に別のアカウントで使用されているため、エラーメッセージが返されました。 それでもドメインを追加したい場合は、チケットを起票し、サポートセンターへお問い合わせください。 |