Managed Clusters - Update Tags

Service:

AKS

API Version:

2022-04-01

Actualiza las etiquetas de un clúster administrado.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}?api-version=2022-04-01

Parámetros de identificador URI

Name	In	Required	Type	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
resourceName	path	True	string	Nombre del recurso de clúster administrado. Regex pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId	path	True	string	Identificador de la suscripción de destino.
api-version	query	True	string	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Name	Type	Description
tags	object	Etiquetas del recurso.

Respuestas

Name	Type	Description
200 OK	ManagedCluster	Aceptar
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Azure Active Directory Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Update Managed Cluster Tags

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2022-04-01

{
  "tags": {
    "tier": "testing",
    "archv3": ""
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.containerservice.models.TagsObject;
import java.util.HashMap;
import java.util.Map;

/** Samples for ManagedClusters UpdateTags. */
public final class Main {
    /*
     * x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-04-01/examples/ManagedClustersUpdateTags.json
     */
    /**
     * Sample code: Update Managed Cluster Tags.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateManagedClusterTags(com.azure.resourcemanager.AzureResourceManager azure) {
        azure
            .kubernetesClusters()
            .manager()
            .serviceClient()
            .getManagedClusters()
            .updateTags(
                "rg1", "clustername1", new TagsObject().withTags(mapOf("archv3", "", "tier", "testing")), Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Go

package armcontainerservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-04-01/examples/ManagedClustersUpdateTags.json
func ExampleManagedClustersClient_BeginUpdateTags() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armcontainerservice.NewManagedClustersClient("subid1", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := client.BeginUpdateTags(ctx,
		"rg1",
		"clustername1",
		armcontainerservice.TagsObject{
			Tags: map[string]*string{
				"archv3": to.Ptr(""),
				"tier":   to.Ptr("testing"),
			},
		},
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// TODO: use response item
	_ = res
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

JavaScript

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates tags on a managed cluster.
 *
 * @summary Updates tags on a managed cluster.
 * x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-04-01/examples/ManagedClustersUpdateTags.json
 */
async function updateManagedClusterTags() {
  const subscriptionId = "subid1";
  const resourceGroupName = "rg1";
  const resourceName = "clustername1";
  const parameters = { tags: { archv3: "", tier: "testing" } };
  const credential = new DefaultAzureCredential();
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.managedClusters.beginUpdateTagsAndWait(
    resourceGroupName,
    resourceName,
    parameters
  );
  console.log(result);
}

updateManagedClusterTags().catch(console.error);

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:

200

{
  "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv3": "",
    "tier": "testing"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": false,
    "diskEncryptionSetID": "/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "dockerBridgeCidr": "172.17.0.1/16"
    }
  }
}

Definiciones

AgentPoolMode	Modo de un grupo de agentes.
AgentPoolType	Tipo de grupo de agentes.
AgentPoolUpgradeSettings	Configuración para actualizar un grupo de agentes
AutoScalerProfile	Parámetros que se van a aplicar al escalador automático del clúster cuando está habilitado
CloudError	Respuesta de error del servicio contenedor.
CloudErrorBody	Respuesta de error del servicio contenedor.
code	Indica si el clúster está en ejecución o detenido.
ContainerServiceLinuxProfile	Generación de perfiles para máquinas virtuales Linux en el clúster del servicio de contenedor.
ContainerServiceNetworkProfile	Perfil de configuración de red.
ContainerServiceSshConfiguration	Configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure.
ContainerServiceSshPublicKey	Contiene información sobre los datos de clave pública del certificado SSH.
createdByType	Tipo de identidad que creó el recurso.
CreationData	Datos usados al crear un recurso de destino a partir de un recurso de origen.
expander	El expansador que se va a usar al escalar verticalmente
ExtendedLocation	Tipo complejo de la ubicación extendida.
ExtendedLocationTypes	Tipo de la ubicación extendida.
GPUInstanceProfile	GPUInstanceProfile que se va a usar para especificar el perfil de instancia de MIG de GPU para la SKU de máquina virtual de GPU compatible.
Identity	Identidad del recurso.
KubeletConfig	Configuraciones de Kubelet de nodos de agente.
KubeletDiskType	Determina la ubicación de volúmenes emptyDir, raíz de datos en tiempo de ejecución del contenedor y almacenamiento efímero de Kubelet.
licenseType	Tipo de licencia que se va a usar para Windows máquinas virtuales. Para más información, consulte Ventajas de usuario híbrido de Azure .
LinuxOSConfig	Configuraciones del sistema operativo de los nodos del agente de Linux.
loadBalancerSku	SKU del equilibrador de carga para el clúster administrado.
ManagedCluster	Clúster administrado.
ManagedClusterAADProfile	AADProfile especifica atributos para Azure Active Directory integración.
ManagedClusterAddonProfile	Un perfil de complemento de Kubernetes para un clúster administrado.
ManagedClusterAgentPoolProfile	Perfil del grupo de agentes de servicio de contenedor.
ManagedClusterAPIServerAccessProfile	Perfil de acceso para el servidor de API de clúster administrado.
ManagedClusterAutoUpgradeProfile	Perfil de actualización automática para un clúster administrado.
ManagedClusterHTTPProxyConfig	Configuración del proxy HTTP del clúster.
ManagedClusterIdentity	Identidad del clúster administrado.
ManagedClusterLoadBalancerProfile	Perfil del equilibrador de carga del clúster administrado.
ManagedClusterManagedOutboundIPProfile	Perfil de los recursos ip de salida administrados del clúster administrado.
ManagedClusterNATGatewayProfile	Perfil de la puerta de enlace NAT del clúster administrado.
ManagedClusterPodIdentity	Detalles sobre la identidad del pod asignada al clúster administrado.
ManagedClusterPodIdentityException	Excepción de identidad de pod, que permite que los pods con determinadas etiquetas accedan al punto de conexión de Azure Instance Metadata Service (IMDS) sin que el servidor de identidad administrada por nodo (NMI) intercepte.
ManagedClusterPodIdentityProfile	Perfil de identidad de pod del clúster administrado.
ManagedClusterPodIdentityProvisioningError	Respuesta de error del aprovisionamiento de identidades de pod.
ManagedClusterPodIdentityProvisioningErrorBody	Respuesta de error del aprovisionamiento de identidades de pod.
ManagedClusterPodIdentityProvisioningState	Estado de aprovisionamiento actual de la identidad del pod.
ManagedClusterSecurityProfile	Perfil de seguridad para el clúster del servicio de contenedor.
ManagedClusterSecurityProfileAzureDefender	Configuración de Azure Defender para el perfil de seguridad.
ManagedClusterServicePrincipalProfile	Información sobre una identidad de entidad de servicio para el clúster que se usará para manipular las API de Azure.
ManagedClusterSKU	SKU de un clúster administrado.
ManagedClusterSKUName	Nombre de una SKU de clúster administrado.
ManagedClusterSKUTier	El nivel de una SKU de clúster administrado.
ManagedClusterStorageProfile	Storage perfil del clúster de servicio de contenedor.
ManagedClusterStorageProfileDiskCSIDriver	Configuración del controlador CSI de AzureDisk para el perfil de almacenamiento.
ManagedClusterStorageProfileFileCSIDriver	Configuración del controlador CSI de AzureFile para el perfil de almacenamiento.
ManagedClusterStorageProfileSnapshotController	Configuración del controlador de instantáneas para el perfil de almacenamiento.
ManagedClusterWindowsProfile	Perfil de Windows máquinas virtuales en el clúster administrado.
ManagedOutboundIPs	Direcciones IP de salida administradas deseadas para el equilibrador de carga del clúster.
networkMode	El modo de red con el que se configura Azure CNI.
NetworkPlugin	Complemento de red que se usa para compilar la red de Kubernetes.
NetworkPolicy	Directiva de red que se usa para compilar la red de Kubernetes.
OSDiskType	Tipo de disco del sistema operativo que se va a usar para las máquinas del grupo de agentes.
OSSKU	Especifica una SKU del sistema operativo. Este valor no se debe especificar si OSType está Windows.
OSType	Tipo de sistema operativo. El valor predeterminado es Linux.
OutboundIPPrefixes	Recursos de prefijo de IP de salida deseados para el equilibrador de carga del clúster.
OutboundIPs	Recursos ip de salida deseados para el equilibrador de carga del clúster.
outboundType	Método de enrutamiento de salida (salida).
PowerState	Describe el estado de energía del clúster.
PrivateLinkResource	Un recurso de vínculo privado
ProvisioningInfo
PublicNetworkAccess	PublicNetworkAccess de managedCluster
ResourceIdentityType	Tipo de identidad que se usa para el clúster administrado.
ResourceReference	Referencia a un recurso de Azure.
ScaleDownMode	Describe cómo se agregan o quitan las máquinas virtuales de los grupos de agentes. Consulte los estados de facturación.
ScaleSetEvictionPolicy	Directiva de expulsión del conjunto de escalado de máquinas virtuales.
ScaleSetPriority	Prioridad del conjunto de escalado de máquinas virtuales.
SysctlConfig	Configuración de Sysctl para nodos de agente de Linux.
systemData	Metadatos relacionados con la creación y la última modificación del recurso.
TagsObject	Objeto Tags para las operaciones de revisión.
upgradeChannel	Canal de actualización para la actualización automática. El valor predeterminado es "none".
UserAssignedIdentities	Identidad de usuario asociada al clúster administrado. Esta identidad se usará en el plano de control. Solo se permite una identidad asignada por el usuario.
UserAssignedIdentity	Detalles sobre una identidad asignada por el usuario.
WindowsGmsaProfile	Windows perfil de gMSA en el clúster administrado.
WorkloadRuntime	Determina el tipo de carga de trabajo que puede ejecutar un nodo.

AgentPoolMode

Modo de un grupo de agentes.

Name	Type	Description
System	string	Los grupos de agentes del sistema son principalmente para hospedar pods críticos del sistema, como CoreDNS y metrics-server. Los grupos de agentes del sistema osType deben ser Linux. La SKU de máquina virtual de grupos de agentes del sistema debe tener al menos 2 vCPU y 4 GB de memoria.
User	string	Los grupos de agentes de usuario son principalmente para hospedar los pods de la aplicación.

AgentPoolType

Tipo de grupo de agentes.

Name	Type	Description
AvailabilitySet	string	Se desaconseja encarecidamente el uso de esto.
VirtualMachineScaleSets	string	Cree un grupo de agentes respaldado por un conjunto de escalado de máquinas virtuales.

AgentPoolUpgradeSettings

Configuración para actualizar un grupo de agentes

Name	Type	Description
maxSurge	string	Número máximo o porcentaje de nodos que se sobrecargan durante la actualización. Esto puede establecerse en un entero (por ejemplo, "5") o en un porcentaje (por ejemplo, "50%"). Si se especifica un porcentaje, es el porcentaje del tamaño total del grupo de agentes en el momento de la actualización. En porcentajes, los nodos fraccionarios se redondean hacia arriba. Si no se especifica, el valor predeterminado es 1. Para obtener más información, incluidos los procedimientos recomendados, consulte: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade

AutoScalerProfile

Parámetros que se van a aplicar al escalador automático del clúster cuando está habilitado

Name	Type	Description
balance-similar-node-groups	string	Detecta grupos de nodos similares y equilibra el número de nodos entre ellos. Los valores válidos son "true" y "false"
expander	expander	El expansador que se va a usar al escalar verticalmente Si no se especifica, el valor predeterminado es "random". Para obtener más información, vea Expansores .
max-empty-bulk-delete	string	Número máximo de nodos vacíos que se pueden eliminar al mismo tiempo. Debe ser un entero positivo. El valor predeterminado es 10.
max-graceful-termination-sec	string	El número máximo de segundos que espera el escalador automático del clúster para la finalización del pod al intentar reducir verticalmente un nodo. El valor predeterminado es 600.
max-node-provision-time	string	El tiempo máximo que espera el escalador automático a que se aprovisione un nodo. El valor predeterminado es "15m". Los valores deben ser un entero seguido de "m". No se admite ninguna unidad de tiempo distinta de minutos (m).
max-total-unready-percentage	string	Porcentaje máximo de nodos no leídos en el clúster. Una vez superado este porcentaje, el escalador automático de clúster detiene las operaciones. El valor predeterminado es 45. El máximo es 100 y el mínimo es 0.
new-pod-scale-up-delay	string	Omita los pods no programados antes de que sean de cierta edad. En escenarios como la escala de ráfagas y lotes en los que no quiere que la CA actúe antes de que el programador de Kubernetes programe todos los pods, puede indicarle a la CA que ignore los pods no programados antes de que tengan una antigüedad concreta. El valor predeterminado es "0s". Los valores deben ser un entero seguido de una unidad ('s' durante segundos, 'm' para minutos, 'h' para horas, etc.).
ok-total-unready-count	string	Número de nodos no leídos permitidos, independientemente de max-total-unready-percentage. Debe ser un entero. El valor predeterminado es 3.
scale-down-delay-after-add	string	Cuánto tiempo después del escalado vertical se reanuda la evaluación de la reducción horizontal El valor predeterminado es "10m". Los valores deben ser un entero seguido de "m". No se admite ninguna unidad de tiempo distinta de minutos (m).
scale-down-delay-after-delete	string	Cuánto tiempo después de la eliminación del nodo se reanuda la evaluación de la reducción horizontal. El valor predeterminado es el intervalo de examen. Los valores deben ser un entero seguido de "m". No se admite ninguna unidad de tiempo distinta de minutos (m).
scale-down-delay-after-failure	string	Cuánto tiempo después de la reducción vertical se reanuda la evaluación de la reducción horizontal. El valor predeterminado es "3m". Los valores deben ser un entero seguido de "m". No se admite ninguna unidad de tiempo distinta de minutos (m).
scale-down-unneeded-time	string	Cuánto tiempo debe ser innecesario un nodo antes de que sea apto para la reducción vertical. El valor predeterminado es "10m". Los valores deben ser un entero seguido de "m". No se admite ninguna unidad de tiempo distinta de minutos (m).
scale-down-unready-time	string	Cuánto tiempo debe ser innecesario un nodo no listo antes de que sea válido para la reducción vertical El valor predeterminado es "20m". Los valores deben ser un entero seguido de "m". No se admite ninguna unidad de tiempo distinta de minutos (m).
scale-down-utilization-threshold	string	Nivel de uso del nodo, definido como la suma de los recursos solicitados dividida por la capacidad, por debajo del cual se puede considerar un nodo para la reducción vertical. El valor predeterminado es "0,5".
scan-interval	string	Frecuencia con la que se vuelve a evaluar el clúster para escalar o reducir verticalmente. El valor predeterminado es "10". Los valores deben ser un número entero de segundos.
skip-nodes-with-local-storage	string	Si el escalador automático de clúster omitirá la eliminación de nodos con pods con almacenamiento local, por ejemplo, EmptyDir o HostPath. El valor predeterminado es true.
skip-nodes-with-system-pods	string	Si el escalador automático de clúster omitirá la eliminación de nodos con pods de kube-system (excepto DaemonSet o pods reflejados). El valor predeterminado es true.

CloudError

Respuesta de error del servicio contenedor.

Name	Type	Description
error	CloudErrorBody	Detalles sobre el error.

CloudErrorBody

Respuesta de error del servicio contenedor.

Name	Type	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	CloudErrorBody[]	Lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

code

Indica si el clúster está en ejecución o detenido.

Name	Type	Description
Running	string	El clúster se está ejecutando.
Stopped	string	El clúster se detiene.

ContainerServiceLinuxProfile

Generación de perfiles para máquinas virtuales Linux en el clúster del servicio de contenedor.

Name	Type	Description
adminUsername	string	Nombre de usuario del administrador que se va a usar para máquinas virtuales Linux.
ssh	ContainerServiceSshConfiguration	La configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure.

ContainerServiceNetworkProfile

Perfil de configuración de red.

Name	Type	Default Value	Description
dnsServiceIP	string	10.0.0.10	Dirección IP asignada al servicio DNS de Kubernetes. Debe estar dentro del intervalo de direcciones del servicio kubernetes especificado en serviceCidr.
dockerBridgeCidr	string	172.17.0.1/16	Intervalo IP de notación CIDR asignado a la red del puente de Docker. No se debe superponer con los intervalos IP de subred ni con el intervalo de direcciones del servicio Kubernetes.
ipFamilies	string[]		Las familias de direcciones IP usadas para especificar las versiones de IP disponibles para el clúster. Las familias de DIRECCIONES IP se usan para determinar clústeres de pila única o de doble pila. Para una sola pila, el valor esperado es IPv4. En el caso de la pila doble, los valores esperados son IPv4 e IPv6.
loadBalancerProfile	ManagedClusterLoadBalancerProfile		Perfil del equilibrador de carga del clúster.
loadBalancerSku	loadBalancerSku		SKU del equilibrador de carga para el clúster administrado. El valor predeterminado es "estándar". Consulte Azure Load Balancer SKU para obtener más información sobre las diferencias entre las SKU del equilibrador de carga.
natGatewayProfile	ManagedClusterNATGatewayProfile		Perfil de la puerta de enlace NAT del clúster.
networkMode	networkMode		El modo de red con el que se configura Azure CNI. No se puede especificar si networkPlugin es distinto de "azure".
networkPlugin	NetworkPlugin	kubenet	Complemento de red que se usa para compilar la red de Kubernetes.
networkPolicy	NetworkPolicy		Directiva de red que se usa para compilar la red de Kubernetes.
outboundType	outboundType	loadBalancer	Método de enrutamiento de salida (salida). Esto solo se puede establecer en el momento de creación del clúster y no se puede cambiar más adelante. Para obtener más información, vea Tipo de salida de salida.
podCidr	string	10.244.0.0/16	Intervalo IP en notación CIDR desde el que se van a asignar las direcciones IP de los pods cuando se utilice kubenet.
podCidrs	string[]		Intervalos IP de notación CIDR desde los que se van a asignar direcciones IP de pod. Se espera un CIDR IPv4 para las redes de pila única. Se esperan dos CIDR, uno para cada familia ip (IPv4/IPv6) para las redes de pila doble.
serviceCidr	string	10.0.0.0/16	Intervalo IP en notación CIDR desde el que se van a asignar las direcciones IP del clúster de servicio. No debe superponerse con ningún intervalo de IP de subred.
serviceCidrs	string[]		Los intervalos IP de notación CIDR desde los que se van a asignar direcciones IP del clúster de servicio. Se espera un CIDR IPv4 para las redes de pila única. Se esperan dos CIDR, uno para cada familia ip (IPv4/IPv6) para las redes de pila doble. No deben superponerse con ningún intervalo IP de subred.

ContainerServiceSshConfiguration

Configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure.

Name	Type	Description
publicKeys	ContainerServiceSshPublicKey[]	Lista de claves públicas SSH usadas para autenticarse con máquinas virtuales basadas en Linux. Se puede especificar un máximo de 1 clave.

ContainerServiceSshPublicKey

Contiene información sobre los datos de clave pública del certificado SSH.

Name	Type	Description
keyData	string	Clave pública de certificado que se usa para autenticarse con máquinas virtuales a través de SSH. El certificado debe estar en formato PEM con o sin encabezados.

createdByType

Tipo de identidad que creó el recurso.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreationData

Datos usados al crear un recurso de destino a partir de un recurso de origen.

Name	Type	Description
sourceResourceId	string	Este es el identificador de ARM del objeto de origen que se va a usar para crear el objeto de destino.

expander

El expansador que se va a usar al escalar verticalmente

Name	Type	Description
least-waste	string	Selecciona el grupo de nodos que tendrá la CPU menos inactiva (si está vinculada, memoria sin usar) después del escalado vertical. Esto resulta útil cuando tiene diferentes clases de nodos, por ejemplo, nodos de CPU elevados o de memoria alta, y solo quiere expandirlos cuando haya pods pendientes que necesiten muchos de esos recursos.
most-pods	string	Selecciona el grupo de nodos que podría programar la mayoría de los pods al escalar verticalmente. Esto resulta útil cuando se usa nodeSelector para asegurarse de que determinados pods llegan a determinados nodos. Tenga en cuenta que esto no hará que el escalador automático seleccione nodos más grandes frente a más pequeños, ya que puede agregar varios nodos más pequeños a la vez.
priority	string	Selecciona el grupo de nodos que tiene la prioridad más alta asignada por el usuario. Esta es la configuración que se describe en más detalles aquí.
random	string	Se usa cuando no tiene una necesidad determinada de que los grupos de nodos se escalen de forma diferente.

ExtendedLocation

Tipo complejo de la ubicación extendida.

Name	Type	Description
name	string	Nombre de la ubicación extendida.
type	ExtendedLocationTypes	Tipo de la ubicación extendida.

ExtendedLocationTypes

Tipo de la ubicación extendida.

Name	Type	Description
EdgeZone	string

GPUInstanceProfile

GPUInstanceProfile que se va a usar para especificar el perfil de instancia de MIG de GPU para la SKU de máquina virtual de GPU compatible.

Name	Type	Description
MIG1g	string
MIG2g	string
MIG3g	string
MIG4g	string
MIG7g	string

Identity

Identidad del recurso.

Name	Type	Description
principalId	string	Identificador de entidad de seguridad de la identidad de recurso.
tenantId	string	Identificador de inquilino del recurso.
type	ResourceIdentityType	Tipo de identidad.

KubeletConfig

Configuraciones de Kubelet de nodos de agente.

Name	Type	Description
allowedUnsafeSysctls	string[]	Lista permitida de sysctls no seguros o patrones sysctl no seguros (que terminan en *).
containerLogMaxFiles	integer	El número máximo de archivos de registro de contenedor que pueden estar presentes para un contenedor. El número debe ser ≥ 2.
containerLogMaxSizeMB	integer	Tamaño máximo (por ejemplo, 10Mi) del archivo de registro de contenedor antes de girarlo.
cpuCfsQuota	boolean	Si el cumplimiento de cuota de CFS de CPU está habilitado para contenedores que especifican límites de CPU. El valor predeterminado es true.
cpuCfsQuotaPeriod	string	Valor del período de cuota cfS de CPU. El valor predeterminado es "100 ms". Los valores válidos son una secuencia de números decimales con una fracción opcional y un sufijo de unidad. Por ejemplo: "300 ms", "2h45m". Las unidades admitidas son "ns", "us", "ms", "s", "m" y "h".
cpuManagerPolicy	string	Directiva del Administrador de CPU que se va a usar. El valor predeterminado es "none". Consulte Directivas de administración de CPU de Kubernetes para más información. Los valores permitidos son "none" y "static".
failSwapOn	boolean	Si se establece en true, se producirá un error al iniciar Kubelet si el intercambio está habilitado en el nodo.
imageGcHighThreshold	integer	Porcentaje de uso del disco después del cual siempre se ejecuta la recolección de elementos no utilizados de la imagen. Para deshabilitar la recolección de elementos no utilizados de la imagen, establezca este valor en 100. El valor predeterminado es el 85 %
imageGcLowThreshold	integer	Porcentaje de uso del disco antes del cual la recolección de elementos no utilizados de la imagen nunca se ejecuta. Esto no se puede establecer más alto que imageGcHighThreshold. El valor predeterminado es el 80 %
podMaxPids	integer	Número máximo de procesos por pod.
topologyManagerPolicy	string	Directiva del Administrador de topologías que se va a usar. Para más información, consulte Administrador de topologías de Kubernetes. El valor predeterminado es "none". Los valores permitidos son "none", "best-effort", "restricted" y "single-numa-node".

KubeletDiskType

Determina la ubicación de volúmenes emptyDir, raíz de datos en tiempo de ejecución del contenedor y almacenamiento efímero de Kubelet.

Name	Type	Description
OS	string	Kubelet usará el disco del sistema operativo para sus datos.
Temporary	string	Kubelet usará el disco temporal para sus datos.

licenseType

Tipo de licencia que se va a usar para Windows máquinas virtuales. Para más información, consulte Ventajas de usuario híbrido de Azure .

Name	Type	Description
None	string	No se aplica ninguna licencia adicional.
Windows_Server	string	Habilita las ventajas del usuario híbrido de Azure para las máquinas virtuales de Windows.

LinuxOSConfig

Configuraciones del sistema operativo de los nodos del agente de Linux.

Name	Type	Description
swapFileSizeMB	integer	Tamaño en MB de un archivo de intercambio que se creará en cada nodo.
sysctls	SysctlConfig	Configuración de Sysctl para nodos de agente de Linux.
transparentHugePageDefrag	string	Si el kernel debe hacer un uso agresivo de la compactación de memoria para que estén disponibles más páginas enormes. Los valores válidos son "always", "defer", "defer+madvise", "madvise" y "never". El valor predeterminado es "madvise". Para obtener más información, vea Transparent Hugepages.
transparentHugePageEnabled	string	Si están habilitadas las enormes transparentes. Los valores válidos son "always", "madvise" y "never". El valor predeterminado es "always". Para obtener más información, vea Transparent Hugepages.

loadBalancerSku

SKU del equilibrador de carga para el clúster administrado.

Name	Type	Description
basic	string	Use un Load Balancer básico con funcionalidad limitada.
standard	string	Use un Load Balancer estándar. Se trata de la SKU de Load Balancer recomendada. Para más información sobre cómo trabajar con el equilibrador de carga en el clúster administrado, consulte el artículo estándar Load Balancer.

ManagedCluster

Clúster administrado.

Name	Type	Description
extendedLocation	ExtendedLocation	Ubicación extendida de la máquina virtual.
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedClusterIdentity	Identidad del clúster administrado, si está configurada.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso.
properties.aadProfile	ManagedClusterAADProfile	AADProfile especifica atributos para la integración de Azure Active Directory. Configuración de Azure Active Directory.
properties.addonProfiles	<string,  ManagedClusterAddonProfile>	Perfil del complemento de clúster administrado.
properties.agentPoolProfiles	ManagedClusterAgentPoolProfile[]	Propiedades del grupo de agentes.
properties.apiServerAccessProfile	ManagedClusterAPIServerAccessProfile	Perfil de acceso para el servidor de API de clúster administrado.
properties.autoScalerProfile	AutoScalerProfile	Parámetros que se van a aplicar al escalador automático del clúster cuando está habilitado
properties.autoUpgradeProfile	ManagedClusterAutoUpgradeProfile	Configuración de actualización automática.
properties.azurePortalFQDN	string	FQDN especial que usa Azure Portal para acceder al clúster administrado. Este FQDN solo lo usa Azure Portal y otros clientes no deben usar este FQDN. Azure Portal requiere que determinados encabezados de uso compartido de recursos entre orígenes (CORS) se envíen en algunas respuestas, que Kubernetes APIServer no controla de forma predeterminada. Este FQDN especial admite CORS, lo que permite que Azure Portal funcione correctamente.
properties.currentKubernetesVersion	string	Versión de Kubernetes que se está ejecutando el clúster administrado. Si kubernetesVersion era una versión <totalmente especificada major.minor.patch>, este campo será exactamente igual a él. Si kubernetesVersion era <major.minor>, este campo contendrá la versión principal.secundaria.patch> completa <que se va a usar.
properties.disableLocalAccounts	boolean	Si las cuentas locales deben deshabilitarse en el clúster administrado. Si se establece en true, la obtención de credenciales estáticas se deshabilitará para este clúster. Solo se debe usar en clústeres administrados habilitados para AAD. Para obtener más información, consulte Deshabilitar cuentas locales.
properties.diskEncryptionSetID	string	Identificador de recurso del cifrado de disco que se va a usar para habilitar el cifrado en reposo. Este es el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}'
properties.dnsPrefix	string	Prefijo DNS del clúster administrado. No se puede actualizar una vez creado el clúster administrado.
properties.enablePodSecurityPolicy	boolean	(EN DESUSO) Si se va a habilitar la directiva de seguridad de pods de Kubernetes (versión preliminar). Esta característica se establece para su eliminación el 15 de octubre de 2020. Obtenga más información en aka.ms/aks/azpodpolicy.
properties.enableRBAC	boolean	Si se va a habilitar el Role-Based Access Control de Kubernetes.
properties.fqdn	string	FQDN del grupo maestro.
properties.fqdnSubdomain	string	Subdominio FQDN del clúster privado con zona dns privada personalizada. No se puede actualizar una vez creado el clúster administrado.
properties.httpProxyConfig	ManagedClusterHTTPProxyConfig	Configuraciones para aprovisionar el clúster con servidores proxy HTTP.
properties.identityProfile	<string,  UserAssignedIdentity>	Identidades asociadas al clúster.
properties.kubernetesVersion	string	Versión de Kubernetes especificada por el usuario. Se admiten ambas versiones <de revisión major.minor.patch> (por ejemplo, 1.20.13) y <major.minor> (por ejemplo, 1.20). Cuando <se especifica major.minor> , la versión de revisión de disponibilidad general admitida más reciente se elige automáticamente. La actualización del clúster con el mismo <major.minor> una vez que se haya creado (por ejemplo, 1.14.x -> 1.14) no desencadenará una actualización, incluso si hay disponible una versión de revisión más reciente. Cuando se actualiza un clúster de AKS compatible, no pueden omitirse las versiones secundarias de Kubernetes. Todas las actualizaciones deben realizarse secuencialmente con arreglo al número de versión principal. Por ejemplo, se permiten actualizaciones entre 1.14.x -> 1.15.x o 1.15.x -> 1.16.x, pero no se permite 1.14.x -> 1.16.x. Consulte Actualización de un clúster de AKS para obtener más detalles.
properties.linuxProfile	ContainerServiceLinuxProfile	El perfil de las máquinas virtuales Linux en el clúster administrado.
properties.maxAgentPools	integer	Número máximo de grupos de agentes para el clúster administrado.
properties.networkProfile	ContainerServiceNetworkProfile	Perfil de configuración de red.
properties.nodeResourceGroup	string	Nombre del grupo de recursos que contiene nodos del grupo de agentes.
properties.podIdentityProfile	ManagedClusterPodIdentityProfile	Perfil de identidad de pod del clúster administrado. Consulte Uso de la identidad de pod de AAD para obtener más información sobre la integración de la identidad del pod de AAD.
properties.powerState	PowerState	Estado de energía del clúster.
properties.privateFQDN	string	FQDN del clúster privado.
properties.privateLinkResources	PrivateLinkResource[]	Recursos de Vínculo privado asociados al clúster.
properties.provisioningState	string	Estado de aprovisionamiento actual.
properties.publicNetworkAccess	PublicNetworkAccess	PublicNetworkAccess de managedCluster Permitir o denegar el acceso a la red pública para AKS
properties.securityProfile	ManagedClusterSecurityProfile	Perfil de seguridad para el clúster administrado.
properties.servicePrincipalProfile	ManagedClusterServicePrincipalProfile	Información sobre una identidad de entidad de servicio para el clúster que se va a usar para manipular las API de Azure.
properties.storageProfile	ManagedClusterStorageProfile	Storage perfil del clúster administrado.
properties.windowsProfile	ManagedClusterWindowsProfile	Perfil de Windows máquinas virtuales en el clúster administrado.
sku	ManagedClusterSKU	SKU del clúster administrado.
systemData	systemData	Los metadatos de Azure Resource Manager que contienen información de createdBy y modifiedBy.
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft. Storage/storageAccounts"

ManagedClusterAADProfile

AADProfile especifica atributos para Azure Active Directory integración.

Name	Type	Description
adminGroupObjectIDs	string[]	Lista de identificadores de objeto de grupo de AAD que tendrán el rol de administrador del clúster.
clientAppID	string	Identificador de aplicación de AAD cliente.
enableAzureRBAC	boolean	Indica si se va a habilitar RBAC de Azure para la autorización de Kubernetes.
managed	boolean	Indica si se va a habilitar AAD administrado.
serverAppID	string	Identificador de aplicación de AAD del servidor.
serverAppSecret	string	Secreto de aplicación de AAD del servidor.
tenantID	string	Identificador de inquilino de AAD que se va a usar para la autenticación. Si no se especifica, usará el inquilino de la suscripción de implementación.

ManagedClusterAddonProfile

Un perfil de complemento de Kubernetes para un clúster administrado.

Name	Type	Description
config	object	Pares clave-valor para configurar un complemento.
enabled	boolean	Si el complemento está habilitado o no.
identity	Identity	Información de la identidad asignada por el usuario utilizada por este complemento.

ManagedClusterAgentPoolProfile

Perfil del grupo de agentes de servicio de contenedor.

Name	Type	Default Value	Description
availabilityZones	string[]		Lista de zonas de disponibilidad que se van a usar para los nodos. Esto solo se puede especificar si la propiedad AgentPoolType es "VirtualMachineScaleSets".
count	integer		Número de agentes (VM) para hospedar contenedores de Docker. Los valores permitidos deben estar comprendidos entre 0 y 1000 (ambos incluidos) para los grupos de usuarios y en el intervalo de 1 a 1000 (ambos incluidos) para los grupos del sistema. El valor predeterminado es 1.
creationData	CreationData		CreationData que se usará para especificar el identificador de instantánea de origen si el grupo de nodos se creará o actualizará mediante una instantánea.
currentOrchestratorVersion	string		Versión de Kubernetes que se está ejecutando el grupo de agentes. Si orchestratorVersion es una versión <principal.secundaria.patch> totalmente especificada, este campo será exactamente igual a él. Si orchestratorVersion es <major.minor>, este campo contendrá la versión principal.secundaria.patch> completa <que se va a usar.
enableAutoScaling	boolean		Si se va a habilitar el escalador automático
enableEncryptionAtHost	boolean		Si se va a habilitar el cifrado del sistema operativo y la unidad de datos basados en host. Esto solo se admite en determinados tamaños de máquina virtual y en determinadas regiones de Azure. Para obtener más información, vea:https://docs.microsoft.com/azure/aks/enable-host-encryption
enableFIPS	boolean		Si se va a usar un sistema operativo habilitado para FIPS. Consulte Incorporación de un grupo de nodos habilitado para FIPS para obtener más detalles.
enableNodePublicIP	boolean		Si cada nodo tiene asignada su propia dirección IP pública. Algunos escenarios pueden requerir que los nodos de un grupo de nodos reciban sus propias direcciones IP públicas dedicadas. Un escenario común es para las cargas de trabajo de juegos, en las que se necesita una consola para tener una conexión directa a una máquina virtual en la nube para minimizar los saltos. Para obtener más información, consulte Asignación de una dirección IP pública por nodo. El valor predeterminado es false.
enableUltraSSD	boolean		Si se va a habilitar UltraSSD
gpuInstanceProfile	GPUInstanceProfile		GPUInstanceProfile que se va a usar para especificar el perfil de instancia de MIG de GPU para la SKU de máquina virtual de GPU compatible.
kubeletConfig	KubeletConfig		Configuraciones de Kubelet de nodos de agente. Configuración de Kubelet en los nodos del grupo de agentes.
kubeletDiskType	KubeletDiskType		Determina la ubicación de volúmenes emptyDir, raíz de datos del entorno de ejecución del contenedor y almacenamiento efímero de Kubelet.
linuxOSConfig	LinuxOSConfig		Configuraciones del sistema operativo de los nodos del agente de Linux. Configuración del sistema operativo de los nodos del agente de Linux.
maxCount	integer		Número máximo de nodos para el escalado automático
maxPods	integer		Número máximo de pods que se pueden ejecutar en un nodo.
minCount	integer		Número mínimo de nodos para el escalado automático
mode	AgentPoolMode		Modo de un grupo de agentes. Un clúster debe tener al menos un grupo de agentes de "sistema" en todo momento. Para más información sobre las restricciones del grupo de agentes y los procedimientos recomendados, consulte: https://docs.microsoft.com/azure/aks/use-system-pools
name	string		Nombre único del perfil del grupo de agentes en el contexto de la suscripción y el grupo de recursos. Windows nombres de grupo de agentes deben tener 6 caracteres o menos.
nodeImageVersion	string		La versión de la imagen de nodo
nodeLabels	object		Las etiquetas de nodo que se conservarán en todos los nodos del grupo de agentes.
nodePublicIPPrefixID	string		Identificador de prefijo de IP pública desde el que los nodos de máquina virtual deben usar direcciones IP. Este es el formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodeTaints	string[]		Los valores taint agregados a nuevos nodos durante la creación y escala del grupo de nodos. Por ejemplo, key=value:NoSchedule.
orchestratorVersion	string		Versión de Kubernetes especificada por el usuario. Se admiten ambas versiones <de revisión major.minor.patch> (por ejemplo, 1.20.13) y <major.minor> (por ejemplo, 1.20). Cuando <se especifica major.minor> , la versión de revisión de disponibilidad general admitida más reciente se elige automáticamente. La actualización del clúster con el mismo <major.minor> una vez que se haya creado (por ejemplo, 1.14.x -> 1.14) no desencadenará una actualización, incluso si hay disponible una versión de revisión más reciente. Se recomienda que actualice todos los grupos de nodos de un clúster de AKS a la misma versión de Kubernetes. La versión del grupo de nodos debe tener la misma versión principal que el plano de control. La versión del grupo de nodos secundaria debe estar dentro de dos versiones secundarias de la versión del plano de control. La versión del grupo de nodos no puede ser mayor que la versión del plano de control. Para más información, consulte Actualización de un grupo de nodos.
osDiskSizeGB	integer		Tamaño del disco del sistema operativo en GB que se va a usar para especificar el tamaño del disco para cada máquina del grupo de maestros y agentes. Si especifica 0, aplicará el tamaño predeterminado de osDisk según el valor de vmSize especificado.
osDiskType	OSDiskType		Tipo de disco del sistema operativo que se va a usar para las máquinas del grupo de agentes. El valor predeterminado es "Efímero" si la máquina virtual la admite y tiene un disco de caché mayor que el OSDiskSizeGB solicitado. De lo contrario, el valor predeterminado es "Administrado". Es posible que no se cambie después de la creación. Para obtener más información, consulte So efímero.
osSKU	OSSKU		Especifica una SKU del sistema operativo. Este valor no se debe especificar si OSType está Windows.
osType	OSType	Linux	Tipo de sistema operativo. El valor predeterminado es Linux.
podSubnetID	string		Identificador de la subred a la que se unirán los pods cuando se inicie. Si se omite, las direcciones IP de pod se asignan estáticamente en la subred del nodo (consulte vnetSubnetID para obtener más detalles). Esta es la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
powerState	PowerState		Indica si el grupo de agentes se está ejecutando o detenido. Cuando se crea por primera vez un grupo de agentes, se ejecuta inicialmente. El grupo de agentes se puede detener estableciendo este campo en Detenido. Un grupo de agentes detenido detiene todas sus máquinas virtuales y no acumula cargos de facturación. Un grupo de agentes solo se puede detener si se está ejecutando y el estado de aprovisionamiento es Correcto.
provisioningState	string		Estado actual de implementación o aprovisionamiento.
proximityPlacementGroupID	string		Identificador del grupo de selección de ubicación de proximidad.
scaleDownMode	ScaleDownMode		Modo de reducción vertical que se va a usar al escalar el grupo de agentes. Esto también afecta al comportamiento del escalador automático del clúster. Si no se especifica, el valor predeterminado es Eliminar.
scaleSetEvictionPolicy	ScaleSetEvictionPolicy	Delete	Directiva de expulsión del conjunto de escalado de máquinas virtuales que se va a usar. No se puede especificar a menos que scaleSetPriority sea "Spot". Si no se especifica, el valor predeterminado es "Delete".
scaleSetPriority	ScaleSetPriority	Regular	Prioridad del conjunto de escalado de máquinas virtuales. Si no se especifica, el valor predeterminado es "Regular".
spotMaxPrice	number	-1	El precio máximo (en dólares estadounidenses) que está dispuesto a pagar por instancias de spot. Los valores posibles son cualquier valor decimal mayor que cero o -1, lo que indica que el precio predeterminado está actualizado a petición. Los valores posibles son cualquier valor decimal mayor que cero o -1, lo que indica la voluntad de pagar cualquier precio a petición. Para más información sobre los precios de spot, consulte precios de máquinas virtuales de acceso puntual.
tags	object		Las etiquetas que se van a conservar en el conjunto de escalado de máquinas virtuales del grupo de agentes.
type	AgentPoolType		Tipo de grupo de agentes.
upgradeSettings	AgentPoolUpgradeSettings		Configuración para actualizar el grupo de agentes
vmSize	string		Tamaño de las máquinas virtuales del grupo de agentes. La disponibilidad del tamaño de máquina virtual varía según la región. Si un nodo contiene recursos de proceso insuficientes (memoria, cpu, etc.), los pods podrían no ejecutarse correctamente. Para más información sobre los tamaños de máquina virtual restringidos, consulte: https://docs.microsoft.com/azure/aks/quotas-skus-regions
vnetSubnetID	string		Identificador de la subred a la que se unirán los nodos del grupo de agentes y, opcionalmente, los pods se unirán al inicio. Si no se especifica, se generará y usará una red virtual y una subred. Si no se especifica ningún podSubnetID, esto se aplica a los nodos y pods; de lo contrario, se aplica solo a los nodos. Esta es la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
workloadRuntime	WorkloadRuntime		Determina el tipo de carga de trabajo que puede ejecutar un nodo.

ManagedClusterAPIServerAccessProfile

Perfil de acceso para el servidor de API de clúster administrado.

Name	Type	Description
authorizedIPRanges	string[]	Los intervalos IP autorizados para acceder al servidor de API de Kubernetes. Los intervalos IP se especifican en formato CIDR, por ejemplo, 137.117.106.88/29. Esta característica no es compatible con los clústeres que usan ip pública por nodo o clústeres que usan un Load Balancer básico. Para más información, consulte Intervalos IP autorizados del servidor de API.
disableRunCommand	boolean	Si se va a deshabilitar el comando de ejecución para el clúster o no.
enablePrivateCluster	boolean	Si se va a crear el clúster como un clúster privado o no. Para más información, consulte Creación de un clúster de AKS privado.
enablePrivateClusterPublicFQDN	boolean	Si se va a crear un FQDN público adicional para un clúster privado o no.
privateDNSZone	string	Modo de zona DNS privada para el clúster. El valor predeterminado es System. Para más información, consulte Configuración de una zona DNS privada. Los valores permitidos son "system" y "none".

ManagedClusterAutoUpgradeProfile

Perfil de actualización automática para un clúster administrado.

Name	Type	Description
upgradeChannel	upgradeChannel	Canal de actualización para la actualización automática. El valor predeterminado es "none". Para más información, consulte configuración del canal de actualización automática del clúster de AKS.

ManagedClusterHTTPProxyConfig

Configuración del proxy HTTP del clúster.

Name	Type	Description
httpProxy	string	Punto de conexión del servidor proxy HTTP que se va a usar.
httpsProxy	string	Punto de conexión del servidor proxy HTTPS que se va a usar.
noProxy	string[]	Los puntos de conexión que no deben pasar por el proxy.
trustedCa	string	Certificado de ENTIDAD de certificación alternativo que se va a usar para conectarse a servidores proxy.

ManagedClusterIdentity

Identidad del clúster administrado.

Name	Type	Description
principalId	string	Identificador de entidad de seguridad de la identidad asignada por el sistema que usan los componentes maestros.
tenantId	string	Identificador de inquilino de la identidad asignada por el sistema que usan los componentes maestros.
type	ResourceIdentityType	Tipo de identidad que se usa para el clúster administrado. Para más información, consulte Uso de identidades administradas en AKS.
userAssignedIdentities	UserAssignedIdentities	Identidad de usuario asociada al clúster administrado. Esta identidad se usará en el plano de control. Solo se permite una identidad asignada por el usuario. Las claves deben ser identificadores de recursos arm con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ManagedClusterLoadBalancerProfile

Perfil del equilibrador de carga del clúster administrado.

Name	Type	Default Value	Description
allocatedOutboundPorts	integer	0	Número deseado de puertos SNAT asignados por máquina virtual. Los valores permitidos están comprendidos entre 0 y 64000 (ambos incluidos). El valor predeterminado es 0, lo que da como resultado la asignación dinámica de puertos de Azure.
effectiveOutboundIPs	ResourceReference[]		Los recursos de IP de salida efectivos del equilibrador de carga del clúster.
enableMultipleStandardLoadBalancers	boolean		Habilite varios equilibradores de carga estándar por clúster de AKS o no.
idleTimeoutInMinutes	integer	30	Tiempo de espera de inactividad del flujo de salida deseado en minutos. Los valores permitidos están comprendidos entre 4 y 120 (ambos incluidos). El valor predeterminado es de 30 minutos.
managedOutboundIPs	ManagedOutboundIPs		Direcciones IP de salida administradas deseadas para el equilibrador de carga del clúster.
outboundIPPrefixes	OutboundIPPrefixes		Recursos de prefijo de IP de salida deseados para el equilibrador de carga del clúster.
outboundIPs	OutboundIPs		Recursos ip de salida deseados para el equilibrador de carga del clúster.

ManagedClusterManagedOutboundIPProfile

Perfil de los recursos ip de salida administrados del clúster administrado.

Name	Type	Default Value	Description
count	integer	1	Número deseado de direcciones IP de salida creadas o administradas por Azure. Los valores permitidos deben estar en el intervalo de 1 a 16 (ambos incluidos). El valor predeterminado es 1.

ManagedClusterNATGatewayProfile

Perfil de la puerta de enlace NAT del clúster administrado.

Name	Type	Default Value	Description
effectiveOutboundIPs	ResourceReference[]		Los recursos de IP de salida efectivos de la puerta de enlace NAT del clúster.
idleTimeoutInMinutes	integer	4	Tiempo de espera de inactividad del flujo de salida deseado en minutos. Los valores permitidos están comprendidos entre 4 y 120 (ambos incluidos). El valor predeterminado es 4 minutos.
managedOutboundIPProfile	ManagedClusterManagedOutboundIPProfile		Perfil de los recursos ip de salida administrados de la puerta de enlace NAT del clúster.

ManagedClusterPodIdentity

Detalles sobre la identidad del pod asignada al clúster administrado.

Name	Type	Description
bindingSelector	string	Selector de enlace que se va a usar para el recurso AzureIdentityBinding.
identity	UserAssignedIdentity	Detalles de la identidad asignada por el usuario.
name	string	Nombre de la identidad del pod.
namespace	string	Espacio de nombres de la identidad del pod.
provisioningInfo	ProvisioningInfo
provisioningState	ManagedClusterPodIdentityProvisioningState	Estado de aprovisionamiento actual de la identidad del pod.

ManagedClusterPodIdentityException

Excepción de identidad de pod, que permite que los pods con determinadas etiquetas accedan al punto de conexión de Azure Instance Metadata Service (IMDS) sin que el servidor de identidad administrada por nodo (NMI) intercepte.

Name	Type	Description
name	string	Nombre de la excepción de identidad del pod.
namespace	string	Espacio de nombres de la excepción de identidad de pod.
podLabels	object	Etiquetas de pod que se van a buscar coincidencias.

ManagedClusterPodIdentityProfile

Perfil de identidad de pod del clúster administrado.

Name	Type	Description
allowNetworkPluginKubenet	boolean	Indica si se permite que la identidad del pod se ejecute en clústeres con redes de Kubenet. La ejecución en Kubenet está deshabilitada de forma predeterminada debido a la naturaleza relacionada con la seguridad de la identidad de pod de AAD y los riesgos de suplantación de ip. Consulte uso del complemento de red kubenet con AAD Pod Identity para obtener más información.
enabled	boolean	Indica si el complemento de identidad de pod está habilitado.
userAssignedIdentities	ManagedClusterPodIdentity[]	Identidades de pod que se van a usar en el clúster.
userAssignedIdentityExceptions	ManagedClusterPodIdentityException[]	Excepciones de identidad de pod que se van a permitir.

ManagedClusterPodIdentityProvisioningError

Respuesta de error del aprovisionamiento de identidades de pod.

Name	Type	Description
error	ManagedClusterPodIdentityProvisioningErrorBody	Detalles sobre el error.

ManagedClusterPodIdentityProvisioningErrorBody

Respuesta de error del aprovisionamiento de identidades de pod.

Name	Type	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	ManagedClusterPodIdentityProvisioningErrorBody[]	Lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

ManagedClusterPodIdentityProvisioningState

Estado de aprovisionamiento actual de la identidad del pod.

Name	Type	Description
Assigned	string
Deleting	string
Failed	string
Updating	string

ManagedClusterSecurityProfile

Perfil de seguridad para el clúster del servicio de contenedor.

Name	Type	Description
azureDefender	ManagedClusterSecurityProfileAzureDefender	Configuración de Azure Defender para el perfil de seguridad.

ManagedClusterSecurityProfileAzureDefender

Configuración de Azure Defender para el perfil de seguridad.

Name	Type	Description
enabled	boolean	Si se va a habilitar Azure Defender
logAnalyticsWorkspaceResourceId	string	Identificador de recurso del área de trabajo de Log Analytics que se va a asociar a Azure Defender. Cuando Azure Defender está habilitado, este campo es obligatorio y debe ser un identificador de recurso de área de trabajo válido. Cuando Azure Defender esté deshabilitado, deje el campo vacío.

ManagedClusterServicePrincipalProfile

Información sobre una identidad de entidad de servicio para el clúster que se usará para manipular las API de Azure.

Name	Type	Description
clientId	string	Identificador de la entidad de servicio.
secret	string	Contraseña secreta asociada a la entidad de servicio en texto sin formato.

ManagedClusterSKU

SKU de un clúster administrado.

Name	Type	Description
name	ManagedClusterSKUName	Nombre de una SKU de clúster administrado.
tier	ManagedClusterSKUTier	Nivel de una SKU de clúster administrado. Si no se especifica, el valor predeterminado es "Gratis". Consulte el Acuerdo de Nivel de Servicio de tiempo de actividad para obtener más detalles.

ManagedClusterSKUName

Nombre de una SKU de clúster administrado.

Name	Type	Description
Basic	string

ManagedClusterSKUTier

El nivel de una SKU de clúster administrado.

Name	Type	Description
Free	string	Sin Acuerdo de Nivel de Servicio garantizado, sin cargos adicionales. Los clústeres de nivel gratis tienen un SLO del 99,5 %.
Paid	string	Garantiza la disponibilidad del 99,95 % del punto de conexión del servidor de la API de Kubernetes para los clústeres que usan Availability Zones y el 99,9 % de la disponibilidad de los clústeres que no usan Availability Zones.

ManagedClusterStorageProfile

Storage perfil del clúster de servicio de contenedor.

Name	Type	Description
diskCSIDriver	ManagedClusterStorageProfileDiskCSIDriver	Configuración del controlador CSI de AzureDisk para el perfil de almacenamiento.
fileCSIDriver	ManagedClusterStorageProfileFileCSIDriver	Configuración del controlador CSI de AzureFile para el perfil de almacenamiento.
snapshotController	ManagedClusterStorageProfileSnapshotController	Configuración del controlador de instantáneas para el perfil de almacenamiento.

ManagedClusterStorageProfileDiskCSIDriver

Configuración del controlador CSI de AzureDisk para el perfil de almacenamiento.

Name	Type	Description
enabled	boolean	Indica si se va a habilitar el controlador CSI de AzureDisk. El valor predeterminado es true.

ManagedClusterStorageProfileFileCSIDriver

Configuración del controlador CSI de AzureFile para el perfil de almacenamiento.

Name	Type	Description
enabled	boolean	Indica si se va a habilitar el controlador CSI de AzureFile. El valor predeterminado es true.

ManagedClusterStorageProfileSnapshotController

Configuración del controlador de instantáneas para el perfil de almacenamiento.

Name	Type	Description
enabled	boolean	Indica si se va a habilitar el controlador de instantáneas. El valor predeterminado es true.

ManagedClusterWindowsProfile

Perfil de Windows máquinas virtuales en el clúster administrado.

Name	Type	Description
adminPassword	string	Especifica la contraseña de la cuenta de administrador. Longitud mínima: 8 caracteres Longitud máxima: 123 caracteres Requisitos de complejidad: 3 de 4 condiciones siguientes deben cumplirse Tiene caracteres inferiores Tiene caracteres superiores Tiene un dígito Tiene un carácter especial (Coincidencia de regex [\W_]) Valores no permitidos: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"
adminUsername	string	Especifica el nombre de la cuenta de administrador. Restricción: No se puede finalizar en "." Valores no permitidos: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "admin2", "admin2" aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". Longitud mínima: 1 carácter Longitud máxima: 20 caracteres
enableCSIProxy	boolean	Indica si se va a habilitar el proxy CSI. Para obtener más información sobre el proxy CSI, consulte el repositorio de GitHub del proxy CSI.
gmsaProfile	WindowsGmsaProfile	Perfil de gMSA Windows en el clúster administrado.
licenseType	licenseType	Tipo de licencia que se va a usar para Windows máquinas virtuales. Para más información, consulte Ventajas del usuario híbrido de Azure .

ManagedOutboundIPs

Direcciones IP de salida administradas deseadas para el equilibrador de carga del clúster.

Name	Type	Default Value	Description
count	integer	1	Número deseado de direcciones IP de salida IPv4 creadas o administradas por Azure para el equilibrador de carga del clúster. Los valores permitidos deben estar comprendidos entre 1 y 100 (ambos incluidos). El valor predeterminado es 1.
countIPv6	integer	0	Número deseado de direcciones IP de salida IPv6 creadas o administradas por Azure para el equilibrador de carga del clúster. Los valores permitidos deben estar comprendidos entre 1 y 100 (ambos incluidos). El valor predeterminado es 0 para una sola pila y 1 para la pila doble.

networkMode

El modo de red con el que se configura Azure CNI.

Name	Type	Description
bridge	string	Ya no se admite
transparent	string	No se crea ningún puente. La comunicación entre pods entre pods es a través de rutas IP creadas por Azure CNI. Consulte Modo transparente para obtener más información.

NetworkPlugin

Complemento de red que se usa para compilar la red de Kubernetes.

Name	Type	Description
azure	string	Use el complemento de red de Azure CNI. Consulte Redes de Azure CNI (avanzadas) para más información.
kubenet	string	Use el complemento de red Kubenet. Consulte Redes kubenet (básicas) para obtener más información.

NetworkPolicy

Directiva de red que se usa para compilar la red de Kubernetes.

Name	Type	Description
azure	string	Use directivas de red de Azure. Consulte las diferencias entre las directivas de Azure y Calico para más información.
calico	string	Use directivas de red de Calico. Consulte las diferencias entre las directivas de Azure y Calico para más información.

OSDiskType

Tipo de disco del sistema operativo que se va a usar para las máquinas del grupo de agentes.

Name	Type	Description
Ephemeral	string	Los discos del sistema operativo efímeros solo se almacenan en el equipo host, al igual que un disco temporal. Esto proporciona una latencia de lectura y escritura menor, junto con escalabilidad de nodos y actualizaciones de clúster más rápidas.
Managed	string	Azure replica el disco del sistema operativo de una máquina virtual en Azure Storage para evitar la pérdida de datos si la máquina virtual debe reubicarse en otro host. Dado que los contenedores no están diseñados para conservar el estado local, este comportamiento ofrece un valor limitado al tiempo que proporciona algunos inconvenientes, incluido el aprovisionamiento de nodos más lento y una mayor latencia de lectura y escritura.

OSSKU

Especifica una SKU del sistema operativo. Este valor no se debe especificar si OSType está Windows.

Name	Type	Description
CBLMariner	string
Ubuntu	string

OSType

Tipo de sistema operativo. El valor predeterminado es Linux.

Name	Type	Description
Linux	string	Use Linux.
Windows	string	Use Windows.

OutboundIPPrefixes

Recursos de prefijo de IP de salida deseados para el equilibrador de carga del clúster.

Name	Type	Description
publicIPPrefixes	ResourceReference[]	Lista de recursos de prefijo de IP pública.

OutboundIPs

Recursos ip de salida deseados para el equilibrador de carga del clúster.

Name	Type	Description
publicIPs	ResourceReference[]	Una lista de recursos de ip pública.

outboundType

Método de enrutamiento de salida (salida).

Name	Type	Description
loadBalancer	string	El equilibrador de carga se usa para la salida a través de una dirección IP pública asignada a AKS. Esto admite los servicios de Kubernetes de tipo "loadBalancer". Para obtener más información, consulte loadbalancer de tipo de salida.
managedNATGateway	string	La puerta de enlace NAT administrada por AKS se usa para la salida.
userAssignedNATGateway	string	La puerta de enlace NAT asignada por el usuario asociada a la subred del clúster se usa para la salida. Se trata de un escenario avanzado y requiere una configuración de red adecuada.
userDefinedRouting	string	Egress el usuario debe definir las rutas de acceso. Se trata de un escenario avanzado y requiere una configuración de red adecuada. Para obtener más información, vea tipo de salida userDefinedRouting.

PowerState

Describe el estado de energía del clúster.

Name	Type	Description
code	code	Indica si el clúster está en ejecución o detenido.

PrivateLinkResource

Un recurso de vínculo privado

Name	Type	Description
groupId	string	Identificador de grupo del recurso.
id	string	Identificador del recurso de vínculo privado.
name	string	Nombre del recurso de vínculo privado.
privateLinkServiceID	string	El identificador de servicio de vínculo privado del recurso, este campo solo se expone a NRP internamente.
requiredMembers	string[]	RequiredMembers del recurso
type	string	El tipo de recurso.

ProvisioningInfo

Name	Type	Description
error	ManagedClusterPodIdentityProvisioningError	Error de asignación de identidad de pod (si existe).

PublicNetworkAccess

PublicNetworkAccess de managedCluster

Name	Type	Description
Disabled	string
Enabled	string

ResourceIdentityType

Tipo de identidad que se usa para el clúster administrado.

Name	Type	Description
None	string	No use una identidad administrada para el clúster administrado; en su lugar, se usará la entidad de servicio.
SystemAssigned	string	Use una identidad administrada asignada por el sistema creada implícitamente para administrar los recursos del clúster. Los componentes maestros del plano de control, como kube-controller-manager, usarán la identidad administrada asignada por el sistema para manipular los recursos de Azure.
UserAssigned	string	Use una identidad especificada por el usuario para administrar los recursos del clúster. Los componentes maestros del plano de control, como kube-controller-manager, usarán la identidad administrada asignada por el usuario especificado para manipular los recursos de Azure.

ResourceReference

Referencia a un recurso de Azure.

Name	Type	Description
id	string	Identificador de recurso completo de Azure.

ScaleDownMode

Describe cómo se agregan o quitan las máquinas virtuales de los grupos de agentes. Consulte los estados de facturación.

Name	Type	Description
Deallocate	string	Intente iniciar instancias desasignadas (si existen) durante el escalado vertical y desasignar instancias durante la reducción vertical.
Delete	string	Cree nuevas instancias durante el escalado vertical y quite instancias durante la reducción vertical.

ScaleSetEvictionPolicy

Directiva de expulsión del conjunto de escalado de máquinas virtuales.

Name	Type	Description
Deallocate	string	Los nodos del conjunto de escalado subyacente del grupo de nodos se establecen en el estado detenido desasignado tras la expulsión. Los nodos en estado stopped-deallocated se consideran también a efectos de la cuota de proceso, lo cual puede generar problemas de escalado o actualización del clúster.
Delete	string	Los nodos del conjunto de escalado subyacente del grupo de nodos se eliminan cuando se expulsan.

ScaleSetPriority

Prioridad del conjunto de escalado de máquinas virtuales.

Name	Type	Description
Regular	string	Se usarán máquinas virtuales normales.
Spot	string	Se usarán máquinas virtuales de prioridad de acceso puntual. No hay ningún Acuerdo de Nivel de Servicio para los nodos de acceso puntual. Consulte spot en AKS para obtener más información.

SysctlConfig

Configuración de Sysctl para nodos de agente de Linux.

Name	Type	Description
fsAioMaxNr	integer	Configuración de Sysctl fs.aio-max-nr.
fsFileMax	integer	Configuración de Sysctl fs.file-max.
fsInotifyMaxUserWatches	integer	Configuración de Sysctl fs.inotify.max_user_watches.
fsNrOpen	integer	Configuración de Sysctl fs.nr_open.
kernelThreadsMax	integer	Configuración de sysctl kernel.threads-max.
netCoreNetdevMaxBacklog	integer	Configuración de Sysctl net.core.netdev_max_backlog.
netCoreOptmemMax	integer	Configuración de Sysctl net.core.optmem_max.
netCoreRmemDefault	integer	Configuración de Sysctl net.core.rmem_default.
netCoreRmemMax	integer	Configuración de Sysctl net.core.rmem_max.
netCoreSomaxconn	integer	Configuración de Sysctl net.core.somaxconn.
netCoreWmemDefault	integer	Configuración de Sysctl net.core.wmem_default.
netCoreWmemMax	integer	Configuración de Sysctl net.core.wmem_max.
netIpv4IpLocalPortRange	string	Configuración de Sysctl net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1	integer	Configuración de Sysctl net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2	integer	Configuración de Sysctl net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3	integer	Configuración de Sysctl net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout	integer	Configuración de Sysctl net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes	integer	Configuración de Sysctl net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime	integer	Configuración de Sysctl net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog	integer	Configuración de Sysctl net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets	integer	Configuración de Sysctl net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse	boolean	Configuración de Sysctl net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl	integer	Configuración de Sysctl net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets	integer	Configuración de Sysctl net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax	integer	Configuración de Sysctl net.netfilter.nf_conntrack_max.
vmMaxMapCount	integer	Configuración de Sysctl vm.max_map_count.
vmSwappiness	integer	Configuración de Sysctl vm.swappiness.
vmVfsCachePressure	integer	Configuración de Sysctl vm.vfs_cache_pressure.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name	Type	Description
createdAt	string	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

TagsObject

Objeto Tags para las operaciones de revisión.

Name	Type	Description
tags	object	Etiquetas del recurso.

upgradeChannel

Canal de actualización para la actualización automática. El valor predeterminado es "none".

Name	Type	Description
node-image	string	Actualice automáticamente la imagen de nodo a la versión más reciente disponible. Microsoft proporciona revisiones e imágenes nuevas para los nodos de imagen con frecuencia (normalmente, semanalmente), pero los nodos en ejecución no obtienen las nuevas imágenes, a menos que realice una actualización de la imagen de nodo. Al activar el canal node-image, se actualizarán automáticamente las imágenes de nodo cada vez que haya disponible una nueva versión.
none	string	Deshabilita las actualizaciones automáticas y mantiene el clúster en su versión actual de Kubernetes.
patch	string	Actualice automáticamente el clúster a la versión de revisión compatible más reciente cuando esté disponible mientras mantiene la versión secundaria igual. Por ejemplo, si un clúster ejecuta la versión 1.17.7 y las versiones 1.17.9, 1.18.4, 1.18.6 y 1.19.1 están disponibles, el clúster se actualiza a 1.17.9.
rapid	string	Actualice automáticamente el clúster a la versión de revisión admitida más reciente en la versión secundaria compatible más reciente. En los casos en los que el clúster está en una versión de Kubernetes que se encuentra en una versión secundaria N-2 donde N es la última versión secundaria, el clúster se actualiza primero a la última versión de revisión compatible en la versión secundaria N-1. Por ejemplo, si un clúster ejecuta la versión 1.17.7 y las versiones 1.17.9, 1.18.4, 1.18.6 y 1.19.1 están disponibles, el clúster se actualiza primero a 1.18.6 y, a continuación, se actualiza a 1.19.1.
stable	string	Actualice automáticamente el clúster a la versión de revisión compatible más reciente en la versión secundaria N-1, donde N es la versión secundaria compatible más reciente. Por ejemplo, si un clúster ejecuta la versión 1.17.7 y las versiones 1.17.9, 1.18.4, 1.18.6 y 1.19.1 están disponibles, el clúster se actualiza a 1.18.6.

UserAssignedIdentities

Identidad de usuario asociada al clúster administrado. Esta identidad se usará en el plano de control. Solo se permite una identidad asignada por el usuario.

Name	Type	Description

UserAssignedIdentity

Detalles sobre una identidad asignada por el usuario.

Name	Type	Description
clientId	string	Identificador de cliente de la identidad asignada por el usuario.
objectId	string	Identificador de objeto de la identidad asignada por el usuario.
resourceId	string	Identificador de recurso de la identidad asignada por el usuario.

WindowsGmsaProfile

Windows perfil de gMSA en el clúster administrado.

Name	Type	Description
dnsServer	string	Especifica el servidor DNS para Windows gMSA. Establézcalo en vacío si ha configurado el servidor DNS en la red virtual que se usa para crear el clúster administrado.
enabled	boolean	Si se va a habilitar Windows gMSA. Especifica si se va a habilitar Windows gMSA en el clúster administrado.
rootDomainName	string	Especifica el nombre de dominio raíz para Windows gMSA. Establézcalo en vacío si ha configurado el servidor DNS en la red virtual que se usa para crear el clúster administrado.

WorkloadRuntime

Determina el tipo de carga de trabajo que puede ejecutar un nodo.

Name	Type	Description
OCIContainer	string	Los nodos usarán Kubelet para ejecutar cargas de trabajo de contenedor OCI estándar.
WasmWasi	string	Los nodos usarán Krustlet para ejecutar cargas de trabajo WASM mediante el proveedor WASI (versión preliminar).