Compartilhar via

az ts

  • Referência

Gerenciar especificações de modelo no escopo da assinatura ou do grupo de recursos.

Comandos

Nome Description Tipo Status
az ts create

Crie uma especificação de modelo e/ou uma versão de especificação de modelo.

 Núcleo GA
az ts delete

Exclua uma especificação de modelo especificada ou uma versão de especificação de modelo por nome ou ID de recurso..

 Núcleo GA
az ts export

Exporte a versão e os artefatos de especificação do modelo especificados (se houver) para a pasta de saída especificada.

 Núcleo GA
az ts list

Listar especificações de modelo ou versões de especificações de modelo.

 Núcleo GA
az ts show

Obtenha a especificação de modelo especificada ou a versão de especificação de modelo.

 Núcleo GA
az ts update

Atualize uma versão de especificação de modelo.

 Núcleo GA

az ts create

Crie uma especificação de modelo e/ou uma versão de especificação de modelo.

az ts create --name
             --resource-group
             [--description]
             [--display-name]
             [--location]
             [--tags]
             [--template-file]
             [--ui-form-definition]
             [--version]
             [--version-description]
             [--yes]

Exemplos

Crie uma especificação de modelo.

az ts create -g testRG --name TemplateSpecName -l WestUS --display-name "MyDisplayName" --description "Simple template spec" --tags key1=value1

Crie uma versão de especificação de modelo.

az ts create -g testRG --name TemplateSpecName -v 2.0 -l WestUS --template-file templateSpec.json --version-description "Less simple template spec" --tags key1=value1 key3=value3

Crie uma especificação de modelo e uma versão da especificação de modelo.

az ts create -g testRG --name TemplateSpecName -v 1.0 -l WestUS --template-file templateSpec.json --display-name "MyDisplayName" --description "Simple template spec" --version-description "Version of simple template spec" --tags key1=value1 key2=value2

Parâmetros Exigidos

--name -n

O nome da especificação do modelo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--description

A descrição da especificação do modelo pai.

--display-name -d

O nome para exibição da especificação do modelo.

--location -l

O local para armazenar a(s) versão(ões) template-spec e template-spec. Não pode ser alterado após a criação.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--template-file -f

Um caminho para um arquivo de modelo ou arquivo Bicep no sistema de arquivos.

--ui-form-definition

O caminho do arquivo uiFormDefinition no sistema de arquivos para a versão de especificação do modelo.

--version -v

A versão de especificação do modelo.

--version-description

A descrição da versão de especificação do modelo.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ts delete

Exclua uma especificação de modelo especificada ou uma versão de especificação de modelo por nome ou ID de recurso..

az ts delete [--name]
             [--resource-group]
             [--template-spec]
             [--version]
             [--yes]

Exemplos

Exclua a especificação do modelo especificado e todas as versões.

az ts delete -g MyResourceGroup --name TemplateSpecName

Exclua a versão especificada da especificação do modelo.

az ts delete -g MyResourceGroup --name TemplateSpecName --version VersionName

Exclua a especificação ou a versão do modelo com base na ID do recurso.

az ts delete --template-spec resourceID

Parâmetros Opcionais

--name -n

O nome da especificação do modelo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--template-spec -s

A id do recurso de especificação do modelo.

--version -v

A versão de especificação do modelo.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ts export

Exporte a versão e os artefatos de especificação do modelo especificados (se houver) para a pasta de saída especificada.

az ts export --output-folder
             [--name]
             [--resource-group]
             [--template-spec]
             [--version]

Exemplos

Exporte a versão de especificação do modelo especificado com base na ID do recurso.

az ts export -s resourceID --output-folder C:/path/

Exporte a versão de especificação do modelo especificado.

az ts export -g testrg --name TemplateSpecName --version VersionName --output-folder C:/path/

Parâmetros Exigidos

--output-folder

Pasta existente para exportação(ões) de saída.

Parâmetros Opcionais

--name -n

O nome da especificação do modelo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--template-spec -s

A id do recurso de especificação do modelo.

--version -v

A versão de especificação do modelo.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ts list

Listar especificações de modelo ou versões de especificações de modelo.

az ts list [--name]
           [--resource-group]

Exemplos

Liste todas as especificações do modelo na assinatura padrão atual.

az ts list

Liste todas as especificações do modelo na assinatura especificada.

az ts list --subscription Subscription

Listar todas as especificações do modelo no grupo de recursos.

az ts list -g MyResourceGroup

Listar todas as versões da especificação do modelo pai.

az ts list -g MyResourceGroup -n TemplateSpecName

Parâmetros Opcionais

--name -n

O nome da especificação do modelo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ts show

Obtenha a especificação de modelo especificada ou a versão de especificação de modelo.

az ts show [--name]
           [--resource-group]
           [--template-spec]
           [--version]

Exemplos

Mostrar a especificação do modelo especificado.

az ts show -g testrg --name TemplateSpecName

Mostrar a versão de especificação do modelo especificado.

az ts show -g testrg --name TemplateSpecName --version VersionName

Mostrar a especificação de modelo especificada ou a versão de especificação de modelo com base na ID do recurso.

az ts show --template-spec resourceID

Parâmetros Opcionais

--name -n

O nome da especificação do modelo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--template-spec -s

A id do recurso de especificação do modelo.

--version -v

A versão de especificação do modelo.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ts update

Atualize uma versão de especificação de modelo.

az ts update [--description]
             [--display-name]
             [--name]
             [--resource-group]
             [--tags]
             [--template-file]
             [--template-spec]
             [--ui-form-definition]
             [--version]
             [--version-description]
             [--yes]

Exemplos

Atualize o conteúdo do modelo de uma especificação de modelo ou versão de especificação de modelo com base na ID do recurso.

az ts update --template-spec resourceID -f updatedFile.json

Atualize o nome para exibição e a(s) tag(s) de uma especificação de modelo com base na ID do recurso.

az ts update --template-spec resourceID --display-name "NewParentDisplayName" --tags key1=value1

Atualize a descrição de uma versão de especificação de modelo sem prompt.

az ts update -g ExistingRG --name ExistingName -v 3.0 --version-description "New description" --yes

Atualize todas as propriedades de uma versão de especificação de modelo.

az ts update -g ExistingRG --name ExistingName -v 3.0 -f updatedTemplate.json --display-name "New parent display name" --description "New parent description" --version-description "New child description" --ui-form-definition formDefinition.json

Remova a(s) tag(s) da versão de especificação do modelo sem prompt.

az ts update -g ExistingRG --name ExistingName -v 3.0 -f updatedTemplate.json --tags --yes

Parâmetros Opcionais

--description

A descrição da especificação do modelo pai.

--display-name -d

O nome para exibição da especificação do modelo.

--name -n

O nome da especificação do modelo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--template-file -f

Um caminho para um arquivo de modelo ou arquivo Bicep no sistema de arquivos.

--template-spec -s

A id do recurso de especificação do modelo.

--ui-form-definition

O caminho do arquivo uiFormDefinition no sistema de arquivos para a versão de especificação do modelo.

--version -v

A versão de especificação do modelo.

--version-description

A descrição da versão de especificação do modelo.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.