Hosts - List

Referencia

Szolgáltatás:: AVS

API-verzió:: 2024-09-01

Gazdagép-erőforrások listázása fürt szerint

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/clusters/{clusterName}/hosts?api-version=2024-09-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
clusterName	path	True	string pattern: ^[-\w\._]+$	A klaszter neve
privateCloudName	path	True	string pattern: ^[-\w\._]+$	A magánfelhő neve
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
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ó.

Válaszok

Name	Típus	Description
200 OK	HostListResult	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

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

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Hosts_List

Mintakérelem

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/clusters/cluster1/hosts?api-version=2024-09-01

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/clusters/cluster1/hosts/esx03-r52.1111111111111111111.westcentralus.prod.azure.com",
      "name": "esx03-r52.1111111111111111111.westcentralus.prod.azure.com",
      "type": "Microsoft.AVS/privateClouds/clusters/hosts",
      "zones": [
        "1"
      ],
      "sku": {
        "name": "av64"
      },
      "properties": {
        "kind": "General",
        "displayName": "esx03-r52.1111111111111111111.westcentralus.prod.azure.com",
        "moRefId": "host-209",
        "fqdn": "esx03-r52.1111111111111111111.westcentralus.prod.azure.com",
        "faultDomain": "1"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/clusters/cluster1/hosts/esx03-r60.1111111111111111111.westcentralus.prod.azure.com",
      "name": "esx03-r60.1111111111111111111.westcentralus.prod.azure.com",
      "type": "Microsoft.AVS/privateClouds/clusters/hosts",
      "zones": [
        "1"
      ],
      "sku": {
        "name": "av64"
      },
      "properties": {
        "kind": "General",
        "displayName": "esx03-r60.1111111111111111111.westcentralus.prod.azure.com",
        "moRefId": "host-128",
        "maintenance": "Replacement"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/clusters/cluster1/hosts/esx03-r65.1111111111111111111.westcentralus.prod.azure.com",
      "name": "esx03-r65.1111111111111111111.westcentralus.prod.azure.com",
      "type": "Microsoft.AVS/privateClouds/clusters/hosts",
      "zones": [
        "1"
      ],
      "properties": {
        "kind": "Specialized"
      }
    }
  ]
}

Definíciók

Name	Description
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
Host	Gazdagép erőforrás
HostKind	A házigazda fajtája.
HostListResult	A gazdagéplista művelet válasza.
HostMaintenance	A gazdagép karbantartásának oka.
HostProvisioningState	A gazdagép kiépítési állapota
Sku	A termékváltozatot képviselő erőforrásmodell-definíció
SkuTier	Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

createdByType

Enumerálás

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

Érték	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

Host

Objektum

Gazdagép erőforrás

Name	Típus	Description
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}"
name	string	Az erőforrás neve
properties.displayName	string	A gazdagép megjelenítendő neve a VMware vCenterben.
properties.faultDomain	string
properties.fqdn	string minLength: 1 maxLength: 255	A gazdagép teljesen minősített domain neve.
properties.kind	HostKind	A házigazda fajtája
properties.maintenance	HostMaintenance	Ha meg van adva, a gazdagép karbantartás alatt áll. Az érték a karbantartás oka.
properties.moRefId	string	vCenter felügyelt objektum hivatkozási azonosítója a gazdagépnek.
properties.provisioningState	HostProvisioningState	A gazdagép kiépítésének állapota.
sku	Sku	Az erőforráshoz rendelt termékváltozat (készletmegőrzési egység).
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"
zones	string[]	A rendelkezésre állási zónák.

HostKind

Enumerálás

A házigazda fajtája.

Érték	Description
General
Specialized

HostListResult

Objektum

A gazdagéplista művelet válasza.

Name	Típus	Description
nextLink	string (uri)	Az elemek következő oldalára mutató hivatkozás
value	Host[]	A gazdagép elemei ezen az oldalon

HostMaintenance

Enumerálás

A gazdagép karbantartásának oka.

Érték	Description
Replacement	A gazdagép helyettesítő gazdagép.
Upgrade	A gazdagép frissítésre szolgál, például ESXi, NSX-T vagy más összetevőre való frissítésre.

HostProvisioningState

Enumerálás

A gazdagép kiépítési állapota

Érték	Description
Canceled	Az erőforrás létrehozása megszakadt.
Failed	Az erőforrás létrehozása nem sikerült.
Succeeded	Az erőforrás létrejött.

Sku

Objektum

A termékváltozatot képviselő erőforrásmodell-definíció

Name	Típus	Description
capacity	integer (int32)	Ha az SKU támogatja a vertikális felskálázást/azt, akkor a kapacitás egészét is tartalmaznia kell. Ha az erőforrás esetében nem lehetséges a vertikális felskálázás/beskálázás, akkor ez kihagyható.
family	string	Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti.
name	string	Az termékváltozat neve. Pl. P3. Ez általában egy betű+szám kód
size	string	A termékváltozat mérete. Ha a névmező a réteg és más értékek kombinációja, akkor ez a különálló kód.
tier	SkuTier	Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges.

SkuTier

Enumerálás

Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges.

Érték	Description
Basic
Free
Premium
Standard

systemData

Objektum

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

Name	Típus	Description
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.

Megosztás a következőn keresztül:

Hosts - List

URI-paraméterek

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Hosts_List

Mintakérelem

Mintaválasz

Definíciók

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Host

HostKind

HostListResult

HostMaintenance

HostProvisioningState

Sku

SkuTier

systemData