az fleet clustermeshprofile
Note
This reference is part of the fleet extension for the Azure CLI (version 2.61.0 or higher). The extension will automatically install the first time you run an az fleet clustermeshprofile 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 manage cluster mesh profiles.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az fleet clustermeshprofile apply |
Apply the cluster mesh profile to selected fleet members. |
Extension | Preview |
| az fleet clustermeshprofile create |
Create or update a cluster mesh profile. |
Extension | Preview |
| az fleet clustermeshprofile delete |
Delete a cluster mesh profile. Members must be disconnected from the profile before it can be deleted. |
Extension | Preview |
| az fleet clustermeshprofile list |
List all cluster mesh profiles for a fleet. |
Extension | Preview |
| az fleet clustermeshprofile list-members |
List fleet members for a cluster mesh profile. |
Extension | Preview |
| az fleet clustermeshprofile show |
Get a cluster mesh profile. |
Extension | Preview |
| az fleet clustermeshprofile wait |
Wait for a cluster mesh profile to reach a desired state. |
Extension | Preview |
az fleet clustermeshprofile apply
Command group 'fleet clustermeshprofile' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Apply the cluster mesh profile to selected fleet members.
az fleet clustermeshprofile apply --fleet-name
--name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--no-wait]
[--what-if]
Examples
Apply a cluster mesh profile.
az fleet clustermeshprofile apply -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile
Preview what changes would be made without actually applying.
az fleet clustermeshprofile apply -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile --what-if --output table
Required Parameters
Specify the fleet name.
Specify name for the cluster mesh profile.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
Show what changes would be made by the apply operation without actually performing it.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az fleet clustermeshprofile create
Command group 'fleet clustermeshprofile' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Create or update a cluster mesh profile.
az fleet clustermeshprofile create --fleet-name
--name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--member-selector --selector]
[--no-wait]
Examples
Create a cluster mesh profile with a label selector.
az fleet clustermeshprofile create -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile --selector "env=production"
Create a cluster mesh profile without a selector (no members selected initially).
az fleet clustermeshprofile create -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile
Required Parameters
Specify the fleet name.
Specify name for the cluster mesh profile.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Kubernetes-style label selector for selecting Fleet members, e.g. 'env=production'.
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az fleet clustermeshprofile delete
Command group 'fleet clustermeshprofile' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Delete a cluster mesh profile. Members must be disconnected from the profile before it can be deleted.
az fleet clustermeshprofile delete --fleet-name
--name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--no-wait]
[--yes]
Examples
Delete a specific cluster mesh profile.
az fleet clustermeshprofile delete -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile
Required Parameters
Specify the fleet name.
Specify name for the cluster mesh profile.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
Do not prompt for confirmation.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az fleet clustermeshprofile list
Command group 'fleet clustermeshprofile' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
List all cluster mesh profiles for a fleet.
az fleet clustermeshprofile list --fleet-name
--resource-group
Examples
List all cluster mesh profiles for a given fleet.
az fleet clustermeshprofile list -g MyFleetResourceGroup -f MyFleetName
Required Parameters
Specify the fleet name.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az fleet clustermeshprofile list-members
Command group 'fleet clustermeshprofile' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
List fleet members for a cluster mesh profile.
Without --selector, lists members currently applied to the mesh profile. With --selector, lists members that would match the profile's label selector (i.e. candidates for the next apply).
az fleet clustermeshprofile list-members --fleet-name
--name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--selector]
Examples
List members currently applied to the mesh.
az fleet clustermeshprofile list-members -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile
List members that would match the profile's selector.
az fleet clustermeshprofile list-members -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile --selector
Required Parameters
Specify the fleet name.
Specify name for the cluster mesh profile.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Filter by the profile's label selector (members that would match after apply) instead of currently applied members.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az fleet clustermeshprofile show
Command group 'fleet clustermeshprofile' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Get a cluster mesh profile.
az fleet clustermeshprofile show --fleet-name
--name
--resource-group
Examples
Show the details of a cluster mesh profile.
az fleet clustermeshprofile show -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile
Required Parameters
Specify the fleet name.
Specify name for the cluster mesh profile.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az fleet clustermeshprofile wait
Command group 'fleet clustermeshprofile' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Wait for a cluster mesh profile to reach a desired state.
az fleet clustermeshprofile wait --cluster-mesh-profile-name --name
--fleet-name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Examples
Wait for the cluster mesh profile to reach Connected state after apply.
az fleet clustermeshprofile wait -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile --custom "properties.status.state=='Connected'"
Wait for the cluster mesh profile to be created.
az fleet clustermeshprofile wait -g MyFleetResourceGroup -f MyFleetName -n MyClusterMeshProfile --created
Required Parameters
Specify name for the cluster mesh profile.
Specify the fleet name.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Wait until created with 'provisioningState' at 'Succeeded'.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
Wait until deleted.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Wait until the resource exists.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Polling interval in seconds.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | 30 |
Maximum wait in seconds.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | 3600 |
Wait until updated with provisioningState at 'Succeeded'.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |