Compartilhar via

az costmanagement export

  • Referência

Observação

Essa referência faz parte da extensão de gerenciamento de custos para a CLI do Azure (versão 2.55.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az costmanagement export . Saiba mais sobre extensões.

Gestão de custos de exportação.

Comandos

Nome Description Tipo Status
az costmanagement export create

A operação para criar uma exportação.

 Extensão GA
az costmanagement export delete

A operação para excluir uma exportação.

 Extensão GA
az costmanagement export list

A operação para listar todas as exportações no escopo determinado.

 Extensão GA
az costmanagement export show

A operação para obter o histórico de execução de uma exportação para o escopo definido por nome de exportação.

 Extensão GA
az costmanagement export update

A operação para atualizar uma exportação.

 Extensão GA

az costmanagement export create

A operação para criar uma exportação.

az costmanagement export create --name
                                --scope
                                --storage-account-id
                                --storage-container
                                --timeframe {BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate}
                                [--dataset-configuration]
                                [--recurrence {Annually, Daily, Monthly, Weekly}]
                                [--recurrence-period]
                                [--schedule-status {Active, Inactive}]
                                [--storage-directory]
                                [--time-period]
                                [--type {ActualCost, AmortizedCost, Usage}]

Exemplos

Criar uma exportação para o escopo do ManagementGroup

az costmanagement export create --name "TestExport" --type "Usage" --dataset-configuration columns="Date" columns="MeterId" columns="InstanceId" columns="ResourceLocation" columns="PreTaxCost" --timeframe "MonthToDate" --storage-container="exports" --storage-account-id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182" --storage-directory="ad-hoc" --recurrence "Weekly" --recurrence-period from="2018-06-01T00:00:00Z" to="2018-10-31T00:00:00Z" --schedule-status "Active" --scope "providers/Microsoft.Management/managementGroups/TestMG"

Criar uma exportação para o escopo do ResourceGroup

az costmanagement export create --name "TestExport" --type "Usage" --dataset-configuration columns="Date" columns="MeterId" columns="InstanceId" columns="ResourceLocation" columns="PreTaxCost" --timeframe "MonthToDate" --storage-container="exports" --storage-account-id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182" --storage-directory="ad-hoc" --recurrence "Weekly" --recurrence-period from="2018-06-01T00:00:00Z" to="2018-10-31T00:00:00Z" --schedule-status "Active" --scope "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG"

Criar uma exportação para o escopo da Assinatura

az costmanagement export create --name "TestExport" --type "Usage" --dataset-configuration columns="Date" columns="MeterId" columns="InstanceId" columns="ResourceLocation" columns="PreTaxCost" --timeframe "MonthToDate" --storage-container="exports" --storage-account-id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182" --storage-directory="ad-hoc" --recurrence "Weekly" --recurrence-period from="2018-06-01T00:00:00Z" to="2018-10-31T00:00:00Z" --schedule-status "Active" --scope "subscriptions/00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--name

Nome da exportação.

--scope

O escopo associado às operações de consulta e exportação. Isso inclui '/subscriptions/{subscriptionId}/' para escopo de assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para escopo resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para escopo do Grupo de Gerenciamento.

--storage-account-id

O ID da conta de armazenamento para armazenar exportações.

--storage-container

O contêiner de armazenamento para entregar exportações.

--timeframe

O período de tempo para extrair dados para a consulta. Se for costume, então um período de tempo específico deve ser fornecido.

valores aceitos: BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate

Parâmetros Opcionais

--dataset-configuration

Tem informações de configuração para os dados na exportação. A configuração será ignorada se a agregação e o agrupamento forem fornecidos. Valor esperado: columns=xx.

--recurrence

A recorrência do agendamento.

valores aceitos: Annually, Daily, Monthly, Weekly
--recurrence-period

Tem data de início e término da recorrência. A data de início deve ser no futuro. Se presente, a data de término deve ser maior que a data de início. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... , as CHAVES disponíveis são: de, para. O formato de hora é como 2020-05-01T00:00:00.

--schedule-status

O status da agenda de exportação. Se inativa, a execução agendada da exportação é pausada.

valores aceitos: Active, Inactive
valor padrão: Inactive
--storage-directory

O diretório raiz no contêiner de armazenamento para armazenar exportações.

--time-period

Tem período de tempo para extrair dados para a consulta. Valor esperado: from=TIMESTAMP1 to=TIMESTAMP2. O formato de carimbo de data/hora é como 2020-05-01T00:00:00.The TIMESTAMP1 deve no futuro e TIMESTAMP2 deve ser maior do que TIMESTAMP1.

--type

O tipo da consulta.

valores aceitos: ActualCost, AmortizedCost, Usage
valor padrão: Usage
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 costmanagement export delete

A operação para excluir uma exportação.

az costmanagement export delete --name
                                --scope
                                [--yes]

Exemplos

excluir uma exportação para um escopo do Grupo de Gerenciamento

az costmanagement export delete --name "TestExport" --scope "providers/Microsoft.Management/managementGroups/TestMG"

excluir uma exportação para o escopo do Grupo de Recursos

az costmanagement export delete --name "TestExport" --scope "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG"

excluir uma exportação para o escopo da Assinatura

az costmanagement export delete --name "TestExport" --scope "subscriptions/00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--name

Nome da exportação.

--scope

O escopo associado às operações de consulta e exportação. Isso inclui '/subscriptions/{subscriptionId}/' para escopo de assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para escopo resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para escopo do Grupo de Gerenciamento.

Parâmetros Opcionais

--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 costmanagement export list

A operação para listar todas as exportações no escopo determinado.

az costmanagement export list --scope

Exemplos

exportações de lista em um escopo do ManagementGroup

az costmanagement export list --scope "providers/Microsoft.Management/managementGroups/TestMG"

exportações de lista em um escopo do ResourceGroup

az costmanagement export list --scope "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG"

exportações de lista em um escopo de Assinatura

az costmanagement export list --scope "subscriptions/00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--scope

O escopo associado às operações de consulta e exportação. Isso inclui '/subscriptions/{subscriptionId}/' para escopo de assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para escopo resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para escopo do Grupo de Gerenciamento.

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 costmanagement export show

A operação para obter o histórico de execução de uma exportação para o escopo definido por nome de exportação.

az costmanagement export show --name
                              --scope

Exemplos

Mostrar uma exportação em um escopo do ManagementGroup

az costmanagement export show --name "TestExport" --scope "providers/Microsoft.Management/managementGroups/TestMG"

Mostrar uma exportação em um escopo do ResourceGroup

az costmanagement export show --name "TestExport" --scope "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG"

Mostrar uma exportação em um escopo de Assinatura

az costmanagement export show --name "TestExport" --scope "subscriptions/00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--name

Nome da exportação.

--scope

O escopo associado às operações de consulta e exportação. Isso inclui '/subscriptions/{subscriptionId}/' para escopo de assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para escopo resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para escopo do Grupo de Gerenciamento.

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 costmanagement export update

A operação para atualizar uma exportação.

az costmanagement export update --name
                                --scope
                                [--dataset-configuration]
                                [--recurrence {Annually, Daily, Monthly, Weekly}]
                                [--recurrence-period]
                                [--schedule-status {Active, Inactive}]
                                [--storage-account-id]
                                [--storage-container]
                                [--storage-directory]
                                [--time-period]
                                [--timeframe {BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate}]

Exemplos

Atualizar uma exportação em um escopo do ManagementGroup

az costmanagement export update --name "TestExport" --dataset-configuration columns="Date" columns="MeterId" columns="InstanceId" columns="ResourceLocation" columns="PreTaxCost" --timeframe "MonthToDate" --storage-container="exports" --storage-account-id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182" --storage-directory="ad-hoc" --recurrence "Weekly" --recurrence-period from="2018-06-01T00:00:00Z" to="2018-10-31T00:00:00Z" --schedule-status "Active" --scope "providers/Microsoft.Management/managementGroups/TestMG"

Atualizar uma exportação em um escopo do ResourceGroup

az costmanagement export update --name "TestExport" --dataset-configuration columns="Date" columns="MeterId" columns="InstanceId" columns="ResourceLocation" columns="PreTaxCost" --timeframe "MonthToDate" --storage-container="exports" --storage-account-id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182" --storage-directory="ad-hoc" --recurrence "Weekly" --recurrence-period from="2018-06-01T00:00:00Z" to="2018-10-31T00:00:00Z" --schedule-status "Active" --scope "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG"

Atualizar uma exportação em um escopo de Assinatura

az costmanagement export update --name "TestExport" --dataset-configuration columns="Date" columns="MeterId" columns="InstanceId" columns="ResourceLocation" columns="PreTaxCost" --timeframe "MonthToDate" --storage-container="exports" --storage-account-id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182" --storage-directory="ad-hoc" --recurrence "Weekly" --recurrence-period from="2018-06-01T00:00:00Z" to="2018-10-31T00:00:00Z" --schedule-status "Active" --scope "subscriptions/00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--name

Nome da exportação.

--scope

O escopo associado às operações de consulta e exportação. Isso inclui '/subscriptions/{subscriptionId}/' para escopo de assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para escopo resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para escopo do Grupo de Gerenciamento.

Parâmetros Opcionais

--dataset-configuration

Tem informações de configuração para os dados na exportação. A configuração será ignorada se a agregação e o agrupamento forem fornecidos. Valor esperado: columns=xx.

--recurrence

A recorrência do agendamento.

valores aceitos: Annually, Daily, Monthly, Weekly
--recurrence-period

Tem data de início e término da recorrência. A data de início deve ser no futuro. Se presente, a data de término deve ser maior que a data de início. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... , as CHAVES disponíveis são: de, para. O formato de hora é como 2020-05-01T00:00:00.

--schedule-status

O status da agenda de exportação. Se inativa, a execução agendada da exportação é pausada.

valores aceitos: Active, Inactive
--storage-account-id

O ID da conta de armazenamento para armazenar exportações.

--storage-container

O contêiner de armazenamento para entregar exportações.

--storage-directory

O diretório raiz no contêiner de armazenamento para armazenar exportações.

--time-period

Tem período de tempo para extrair dados para a consulta. Valor esperado: from=TIMESTAMP1 to=TIMESTAMP2. O formato de carimbo de data/hora é como 2020-05-01T00:00:00.The TIMESTAMP1 deve no futuro e TIMESTAMP2 deve ser maior do que TIMESTAMP1.

--timeframe

O período de tempo para extrair dados para a consulta. Se for costume, então um período de tempo específico deve ser fornecido.

valores aceitos: BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate
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.