az k8s-extension extension-types

Note

This reference is part of the k8s-extension extension for the Azure CLI (version 2.51.0 or higher). The extension will automatically install the first time you run an az k8s-extension extension-types command. Learn more about extensions.

This command group is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Commands to discover Kubernetes Extension Types.

Commands

Name Description Type Status
az k8s-extension extension-types list

List available Cluster Extension Types for an existing cluster.

Extension Preview and Deprecated
az k8s-extension extension-types list-by-cluster

List available Cluster Extension Types for an existing cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

Extension Preview
az k8s-extension extension-types list-by-location

List available Cluster Extension Types in a region.

Extension Preview
az k8s-extension extension-types list-versions

List available versions for a Cluster Extension Type for a given cluster.

Extension Preview and Deprecated
az k8s-extension extension-types list-versions-by-cluster

List available versions for a Cluster Extension Type for a given cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

Extension Preview
az k8s-extension extension-types list-versions-by-location

List available versions for a Cluster Extension Type versions in a region.

Extension Preview
az k8s-extension extension-types show

Get properties for a Cluster Extension Type in a region.

Extension Preview and Deprecated
az k8s-extension extension-types show-by-cluster

Show properties for a Cluster Extension Type for an existing cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

Extension Preview
az k8s-extension extension-types show-by-location

Show properties for a Cluster Extension Type in a region.

Extension Preview
az k8s-extension extension-types show-version-by-cluster

Show properties associated with a Cluster Extension Type version for an existing cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

Extension Preview
az k8s-extension extension-types show-version-by-location

Show properties associated with a Cluster Extension Type version in a region.

Extension Preview

az k8s-extension extension-types list

Preview Deprecated

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command has been deprecated and will be removed in a future release. Use 'az k8s-extension extension-types list-by-cluster' instead.

List available Cluster Extension Types for an existing cluster.

az k8s-extension extension-types list --cluster-name
                                      --cluster-type {appliances, connectedClusters, managedClusters}
                                      --resource-group
                                      [--plan-name]
                                      [--plan-product]
                                      [--plan-publisher]
                                      [--release-train]

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--plan-name

The plan name is referring to the Marketplace Plan ID of the extension.

--plan-product

The plan product is referring to the Marketplace Product ID of the extension.

--plan-publisher

The plan publisher is referring to the Marketplace Publisher ID of the extension.

--release-train

Specify the release train for the extension type.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types list-by-cluster

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List available Cluster Extension Types for an existing cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

az k8s-extension extension-types list-by-cluster --cluster-name
                                                 --cluster-type {appliances, connectedClusters, managedClusters}
                                                 --resource-group
                                                 [--plan-name]
                                                 [--plan-product]
                                                 [--plan-publisher]
                                                 [--release-train]

Examples

List available Cluster Extension Types for an existing cluster

az k8s-extension extension-types list-by-cluster --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--plan-name

The plan name is referring to the Marketplace Plan ID of the extension.

--plan-product

The plan product is referring to the Marketplace Product ID of the extension.

--plan-publisher

The plan publisher is referring to the Marketplace Publisher ID of the extension.

--release-train

Specify the release train for the extension type.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types list-by-location

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List available Cluster Extension Types in a region.

az k8s-extension extension-types list-by-location --location
                                                  [--cluster-type {appliances, connectedClusters, managedClusters}]
                                                  [--plan-name]
                                                  [--plan-product]
                                                  [--plan-publisher]
                                                  [--release-train]

Examples

List available Cluster Extension Types in a region

az k8s-extension extension-types list-by-location --location eastus

Required Parameters

--location -l

Name of the location. Values from: az account list-locations.

Optional Parameters

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--plan-name

The plan name is referring to the Marketplace Plan ID of the extension.

--plan-product

The plan product is referring to the Marketplace Product ID of the extension.

--plan-publisher

The plan publisher is referring to the Marketplace Publisher ID of the extension.

--release-train

Specify the release train for the extension type.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types list-versions

Preview Deprecated

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command has been deprecated and will be removed in a future release. Use 'az k8s-extension extension-types list-versions-by-cluster' instead.

List available versions for a Cluster Extension Type for a given cluster.

az k8s-extension extension-types list-versions --cluster-name
                                               --cluster-type {appliances, connectedClusters, managedClusters}
                                               --extension-type
                                               --resource-group
                                               [--major-version]
                                               [--release-train]
                                               [--show-latest {false, true}]

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--extension-type

Name of the extension type.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--major-version

Filter results by only the major version of an extension type. For example if 1 is specified, all versions with major version 1 (1.1, 1.1.2) will be shown. The default value is None.

--release-train

Specify the release train for the extension type.

--show-latest

Filter results by only the latest version. For example, if this flag is used the latest version of the extensionType will be shown.

accepted values: false, true
default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types list-versions-by-cluster

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List available versions for a Cluster Extension Type for a given cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

az k8s-extension extension-types list-versions-by-cluster --cluster-name
                                                          --cluster-type {appliances, connectedClusters, managedClusters}
                                                          --extension-type
                                                          --resource-group
                                                          [--major-version]
                                                          [--release-train]
                                                          [--show-latest {false, true}]

Examples

List available versions for a Cluster Extension Type for a given cluster

az k8s-extension extension-types list-versions-by-cluster --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --extension-type microsoft.flux

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--extension-type

Name of the extension type.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--major-version

Filter results by only the major version of an extension type. For example if 1 is specified, all versions with major version 1 (1.1, 1.1.2) will be shown. The default value is None.

--release-train

Specify the release train for the extension type.

--show-latest

Filter results by only the latest version. For example, if this flag is used the latest version of the extensionType will be shown.

accepted values: false, true
default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types list-versions-by-location

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List available versions for a Cluster Extension Type versions in a region.

az k8s-extension extension-types list-versions-by-location --extension-type
                                                           --location
                                                           [--cluster-type {appliances, connectedClusters, managedClusters}]
                                                           [--major-version]
                                                           [--release-train]
                                                           [--show-latest {false, true}]

Examples

List available versions for a Cluster Extension Type versions in a region

az k8s-extension extension-types list-versions-by-location --location eastus --extension-type microsoft.flux

Required Parameters

--extension-type

Name of the extension type.

--location -l

Name of the location. Values from: az account list-locations.

Optional Parameters

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--major-version

Filter results by only the major version of an extension type. For example if 1 is specified, all versions with major version 1 (1.1, 1.1.2) will be shown. The default value is None.

--release-train

Specify the release train for the extension type.

--show-latest

Filter results by only the latest version. For example, if this flag is used the latest version of the extensionType will be shown.

accepted values: false, true
default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types show

Preview Deprecated

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command has been deprecated and will be removed in a future release. Use 'az k8s-extension extension-types show-by-cluster' instead.

Get properties for a Cluster Extension Type in a region.

az k8s-extension extension-types show --extension-type
                                      --location

Required Parameters

--extension-type

Name of the extension type.

--location -l

Name of the location. Values from: az account list-locations.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types show-by-cluster

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Show properties for a Cluster Extension Type for an existing cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

az k8s-extension extension-types show-by-cluster --cluster-name
                                                 --cluster-type {appliances, connectedClusters, managedClusters}
                                                 --extension-type
                                                 --resource-group

Examples

Show properties for a Cluster Extension Type for an existing cluster

az k8s-extension extension-types show-by-cluster --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --extension-type microsoft.openservicemesh

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--extension-type

Name of the extension type.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types show-by-location

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Show properties for a Cluster Extension Type in a region.

az k8s-extension extension-types show-by-location --extension-type
                                                  --location

Examples

Show properties for a Cluster Extension Type in a region

az k8s-extension extension-types show-by-location --location eastus --extension-type microsoft.openservicemesh

Required Parameters

--extension-type

Name of the extension type.

--location -l

Name of the location. Values from: az account list-locations.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types show-version-by-cluster

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Show properties associated with a Cluster Extension Type version for an existing cluster. The properties used for filtering include type of cluster (managed, connected, etc), kubernetes version, location of the cluster.

az k8s-extension extension-types show-version-by-cluster --cluster-name
                                                         --cluster-type {appliances, connectedClusters, managedClusters}
                                                         --extension-type
                                                         --resource-group
                                                         --version

Examples

Show properties associated with a Cluster Extension Type version for an existing cluster

az k8s-extension extension-types show-version-by-cluster --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --extension-type microsoft.openservicemesh --version 1.0.0

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances.

accepted values: appliances, connectedClusters, managedClusters
--extension-type

Name of the extension type.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--version

Version for the extension type.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension extension-types show-version-by-location

Preview

Command group 'k8s-extension extension-types' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Show properties associated with a Cluster Extension Type version in a region.

az k8s-extension extension-types show-version-by-location --extension-type
                                                          --location
                                                          --version

Examples

Show properties associated with a Cluster Extension Type version in a region.

az k8s-extension extension-types show-version-by-location --location eastus --extension-type microsoft.openservicemesh --version 1.0.0

Required Parameters

--extension-type

Name of the extension type.

--location -l

Name of the location. Values from: az account list-locations.

--version

Version for the extension type.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.