Partilhar via

az costmanagement export

  • Referência

Nota

Essa referência faz parte da extensão de gerenciamento de custos da 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

Name 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 Grupo de Gerenciamento

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 Grupo de Recursos

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 Obrigatórios

--name

Nome da exportação.

--scope

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

--storage-account-id

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

--storage-container

O contentor de armazenamento para entregar exportações.

--timeframe

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

Valores aceites: 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 cronograma.

Valores aceites: Annually, Daily, Monthly, Weekly
--recurrence-period

Tem data de início e fim da recorrência. A data de início deve ser futura. Se presente, a data final deve ser maior do 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 do cronograma de exportação. Se estiver inativa, a execução programada da exportação será pausada.

Valores aceites: Active, Inactive
Default value: 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.O TIMESTAMP1 deve no futuro e TIMESTAMP2 deve ser maior que TIMESTAMP1.

--type

O tipo da consulta.

Valores aceites: ActualCost, AmortizedCost, Usage
Default value: Usage
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--name

Nome da exportação.

--scope

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

Parâmetros Opcionais

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

listar exportações em um escopo do Grupo de Gerenciamento

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

listar exportações em um escopo do Grupo de Recursos

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

listar exportações em um escopo de Assinatura

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

Parâmetros Obrigatórios

--scope

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Grupo de Gerenciamento

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

Mostrar uma exportação em um escopo do Grupo de Recursos

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 Obrigatórios

--name

Nome da exportação.

--scope

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Grupo de Gerenciamento

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 Grupo de Recursos

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 Obrigatórios

--name

Nome da exportação.

--scope

O escopo associado às operações de consulta e exportação. Isso inclui '/subscriptions/{subscriptionId}/' para o escopo da assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para o escopo resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para o 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 cronograma.

Valores aceites: Annually, Daily, Monthly, Weekly
--recurrence-period

Tem data de início e fim da recorrência. A data de início deve ser futura. Se presente, a data final deve ser maior do 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 do cronograma de exportação. Se estiver inativa, a execução programada da exportação será pausada.

Valores aceites: Active, Inactive
--storage-account-id

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

--storage-container

O contentor 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.O TIMESTAMP1 deve no futuro e TIMESTAMP2 deve ser maior que TIMESTAMP1.

--timeframe

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

Valores aceites: BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.