Compartilhar via


Web Apps - Analyze Custom Hostname Slot

Descrição para Analisar um nome de host personalizado.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
name
path True

string

Nome do aplicativo Web.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+[^\.]$

Nome do grupo de recursos ao qual o recurso pertence.

slot
path True

string

Nome do slot do aplicativo Web. Se não for especificado, o padrão será o slot de produção.

subscriptionId
path True

string

Sua ID de assinatura do Azure. Esta é uma cadeia de caracteres formatada por GUID (por exemplo, 000000000-0000-0000-0000-000000000000000).

api-version
query True

string

Versão da API

hostName
query

string

Nome do host personalizado.

Respostas

Nome Tipo Description
200 OK

CustomHostnameAnalysisResult

OKEY

Other Status Codes

DefaultErrorResponse

Resposta de erro do Serviço de Aplicativo.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Analyze custom hostname for slot

Solicitação de exemplo

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

Resposta de exemplo

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/slots/staging",
  "name": "sitef6141/staging",
  "type": "Microsoft.Web/sites/stagings",
  "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/slots/qa",
    "cNameRecords": [
      "siteog.azurewebsites.net"
    ]
  }
}

Definições

Nome Description
CustomHostnameAnalysisResult

Análise de domínio personalizada.

DefaultErrorResponse

Resposta de erro do Serviço de Aplicativo.

Details
DnsVerificationTestResult

Resultado do teste de verificação DNS.

Error

Modelo de erro.

ErrorEntity

Corpo da resposta de erro retornada da API.

CustomHostnameAnalysisResult

Análise de domínio personalizada.

Nome Tipo Description
id

string

ID do recurso.

kind

string

Tipo de recurso.

name

string

Nome do recurso.

properties.aRecords

string[]

Um controlador de registros pode ver esse nome de host.

properties.alternateCNameRecords

string[]

O controlador de registros CName alternativo pode ver esse nome de host.

properties.alternateTxtRecords

string[]

O controlador de registros TXT alternativo pode ver esse nome de host.

properties.cNameRecords

string[]

O controlador de registros CName pode ver esse nome de host.

properties.conflictingAppResourceId

string

Nome do aplicativo conflitante na unidade de escala se ele estiver dentro da mesma assinatura.

properties.customDomainVerificationFailureInfo

ErrorEntity

Informações de falha bruta se a verificação de DNS falhar.

properties.customDomainVerificationTest

DnsVerificationTestResult

Resultado do teste de verificação DNS.

properties.hasConflictAcrossSubscription

boolean

true se houver um conflito entre assinaturas; caso contrário, false.

properties.hasConflictOnScaleUnit

boolean

true se houver um conflito em uma unidade de escala; caso contrário, false.

properties.isHostnameAlreadyVerified

boolean

true se o nome do host já estiver verificado; caso contrário, false.

properties.txtRecords

string[]

O controlador de registros TXT pode ver esse nome de host.

type

string

Tipo de recurso.

DefaultErrorResponse

Resposta de erro do Serviço de Aplicativo.

Nome Tipo Description
error

Error

Modelo de erro.

Details

Nome Tipo Description
code

string

Cadeia de caracteres padronizada para identificar programaticamente o erro.

message

string

Informações detalhadas de descrição e depuração de erros.

target

string

Informações detalhadas de descrição e depuração de erros.

DnsVerificationTestResult

Resultado do teste de verificação DNS.

Valor Description
Failed
Passed
Skipped

Error

Modelo de erro.

Nome Tipo Description
code

string

Cadeia de caracteres padronizada para identificar programaticamente o erro.

details

Details[]

Erros detalhados.

innererror

string

Mais informações para depurar o erro.

message

string

Informações detalhadas de descrição e depuração de erros.

target

string

Informações detalhadas de descrição e depuração de erros.

ErrorEntity

Corpo da resposta de erro retornada da API.

Nome Tipo Description
code

string

Código de erro básico.

details

ErrorEntity[]

Detalhes do erro.

extendedCode

string

Tipo de erro.

innerErrors

ErrorEntity[]

Erros internos.

message

string

Todos os detalhes do erro.

messageTemplate

string

Modelo de mensagem.

parameters

string[]

Parâmetros para o modelo.

target

string

O destino do erro.