Custom Domains - Enable Custom Https
カスタム ドメインの https 配信を有効にします。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/enableCustomHttps?api-version=2024-02-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
custom
|
path | True |
string |
エンドポイント内のカスタム ドメインの名前。 |
endpoint
|
path | True |
string |
グローバルに一意であるプロファイルの下のエンドポイントの名前。 |
profile
|
path | True |
string |
リソース グループ内で一意の CDN プロファイルの名前。 |
resource
|
path | True |
string |
Azure サブスクリプション内のリソース グループの名前。 正規表現パターン: |
subscription
|
path | True |
string |
Azure サブスクリプション ID。 |
api-version
|
query | True |
string |
クライアント要求で使用される API のバージョン。 現在のバージョンは 2024-02-01 です。 |
要求本文
要求本文は、次のいずれかの可能性があります。
名前 | 説明 |
---|---|
Cdn |
SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。 |
User |
SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。 |
CdnManagedHttpsParameters
SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。
名前 | 必須 | 型 | 説明 |
---|---|---|---|
certificateSource | True |
string:
Cdn |
SSL 証明書のソースを定義します。 |
certificateSourceParameters | True |
SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。 |
|
protocolType | True |
セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。 |
|
minimumTlsVersion |
Https に使用される TLS プロトコルのバージョン |
UserManagedHttpsParameters
SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。
名前 | 必須 | 型 | 説明 |
---|---|---|---|
certificateSource | True |
string:
Azure |
SSL 証明書のソースを定義します。 |
certificateSourceParameters | True |
SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。 |
|
protocolType | True |
セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。 |
|
minimumTlsVersion |
Https に使用される TLS プロトコルのバージョン |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK です。 要求は成功しました。 |
|
202 Accepted |
受け入れられ、操作は非同期的に完了します。 ヘッダー location: string |
|
Other Status Codes |
操作が失敗した理由を説明する CDN エラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
要求のサンプル
POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customDomains/www-someDomain-net/enableCustomHttps?api-version=2024-02-01
応答のサンプル
{
"name": "www-someDomain-net",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
"type": "Microsoft.Cdn/profiles/endpoints/customdomains",
"properties": {
"provisioningState": "Succeeded",
"resourceState": "Active",
"hostName": "www.someDomain.net",
"customHttpsProvisioningState": "Enabled",
"customHttpsProvisioningSubstate": "CertificateDeployed",
"validationData": "validationdata"
}
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2024-02-01
{
"name": "www-someDomain-net",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
"type": "Microsoft.Cdn/profiles/endpoints/customdomains",
"properties": {
"provisioningState": "Succeeded",
"resourceState": "Active",
"hostName": "www.someDomain.net",
"customHttpsProvisioningState": "Enabling",
"customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
"validationData": "validationdata"
}
}
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate
要求のサンプル
POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customDomains/www-someDomain-net/enableCustomHttps?api-version=2024-02-01
応答のサンプル
{
"name": "www-someDomain-net",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
"type": "Microsoft.Cdn/profiles/endpoints/customdomains",
"properties": {
"provisioningState": "Succeeded",
"resourceState": "Active",
"hostName": "www.someDomain.net",
"customHttpsProvisioningState": "Enabled",
"customHttpsProvisioningSubstate": "CertificateDeployed",
"validationData": "validationdata"
}
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2024-02-01
{
"name": "www-someDomain-net",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
"type": "Microsoft.Cdn/profiles/endpoints/customdomains",
"properties": {
"provisioningState": "Succeeded",
"resourceState": "Active",
"hostName": "www.someDomain.net",
"customHttpsProvisioningState": "Enabling",
"customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
"validationData": "validationdata"
}
}
定義
名前 | 説明 |
---|---|
Cdn |
カスタム ドメインをセキュリティで保護するために CDN マネージド証明書を使用するためのパラメーターを定義します。 |
Cdn |
SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。 |
Certificate |
使用される証明書の種類 |
Custom |
顧客がブランド化のために提供するエンドポイント ホスト名へのフレンドリ ドメイン名マッピング ( 例: www.contoso.com)。 |
Custom |
カスタム ドメインのリソースの状態。 |
Custom |
カスタム ドメインのプロビジョニング状態。 |
Custom |
プロビジョニング サブ状態は、カスタム HTTPS の有効化/無効化プロセスの進行状況を段階的に示します。 |
Delete |
証明書がKey Vaultから削除されたときに実行されるアクションについて説明します。 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Identity |
リソースを作成または変更する ID の種類 |
Key |
カスタム ドメインをセキュリティで保護するためにユーザーの KeyVault 証明書を使用するためのパラメーターについて説明します。 |
Minimum |
Https に使用される TLS プロトコルのバージョン |
Protocol |
セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。 |
System |
システム データの読み取り専用 |
Update |
Key Vaultで証明書が更新されたときに実行されるアクションについて説明します。 |
User |
SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。 |
CdnCertificateSourceParameters
カスタム ドメインをセキュリティで保護するために CDN マネージド証明書を使用するためのパラメーターを定義します。
名前 | 型 | 説明 |
---|---|---|
certificateType |
使用される証明書の種類 |
|
typeName | enum: |
CdnManagedHttpsParameters
SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。
名前 | 型 | 説明 |
---|---|---|
certificateSource |
string:
Cdn |
SSL 証明書のソースを定義します。 |
certificateSourceParameters |
SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。 |
|
minimumTlsVersion |
Https に使用される TLS プロトコルのバージョン |
|
protocolType |
セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。 |
CertificateType
使用される証明書の種類
名前 | 型 | 説明 |
---|---|---|
Dedicated |
string |
|
Shared |
string |
CustomDomain
顧客がブランド化のために提供するエンドポイント ホスト名へのフレンドリ ドメイン名マッピング ( 例: www.contoso.com)。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの ID |
name |
string |
リソース名。 |
properties.customHttpsParameters | CustomDomainHttpsParameters: |
カスタム HTTPS をセキュリティで保護するための証明書パラメーター |
properties.customHttpsProvisioningState |
カスタム ドメインのプロビジョニング状態。 |
|
properties.customHttpsProvisioningSubstate |
プロビジョニング サブ状態は、カスタム HTTPS の有効化/無効化プロセスの進行状況を段階的に示します。 |
|
properties.hostName |
string |
カスタム ドメインのホスト名。 ドメイン名を指定してください。 |
properties.provisioningState |
カスタム ドメインのカスタム Https のプロビジョニング状態。 |
|
properties.resourceState |
カスタム ドメインのリソースの状態。 |
|
properties.validationData |
string |
ローカル のコンプライアンス上の理由により、CDN を一部のリージョンに配信する場合は、特別な検証またはデータが必要になる場合があります。 たとえば、中国でコンテンツを配信するには、カスタム ドメインの ICP ライセンス番号が必要です。 |
systemData |
システム データの読み取り専用 |
|
type |
string |
リソースの種類。 |
CustomDomainResourceState
カスタム ドメインのリソースの状態。
名前 | 型 | 説明 |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
CustomHttpsProvisioningState
カスタム ドメインのプロビジョニング状態。
名前 | 型 | 説明 |
---|---|---|
Disabled |
string |
|
Disabling |
string |
|
Enabled |
string |
|
Enabling |
string |
|
Failed |
string |
CustomHttpsProvisioningSubstate
プロビジョニング サブ状態は、カスタム HTTPS の有効化/無効化プロセスの進行状況を段階的に示します。
名前 | 型 | 説明 |
---|---|---|
CertificateDeleted |
string |
|
CertificateDeployed |
string |
|
DeletingCertificate |
string |
|
DeployingCertificate |
string |
|
DomainControlValidationRequestApproved |
string |
|
DomainControlValidationRequestRejected |
string |
|
DomainControlValidationRequestTimedOut |
string |
|
IssuingCertificate |
string |
|
PendingDomainControlValidationREquestApproval |
string |
|
SubmittingDomainControlValidationRequest |
string |
DeleteRule
証明書がKey Vaultから削除されたときに実行されるアクションについて説明します。
名前 | 型 | 説明 |
---|---|---|
NoAction |
string |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
IdentityType
リソースを作成または変更する ID の種類
名前 | 型 | 説明 |
---|---|---|
application |
string |
|
key |
string |
|
managedIdentity |
string |
|
user |
string |
KeyVaultCertificateSourceParameters
カスタム ドメインをセキュリティで保護するためにユーザーの KeyVault 証明書を使用するためのパラメーターについて説明します。
名前 | 型 | 説明 |
---|---|---|
deleteRule |
証明書がKey Vaultから削除されたときに実行されるアクションについて説明します。 |
|
resourceGroupName |
string |
SSL 証明書を含むユーザーのKey Vaultのリソース グループ |
secretName |
string |
Key Vault内の Key Vault シークレット (完全な証明書 PFX を表す) の名前。 |
secretVersion |
string |
Key VaultのKey Vault シークレットのバージョン (GUID)。 |
subscriptionId |
string |
SSL 証明書を含むユーザーのKey Vaultのサブスクリプション ID |
typeName | enum: | |
updateRule |
Key Vaultで証明書が更新されたときに実行されるアクションについて説明します。 |
|
vaultName |
string |
SSL 証明書を含むユーザーのKey Vaultの名前 |
MinimumTlsVersion
Https に使用される TLS プロトコルのバージョン
名前 | 型 | 説明 |
---|---|---|
None |
string |
|
TLS10 |
string |
|
TLS12 |
string |
ProtocolType
セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。
名前 | 型 | 説明 |
---|---|---|
IPBased |
string |
|
ServerNameIndication |
string |
SystemData
システム データの読み取り専用
名前 | 型 | 説明 |
---|---|---|
createdAt |
string |
リソース作成のタイムスタンプ (UTC) |
createdBy |
string |
リソースを作成した ID の識別子 |
createdByType |
リソースを作成した ID の種類 |
|
lastModifiedAt |
string |
リソースの最終変更のタイムスタンプ (UTC) |
lastModifiedBy |
string |
リソースを最後に変更した ID の識別子 |
lastModifiedByType |
リソースを最後に変更した ID の種類 |
UpdateRule
Key Vaultで証明書が更新されたときに実行されるアクションについて説明します。
名前 | 型 | 説明 |
---|---|---|
NoAction |
string |
UserManagedHttpsParameters
SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。
名前 | 型 | 説明 |
---|---|---|
certificateSource |
string:
Azure |
SSL 証明書のソースを定義します。 |
certificateSourceParameters |
SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。 |
|
minimumTlsVersion |
Https に使用される TLS プロトコルのバージョン |
|
protocolType |
セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。 |