次の方法で共有


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 パラメーター

名前 / 必須 説明
customDomainName
path True

string

エンドポイント内のカスタム ドメインの名前。

endpointName
path True

string

グローバルに一意であるプロファイルの下のエンドポイントの名前。

profileName
path True

string

リソース グループ内で一意の CDN プロファイルの名前。

resourceGroupName
path True

string

Azure サブスクリプション内のリソース グループの名前。

正規表現パターン: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Azure サブスクリプション ID。

api-version
query True

string

クライアント要求で使用される API のバージョン。 現在のバージョンは 2024-02-01 です。

要求本文

要求本文は、次のいずれかの可能性があります。

名前 説明
CdnManagedHttpsParameters

SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。

UserManagedHttpsParameters

SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。

CdnManagedHttpsParameters

SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。

名前 必須 説明
certificateSource True string:

Cdn

SSL 証明書のソースを定義します。

certificateSourceParameters True

CdnCertificateSourceParameters

SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。

protocolType True

ProtocolType

セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。

minimumTlsVersion

MinimumTlsVersion

Https に使用される TLS プロトコルのバージョン

UserManagedHttpsParameters

SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。

名前 必須 説明
certificateSource True string:

AzureKeyVault

SSL 証明書のソースを定義します。

certificateSourceParameters True

KeyVaultCertificateSourceParameters

SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。

protocolType True

ProtocolType

セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。

minimumTlsVersion

MinimumTlsVersion

Https に使用される TLS プロトコルのバージョン

応答

名前 説明
200 OK

CustomDomain

OK です。 要求は成功しました。

202 Accepted

CustomDomain

受け入れられ、操作は非同期的に完了します。

ヘッダー

location: string

Other Status Codes

ErrorResponse

操作が失敗した理由を説明する CDN エラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントの借用

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

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"
  }
}

定義

名前 説明
CdnCertificateSourceParameters

カスタム ドメインをセキュリティで保護するために CDN マネージド証明書を使用するためのパラメーターを定義します。

CdnManagedHttpsParameters

SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。

CertificateType

使用される証明書の種類

CustomDomain

顧客がブランド化のために提供するエンドポイント ホスト名へのフレンドリ ドメイン名マッピング ( 例: www.contoso.com)。

CustomDomainResourceState

カスタム ドメインのリソースの状態。

CustomHttpsProvisioningState

カスタム ドメインのプロビジョニング状態。

CustomHttpsProvisioningSubstate

プロビジョニング サブ状態は、カスタム HTTPS の有効化/無効化プロセスの進行状況を段階的に示します。

DeleteRule

証明書がKey Vaultから削除されたときに実行されるアクションについて説明します。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

IdentityType

リソースを作成または変更する ID の種類

KeyVaultCertificateSourceParameters

カスタム ドメインをセキュリティで保護するためにユーザーの KeyVault 証明書を使用するためのパラメーターについて説明します。

MinimumTlsVersion

Https に使用される TLS プロトコルのバージョン

ProtocolType

セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。

SystemData

システム データの読み取り専用

UpdateRule

Key Vaultで証明書が更新されたときに実行されるアクションについて説明します。

UserManagedHttpsParameters

SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。

CdnCertificateSourceParameters

カスタム ドメインをセキュリティで保護するために CDN マネージド証明書を使用するためのパラメーターを定義します。

名前 説明
certificateType

CertificateType

使用される証明書の種類

typeName enum:

CdnCertificateSourceParameters

CdnManagedHttpsParameters

SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。

名前 説明
certificateSource string:

Cdn

SSL 証明書のソースを定義します。

certificateSourceParameters

CdnCertificateSourceParameters

SSL を有効にするために CDN マネージド証明書を使用して証明書ソース パラメーターを定義します。

minimumTlsVersion

MinimumTlsVersion

Https に使用される TLS プロトコルのバージョン

protocolType

ProtocolType

セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。

CertificateType

使用される証明書の種類

名前 説明
Dedicated

string

Shared

string

CustomDomain

顧客がブランド化のために提供するエンドポイント ホスト名へのフレンドリ ドメイン名マッピング ( 例: www.contoso.com)。

名前 説明
id

string

リソースの ID

name

string

リソース名。

properties.customHttpsParameters CustomDomainHttpsParameters:

カスタム HTTPS をセキュリティで保護するための証明書パラメーター

properties.customHttpsProvisioningState

CustomHttpsProvisioningState

カスタム ドメインのプロビジョニング状態。

properties.customHttpsProvisioningSubstate

CustomHttpsProvisioningSubstate

プロビジョニング サブ状態は、カスタム HTTPS の有効化/無効化プロセスの進行状況を段階的に示します。

properties.hostName

string

カスタム ドメインのホスト名。 ドメイン名を指定してください。

properties.provisioningState

CustomHttpsProvisioningState

カスタム ドメインのカスタム Https のプロビジョニング状態。

properties.resourceState

CustomDomainResourceState

カスタム ドメインのリソースの状態。

properties.validationData

string

ローカル のコンプライアンス上の理由により、CDN を一部のリージョンに配信する場合は、特別な検証またはデータが必要になる場合があります。 たとえば、中国でコンテンツを配信するには、カスタム ドメインの ICP ライセンス番号が必要です。

systemData

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

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

error オブジェクト。

IdentityType

リソースを作成または変更する ID の種類

名前 説明
application

string

key

string

managedIdentity

string

user

string

KeyVaultCertificateSourceParameters

カスタム ドメインをセキュリティで保護するためにユーザーの KeyVault 証明書を使用するためのパラメーターについて説明します。

名前 説明
deleteRule

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:

KeyVaultCertificateSourceParameters

updateRule

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

IdentityType

リソースを作成した ID の種類

lastModifiedAt

string

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID の識別子

lastModifiedByType

IdentityType

リソースを最後に変更した ID の種類

UpdateRule

Key Vaultで証明書が更新されたときに実行されるアクションについて説明します。

名前 説明
NoAction

string

UserManagedHttpsParameters

SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。

名前 説明
certificateSource string:

AzureKeyVault

SSL 証明書のソースを定義します。

certificateSourceParameters

KeyVaultCertificateSourceParameters

SSL を有効にするために、ユーザーの keyvault 証明書を使用して証明書ソース パラメーターを定義します。

minimumTlsVersion

MinimumTlsVersion

Https に使用される TLS プロトコルのバージョン

protocolType

ProtocolType

セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。