Web Apps - Analyze Custom Hostname
Beschrijving voor Een aangepaste hostnaam analyseren.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/analyzeCustomHostname?api-version=2023-12-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/analyzeCustomHostname?hostName={hostName}&api-version=2023-12-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
name
|
path | True |
string |
Naam van web-app. |
resource
|
path | True |
string |
Naam van de resourcegroep waartoe de resource behoort. Regex-patroon: |
subscription
|
path | True |
string |
Uw Azure-abonnements-id. Dit is een tekenreeks met GUID-indeling (bijvoorbeeld 000000000-0000-0000-0000-000000000000). |
api-version
|
query | True |
string |
API-versie |
host
|
query |
string |
Aangepaste hostnaam. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
App Service foutreactie. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
Analyze custom hostname for webapp.
Voorbeeldaanvraag
Voorbeeldrespons
{
"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"
]
}
}
Definities
Name | Description |
---|---|
Custom |
Aangepaste domeinanalyse. |
Default |
App Service foutreactie. |
Details | |
Dns |
Testresultaat voor DNS-verificatie. |
Error |
Foutmodel. |
Error |
Hoofdtekst van het foutbericht dat is geretourneerd door de API. |
CustomHostnameAnalysisResult
Aangepaste domeinanalyse.
Name | Type | Description |
---|---|---|
id |
string |
Resource-id. |
kind |
string |
Soort resource. |
name |
string |
Resourcenaam. |
properties.aRecords |
string[] |
Een recordcontroller kan deze hostnaam zien. |
properties.alternateCNameRecords |
string[] |
Alternatieve CName-recordscontroller kan zien voor deze hostnaam. |
properties.alternateTxtRecords |
string[] |
Alternatieve TXT-records controller kan zien voor deze hostnaam. |
properties.cNameRecords |
string[] |
De CName-recordcontroller kan deze hostnaam zien. |
properties.conflictingAppResourceId |
string |
Naam van de conflicterende app op schaaleenheid als deze zich binnen hetzelfde abonnement bevindt. |
properties.customDomainVerificationFailureInfo |
Onbewerkte foutinformatie als DNS-verificatie mislukt. |
|
properties.customDomainVerificationTest |
Testresultaat voor DNS-verificatie. |
|
properties.hasConflictAcrossSubscription |
boolean |
|
properties.hasConflictOnScaleUnit |
boolean |
|
properties.isHostnameAlreadyVerified |
boolean |
|
properties.txtRecords |
string[] |
DE TXT-recordcontroller kan zien voor deze hostnaam. |
type |
string |
Resourcetype. |
DefaultErrorResponse
App Service foutreactie.
Name | Type | Description |
---|---|---|
error |
Foutmodel. |
Details
Name | Type | Description |
---|---|---|
code |
string |
Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren. |
message |
string |
Gedetailleerde foutbeschrijving en foutopsporingsinformatie. |
target |
string |
Gedetailleerde foutbeschrijving en foutopsporingsinformatie. |
DnsVerificationTestResult
Testresultaat voor DNS-verificatie.
Name | Type | Description |
---|---|---|
Failed |
string |
|
Passed |
string |
|
Skipped |
string |
Error
Foutmodel.
Name | Type | Description |
---|---|---|
code |
string |
Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren. |
details |
Details[] |
Gedetailleerde fouten. |
innererror |
string |
Meer informatie over foutopsporing. |
message |
string |
Gedetailleerde foutbeschrijving en foutopsporingsinformatie. |
target |
string |
Gedetailleerde foutbeschrijving en foutopsporingsinformatie. |
ErrorEntity
Hoofdtekst van het foutbericht dat is geretourneerd door de API.
Name | Type | Description |
---|---|---|
code |
string |
Basisfoutcode. |
details |
Foutdetails. |
|
extendedCode |
string |
Type fout. |
innerErrors |
Interne fouten. |
|
message |
string |
Eventuele details van de fout. |
messageTemplate |
string |
Berichtsjabloon. |
parameters |
string[] |
Parameters voor de sjabloon. |
target |
string |
Het foutdoel. |