Extensions - Create

Služba:

Kubernetes Configuration

Verze rozhraní API:

2025-03-01

Vytvořte nové rozšíření clusteru Kubernetes.

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

Parametry identifikátoru URI

Název	V	Vyžadováno	Typ	Description
clusterName	path	True	string pattern: ^.*	Název clusteru Kubernetes.
clusterResourceName	path	True	string pattern: ^[a-zA-Z]*$	Název zdroje clusteru Kubernetes – tj. managedClusters, connectedClusters, provisionedClusters, appliances.
clusterRp	path	True	string	RP clusteru Kubernetes – tj. Microsoft.ContainerService, Microsoft.Kubernetes, Microsoft.HybridContainerService.
extensionName	path	True	string	Název rozšíření.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Název	Typ	Description
identity	Identity	Identita prostředku rozšíření
managedBy	string (arm-id)	Plně kvalifikované ID prostředku, který tento prostředek spravuje. Označuje, jestli je tento prostředek spravovaný jiným prostředkem Azure. Pokud je k dispozici, úplné nasazení režimu neodstraní prostředek, pokud se odebere ze šablony, protože je spravován jiným prostředkem.
plan	Plan	Podrobnosti plánu zdrojů
properties.additionalDetails	AdditionalDetails	Další podrobnosti poskytl vydavatel rozšíření.
properties.aksAssignedIdentity	ExtensionPropertiesAksAssignedIdentity	Identita prostředku rozšíření v clusteru AKS
properties.autoUpgradeMinorVersion	boolean	Poznamenejte si, jestli se toto rozšíření účastní automatického upgradu podverze, nebo ne.
properties.autoUpgradeMode	AutoUpgradeMode	Režim upgradu pro automatické upgradování. Výchozí je "kompatibilní".
properties.configurationProtectedSettings	object	Nastavení konfigurace, která jsou citlivá, jako páry název-hodnota pro konfiguraci tohoto rozšíření.
properties.configurationSettings	object	Nastavení konfigurace, jako páry název-hodnota pro konfiguraci tohoto rozšíření.
properties.extensionType	string	Typ rozšíření, jehož zdrojem je instance. Musí to být jeden z typů rozšíření registrovaných v Microsoft.KubernetesConfiguration vydavatelem rozšíření.
properties.managementDetails	ManagementDetails	Podrobnosti o řízení prodloužení
properties.releaseTrain	string	ReleaseTrain se toto rozšíření účastní automatického upgradu (např. Stable, Preview atd.) – pouze pokud je autoUpgradeMinorVersion "true".
properties.scope	Scope	Obor, na kterém je rozšíření nainstalované.
properties.statuses	ExtensionStatus[]	Stav z tohoto rozšíření
properties.version	string	Uživatelem zadaná verze rozšíření pro toto rozšíření na "připnout". Pokud chcete použít verzi, musí být autoUpgradeMinorVersion false.

Odpovědi

Název	Typ	Description
200 OK	Extension	Aktualizace "Extension" zdroje byla úspěšná
201 Created	Extension	Operace vytvoření zdroje 'Extension' byla úspěšná Hlavičky Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Název	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create Extension

Create Extension with Plan

Create Extension

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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
  }
}

Stavový kód:

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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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
  }
}

Stavový kód:

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
  }
}

Definice

Název	Description
AccessDetail	Metadata o přístupových detailech spravující entity rozšíření
AdditionalDetails	Další podrobnosti poskytl vydavatel rozšíření.
AKSIdentityType	Typ identity.
AutoUpgradeMode	Režim upgradu pro automatické upgradování. Výchozí je "kompatibilní".
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
Extension	Objekt Extension.
ExtensionPropertiesAksAssignedIdentity	Identita prostředku rozšíření v clusteru AKS
ExtensionStatus	Stav z rozšíření
Identity	Identita prostředku
LevelType	Úroveň stavu.
ManagementDetails	Metadata o spravující entitě rozšíření a povolených operacích.
Plan	Naplánujte zdroj.
ProvisioningState	Stav zřizování prostředku.
ResourceIdentityType	Typ identity.
Scope	Rozsah rozšíření. Může to být cluster nebo obor názvů; ale ne oba.
ScopeCluster	Určuje, že obor rozšíření je Cluster.
ScopeNamespace	Určuje, že obor rozšíření je Obor názvů.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

AccessDetail

Objekt

Metadata o přístupových detailech spravující entity rozšíření

Název	Typ	Description
allowedActions	string[]	Seznam povolených akcí pro entitu
description	string	Popis subjektu
entity	string	Subjekt, na který se vztahují přístupové údaje

AdditionalDetails

Objekt

Další podrobnosti poskytl vydavatel rozšíření.

Název	Typ	Description
docs	string	Dokumentace k prodloužení.
releaseNotes	string	Poznámky k vydání k rozšíření.
troubleshootingGuide	string	Návod na řešení problémů s rozšířením.

AKSIdentityType

Výčet

Typ identity.

Hodnota	Description
SystemAssigned	SystemAssigned identita
UserAssigned	UserAssigned identity
Workload	Identita úloh

AutoUpgradeMode

Výčet

Režim upgradu pro automatické upgradování. Výchozí je "kompatibilní".

Hodnota	Description
none	Rozšíření nebude automaticky aktualizováno.
patch	Rozšíření bude automaticky aktualizováno na nejnovější verzi patche v rámci vedlejší verze.
compatible	Rozšíření bude automaticky aktualizováno na kompatibilní verze podle určení uživatele.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Název	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Název	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Název	Typ	Description
error	ErrorDetail	Objekt chyby.

Extension

Objekt

Objekt Extension.

Název	Typ	Default value	Description
id	string		Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identita prostředku rozšíření
managedBy	string (arm-id)		Plně kvalifikované ID prostředku, který tento prostředek spravuje. Označuje, jestli je tento prostředek spravovaný jiným prostředkem Azure. Pokud je k dispozici, úplné nasazení režimu neodstraní prostředek, pokud se odebere ze šablony, protože je spravován jiným prostředkem.
name	string		Název prostředku
plan	Plan		Podrobnosti plánu zdrojů
properties.additionalDetails	AdditionalDetails		Další podrobnosti poskytl vydavatel rozšíření.
properties.aksAssignedIdentity	ExtensionPropertiesAksAssignedIdentity		Identita prostředku rozšíření v clusteru AKS
properties.autoUpgradeMinorVersion	boolean	True	Poznamenejte si, jestli se toto rozšíření účastní automatického upgradu podverze, nebo ne.
properties.autoUpgradeMode	AutoUpgradeMode	compatible	Režim upgradu pro automatické upgradování. Výchozí je "kompatibilní".
properties.configurationProtectedSettings	object		Nastavení konfigurace, která jsou citlivá, jako páry název-hodnota pro konfiguraci tohoto rozšíření.
properties.configurationSettings	object		Nastavení konfigurace, jako páry název-hodnota pro konfiguraci tohoto rozšíření.
properties.currentVersion	string		Aktuálně nainstalovaná verze rozšíření
properties.customLocationSettings	object		Vlastnosti vlastního nastavení umístění.
properties.errorInfo	ErrorDetail		Informace o chybách z agenta – například chyby během instalace.
properties.extensionState	string		Stav rozšíření na clusteru.
properties.extensionType	string		Typ rozšíření, jehož zdrojem je instance. Musí to být jeden z typů rozšíření registrovaných v Microsoft.KubernetesConfiguration vydavatelem rozšíření.
properties.isSystemExtension	boolean	False	Označení příznakem pro upozornění, pokud se jedná o systémové rozšíření
properties.managementDetails	ManagementDetails		Podrobnosti o řízení prodloužení
properties.packageUri	string		Identifikátor URI balíčku Helm
properties.provisioningState	ProvisioningState		Stav instalace tohoto rozšíření
properties.releaseTrain	string	Stable	ReleaseTrain se toto rozšíření účastní automatického upgradu (např. Stable, Preview atd.) – pouze pokud je autoUpgradeMinorVersion "true".
properties.scope	Scope		Obor, na kterém je rozšíření nainstalované.
properties.statuses	ExtensionStatus[]		Stav z tohoto rozšíření
properties.version	string		Uživatelem zadaná verze rozšíření pro toto rozšíření na "připnout". Pokud chcete použít verzi, musí být autoUpgradeMinorVersion false.
systemData	systemData		Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string		Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ExtensionPropertiesAksAssignedIdentity

Objekt

Identita prostředku rozšíření v clusteru AKS

Název	Typ	Description
clientId	string	Client ID identity zdroje.
objectId	string	ID objektu identity zdroje.
principalId	string	ID objektu zabezpečení identity prostředku.
resourceId	string (arm-id)	ID identity zdroje.
tenantId	string	ID tenanta prostředku.
type	AKSIdentityType	Typ identity.

ExtensionStatus

Objekt

Stav z rozšíření

Název	Typ	Default value	Description
code	string		Stavový kód poskytnutý rozšířením
displayStatus	string		Stručný popis stavu rozšíření.
level	LevelType	Information	Úroveň stavu.
message	string		Podrobná zpráva o stavu rozšíření
time	string		DatumLiteral (podle ISO8601) s upozorněním na čas instalace.

Identity

Objekt

Identita prostředku

Název	Typ	Description
principalId	string	ID objektu zabezpečení identity prostředku.
tenantId	string	ID tenanta prostředku.
type	ResourceIdentityType	Typ identity.

LevelType

Výčet

Úroveň stavu.

Hodnota	Description
Error	Označuje stav chyby z rozšíření.
Warning	Ukazuje varovný stav z rozšíření.
Information	Označuje informační status z prodloužení.

ManagementDetails

Objekt

Metadata o spravující entitě rozšíření a povolených operacích.

Název	Typ	Description
accessDetails	AccessDetail[]	Seznam přístupových údajů spravující entity
category	string	Kategorie řídícího subjektu

Plan

Objekt

Naplánujte zdroj.

Název	Typ	Description
name	string	Uživatelem definovaný název artefaktu třetí strany, který se pořizován.
product	string	Artefakt třetí strany, který se pořizován Např. NewRelic. Produkt se mapuje na OfferID zadané pro artefakt v době onboardingu Data Marketu.
promotionCode	string	Vydavatel poskytl propagační kód zřízený na data Marketu pro uvedený produkt nebo artefakt.
publisher	string	Vydavatel artefaktu třetí strany, který se kupuje. Např. NewRelic
version	string	Verze požadovaného produktu nebo artefaktu.

ProvisioningState

Výčet

Stav zřizování prostředku.

Hodnota	Description
Succeeded	Zdroj byl vytvořen.
Failed	Vytvoření zdroje se nezdařilo.
Canceled	Vytváření zdrojů bylo zrušeno.
Creating	Vytváří se zdroj.
Updating	Zdroj se aktualizuje.
Deleting	Prostředek se odstraňuje.

ResourceIdentityType

Výčet

Typ identity.

Hodnota	Description
SystemAssigned

Scope

Objekt

Rozsah rozšíření. Může to být cluster nebo obor názvů; ale ne oba.

Název	Typ	Description
cluster	ScopeCluster	Určuje, že obor rozšíření je Cluster.
namespace	ScopeNamespace	Určuje, že obor rozšíření je Obor názvů.

ScopeCluster

Objekt

Určuje, že obor rozšíření je Cluster.

Název	Typ	Description
releaseNamespace	string	Obor názvů, kde musí být umístěna verze rozšíření pro rozšíření s vymezeným oborem clusteru. Pokud tento obor názvů neexistuje, vytvoří se.

ScopeNamespace

Objekt

Určuje, že obor rozšíření je Obor názvů.

Název	Typ	Description
targetNamespace	string	Obor názvů, ve kterém se rozšíření vytvoří pro rozšíření s oborem názvů Pokud tento obor názvů neexistuje, vytvoří se.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Název	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.