List Custom Host Name Sites - List Custom Host Name Sites

Szolgáltatás:

App Service

API verzió:

2025-05-01

Egyéni állomásnevek lekérése ebben az előfizetésben

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/customhostnameSites?api-version=2025-05-01

Opcionális paraméterekkel:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/customhostnameSites?api-version=2025-05-01&hostname={hostname}

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
hostname	query		string	Adott állomásnév

Válaszok

Név	Típus	Leírás
200 OK	CustomHostnameSitesCollection	A kérés sikeres volt.
Other Status Codes	DefaultErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Flow: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Leírás
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get custom hostnames under subscription

Get specific custom hostname under subscription

Get custom hostnames under subscription

Mintakérés

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/customhostnameSites?api-version=2025-05-01

Mintaválasz

Állapotkód:

200

{
  "nextLink": null,
  "value": [
    {
      "name": "mywebapp.azurewebsites.net",
      "type": "Microsoft.Web/customhostnameSites",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/customhostnameSites/mywebapp.azurewebsites.net",
      "properties": {
        "customHostname": "mywebapp.azurewebsites.net",
        "region": "West US",
        "siteResourceIds": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/westus-rg/providers/Microsoft.Web/sites/mywebapp"
          }
        ]
      }
    },
    {
      "name": "www.example.com",
      "type": "Microsoft.Web/customhostnameSites",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/customhostnameSites/www.example.com",
      "properties": {
        "customHostname": "www.example.com",
        "region": "West US 2",
        "siteResourceIds": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/westus2-rg/providers/Microsoft.Web/sites/westus2app1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/westus2-rg/providers/Microsoft.Web/sites/westus2app2"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/westus2-rg/providers/Microsoft.Web/sites/westus2app3"
          }
        ]
      }
    }
  ]
}

Get specific custom hostname under subscription

Mintakérés

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/customhostnameSites?api-version=2025-05-01&hostname=www.example.com

Mintaválasz

Állapotkód:

200

{
  "nextLink": null,
  "value": [
    {
      "name": "www.example.com",
      "type": "Microsoft.Web/customhostnameSites",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/customhostnameSites/www.example.com",
      "properties": {
        "customHostname": "www.example.com",
        "region": "West US 2",
        "siteResourceIds": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/westus2-rg/providers/Microsoft.Web/sites/westus2app1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/westus2-rg/providers/Microsoft.Web/sites/westus2app2"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/westus2-rg/providers/Microsoft.Web/sites/westus2app3"
          }
        ]
      }
    }
  ]
}

Meghatározások

Név	Leírás
createdByType	Az erőforrást létrehozó identitás típusa.
CustomHostnameSites	Állomásnév és hozzárendelt helyek
CustomHostnameSitesCollection	Egyéni állomásnév-webhelyek gyűjteménye
DefaultErrorResponse	App Service-hibaválasz.
DefaultErrorResponseError	Hibamodell.
DefaultErrorResponseErrorDetailsItem	Részletes hibák.
Identifier	Tartományspecifikus erőforrás-azonosító.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Leírás
User
Application
ManagedIdentity
Key

CustomHostnameSites

Tárgy

Állomásnév és hozzárendelt helyek

Név	Típus	Leírás
id	string	Erőforrás-azonosító.
kind	string	Erőforrás típusa.
name	string	Erőforrás neve.
properties.customHostname	string
properties.region	string
properties.siteResourceIds	Identifier[]	Tartományspecifikus erőforrás-azonosító.
type	string	Erőforrás típusa.

CustomHostnameSitesCollection

Tárgy

Egyéni állomásnév-webhelyek gyűjteménye

Név	Típus	Leírás
nextLink	string (uri)	Az elemek következő oldalára mutató hivatkozás
value	CustomHostnameSites[]	Az CustomHostnameSites elemek ezen az oldalon

DefaultErrorResponse

Tárgy

App Service-hibaválasz.

Név	Típus	Leírás
error	DefaultErrorResponseError	Hibamodell.

DefaultErrorResponseError

Tárgy

Hibamodell.

Név	Típus	Leírás
code	string	Szabványosított sztring a hiba programozott azonosításához.
details	DefaultErrorResponseErrorDetailsItem[]	Részletes hibák.
innererror	string	További információ a hiba hibakereséséről.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

DefaultErrorResponseErrorDetailsItem

Tárgy

Részletes hibák.

Név	Típus	Leírás
code	string	Szabványosított sztring a hiba programozott azonosításához.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

Identifier

Tárgy

Tartományspecifikus erőforrás-azonosító.

Név	Típus	Leírás
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Erőforrás típusa.
name	string	Az erőforrás neve
properties.id	string	Az identitás sztring-ábrázolása.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Név	Típus	Leírás
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.