Compartilhar via

az ts

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 uma versão de especificação de modelo.

 Core GA
az ts delete

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

 Core GA
az ts export

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

 Core GA
az ts list

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

 Core GA
az ts show

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

 Core GA
az ts update

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

 Core GA

az ts create

Crie uma especificação de modelo e 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 de 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--description

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

--display-name -d

O nome de exibição da especificação de modelo.

--location -l

O local para armazenar as versões template-spec e template-spec. Não é possível alterar após a criação.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas 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 de modelo.

--version -v

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

--version-description

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

--yes -y

Não solicite confirmação.

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az ts delete

Exclua uma especificação de modelo especificada ou 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 de modelo especificada e todas as versões.

az ts delete -g MyResourceGroup --name TemplateSpecName

Exclua a versão especificada da especificação de 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--name -n

O nome da especificação de 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 de modelo.

--version -v

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

--yes -y

Não solicite confirmação.

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az ts export

Exporte a versão e os artefatos de especificação de 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 especificada de especificação de modelo com base na ID do recurso.

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

Exporte a versão especificada de especificação de modelo.

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

Parâmetros Exigidos

--output-folder

Pasta existente para exportação de saída.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--name -n

O nome da especificação de 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 de modelo.

--version -v

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

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az ts list

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

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

Exemplos

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

az ts list

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

az ts list --subscription Subscription

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

az ts list -g MyResourceGroup

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

az ts list -g MyResourceGroup -n TemplateSpecName

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--name -n

O nome da especificação de 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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 de modelo especificada.

az ts show -g testrg --name TemplateSpecName

Mostrar a versão especificada de especificação de modelo.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--name -n

O nome da especificação de 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 de modelo.

--version -v

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

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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 de exibição e as marcas 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 marcas da versão de especificação de modelo sem prompt.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--description

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

--display-name -d

O nome de exibição da especificação de modelo.

--name -n

O nome da especificação de modelo.

--resource-group -g

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

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas 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 de modelo.

--ui-form-definition

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

--version -v

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

--version-description

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

--yes -y

Não solicite confirmação.

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False