Partilhar via

Exports - Create Or Update

  • Referência
Serviço:
Cost Management
Versão da API:
2024-08-01

A operação para criar ou atualizar uma exportação. A operação de atualização requer que o eTag mais recente seja definido na solicitação. Você pode obter o eTag mais recente executando uma operação get. Criar operação não requer eTag.

PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}?api-version=2024-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
exportName
 path True

string

Nome da exportação.
scope
 path True

string

O escopo associado às operações de exportação. Isso inclui '/subscriptions/{subscriptionId}/' para o escopo da assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para o escopo resourceGroup, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para o escopo da Conta de Cobrança e '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' para o escopo do Departamento, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' para o escopo EnrollmentAccount, '/providers/Microsoft.Management/managementGroups/{managementGroupId} para o escopo do Grupo de Gerenciamento, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' para o escopo do billingProfile, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' para o escopo invoiceSection e '/providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' específico para parceiros.
api-version
 query True

string

A versão da API a ser usada para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
properties.definition True

ExportDefinition

Tem a definição para a exportação.
properties.deliveryInfo True

ExportDeliveryInfo

Tem informações de entrega para a exportação.
eTag

string

eTag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.
identity

SystemAssignedServiceIdentity

A identidade gerenciada associada à Exportação
location

string

O local da identidade gerenciada da Exportação. Necessário apenas ao utilizar a identidade gerenciada.
properties.format

FormatType

O formato da exportação que está sendo entregue. Atualmente, apenas 'Csv' é suportado.
properties.partitionData

boolean

Se definido como true, os dados exportados serão particionados por tamanho e colocados em um diretório de blob junto com um arquivo de manifesto. Observação: essa opção está atualmente disponível apenas para escopos de comércio do Contrato de Cliente Microsoft.
properties.runHistory

ExportExecutionListResult

Se solicitado, tem o histórico de execução mais recente para a exportação.
properties.schedule

ExportSchedule

Tem informações de agendamento para a exportação.

Respostas

Name Tipo Description
200 OK

Export

OK. O pedido foi bem-sucedido.
201 Created

Export

Criado.
Other Status Codes

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

ExportCreateOrUpdateByBillingAccount
ExportCreateOrUpdateByDepartment
ExportCreateOrUpdateByEnrollmentAccount
ExportCreateOrUpdateByManagementGroup
ExportCreateOrUpdateByResourceGroup
ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Pedido de amostra

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Resposta da amostra

Código de estado:
201 
{
  "id": "providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}
Código de estado:
200 
{
  "id": "providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByDepartment

Pedido de amostra

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Resposta da amostra

Código de estado:
201 
{
  "id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}
Código de estado:
200 
{
  "id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByEnrollmentAccount

Pedido de amostra

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Resposta da amostra

Código de estado:
201 
{
  "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}
Código de estado:
200 
{
  "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByManagementGroup

Pedido de amostra

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Resposta da amostra

Código de estado:
201 
{
  "id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}
Código de estado:
200 
{
  "id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByResourceGroup

Pedido de amostra

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Resposta da amostra

Código de estado:
201 
{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}
Código de estado:
200 
{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateBySubscription

Pedido de amostra

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Resposta da amostra

Código de estado:
201 
{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}
Código de estado:
200 
{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Definições

Name Description
CommonExportProperties

As propriedades comuns da exportação.
ErrorDetails

Os detalhes do erro.
ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

  • 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".
ExecutionStatus

O último status conhecido da execução de exportação.
ExecutionType

O tipo de execução de exportação.
Export

Um recurso de exportação.
ExportDataset

A definição para os dados na exportação.
ExportDatasetConfiguration

A configuração do conjunto de dados de exportação. Permite que as colunas sejam selecionadas para a exportação. Se não for fornecida, a exportação incluirá todas as colunas disponíveis.
ExportDefinition

A definição de exportação.
ExportDeliveryDestination

Isso representa o local da conta de armazenamento de blob onde as exportações de custos serão entregues. Há duas maneiras de configurar o destino. A abordagem recomendada para a maioria dos clientes é especificar o resourceId da conta de armazenamento. Isso requer um registro único da assinatura da conta com o provedor de recursos Microsoft.CostManagementExports para dar aos serviços de Gerenciamento de Custos acesso ao armazenamento. Ao criar uma exportação no portal do Azure, esse registro é realizado automaticamente, mas os usuários da API podem precisar registrar a assinatura explicitamente (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Outra maneira de configurar o destino está disponível SOMENTE para Parceiros com um plano de Contrato de Parceiro Microsoft que sejam administradores globais de suas contas de cobrança. Esses parceiros, em vez de especificar o resourceId de uma conta de armazenamento, podem especificar o nome da conta de armazenamento junto com um token SAS para a conta. Isso permite a exportação de custos para uma conta de armazenamento em qualquer locatário. O token SAS deve ser criado para o serviço de blob com os tipos de recursos Service/Container/Object e com as permissões Read/Write/Delete/List/Add/Create (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).
ExportDeliveryInfo

As informações de entrega associadas a uma exportação.
ExportExecutionListResult

Resultado da listagem do histórico de execução de uma exportação.
ExportRecurrencePeriod

As datas de início e término do cronograma de recorrência.
ExportRun

Uma execução de exportação.
ExportSchedule

O cronograma associado à exportação.
ExportTimePeriod

O intervalo de datas para dados na exportação. Isso só deve ser especificado com timeFrame definido como 'Personalizado'. O intervalo máximo de datas é de 3 meses.
ExportType

O tipo de exportação. Observe que 'Uso' é equivalente a 'Custo Real' e é aplicável a exportações que ainda não fornecem dados para cobranças ou amortização para reservas de serviços.
FormatType

O formato da exportação que está sendo entregue. Atualmente, apenas 'Csv' é suportado.
GranularityType

A granularidade das linhas na exportação. Atualmente, apenas 'Daily' é suportado.
RecurrenceType

A recorrência do cronograma.
StatusType

O status do cronograma de exportação. Se 'Inativo', a agenda da exportação é pausada.
SystemAssignedServiceIdentity

Identidade do serviço gerenciado (atribuído ao sistema ou nenhum)
SystemAssignedServiceIdentityType

Tipo de identidade de serviço gerenciado (sistema atribuído ou nenhum).
TimeframeType

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

CommonExportProperties

As propriedades comuns da exportação.

Name Tipo Description
definition

ExportDefinition

Tem a definição para a exportação.
deliveryInfo

ExportDeliveryInfo

Tem informações de entrega para a exportação.
format

FormatType

O formato da exportação que está sendo entregue. Atualmente, apenas 'Csv' é suportado.
nextRunTimeEstimate

string

Se a exportação tiver uma agenda ativa, fornece uma estimativa do próximo tempo de execução.
partitionData

boolean

Se definido como true, os dados exportados serão particionados por tamanho e colocados em um diretório de blob junto com um arquivo de manifesto. Observação: essa opção está atualmente disponível apenas para escopos de comércio do Contrato de Cliente Microsoft.
runHistory

ExportExecutionListResult

Se solicitado, tem o histórico de execução mais recente para a exportação.

ErrorDetails

Os detalhes do erro.

Name Tipo Description
code

string

Código de erro.
message

string

Mensagem de erro indicando por que a operação falhou.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

  • 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Name Tipo Description
error

ErrorDetails

Os detalhes do erro.

ExecutionStatus

O último status conhecido da execução de exportação.

Name Tipo Description
Completed

string

DataNotAvailable

string

Failed

string

InProgress

string

NewDataNotAvailable

string

Queued

string

Timeout

string

ExecutionType

O tipo de execução de exportação.

Name Tipo Description
OnDemand

string

Scheduled

string

Export

Um recurso de exportação.

Name Tipo Description
eTag

string

eTag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.
id

string

Id do recurso.
identity

SystemAssignedServiceIdentity

A identidade gerenciada associada à Exportação
location

string

O local da identidade gerenciada da Exportação. Necessário apenas ao utilizar a identidade gerenciada.
name

string

Nome do recurso.
properties.definition

ExportDefinition

Tem a definição para a exportação.
properties.deliveryInfo

ExportDeliveryInfo

Tem informações de entrega para a exportação.
properties.format

FormatType

O formato da exportação que está sendo entregue. Atualmente, apenas 'Csv' é suportado.
properties.nextRunTimeEstimate

string

Se a exportação tiver uma agenda ativa, fornece uma estimativa do próximo tempo de execução.
properties.partitionData

boolean

Se definido como true, os dados exportados serão particionados por tamanho e colocados em um diretório de blob junto com um arquivo de manifesto. Observação: essa opção está atualmente disponível apenas para escopos de comércio do Contrato de Cliente Microsoft.
properties.runHistory

ExportExecutionListResult

Se solicitado, tem o histórico de execução mais recente para a exportação.
properties.schedule

ExportSchedule

Tem informações de agendamento para a exportação.
type

string

Tipo de recurso.

ExportDataset

A definição para os dados na exportação.

Name Tipo Description
configuration

ExportDatasetConfiguration

A configuração do conjunto de dados de exportação.
granularity

GranularityType

A granularidade das linhas na exportação. Atualmente, apenas 'Daily' é suportado.

ExportDatasetConfiguration

A configuração do conjunto de dados de exportação. Permite que as colunas sejam selecionadas para a exportação. Se não for fornecida, a exportação incluirá todas as colunas disponíveis.

Name Tipo Description
columns

string[]

Matriz de nomes de colunas a serem incluídos na exportação. Se não for fornecida, a exportação incluirá todas as colunas disponíveis. As colunas disponíveis podem variar de acordo com o canal do cliente (ver exemplos).

ExportDefinition

A definição de exportação.

Name Tipo Description
dataSet

ExportDataset

A definição para os dados na exportação.
timePeriod

ExportTimePeriod

Tem período de tempo para extrair dados para a exportação.
timeframe

TimeframeType

O período de tempo para extrair dados para a exportação. Se for habitual, deve ser fornecido um período de tempo específico.
type

ExportType

O tipo de exportação. Observe que 'Uso' é equivalente a 'Custo Real' e é aplicável a exportações que ainda não fornecem dados para cobranças ou amortização para reservas de serviços.

ExportDeliveryDestination

Isso representa o local da conta de armazenamento de blob onde as exportações de custos serão entregues. Há duas maneiras de configurar o destino. A abordagem recomendada para a maioria dos clientes é especificar o resourceId da conta de armazenamento. Isso requer um registro único da assinatura da conta com o provedor de recursos Microsoft.CostManagementExports para dar aos serviços de Gerenciamento de Custos acesso ao armazenamento. Ao criar uma exportação no portal do Azure, esse registro é realizado automaticamente, mas os usuários da API podem precisar registrar a assinatura explicitamente (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Outra maneira de configurar o destino está disponível SOMENTE para Parceiros com um plano de Contrato de Parceiro Microsoft que sejam administradores globais de suas contas de cobrança. Esses parceiros, em vez de especificar o resourceId de uma conta de armazenamento, podem especificar o nome da conta de armazenamento junto com um token SAS para a conta. Isso permite a exportação de custos para uma conta de armazenamento em qualquer locatário. O token SAS deve ser criado para o serviço de blob com os tipos de recursos Service/Container/Object e com as permissões Read/Write/Delete/List/Add/Create (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).

Name Tipo Description
container

string

O nome do contêiner onde as exportações serão carregadas. Se o contêiner não existir, ele será criado.
resourceId

string

A ID do recurso da conta de armazenamento onde as exportações serão entregues. Isso não é necessário se um sasToken e storageAccount forem especificados.
rootFolderPath

string

O nome do diretório onde as exportações serão carregadas.
sasToken

string

Um token SAS para a conta de armazenamento. Para um conjunto restrito de clientes do Azure, isso junto com storageAccount pode ser especificado em vez de resourceId. Nota: o valor retornado pela API para esta propriedade será sempre ofuscado. O retorno desse mesmo valor ofuscado não resultará na atualização do token SAS. Para atualizar esse valor, um novo token SAS deve ser especificado.
storageAccount

string

A conta de armazenamento onde as exportações serão carregadas. Para um conjunto restrito de clientes do Azure, isso junto com sasToken pode ser especificado em vez de resourceId.

ExportDeliveryInfo

As informações de entrega associadas a uma exportação.

Name Tipo Description
destination

ExportDeliveryDestination

Tem destino para a exportação que está sendo entregue.

ExportExecutionListResult

Resultado da listagem do histórico de execução de uma exportação.

Name Tipo Description
value

ExportRun[]

Uma lista de execuções de exportação.

ExportRecurrencePeriod

As datas de início e término do cronograma de recorrência.

Name Tipo Description
from

string

A data de início da recorrência.
to

string

A data final da recorrência.

ExportRun

Uma execução de exportação.

Name Tipo Description
eTag

string

eTag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.
id

string

Id do recurso.
name

string

Nome do recurso.
properties.error

ErrorDetails

Os detalhes de qualquer erro.
properties.executionType

ExecutionType

O tipo de execução de exportação.
properties.fileName

string

O nome do arquivo exportado.
properties.processingEndTime

string

A hora em que a execução da exportação terminou.
properties.processingStartTime

string

O tempo em que a exportação foi escolhida para ser executada.
properties.runSettings

CommonExportProperties

As configurações de exportação que estavam em vigor para esta execução.
properties.status

ExecutionStatus

O último status conhecido da execução de exportação.
properties.submittedBy

string

O identificador da entidade que disparou a exportação. Para execuções sob demanda é o e-mail do usuário. Para execuções programadas é 'Sistema'.
properties.submittedTime

string

A hora em que a exportação estava na fila para ser executada.
type

string

Tipo de recurso.

ExportSchedule

O cronograma associado à exportação.

Name Tipo Description
recurrence

RecurrenceType

A recorrência do cronograma.
recurrencePeriod

ExportRecurrencePeriod

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

StatusType

O status do cronograma de exportação. Se 'Inativo', a agenda da exportação é pausada.

ExportTimePeriod

O intervalo de datas para dados na exportação. Isso só deve ser especificado com timeFrame definido como 'Personalizado'. O intervalo máximo de datas é de 3 meses.

Name Tipo Description
from

string

A data de início dos dados de exportação.
to

string

A data final para exportar dados.

ExportType

O tipo de exportação. Observe que 'Uso' é equivalente a 'Custo Real' e é aplicável a exportações que ainda não fornecem dados para cobranças ou amortização para reservas de serviços.

Name Tipo Description
ActualCost

string

AmortizedCost

string

Usage

string

FormatType

O formato da exportação que está sendo entregue. Atualmente, apenas 'Csv' é suportado.

Name Tipo Description
Csv

string

GranularityType

A granularidade das linhas na exportação. Atualmente, apenas 'Daily' é suportado.

Name Tipo Description
Daily

string

RecurrenceType

A recorrência do cronograma.

Name Tipo Description
Annually

string

Daily

string

Monthly

string

Weekly

string

StatusType

O status do cronograma de exportação. Se 'Inativo', a agenda da exportação é pausada.

Name Tipo Description
Active

string

Inactive

string

SystemAssignedServiceIdentity

Identidade do serviço gerenciado (atribuído ao sistema ou nenhum)

Name Tipo Description
principalId

string

O ID da entidade de serviço da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
tenantId

string

O ID do locatário da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
type

SystemAssignedServiceIdentityType

Tipo de identidade de serviço gerenciado (sistema atribuído ou nenhum).

SystemAssignedServiceIdentityType

Tipo de identidade de serviço gerenciado (sistema atribuído ou nenhum).

Name Tipo Description
None

string

SystemAssigned

string

TimeframeType

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

Name Tipo Description
BillingMonthToDate

string

Custom

string

MonthToDate

string

TheLastBillingMonth

string

TheLastMonth

string

WeekToDate

string