Compartir a través de


az costmanagement export

Note

Esta referencia forma parte de la extensión costmanagement para la CLI de Azure (versión 2.55.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az costmanagement export. Obtenga más información sobre las extensiones.

Exportación de Costmanagement.

Comandos

Nombre Description Tipo Estado
az costmanagement export create

Operación para crear una exportación.

Extension GA
az costmanagement export delete

Operación para eliminar una exportación.

Extension GA
az costmanagement export list

Operación para enumerar todas las exportaciones en el ámbito especificado.

Extension GA
az costmanagement export show

Operación para obtener el historial de ejecución de una exportación para el ámbito definido por nombre de exportación.

Extension GA
az costmanagement export update

Operación para actualizar una exportación.

Extension GA

az costmanagement export create

Operación para crear una exportación.

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}]

Ejemplos

Creación de una exportación para el ámbito 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"

Creación de una exportación para el ámbito de 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"

Creación de una exportación para el ámbito de suscripción

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 requeridos

--name

Nombre de exportación.

--scope

Ámbito asociado a las operaciones de consulta y exportación. Esto incluye '/subscriptions/{subscriptionId}/' para el ámbito de la suscripción, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para el ámbito del grupo de administración.

--storage-account-id

Identificador de la cuenta de almacenamiento para almacenar las exportaciones.

Propiedad Valor
Grupo de parámetros: Delivery Destination Info Arguments
--storage-container

Contenedor de almacenamiento para entregar exportaciones.

Propiedad Valor
Grupo de parámetros: Delivery Destination Info Arguments
--timeframe

Período de tiempo para extraer datos de la consulta. Si es personalizado, se debe proporcionar un período de tiempo específico.

Propiedad Valor
Grupo de parámetros: Export Definition Arguments
Valores aceptados: BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--dataset-configuration

Tiene información de configuración para los datos de la exportación. La configuración se omitirá si se proporcionan la agregación y la agrupación. Valor esperado: columns=xx.

Propiedad Valor
Grupo de parámetros: Export Definition Arguments
--recurrence

Periodicidad de la programación.

Propiedad Valor
Grupo de parámetros: Schedule Info Arguments
Valores aceptados: Annually, Daily, Monthly, Weekly
--recurrence-period

Tiene la fecha de inicio y finalización de la periodicidad. La fecha de inicio debe estar en el futuro. Si está presente, la fecha de finalización debe ser mayor que la fecha de inicio. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... , los KEY disponibles son: de a. El formato de hora es como 2020-05-01T00:00:00.

Propiedad Valor
Grupo de parámetros: Schedule Info Arguments
--schedule-status

Estado de la programación de la exportación. Si está inactivo, la ejecución programada de la exportación se pausa.

Propiedad Valor
Grupo de parámetros: Schedule Info Arguments
Valor predeterminado: Inactive
Valores aceptados: Active, Inactive
--storage-directory

Directorio raíz del contenedor de almacenamiento que se va a almacenar las exportaciones.

Propiedad Valor
Grupo de parámetros: Delivery Destination Info Arguments
--time-period

Tiene un período de tiempo para extraer datos de la consulta. Valor esperado: from=TIMESTAMP1 to=TIMESTAMP2. El formato de marca de tiempo es como 2020-05-01T00:00:00.El TIMESTAMP1 debe ser mayor que TIMESTAMP2 TIMESTAMP1.

Propiedad Valor
Grupo de parámetros: Export Definition Arguments
--type

Tipo de la consulta.

Propiedad Valor
Grupo de parámetros: Export Definition Arguments
Valor predeterminado: Usage
Valores aceptados: ActualCost, AmortizedCost, Usage
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az costmanagement export delete

Operación para eliminar una exportación.

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

Ejemplos

eliminar una exportación para un ámbito managementGroup

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

eliminar una exportación para el ámbito de ResourceGroup

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

eliminar una exportación para el ámbito de la suscripción

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

Parámetros requeridos

--name

Nombre de exportación.

--scope

Ámbito asociado a las operaciones de consulta y exportación. Esto incluye '/subscriptions/{subscriptionId}/' para el ámbito de la suscripción, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para el ámbito del grupo de administración.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az costmanagement export list

Operación para enumerar todas las exportaciones en el ámbito especificado.

az costmanagement export list --scope

Ejemplos

enumerar exportaciones en un ámbito de ManagementGroup

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

enumerar exportaciones en un ámbito de ResourceGroup

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

enumerar exportaciones en un ámbito de suscripción

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

Parámetros requeridos

--scope

Ámbito asociado a las operaciones de consulta y exportación. Esto incluye '/subscriptions/{subscriptionId}/' para el ámbito de la suscripción, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para el ámbito del grupo de administración.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az costmanagement export show

Operación para obtener el historial de ejecución de una exportación para el ámbito definido por nombre de exportación.

az costmanagement export show --name
                              --scope

Ejemplos

Mostrar una exportación en un ámbito ManagementGroup

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

Mostrar una exportación en un ámbito de ResourceGroup

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

Mostrar una exportación en un ámbito de suscripción

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

Parámetros requeridos

--name

Nombre de exportación.

--scope

Ámbito asociado a las operaciones de consulta y exportación. Esto incluye '/subscriptions/{subscriptionId}/' para el ámbito de la suscripción, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para el ámbito del grupo de administración.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az costmanagement export update

Operación para actualizar una exportación.

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}]

Ejemplos

Actualizar una exportación en un ámbito de 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"

Actualización de una exportación en un ámbito de 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"

Actualización de una exportación en un ámbito de suscripción

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 requeridos

--name

Nombre de exportación.

--scope

Ámbito asociado a las operaciones de consulta y exportación. Esto incluye '/subscriptions/{subscriptionId}/' para el ámbito de la suscripción, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para el ámbito del grupo de administración.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--dataset-configuration

Tiene información de configuración para los datos de la exportación. La configuración se omitirá si se proporcionan la agregación y la agrupación. Valor esperado: columns=xx.

Propiedad Valor
Grupo de parámetros: Export Definition Arguments
--recurrence

Periodicidad de la programación.

Propiedad Valor
Grupo de parámetros: Schedule Info Arguments
Valores aceptados: Annually, Daily, Monthly, Weekly
--recurrence-period

Tiene la fecha de inicio y finalización de la periodicidad. La fecha de inicio debe estar en el futuro. Si está presente, la fecha de finalización debe ser mayor que la fecha de inicio. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... , los KEY disponibles son: de a. El formato de hora es como 2020-05-01T00:00:00.

Propiedad Valor
Grupo de parámetros: Schedule Info Arguments
--schedule-status

Estado de la programación de la exportación. Si está inactivo, la ejecución programada de la exportación se pausa.

Propiedad Valor
Grupo de parámetros: Schedule Info Arguments
Valores aceptados: Active, Inactive
--storage-account-id

Identificador de la cuenta de almacenamiento para almacenar las exportaciones.

Propiedad Valor
Grupo de parámetros: Delivery Destination Info Arguments
--storage-container

Contenedor de almacenamiento para entregar exportaciones.

Propiedad Valor
Grupo de parámetros: Delivery Destination Info Arguments
--storage-directory

Directorio raíz del contenedor de almacenamiento que se va a almacenar las exportaciones.

Propiedad Valor
Grupo de parámetros: Delivery Destination Info Arguments
--time-period

Tiene un período de tiempo para extraer datos de la consulta. Valor esperado: from=TIMESTAMP1 to=TIMESTAMP2. El formato de marca de tiempo es como 2020-05-01T00:00:00.El TIMESTAMP1 debe ser mayor que TIMESTAMP2 TIMESTAMP1.

Propiedad Valor
Grupo de parámetros: Export Definition Arguments
--timeframe

Período de tiempo para extraer datos de la consulta. Si es personalizado, se debe proporcionar un período de tiempo específico.

Propiedad Valor
Grupo de parámetros: Export Definition Arguments
Valores aceptados: BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False