Custom Domains - Disable Custom Https

サービス:: CDN

API バージョン:: 2025-04-15

カスタムドメインの https 配信を無効にします。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/disableCustomHttps?api-version=2025-04-15

URI パラメーター

名前	/	必須	型	説明
customDomainName	path	True	string	エンドポイント内のカスタムドメインの名前。
endpointName	path	True	string	グローバルに一意であるプロファイルの下のエンドポイントの名前。
profileName	path	True	string	リソースグループ内で一意である CDN プロファイルの名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前は大文字と小文字が区別されます。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	CustomDomain	わかりました。要求は成功しました。
202 Accepted	CustomDomain	受け入れられ、操作は非同期的に完了します。ヘッダー location: string
Other Status Codes	ErrorResponse	操作が失敗した理由を説明する CDN エラー応答。

名前

型

説明

200 OK

CustomDomain

わかりました。要求は成功しました。

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_DisableCustomHttps

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customDomains/www-someDomain-net/disableCustomHttps?api-version=2025-04-15

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Cdn.Models;
using Azure.ResourceManager.Cdn;

// Generated from example definition: specification/cdn/resource-manager/Microsoft.Cdn/stable/2025-04-15/examples/CustomDomains_DisableCustomHttps.json
// this example is just showing the usage of "CdnCustomDomains_DisableCustomHttps" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this CdnCustomDomainResource created on azure
// for more information of creating CdnCustomDomainResource, please refer to the document of CdnCustomDomainResource
string subscriptionId = "subid";
string resourceGroupName = "RG";
string profileName = "profile1";
string endpointName = "endpoint1";
string customDomainName = "www-someDomain-net";
ResourceIdentifier cdnCustomDomainResourceId = CdnCustomDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, profileName, endpointName, customDomainName);
CdnCustomDomainResource cdnCustomDomain = client.GetCdnCustomDomainResource(cdnCustomDomainResourceId);

// invoke the operation
ArmOperation<CdnCustomDomainResource> lro = await cdnCustomDomain.DisableCustomHttpsAsync(WaitUntil.Completed);
CdnCustomDomainResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
CdnCustomDomainData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "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": "Disabled",
    "customHttpsProvisioningSubstate": "CertificateDeleted",
    "validationData": null
  }
}

状態コード:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2025-04-15

{
  "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": null
  }
}

定義

名前	説明
CdnCertificateSourceParameters	カスタムドメインをセキュリティで保護するために CDN マネージド証明書を使用するためのパラメーターを定義します。
CdnManagedHttpsParameters	SSL を有効にするために CDN マネージド証明書を使用して証明書ソースパラメーターを定義します。
CertificateType	使用される証明書の種類
createdByType	リソースを作成した ID の種類。
CustomDomain	ブランディングの目的で顧客が提供するエンドポイントホスト名へのわかりやすいドメイン名マッピング (例: `www.contoso.com`)。
CustomDomainResourceState	カスタムドメインのリソースの状態。
CustomHttpsProvisioningState	カスタムドメインのプロビジョニング状態。
CustomHttpsProvisioningSubstate	プロビジョニングサブステートは、カスタム HTTPS の有効化/無効化プロセスの進行状況を段階的に示します。
DeleteRule	証明書が Key Vault から削除されたときに実行されるアクションについて説明します。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
KeyVaultCertificateSourceParameters	カスタムドメインをセキュリティで保護するためにユーザーの KeyVault 証明書を使用するためのパラメーターについて説明します。
MinimumTlsVersion	Https に使用される TLS プロトコルのバージョン
ProtocolType	セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。
systemData	リソースの作成と最後の変更に関連するメタデータ。
UpdateRule	Key Vault で証明書が更新されたときに実行されるアクションについて説明します。
UserManagedHttpsParameters	SSL を有効にするためにユーザーの keyvault 証明書を使用して、証明書ソースパラメーターを定義します。

CdnCertificateSourceParameters

Object

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

名前	型	説明
certificateType	CertificateType	使用される証明書の種類
typeName	string: CdnCertificateSourceParameters

CdnManagedHttpsParameters

Object

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

名前	型	説明
certificateSource	string: Cdn	SSL 証明書のソースを定義します。
certificateSourceParameters	CdnCertificateSourceParameters	SSL を有効にするために CDN マネージド証明書を使用して証明書ソースパラメーターを定義します。
minimumTlsVersion	MinimumTlsVersion	Https に使用される TLS プロトコルのバージョン
protocolType	ProtocolType	セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。

CertificateType

列挙

使用される証明書の種類

値	説明
Dedicated
Shared

createdByType

列挙

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

値	説明
Application
Key
ManagedIdentity
User

CustomDomain

Object

ブランディングの目的で顧客が提供するエンドポイントホスト名へのわかりやすいドメイン名マッピング (例: www.contoso.com)。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.customHttpsParameters	CustomDomainHttpsParameters: CdnManagedHttpsParameters UserManagedHttpsParameters	カスタム 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	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

CustomDomainResourceState

列挙

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

値	説明
Active
Creating
Deleting

CustomHttpsProvisioningState

列挙

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

値	説明
Disabled
Disabling
Enabled
Enabling
Failed

CustomHttpsProvisioningSubstate

列挙

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

値	説明
CertificateDeleted
CertificateDeployed
DeletingCertificate
DeployingCertificate
DomainControlValidationRequestApproved
DomainControlValidationRequestRejected
DomainControlValidationRequestTimedOut
IssuingCertificate
PendingDomainControlValidationREquestApproval
SubmittingDomainControlValidationRequest

DeleteRule

列挙

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

値	説明
NoAction

ErrorAdditionalInfo

Object

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

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

KeyVaultCertificateSourceParameters

Object

カスタムドメインをセキュリティで保護するためにユーザーの 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	string: KeyVaultCertificateSourceParameters
updateRule	UpdateRule	Key Vault で証明書が更新されたときに実行されるアクションについて説明します。
vaultName	string	SSL 証明書を含むユーザーの Key Vault の名前

MinimumTlsVersion

列挙

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

値	説明
None
TLS10
TLS12

ProtocolType

列挙

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

値	説明
IPBased
ServerNameIndication

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

UpdateRule

列挙

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

値	説明
NoAction

UserManagedHttpsParameters

Object

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

名前	型	説明
certificateSource	string: AzureKeyVault	SSL 証明書のソースを定義します。
certificateSourceParameters	KeyVaultCertificateSourceParameters	SSL を有効にするためにユーザーの keyvault 証明書を使用して、証明書ソースパラメーターを定義します。
minimumTlsVersion	MinimumTlsVersion	Https に使用される TLS プロトコルのバージョン
protocolType	ProtocolType	セキュリティで保護された配信に使用される TLS 拡張プロトコルを定義します。

次の方法で共有

Custom Domains - Disable Custom Https

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

CustomDomains_DisableCustomHttps

要求のサンプル

応答のサンプル

定義

CdnCertificateSourceParameters

CdnManagedHttpsParameters

CertificateType

createdByType

CustomDomain

CustomDomainResourceState

CustomHttpsProvisioningState

CustomHttpsProvisioningSubstate

DeleteRule

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

KeyVaultCertificateSourceParameters

MinimumTlsVersion

ProtocolType

systemData

UpdateRule

UserManagedHttpsParameters