Extensions - Create

Serviço:

Kubernetes Configuration

Versão da API:

2025-03-01

Crie uma nova extensão de cluster do Kubernetes.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/extensions/{extensionName}?api-version=2025-03-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
clusterName	path	True	string pattern: ^.*	O nome do cluster kubernetes.
clusterResourceName	path	True	string pattern: ^[a-zA-Z]*$	O nome do recurso do cluster Kubernetes - ou seja, managedClusters, connectedClusters, provisionedClusters, appliances.
clusterRp	path	True	string	O cluster Kubernetes RP - ou seja, Microsoft.ContainerService, Microsoft.Kubernetes, Microsoft.HybridContainerService.
extensionName	path	True	string	Nome da extensão.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
identity	Identity	Identidade do recurso de extensão
managedBy	string (arm-id)	A ID de recurso totalmente qualificada do recurso que gerencia esse recurso. Indica se esse recurso é gerenciado por outro recurso do Azure. Se isso estiver presente, a implantação em modo completo não excluirá o recurso se ele for removido do modelo, uma vez que é gerenciado por outro recurso.
plan	Plan	Detalhes do plano de recursos.
properties.additionalDetails	AdditionalDetails	Detalhes adicionais fornecidos pelo editor da extensão.
properties.aksAssignedIdentity	ExtensionPropertiesAksAssignedIdentity	Identidade do recurso de extensão em um cluster AKS
properties.autoUpgradeMinorVersion	boolean	Sinalize para observar se esta extensão participa na atualização automática da versão secundária ou não.
properties.autoUpgradeMode	AutoUpgradeMode	O modo de upgrade para upgrade automático. O padrão é "compatível".
properties.configurationProtectedSettings	object	Definições de configuração que são confidenciais, como pares nome-valor para configurar esta extensão.
properties.configurationSettings	object	Definições de configuração, como pares nome-valor para configurar esta extensão.
properties.extensionType	string	Tipo de extensão, da qual este recurso é uma instância. Ele deve ser um dos tipos de extensão registrados com Microsoft.KubernetesConfiguration pelo editor de extensão.
properties.managementDetails	ManagementDetails	Detalhes de gestão da extensão
properties.releaseTrain	string	ReleaseTrain esta extensão participa para atualização automática (por exemplo, Stable, Preview, etc.) - somente se autoUpgradeMinorVersion for 'true'.
properties.scope	Scope	Escopo no qual a extensão está instalada.
properties.statuses	ExtensionStatus[]	Status desta extensão.
properties.version	string	Versão especificada pelo usuário da extensão para esta extensão para 'pin'. Para usar 'version', autoUpgradeMinorVersion deve ser 'false'.

Respostas

Name	Tipo	Description
200 OK	Extension	Operação de atualização 'Extensão' de recurso bem-sucedida
201 Created	Extension	Operação de criação de 'Extensão' de recurso foi bem-sucedida Cabeçalhos Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Create Extension

Create Extension with Plan

Create Extension

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/ClusterMonitor?api-version=2025-03-01

{
  "properties": {
    "extensionType": "azuremonitor-containers",
    "autoUpgradeMode": "compatible",
    "autoUpgradeMinorVersion": true,
    "releaseTrain": "Preview",
    "scope": {
      "cluster": {
        "releaseNamespace": "kube-system"
      }
    },
    "configurationSettings": {
      "omsagent.secret.wsid": "fakeTokenPlaceholder",
      "omsagent.env.clusterName": "clusterName1"
    },
    "configurationProtectedSettings": {
      "omsagent.secret.key": "secretKeyValue01"
    }
  }
}

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.kubernetesconfiguration.extensions import KubernetesConfigurationExtensionsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-kubernetesconfiguration-extensions
# USAGE
    python create_extension.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = KubernetesConfigurationExtensionsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.extensions.begin_create(
        resource_group_name="rg1",
        cluster_rp="Microsoft.Kubernetes",
        cluster_resource_name="connectedClusters",
        cluster_name="clusterName1",
        extension_name="ClusterMonitor",
        extension={
            "properties": {
                "autoUpgradeMinorVersion": True,
                "autoUpgradeMode": "compatible",
                "configurationProtectedSettings": {"omsagent.secret.key": "secretKeyValue01"},
                "configurationSettings": {
                    "omsagent.env.clusterName": "clusterName1",
                    "omsagent.secret.wsid": "fakeTokenPlaceholder",
                },
                "extensionType": "azuremonitor-containers",
                "releaseTrain": "Preview",
                "scope": {"cluster": {"releaseNamespace": "kube-system"}},
            }
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-03-01/CreateExtension.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armextensions_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/kubernetesconfiguration/armextensions"
)

// Generated from example definition: 2025-03-01/CreateExtension.json
func ExampleClient_BeginCreate_createExtension() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armextensions.NewClientFactory("subId1", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewClient().BeginCreate(ctx, "rg1", "Microsoft.Kubernetes", "connectedClusters", "clusterName1", "ClusterMonitor", armextensions.Extension{
		Properties: &armextensions.ExtensionProperties{
			ExtensionType:           to.Ptr("azuremonitor-containers"),
			AutoUpgradeMode:         to.Ptr(armextensions.AutoUpgradeModeCompatible),
			AutoUpgradeMinorVersion: to.Ptr(true),
			ReleaseTrain:            to.Ptr("Preview"),
			Scope: &armextensions.Scope{
				Cluster: &armextensions.ScopeCluster{
					ReleaseNamespace: to.Ptr("kube-system"),
				},
			},
			ConfigurationSettings: map[string]*string{
				"omsagent.secret.wsid":     to.Ptr("fakeTokenPlaceholder"),
				"omsagent.env.clusterName": to.Ptr("clusterName1"),
			},
			ConfigurationProtectedSettings: map[string]*string{
				"omsagent.secret.key": to.Ptr("secretKeyValue01"),
			},
		},
	}, 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)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armextensions.ClientCreateResponse{
	// 	Extension: &armextensions.Extension{
	// 		ID: to.Ptr("/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/ClusterMonitor"),
	// 		Type: to.Ptr("Microsoft.KubernetesConfiguration/extensions"),
	// 		Name: to.Ptr("ClusterMonitor"),
	// 		SystemData: &armextensions.SystemData{
	// 			CreatedBy: to.Ptr("string"),
	// 			CreatedByType: to.Ptr(armextensions.CreatedByTypeApplication),
	// 			CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-09-08T05:10:57.027Z"); return t}()),
	// 			LastModifiedBy: to.Ptr("string"),
	// 			LastModifiedByType: to.Ptr(armextensions.CreatedByTypeApplication),
	// 			LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-09-08T05:10:57.027Z"); return t}()),
	// 		},
	// 		Properties: &armextensions.ExtensionProperties{
	// 			ExtensionType: to.Ptr("azuremonitor-containers"),
	// 			AutoUpgradeMode: to.Ptr(armextensions.AutoUpgradeModeCompatible),
	// 			AutoUpgradeMinorVersion: to.Ptr(true),
	// 			ReleaseTrain: to.Ptr("Preview"),
	// 			Version: to.Ptr("0.1.4"),
	// 			Scope: &armextensions.Scope{
	// 				Cluster: &armextensions.ScopeCluster{
	// 					ReleaseNamespace: to.Ptr("kube-system"),
	// 				},
	// 			},
	// 			ConfigurationSettings: map[string]*string{
	// 				"omsagent.secret.wsid": to.Ptr("fakeTokenPlaceholder"),
	// 				"omsagent.env.clusterName": to.Ptr("clusterName1"),
	// 			},
	// 			ProvisioningState: to.Ptr(armextensions.ProvisioningStateSucceeded),
	// 			CurrentVersion: to.Ptr("0.1.4"),
	// 			Statuses: []*armextensions.ExtensionStatus{
	// 			},
	// 			IsSystemExtension: to.Ptr(false),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ExtensionsClient } = require("@azure/arm-kubernetesconfiguration-extensions");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to create a new Kubernetes Cluster Extension.
 *
 * @summary create a new Kubernetes Cluster Extension.
 * x-ms-original-file: 2025-03-01/CreateExtension.json
 */
async function createExtension() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "subId1";
  const client = new ExtensionsClient(credential, subscriptionId);
  const result = await client.extensions.create(
    "rg1",
    "Microsoft.Kubernetes",
    "connectedClusters",
    "clusterName1",
    "ClusterMonitor",
    {
      extensionType: "azuremonitor-containers",
      autoUpgradeMode: "compatible",
      autoUpgradeMinorVersion: true,
      releaseTrain: "Preview",
      scope: { cluster: { releaseNamespace: "kube-system" } },
      configurationSettings: {
        "omsagent.secret.wsid": "fakeTokenPlaceholder",
        "omsagent.env.clusterName": "clusterName1",
      },
      configurationProtectedSettings: { "omsagent.secret.key": "secretKeyValue01" },
    },
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:

201

Azure-AsyncOperation: http://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Kubernetes/ConnectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/ClusterMonitor/operations/operationId?api-version=2025-03-01

{
  "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/ClusterMonitor",
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "name": "ClusterMonitor",
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2021-09-08T05:10:57.027Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-09-08T05:10:57.027Z"
  },
  "properties": {
    "extensionType": "azuremonitor-containers",
    "autoUpgradeMode": "compatible",
    "autoUpgradeMinorVersion": true,
    "releaseTrain": "Preview",
    "version": "0.1.4",
    "scope": {
      "cluster": {
        "releaseNamespace": "kube-system"
      }
    },
    "configurationSettings": {
      "omsagent.secret.wsid": "fakeTokenPlaceholder",
      "omsagent.env.clusterName": "clusterName1"
    },
    "provisioningState": "Creating",
    "currentVersion": null,
    "statuses": [],
    "isSystemExtension": false
  }
}

Código de estado:

200

{
  "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/ClusterMonitor",
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "name": "ClusterMonitor",
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2021-09-08T05:10:57.027Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-09-08T05:10:57.027Z"
  },
  "properties": {
    "extensionType": "azuremonitor-containers",
    "autoUpgradeMode": "compatible",
    "autoUpgradeMinorVersion": true,
    "releaseTrain": "Preview",
    "version": "0.1.4",
    "scope": {
      "cluster": {
        "releaseNamespace": "kube-system"
      }
    },
    "configurationSettings": {
      "omsagent.secret.wsid": "fakeTokenPlaceholder",
      "omsagent.env.clusterName": "clusterName1"
    },
    "provisioningState": "Succeeded",
    "currentVersion": "0.1.4",
    "statuses": [],
    "isSystemExtension": false
  }
}

Create Extension with Plan

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/azureVote?api-version=2025-03-01

{
  "properties": {
    "extensionType": "azure-vote",
    "autoUpgradeMode": "compatible",
    "autoUpgradeMinorVersion": true,
    "releaseTrain": "Preview"
  },
  "plan": {
    "name": "azure-vote-standard",
    "publisher": "Microsoft",
    "product": "azure-vote-standard-offer-id"
  }
}

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.kubernetesconfiguration.extensions import KubernetesConfigurationExtensionsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-kubernetesconfiguration-extensions
# USAGE
    python create_extension_with_plan.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = KubernetesConfigurationExtensionsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.extensions.begin_create(
        resource_group_name="rg1",
        cluster_rp="Microsoft.Kubernetes",
        cluster_resource_name="connectedClusters",
        cluster_name="clusterName1",
        extension_name="azureVote",
        extension={
            "plan": {
                "name": "azure-vote-standard",
                "product": "azure-vote-standard-offer-id",
                "publisher": "Microsoft",
            },
            "properties": {
                "autoUpgradeMinorVersion": True,
                "autoUpgradeMode": "compatible",
                "extensionType": "azure-vote",
                "releaseTrain": "Preview",
            },
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-03-01/CreateExtensionWithPlan.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armextensions_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/kubernetesconfiguration/armextensions"
)

// Generated from example definition: 2025-03-01/CreateExtensionWithPlan.json
func ExampleClient_BeginCreate_createExtensionWithPlan() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armextensions.NewClientFactory("subId1", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewClient().BeginCreate(ctx, "rg1", "Microsoft.Kubernetes", "connectedClusters", "clusterName1", "azureVote", armextensions.Extension{
		Properties: &armextensions.ExtensionProperties{
			ExtensionType:           to.Ptr("azure-vote"),
			AutoUpgradeMode:         to.Ptr(armextensions.AutoUpgradeModeCompatible),
			AutoUpgradeMinorVersion: to.Ptr(true),
			ReleaseTrain:            to.Ptr("Preview"),
		},
		Plan: &armextensions.Plan{
			Name:      to.Ptr("azure-vote-standard"),
			Publisher: to.Ptr("Microsoft"),
			Product:   to.Ptr("azure-vote-standard-offer-id"),
		},
	}, 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)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armextensions.ClientCreateResponse{
	// 	Extension: &armextensions.Extension{
	// 		ID: to.Ptr("/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/azureVote"),
	// 		Type: to.Ptr("Microsoft.KubernetesConfiguration/extensions"),
	// 		Name: to.Ptr("azureVote"),
	// 		SystemData: &armextensions.SystemData{
	// 			CreatedBy: to.Ptr("string"),
	// 			CreatedByType: to.Ptr(armextensions.CreatedByTypeApplication),
	// 			CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-09-08T05:10:57.027Z"); return t}()),
	// 			LastModifiedBy: to.Ptr("string"),
	// 			LastModifiedByType: to.Ptr(armextensions.CreatedByTypeApplication),
	// 			LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-09-08T05:10:57.027Z"); return t}()),
	// 		},
	// 		Plan: &armextensions.Plan{
	// 			Name: to.Ptr("azure-vote-standard"),
	// 			Publisher: to.Ptr("Microsoft"),
	// 			Product: to.Ptr("azure-vote-standard-offer-id"),
	// 		},
	// 		Properties: &armextensions.ExtensionProperties{
	// 			ExtensionType: to.Ptr("azure-vote"),
	// 			AutoUpgradeMode: to.Ptr(armextensions.AutoUpgradeModeCompatible),
	// 			AutoUpgradeMinorVersion: to.Ptr(true),
	// 			ReleaseTrain: to.Ptr("Preview"),
	// 			Version: to.Ptr("0.1.4"),
	// 			Scope: &armextensions.Scope{
	// 				Cluster: &armextensions.ScopeCluster{
	// 					ReleaseNamespace: to.Ptr("kube-system"),
	// 				},
	// 			},
	// 			ProvisioningState: to.Ptr(armextensions.ProvisioningStateCreating),
	// 			Statuses: []*armextensions.ExtensionStatus{
	// 			},
	// 			CurrentVersion: to.Ptr("0.1.4"),
	// 			IsSystemExtension: to.Ptr(false),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ExtensionsClient } = require("@azure/arm-kubernetesconfiguration-extensions");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to create a new Kubernetes Cluster Extension.
 *
 * @summary create a new Kubernetes Cluster Extension.
 * x-ms-original-file: 2025-03-01/CreateExtensionWithPlan.json
 */
async function createExtensionWithPlan() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "subId1";
  const client = new ExtensionsClient(credential, subscriptionId);
  const result = await client.extensions.create(
    "rg1",
    "Microsoft.Kubernetes",
    "connectedClusters",
    "clusterName1",
    "azureVote",
    {
      extensionType: "azure-vote",
      autoUpgradeMode: "compatible",
      autoUpgradeMinorVersion: true,
      releaseTrain: "Preview",
      plan: {
        name: "azure-vote-standard",
        publisher: "Microsoft",
        product: "azure-vote-standard-offer-id",
      },
    },
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:

201

Azure-AsyncOperation: http://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Kubernetes/ConnectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/azureVote/operations/operationId?api-version=2025-03-01

{
  "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/azureVote",
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "name": "azureVote",
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2021-09-08T05:10:57.027Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-09-08T05:10:57.027Z"
  },
  "plan": {
    "name": "azure-vote-standard",
    "publisher": "Microsoft",
    "product": "azure-vote-standard-offer-id"
  },
  "properties": {
    "extensionType": "azure-vote",
    "autoUpgradeMode": "compatible",
    "autoUpgradeMinorVersion": true,
    "releaseTrain": "Preview",
    "version": "0.1.4",
    "scope": {
      "cluster": {
        "releaseNamespace": "kube-system"
      }
    },
    "provisioningState": "Creating",
    "statuses": [],
    "currentVersion": null,
    "isSystemExtension": false
  }
}

Código de estado:

200

Azure-AsyncOperation: http://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Kubernetes/ConnectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/ClusterMonitor/operations/operationId?api-version=2025-03-01

{
  "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/extensions/azureVote",
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "name": "azureVote",
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2021-09-08T05:10:57.027Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-09-08T05:10:57.027Z"
  },
  "plan": {
    "name": "azure-vote-standard",
    "publisher": "Microsoft",
    "product": "azure-vote-standard-offer-id"
  },
  "properties": {
    "extensionType": "azure-vote",
    "autoUpgradeMode": "compatible",
    "autoUpgradeMinorVersion": true,
    "releaseTrain": "Preview",
    "version": "0.1.4",
    "scope": {
      "cluster": {
        "releaseNamespace": "kube-system"
      }
    },
    "provisioningState": "Creating",
    "statuses": [],
    "currentVersion": "0.1.4",
    "isSystemExtension": false
  }
}

Definições

Name	Description
AccessDetail	Metadados sobre os detalhes de acesso da entidade gestora da extensão
AdditionalDetails	Detalhes adicionais fornecidos pelo editor da extensão.
AKSIdentityType	O tipo de identidade.
AutoUpgradeMode	O modo de upgrade para upgrade automático. O padrão é "compatível".
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
Extension	O objeto Extension.
ExtensionPropertiesAksAssignedIdentity	Identidade do recurso de extensão em um cluster AKS
ExtensionStatus	Status da extensão.
Identity	Identidade do recurso.
LevelType	Nível do estatuto.
ManagementDetails	Metadados sobre a entidade gestora da extensão e as operações permitidas.
Plan	Planeje o recurso.
ProvisioningState	O estado de provisionamento do recurso.
ResourceIdentityType	O tipo de identidade.
Scope	Âmbito da extensão. Pode ser Cluster ou Namespace; mas não ambos.
ScopeCluster	Especifica que o escopo da extensão é Cluster
ScopeNamespace	Especifica que o escopo da extensão é Namespace
systemData	Metadados referentes à criação e última modificação do recurso.

AccessDetail

Object

Metadados sobre os detalhes de acesso da entidade gestora da extensão

Name	Tipo	Description
allowedActions	string[]	Lista de ações permitidas para a entidade
description	string	A descrição da entidade
entity	string	A entidade a que se aplicam os dados de acesso

AdditionalDetails

Object

Detalhes adicionais fornecidos pelo editor da extensão.

Name	Tipo	Description
docs	string	Documentação para a extensão.
releaseNotes	string	Notas de lançamento da extensão.
troubleshootingGuide	string	Guia de resolução de problemas para a extensão.

AKSIdentityType

Enumeração

O tipo de identidade.

Valor	Description
SystemAssigned	Identidade SystemAssigned
UserAssigned	Identidade UserAssigned
Workload	Identidade do fluxo de trabalho

AutoUpgradeMode

Enumeração

O modo de upgrade para upgrade automático. O padrão é "compatível".

Valor	Description
none	A extensão não será automaticamente atualizada.
patch	A extensão será automaticamente atualizada para a versão mais recente da atualização dentro da versão menor.
compatible	A extensão será automaticamente atualizada para versões compatíveis conforme determinado pelo utilizador.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

Extension

Object

O objeto Extension.

Name	Tipo	Default value	Description
id	string		ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identidade do recurso de extensão
managedBy	string (arm-id)		A ID de recurso totalmente qualificada do recurso que gerencia esse recurso. Indica se esse recurso é gerenciado por outro recurso do Azure. Se isso estiver presente, a implantação em modo completo não excluirá o recurso se ele for removido do modelo, uma vez que é gerenciado por outro recurso.
name	string		O nome do recurso
plan	Plan		Detalhes do plano de recursos.
properties.additionalDetails	AdditionalDetails		Detalhes adicionais fornecidos pelo editor da extensão.
properties.aksAssignedIdentity	ExtensionPropertiesAksAssignedIdentity		Identidade do recurso de extensão em um cluster AKS
properties.autoUpgradeMinorVersion	boolean	True	Sinalize para observar se esta extensão participa na atualização automática da versão secundária ou não.
properties.autoUpgradeMode	AutoUpgradeMode	compatible	O modo de upgrade para upgrade automático. O padrão é "compatível".
properties.configurationProtectedSettings	object		Definições de configuração que são confidenciais, como pares nome-valor para configurar esta extensão.
properties.configurationSettings	object		Definições de configuração, como pares nome-valor para configurar esta extensão.
properties.currentVersion	string		Versão atualmente instalada da extensão.
properties.customLocationSettings	object		Propriedades de configurações de local personalizadas.
properties.errorInfo	ErrorDetail		Informações de erro do agente - por exemplo, erros durante a instalação.
properties.extensionState	string		Estado da extensão no cluster.
properties.extensionType	string		Tipo de extensão, da qual este recurso é uma instância. Ele deve ser um dos tipos de extensão registrados com Microsoft.KubernetesConfiguration pelo editor de extensão.
properties.isSystemExtension	boolean	False	Sinalizar para observar se esta extensão é uma extensão do sistema
properties.managementDetails	ManagementDetails		Detalhes de gestão da extensão
properties.packageUri	string		Uri do pacote Helm
properties.provisioningState	ProvisioningState		Estado de instalação desta extensão.
properties.releaseTrain	string	Stable	ReleaseTrain esta extensão participa para atualização automática (por exemplo, Stable, Preview, etc.) - somente se autoUpgradeMinorVersion for 'true'.
properties.scope	Scope		Escopo no qual a extensão está instalada.
properties.statuses	ExtensionStatus[]		Status desta extensão.
properties.version	string		Versão especificada pelo usuário da extensão para esta extensão para 'pin'. Para usar 'version', autoUpgradeMinorVersion deve ser 'false'.
systemData	systemData		Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string		O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ExtensionPropertiesAksAssignedIdentity

Object

Identidade do recurso de extensão em um cluster AKS

Name	Tipo	Description
clientId	string	O ID do cliente da identidade do recurso.
objectId	string	O ID do objeto da identidade do recurso.
principalId	string	A ID principal da identidade do recurso.
resourceId	string (arm-id)	O ID da identidade do recurso.
tenantId	string	A ID do locatário do recurso.
type	AKSIdentityType	O tipo de identidade.

ExtensionStatus

Object

Status da extensão.

Name	Tipo	Default value	Description
code	string		Código de status fornecido pela extensão
displayStatus	string		Breve descrição do estado da extensão.
level	LevelType	Information	Nível do estatuto.
message	string		Mensagem detalhada do status da extensão.
time	string		DateLiteral (por ISO8601) observando a hora do status da instalação.

Identity

Object

Identidade do recurso.

Name	Tipo	Description
principalId	string	A ID principal da identidade do recurso.
tenantId	string	A ID do locatário do recurso.
type	ResourceIdentityType	O tipo de identidade.

LevelType

Enumeração

Nível do estatuto.

Valor	Description
Error	Indica um estado de erro da extensão.
Warning	Indica um estado de aviso da extensão.
Information	Indica um estado informativo da extensão.

ManagementDetails

Object

Metadados sobre a entidade gestora da extensão e as operações permitidas.

Name	Tipo	Description
accessDetails	AccessDetail[]	Lista de detalhes de acesso da entidade gestora
category	string	A categoria da entidade gestora

Plan

Object

Planeje o recurso.

Name	Tipo	Description
name	string	Um nome definido pelo usuário do artefato de 3ª parte que está sendo adquirido.
product	string	O artefato da 3ª Parte que está sendo adquirido. Por exemplo, NewRelic. O produto é mapeado para o OfferID especificado para o artefato no momento da integração do Data Market.
promotionCode	string	Um editor forneceu o código promocional conforme previsto no Data Market para o referido produto/artefato.
publisher	string	O editor do 3rd Party Artifact que está sendo comprado. Por exemplo, NewRelic
version	string	A versão do produto/artefato desejado.

ProvisioningState

Enumeração

O estado de provisionamento do recurso.

Valor	Description
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Creating	O recurso está sendo criado.
Updating	O recurso está sendo atualizado.
Deleting	O recurso está sendo excluído.

ResourceIdentityType

Enumeração

O tipo de identidade.

Valor	Description
SystemAssigned

Scope

Object

Âmbito da extensão. Pode ser Cluster ou Namespace; mas não ambos.

Name	Tipo	Description
cluster	ScopeCluster	Especifica que o escopo da extensão é Cluster
namespace	ScopeNamespace	Especifica que o escopo da extensão é Namespace

ScopeCluster

Object

Especifica que o escopo da extensão é Cluster

Name	Tipo	Description
releaseNamespace	string	Namespace onde a extensão Release deve ser colocada, para uma extensão com escopo de cluster. Se esse namespace não existir, ele será criado

ScopeNamespace

Object

Especifica que o escopo da extensão é Namespace

Name	Tipo	Description
targetNamespace	string	Namespace onde a extensão será criada para uma extensão com escopo Namespace. Se esse namespace não existir, ele será criado

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.