Partilhar via


az costmanagement export

Note

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.

Extension disponibilidade geral
az costmanagement export delete

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

Extension disponibilidade geral
az costmanagement export list

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

Extension disponibilidade geral
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.

Extension disponibilidade geral
az costmanagement export update

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

Extension disponibilidade geral

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.

Propriedade Valor
Grupo de parâmetros: Delivery Destination Info Arguments
--storage-container

O contentor de armazenamento para entregar exportações.

Propriedade Valor
Grupo de parâmetros: Delivery Destination Info Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Export Definition Arguments
Valores aceites: BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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.

Propriedade Valor
Grupo de parâmetros: Export Definition Arguments
--recurrence

A recorrência do cronograma.

Propriedade Valor
Grupo de parâmetros: Schedule Info Arguments
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.

Propriedade Valor
Grupo de parâmetros: Schedule Info Arguments
--schedule-status

O status do cronograma de exportação. Se estiver inativa, a execução programada da exportação será pausada.

Propriedade Valor
Grupo de parâmetros: Schedule Info Arguments
Default value: Inactive
Valores aceites: Active, Inactive
--storage-directory

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

Propriedade Valor
Grupo de parâmetros: Delivery Destination Info Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Export Definition Arguments
--type

O tipo da consulta.

Propriedade Valor
Grupo de parâmetros: Export Definition Arguments
Default value: Usage
Valores aceites: ActualCost, AmortizedCost, Usage
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--yes -y

Não solicite confirmação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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.

Propriedade Valor
Grupo de parâmetros: Export Definition Arguments
--recurrence

A recorrência do cronograma.

Propriedade Valor
Grupo de parâmetros: Schedule Info Arguments
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.

Propriedade Valor
Grupo de parâmetros: Schedule Info Arguments
--schedule-status

O status do cronograma de exportação. Se estiver inativa, a execução programada da exportação será pausada.

Propriedade Valor
Grupo de parâmetros: Schedule Info Arguments
Valores aceites: Active, Inactive
--storage-account-id

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

Propriedade Valor
Grupo de parâmetros: Delivery Destination Info Arguments
--storage-container

O contentor de armazenamento para entregar exportações.

Propriedade Valor
Grupo de parâmetros: Delivery Destination Info Arguments
--storage-directory

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

Propriedade Valor
Grupo de parâmetros: Delivery Destination Info Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Export Definition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Export Definition Arguments
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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False