Load Balancers - Create Or Update

Szolgáltatás:

AKS

API-verzió:

2025-04-02-preview

Létrehoz vagy frissít egy terheléselosztót a megadott felügyelt fürtben.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/loadBalancers/{loadBalancerName}?api-version=2025-04-02-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
loadBalancerName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	A terheléselosztó 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.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	A felügyelt fürterőforrás neve.
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ó.

Kérelem törzse

Name	Kötelező	Típus	Description
properties.primaryAgentPoolName	True	string	Kötelező mező. Egy sztringérték, amely meg kell adnia egy meglévő ügynökkészlet azonosítóját. Az adott készlet összes csomópontja mindig hozzá lesz adva ehhez a terheléselosztóhoz. Ennek az ügynökkészletnek legalább egy csomópontot és minCount>=1-et kell tartalmaznia az automatikus skálázási műveletekhez. Egy ügynökkészlet csak egyetlen terheléselosztó elsődleges készlete lehet.
properties.allowServicePlacement		boolean	A szolgáltatások automatikus elhelyezése a terheléselosztón. Ha nincs megadva, az alapértelmezett érték igaz. Ha manuálisan false (hamis) értékre van állítva, a külső és a belső terheléselosztó sem lesz kiválasztva a szolgáltatásokhoz, hacsak nem kifejezetten célba veszi azt.
properties.nodeSelector		LabelSelector	A kijelölőnek megfelelő csomópontok a terheléselosztó lehetséges tagjai lesznek.
properties.serviceLabelSelector		LabelSelector	Ezen a terheléselosztón csak a választónak megfelelő szolgáltatások helyezhetők el.
properties.serviceNamespaceSelector		LabelSelector	A választóval egyező névterekben létrehozott szolgáltatások ezen a terheléselosztón helyezhetők el.

Válaszok

Name	Típus	Description
200 OK	LoadBalancer	A meglévő terheléselosztó frissítése sikeresen megtörtént
201 Created	LoadBalancer	Az új terheléselosztó létrehozása sikeresen megtörtént
Other Status Codes	CloudError	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

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

Create or update a Load Balancer

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/loadBalancers/kubernetes?api-version=2025-04-02-preview

{
  "properties": {
    "primaryAgentPoolName": "agentpool1",
    "allowServicePlacement": true
  }
}

Mintaválasz

Állapotkód:

200

{
  "name": "kubernetes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/loadBalancers/kubernetes",
  "properties": {
    "primaryAgentPoolName": "agentPool1",
    "allowServicePlacement": true,
    "provisioningState": "Succeeded"
  }
}

Állapotkód:

201

{
  "name": "kubernetes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/loadBalancers/kubernetes",
  "properties": {
    "primaryAgentPoolName": "agentPool1",
    "allowServicePlacement": true,
    "provisioningState": "Succeeded"
  }
}

Definíciók

Name	Description
CloudError	Hibaválasz a Container service-től.
CloudErrorBody	Hibaválasz a Container service-től.
createdByType	Az erőforrást létrehozó identitás típusa.
LabelSelector	A címkeválasztók egy erőforráskészleten keresztüli címke-lekérdezések. A matchLabels és a matchExpressions eredménye ANDed. Az üres címkeválasztó az összes objektumnak megfelel. A nullcímke-választó nem felel meg objektumoknak.
LabelSelectorRequirement	A címkeválasztó követelmény egy olyan választó, amely értékeket, kulcsot és a kulcsot és értékeket összekapcsoló operátort tartalmaz.
LoadBalancer	Több standard terheléselosztó konfigurációi. Ha nincs megadva, a rendszer egyetlen terheléselosztó módot használ. Több standard terheléselosztó mód is használható, ha bérletkor egy konfigurációt ad meg. Egy kubernetesnevű konfigurációnak kell lennie. A név mező a megfelelő nyilvános terheléselosztó neve lesz. Szükség esetén létrejön egy belső terheléselosztó, és a név a következő lesz <name>-internal: . A belső terheléselosztó ugyanazokat a konfigurációkat használja, mint a külső. A belső lbs-eket nem kell szerepeltetni a LoadBalancer-listában.
operator	operátor egy kulcs egy értékkészlethez való viszonyát jelöli. Az érvényes operátorok be- és be vannak adva
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

CloudError

Objektum

Hibaválasz a Container service-től.

Name	Típus	Description
error	CloudErrorBody	A hibával kapcsolatos részletek.

CloudErrorBody

Objektum

Hibaválasz a Container service-től.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details	CloudErrorBody[]	A hiba további részleteinek listája.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target	string	Az adott hiba célja. Például a tulajdonság neve hibás.

createdByType

Enumerálás

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

Érték	Description
Application
Key
ManagedIdentity
User

LabelSelector

Objektum

A címkeválasztók egy erőforráskészleten keresztüli címke-lekérdezések. A matchLabels és a matchExpressions eredménye ANDed. Az üres címkeválasztó az összes objektumnak megfelel. A nullcímke-választó nem felel meg objektumoknak.

Name	Típus	Description
matchExpressions	LabelSelectorRequirement[]	A matchExpressions a címkeválasztó követelmények listája. A követelmények ANDedek.
matchLabels	string[]	a matchLabels {key=value} párok tömbje. A matchLabels-megfeleltetés egyetlen {key=value} eleme megegyezik a matchExpressions elemével, amelynek kulcsmezője keyaz operátor In, és az értéktömb csak valuea függvényt tartalmazza. A követelmények ANDedek.

LabelSelectorRequirement

Objektum

A címkeválasztó követelmény egy olyan választó, amely értékeket, kulcsot és a kulcsot és értékeket összekapcsoló operátort tartalmaz.

Name	Típus	Description
key	string	A kulcs az a címkekulcs, amelyre a választó vonatkozik.
operator	operator	operátor egy kulcs egy értékkészlethez való viszonyát jelöli. Az érvényes operátorok be- és be vannak adva
values	string[]	az értékek sztringértékek tömbje, az értéktömbnek nem üresnek kell lennie.

LoadBalancer

Objektum

Több standard terheléselosztó konfigurációi. Ha nincs megadva, a rendszer egyetlen terheléselosztó módot használ. Több standard terheléselosztó mód is használható, ha bérletkor egy konfigurációt ad meg. Egy kubernetesnevű konfigurációnak kell lennie. A név mező a megfelelő nyilvános terheléselosztó neve lesz. Szükség esetén létrejön egy belső terheléselosztó, és a név a következő lesz <name>-internal: . A belső terheléselosztó ugyanazokat a konfigurációkat használja, mint a külső. A belső lbs-eket nem kell szerepeltetni a LoadBalancer-listában.

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.allowServicePlacement	boolean	A szolgáltatások automatikus elhelyezése a terheléselosztón. Ha nincs megadva, az alapértelmezett érték igaz. Ha manuálisan false (hamis) értékre van állítva, a külső és a belső terheléselosztó sem lesz kiválasztva a szolgáltatásokhoz, hacsak nem kifejezetten célba veszi azt.
properties.nodeSelector	LabelSelector	A kijelölőnek megfelelő csomópontok a terheléselosztó lehetséges tagjai lesznek.
properties.primaryAgentPoolName	string	Kötelező mező. Egy sztringérték, amely meg kell adnia egy meglévő ügynökkészlet azonosítóját. Az adott készlet összes csomópontja mindig hozzá lesz adva ehhez a terheléselosztóhoz. Ennek az ügynökkészletnek legalább egy csomópontot és minCount>=1-et kell tartalmaznia az automatikus skálázási műveletekhez. Egy ügynökkészlet csak egyetlen terheléselosztó elsődleges készlete lehet.
properties.provisioningState	string	Az aktuális kiépítési állapot.
properties.serviceLabelSelector	LabelSelector	Ezen a terheléselosztón csak a választónak megfelelő szolgáltatások helyezhetők el.
properties.serviceNamespaceSelector	LabelSelector	A választóval egyező névterekben létrehozott szolgáltatások ezen a terheléselosztón helyezhetők el.
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"

operator

Enumerálás

operátor egy kulcs egy értékkészlethez való viszonyát jelöli. Az érvényes operátorok be- és be vannak adva

Érték	Description
DoesNotExist	A kulcs értéke nem létezhet.
Exists	A kulcs értékének léteznie kell.
In	A kulcs értékének szerepelnie kell az adott listában.
NotIn	A kulcs értéke nem szerepelhet a megadott listában.

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.