Web Apps - Create Or Update Host Name Binding

Dienst:

App Service

API-Version:

2025-03-01

Beschreibung für Erstellt eine Hostnamenbindung für eine App.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostNameBindings/{hostName}?api-version=2025-03-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
hostName	path	True	string	Hostname in der Hostnamenbindung.
name	path	True	string	Name der App.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+[^\.]$	Name der Ressourcengruppe, zu der die Ressource gehört.
subscriptionId	path	True	string	die Azure-Abonnement-ID Dies ist eine GUID-formatierte Zeichenfolge (z. B. 0000000-0000-0000-0000-000000000000).
api-version	query	True	string	API-Version

Anforderungstext

Name	Typ	Beschreibung
kind	string	Art der Ressource.
properties.azureResourceName	string	Azure-Ressourcenname.
properties.azureResourceType	AzureResourceType	Azure-Ressourcentyp.
properties.customHostNameDnsRecordType	CustomHostNameDnsRecordType	Benutzerdefinierter DNS-Eintragstyp.
properties.domainId	string	Vollqualifizierter ARM-Domänenressourcen-URI.
properties.hostNameType	HostNameType	Hostnamentyp.
properties.siteName	string	App Service-App-Name.
properties.sslState	SslState	SSL-Typ
properties.thumbprint	string	SSL-Zertifikatfingerabdruck

Antworten

Name	Typ	Beschreibung
200 OK	HostNameBinding	OKAY
Other Status Codes	DefaultErrorResponse	Fehlerantwort des App-Diensts.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Definitionen

Name	Beschreibung
AzureResourceType	Azure-Ressourcentyp.
CustomHostNameDnsRecordType	Benutzerdefinierter DNS-Eintragstyp.
DefaultErrorResponse	Fehlerantwort des App-Diensts.
Details
Error	Fehlermodell.
HostNameBinding	Ein Hostname-Bindungsobjekt.
HostNameType	Hostnamentyp.
SslState	SSL-Typ

AzureResourceType

Enumeration

Azure-Ressourcentyp.

Wert	Beschreibung
Website
TrafficManager

CustomHostNameDnsRecordType

Enumeration

Benutzerdefinierter DNS-Eintragstyp.

Wert	Beschreibung
CName
A

DefaultErrorResponse

Objekt

Fehlerantwort des App-Diensts.

Name	Typ	Beschreibung
error	Error	Fehlermodell.

Details

Objekt

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

Error

Objekt

Fehlermodell.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
details	Details[]	Detaillierte Fehler.
innererror	string	Weitere Informationen zum Debuggen von Fehlern.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

HostNameBinding

Objekt

Ein Hostname-Bindungsobjekt.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
kind	string	Art der Ressource.
name	string	Ressourcenname.
properties.azureResourceName	string	Azure-Ressourcenname.
properties.azureResourceType	AzureResourceType	Azure-Ressourcentyp.
properties.customHostNameDnsRecordType	CustomHostNameDnsRecordType	Benutzerdefinierter DNS-Eintragstyp.
properties.domainId	string	Vollqualifizierter ARM-Domänenressourcen-URI.
properties.hostNameType	HostNameType	Hostnamentyp.
properties.siteName	string	App Service-App-Name.
properties.sslState	SslState	SSL-Typ
properties.thumbprint	string	SSL-Zertifikatfingerabdruck
properties.virtualIP	string	Virtuelle IP-Adresse, die dem Hostnamen zugewiesen ist, wenn IP-basiertes SSL aktiviert ist.
type	string	Ressourcentyp.

HostNameType

Enumeration

Hostnamentyp.

Wert	Beschreibung
Verified
Managed

SslState

Enumeration

SSL-Typ

Wert	Beschreibung
Disabled
SniEnabled
IpBasedEnabled