Web Apps - Analyze Custom Hostname

Başvuru

Service:: App Service

API Version:: 2023-12-01

Özel ana bilgisayar adını analiz etme açıklaması.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/analyzeCustomHostname?api-version=2023-12-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/analyzeCustomHostname?hostName={hostName}&api-version=2023-12-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
name	path	True	string	Web uygulamasının adı.
resourceGroupName	path	True	string	Kaynağın ait olduğu kaynak grubunun adı. Regex pattern: `^[-\w\._]+[^\.]$`
subscriptionId	path	True	string	Azure abonelik kimliğiniz. Bu GUID biçimli bir dizedir (örn. 000000000-0000-0000-0000-000000000000).
api-version	query	True	string	API Sürümü
hostName	query		string	Özel ana bilgisayar adı.

Yanıtlar

Name	Tür	Description
200 OK	CustomHostnameAnalysisResult	Tamam
Other Status Codes	DefaultErrorResponse	hata yanıtı App Service.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Analyze custom hostname for webapp.

Sample Request

HTTP

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/analyzeCustomHostname?api-version=2023-12-01

Sample Response

Status code:: 200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "properties": {
    "isHostnameAlreadyVerified": true,
    "customDomainVerificationTest": "Passed",
    "customDomainVerificationFailureInfo": {
      "code": "07198",
      "message": "Custom domain verification failed on conflicting CNAMEs."
    },
    "hasConflictOnScaleUnit": false,
    "hasConflictAcrossSubscription": true,
    "conflictingAppResourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/siteog",
    "cNameRecords": [
      "siteog.azurewebsites.net"
    ]
  }
}

Tanımlar

Name	Description
CustomHostnameAnalysisResult	Özel etki alanı analizi.
DefaultErrorResponse	hata yanıtı App Service.
Details
DnsVerificationTestResult	DNS doğrulama testi sonucu.
Error	Hata modeli.
ErrorEntity	API'den döndürülen hata yanıtının gövdesi.

CustomHostnameAnalysisResult

Özel etki alanı analizi.

Name	Tür	Description
id	string	Kaynak Kimliği.
kind	string	Kaynak türü.
name	string	Kaynak Adı.
properties.aRecords	string[]	Kayıt denetleyicisi bu konak adı için görebilir.
properties.alternateCNameRecords	string[]	Bu ana bilgisayar adı için alternatif CName kayıt denetleyicisi görebilir.
properties.alternateTxtRecords	string[]	Bu ana bilgisayar adı için diğer TXT kayıt denetleyicisini görebilir.
properties.cNameRecords	string[]	CName kayıt denetleyicisi bu ana bilgisayar adı için görebilir.
properties.conflictingAppResourceId	string	Aynı abonelik içindeyse ölçek birimi üzerinde çakışan uygulamanın adı.
properties.customDomainVerificationFailureInfo	ErrorEntity	DNS doğrulaması başarısız olursa ham hata bilgileri.
properties.customDomainVerificationTest	DnsVerificationTestResult	DNS doğrulama testi sonucu.
properties.hasConflictAcrossSubscription	boolean	`true` abonelikler arasında çakışma varsa; aksi takdirde , `false`.
properties.hasConflictOnScaleUnit	boolean	`true` ölçek biriminde çakışma varsa; aksi takdirde , `false`.
properties.isHostnameAlreadyVerified	boolean	`true` konak adı zaten doğrulanmışsa; aksi takdirde , `false`.
properties.txtRecords	string[]	TXT kayıt denetleyicisi bu ana bilgisayar adı için görebilir.
type	string	Kaynak türü.

DefaultErrorResponse

hata yanıtı App Service.

Name	Tür	Description
error	Error	Hata modeli.

Details

Name	Tür	Description
code	string	Hatayı program aracılığıyla tanımlamak için standartlaştırılmış dize.
message	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.
target	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.

DnsVerificationTestResult

DNS doğrulama testi sonucu.

Name	Tür	Description
Failed	string
Passed	string
Skipped	string

Error

Hata modeli.

Name	Tür	Description
code	string	Hatayı program aracılığıyla tanımlamak için standartlaştırılmış dize.
details	Details[]	Ayrıntılı hatalar.
innererror	string	Hata ayıklamak için daha fazla bilgi.
message	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.
target	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.

ErrorEntity

API'den döndürülen hata yanıtının gövdesi.

Name	Tür	Description
code	string	Temel hata kodu.
details	ErrorEntity[]	Hata Ayrıntıları.
extendedCode	string	Hata türü.
innerErrors	ErrorEntity[]	İç hatalar.
message	string	Hatanın tüm ayrıntıları.
messageTemplate	string	İleti şablonu.
parameters	string[]	Şablonun parametreleri.
target	string	Hata hedefi.

Share via