Exports - Create Or Update

Service:

Cost Management

API Version:

2023-11-01

De bewerking voor het maken of bijwerken van een export. Voor de updatebewerking moet de meest recente eTag worden ingesteld in de aanvraag. U kunt de meest recente eTag verkrijgen door een get-bewerking uit te voeren. Voor de maakbewerking is geen eTag vereist.

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

URI-parameters

Name	In	Vereist	Type	Description
exportName	path	True	string	Exportnaam.
scope	path	True	string	Het bereik dat is gekoppeld aan exportbewerkingen. Dit omvat '/subscriptions/{subscriptionId}/' voor het abonnementsbereik, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' voor resourceGroup-bereik, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' voor factureringsaccountbereik en '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' voor Afdelingsbereik, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId} voor enrollmentAccount-bereik, /providers/Microsoft.Management/managementGroups/{managementGroupId} voor het bereik van de beheergroep, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' voor billingProfile-bereik, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' voor invoiceSection-bereik en '/providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId} specifiek voor partners.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
properties.definition	True	ExportDefinition	Heeft de definitie voor de export.
properties.deliveryInfo	True	ExportDeliveryInfo	Heeft leveringsgegevens voor de export.
eTag		string	eTag van de resource. Voor het afhandelen van gelijktijdige updatescenario's wordt dit veld gebruikt om te bepalen of de gebruiker de nieuwste versie bijwerkt of niet.
identity		SystemAssignedServiceIdentity	De beheerde identiteit die is gekoppeld aan Export
location		string	De locatie van de beheerde identiteit van de export. Alleen vereist bij het gebruik van een beheerde identiteit.
properties.format		FormatType	De indeling van de export die wordt geleverd. Momenteel wordt alleen CSV ondersteund.
properties.partitionData		boolean	Als deze optie is ingesteld op true, worden geëxporteerde gegevens gepartitioneerd op grootte en samen met een manifestbestand in een blobmap geplaatst. Opmerking: deze optie is momenteel alleen beschikbaar voor Microsoft-klantovereenkomst commerce-bereiken.
properties.runHistory		ExportExecutionListResult	Indien aangevraagd, heeft de meest recente uitvoeringsgeschiedenis voor de export.
properties.schedule		ExportSchedule	Bevat planningsgegevens voor de export.

Antwoorden

Name	Type	Description
200 OK	Export	OK. De aanvraag is geslaagd.
201 Created	Export	Gemaakt.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ExportCreateOrUpdateByBillingAccount

ExportCreateOrUpdateByDepartment

ExportCreateOrUpdateByEnrollmentAccount

ExportCreateOrUpdateByManagementGroup

ExportCreateOrUpdateByResourceGroup

ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

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

Status code:

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

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

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

Status code:

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

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

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

Status code:

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

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

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

Status code:

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

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

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

Status code:

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

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

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

Status code:

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

Definities

Name	Description
CommonExportProperties	De algemene eigenschappen van de export.
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht. Enkele foutberichten: 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'x-ms-ratelimit-microsoft.consumption-retry-after'. 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u net zolang hebt gewacht zoals aangegeven in de header 'Retry-After'.
ExecutionStatus	De laatst bekende status van de exportuitvoering.
ExecutionType	Het type exportuitvoering.
Export	Een exportresource.
ExportDataset	De definitie voor gegevens in de export.
ExportDatasetConfiguration	De configuratie van de exportgegevensset. Hiermee kunt u kolommen selecteren voor de export. Als deze niet is opgegeven, bevat de export alle beschikbare kolommen.
ExportDefinition	De definitie van een export.
ExportDeliveryDestination	Dit vertegenwoordigt de locatie van het blob-opslagaccount waar exporten van kosten worden geleverd. Er zijn twee manieren om het doel te configureren. De aanpak die voor de meeste klanten wordt aanbevolen, is om de resourceId van het opslagaccount op te geven. Hiervoor is een eenmalige registratie van het abonnement van het account vereist bij de resourceprovider Microsoft.CostManagementExports om Cost Management-services toegang te geven tot de opslag. Bij het maken van een export in de Azure Portal wordt deze registratie automatisch uitgevoerd, maar moeten API-gebruikers het abonnement mogelijk expliciet registreren (zie https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services voor meer informatie ). Een andere manier om de bestemming te configureren is ALLEEN beschikbaar voor partners met een Microsoft Partner-overeenkomst abonnement die globale beheerders van hun factureringsrekening zijn. Deze partners kunnen in plaats van de resourceId van een opslagaccount op te geven, de naam van het opslagaccount opgeven, samen met een SAS-token voor het account. Hierdoor kunnen kosten worden geëxporteerd naar een opslagaccount in elke tenant. Het SAS-token moet worden gemaakt voor de blob-service met resourcetypen Service/Container/Object en met de machtigingen Lezen/Schrijven/Verwijderen/Lijst/Toevoegen/Maken (zie https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key voor meer informatie ).
ExportDeliveryInfo	De leveringsgegevens die zijn gekoppeld aan een export.
ExportExecutionListResult	Resultaat van het weergeven van de uitvoeringsgeschiedenis van een export.
ExportRecurrencePeriod	De begin- en einddatum voor het terugkeerschema.
ExportRun	Een exportuitvoering.
ExportSchedule	De planning die is gekoppeld aan de export.
ExportTimePeriod	Het datumbereik voor gegevens in de export. Dit moet alleen worden opgegeven met TimeFrame ingesteld op 'Aangepast'. Het maximale datumbereik is 3 maanden.
ExportType	Het type export. Houd er rekening mee dat 'Usage' gelijk is aan 'ActualCost' en van toepassing is op exports die nog geen gegevens bieden voor kosten of afschrijving voor servicereserveringen.
FormatType	De indeling van de export die wordt geleverd. Momenteel wordt alleen CSV ondersteund.
GranularityType	De granulariteit van rijen in de export. Momenteel wordt alleen 'Dagelijks' ondersteund.
RecurrenceType	Het schema-terugkeerpatroon.
StatusType	De status van de exportplanning. Als 'Inactief' is, wordt de planning van de export onderbroken.
SystemAssignedServiceIdentity	Beheerde service-identiteit (door het systeem toegewezen of geen)
SystemAssignedServiceIdentityType	Type beheerde service-identiteit (door het systeem toegewezen of geen).
TimeframeType	Het tijdsbestek voor het ophalen van gegevens voor de export. Indien aangepast, moet een specifieke periode worden opgegeven.

CommonExportProperties

De algemene eigenschappen van de export.

Name	Type	Description
definition	ExportDefinition	Heeft de definitie voor de export.
deliveryInfo	ExportDeliveryInfo	Heeft leveringsgegevens voor de export.
format	FormatType	De indeling van de export die wordt geleverd. Momenteel wordt alleen CSV ondersteund.
nextRunTimeEstimate	string	Als de export een actief schema heeft, geeft u een schatting van de volgende uitvoeringstijd.
partitionData	boolean	Als deze optie is ingesteld op true, worden geëxporteerde gegevens gepartitioneerd op grootte en samen met een manifestbestand in een blobmap geplaatst. Opmerking: deze optie is momenteel alleen beschikbaar voor Microsoft-klantovereenkomst commerce-bereiken.
runHistory	ExportExecutionListResult	Indien aangevraagd, heeft de meest recente uitvoeringsgeschiedenis voor de export.

ErrorDetails

De details van de fout.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht.

Enkele foutberichten:

• 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'x-ms-ratelimit-microsoft.consumption-retry-after'.

• 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u net zolang hebt gewacht zoals aangegeven in de header 'Retry-After'.

Name	Type	Description
error	ErrorDetails	De details van de fout.

ExecutionStatus

De laatst bekende status van de exportuitvoering.

Name	Type	Description
Completed	string
DataNotAvailable	string
Failed	string
InProgress	string
NewDataNotAvailable	string
Queued	string
Timeout	string

ExecutionType

Het type exportuitvoering.

Name	Type	Description
OnDemand	string
Scheduled	string

Export

Een exportresource.

Name	Type	Description
eTag	string	eTag van de resource. Dit veld wordt gebruikt om te bepalen of de gebruiker de nieuwste versie bijwerkt of niet.
id	string	Resource-id.
identity	SystemAssignedServiceIdentity	De beheerde identiteit die is gekoppeld aan Export
location	string	De locatie van de beheerde identiteit van de export. Alleen vereist bij het gebruik van een beheerde identiteit.
name	string	Resourcenaam.
properties.definition	ExportDefinition	Bevat de definitie voor de export.
properties.deliveryInfo	ExportDeliveryInfo	Heeft leveringsgegevens voor de export.
properties.format	FormatType	De indeling van de export die wordt geleverd. Momenteel wordt alleen CSV ondersteund.
properties.nextRunTimeEstimate	string	Als de export een actieve planning heeft, geeft u een schatting van de volgende uitvoeringstijd.
properties.partitionData	boolean	Als dit is ingesteld op true, worden geëxporteerde gegevens gepartitioneerd op grootte en samen met een manifestbestand in een blobmap geplaatst. Opmerking: deze optie is momenteel alleen beschikbaar voor Microsoft-klantovereenkomst commerce-bereiken.
properties.runHistory	ExportExecutionListResult	Indien aangevraagd, heeft de meest recente uitvoeringsgeschiedenis voor de export.
properties.schedule	ExportSchedule	Bevat planningsgegevens voor de export.
type	string	Resourcetype.

ExportDataset

De definitie voor gegevens in de export.

Name	Type	Description
configuration	ExportDatasetConfiguration	De configuratie van de exportgegevensset.
granularity	GranularityType	De granulariteit van rijen in de export. Momenteel wordt alleen 'Dagelijks' ondersteund.

ExportDatasetConfiguration

De configuratie van de exportgegevensset. Hiermee kunt u kolommen selecteren voor de export. Als deze niet is opgegeven, bevat de export alle beschikbare kolommen.

Name	Type	Description
columns	string[]	Matrix met kolomnamen die moeten worden opgenomen in de export. Als deze niet is opgegeven, bevat de export alle beschikbare kolommen. De beschikbare kolommen kunnen variëren per klantkanaal (zie voorbeelden).

ExportDefinition

De definitie van een export.

Name	Type	Description
dataSet	ExportDataset	De definitie voor gegevens in de export.
timePeriod	ExportTimePeriod	Heeft een tijdsperiode voor het ophalen van gegevens voor de export.
timeframe	TimeframeType	Het tijdsbestek voor het ophalen van gegevens voor de export. Indien aangepast, moet een specifieke periode worden opgegeven.
type	ExportType	Het type export. Houd er rekening mee dat 'Usage' gelijk is aan 'ActualCost' en van toepassing is op exports die nog geen gegevens bieden voor kosten of afschrijving voor servicereserveringen.

ExportDeliveryDestination

Dit vertegenwoordigt de locatie van het blob-opslagaccount waar exporten van kosten worden geleverd. Er zijn twee manieren om het doel te configureren. De aanpak die voor de meeste klanten wordt aanbevolen, is om de resourceId van het opslagaccount op te geven. Hiervoor is een eenmalige registratie van het abonnement van het account vereist bij de resourceprovider Microsoft.CostManagementExports om Cost Management-services toegang te geven tot de opslag. Bij het maken van een export in de Azure Portal wordt deze registratie automatisch uitgevoerd, maar moeten API-gebruikers het abonnement mogelijk expliciet registreren (zie https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services voor meer informatie ). Een andere manier om de bestemming te configureren is ALLEEN beschikbaar voor partners met een Microsoft Partner-overeenkomst abonnement die globale beheerders van hun factureringsrekening zijn. Deze partners kunnen in plaats van de resourceId van een opslagaccount op te geven, de naam van het opslagaccount opgeven, samen met een SAS-token voor het account. Hierdoor kunnen kosten worden geëxporteerd naar een opslagaccount in elke tenant. Het SAS-token moet worden gemaakt voor de blob-service met resourcetypen Service/Container/Object en met de machtigingen Lezen/Schrijven/Verwijderen/Lijst/Toevoegen/Maken (zie https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key voor meer informatie ).

Name	Type	Description
container	string	De naam van de container waar exports worden geüpload. Als de container niet bestaat, wordt deze gemaakt.
resourceId	string	De resource-id van het opslagaccount waar exports worden geleverd. Dit is niet vereist als een sasToken en storageAccount zijn opgegeven.
rootFolderPath	string	De naam van de map waar exports worden geüpload.
sasToken	string	Een SAS-token voor het opslagaccount. Voor een beperkte set Azure-klanten kan dit samen met storageAccount worden opgegeven in plaats van resourceId. Opmerking: de waarde die door de API voor deze eigenschap wordt geretourneerd, wordt altijd verborgen. Als u dezelfde verborgen waarde retourneert, wordt het SAS-token niet bijgewerkt. Als u deze waarde wilt bijwerken, moet een nieuw SAS-token worden opgegeven.
storageAccount	string	Het opslagaccount waar exports worden geüpload. Voor een beperkte set Azure-klanten kan dit samen met sasToken worden opgegeven in plaats van resourceId.

ExportDeliveryInfo

De leveringsgegevens die zijn gekoppeld aan een export.

Name	Type	Description
destination	ExportDeliveryDestination	Heeft de bestemming voor de export die wordt geleverd.

ExportExecutionListResult

Resultaat van het weergeven van de uitvoeringsgeschiedenis van een export.

Name	Type	Description
value	ExportRun[]	Een lijst met exportuitvoeringen.

ExportRecurrencePeriod

De begin- en einddatum voor het terugkeerschema.

Name	Type	Description
from	string	De begindatum van het terugkeerpatroon.
to	string	De einddatum van het terugkeerpatroon.

ExportRun

Een exportuitvoering.

Name	Type	Description
eTag	string	eTag van de resource. Voor het afhandelen van gelijktijdige updatescenario's wordt dit veld gebruikt om te bepalen of de gebruiker de nieuwste versie bijwerkt of niet.
id	string	Resource-id.
name	string	Resourcenaam.
properties.error	ErrorDetails	De details van eventuele fouten.
properties.executionType	ExecutionType	Het type exportuitvoering.
properties.fileName	string	De naam van het geëxporteerde bestand.
properties.processingEndTime	string	Het tijdstip waarop de exportbewerking is voltooid.
properties.processingStartTime	string	Het tijdstip waarop de export is opgehaald om te worden uitgevoerd.
properties.runSettings	CommonExportProperties	De exportinstellingen die van kracht waren voor deze uitvoering.
properties.status	ExecutionStatus	De laatst bekende status van de exportuitvoering.
properties.submittedBy	string	De id voor de entiteit die de export heeft geactiveerd. Voor uitvoeringen op aanvraag is dit het e-mailadres van de gebruiker. Voor geplande uitvoeringen is dit 'Systeem'.
properties.submittedTime	string	Het tijdstip waarop de export in de wachtrij is geplaatst om te worden uitgevoerd.
type	string	Resourcetype.

ExportSchedule

De planning die is gekoppeld aan de export.

Name	Type	Description
recurrence	RecurrenceType	Het schema-terugkeerpatroon.
recurrencePeriod	ExportRecurrencePeriod	Heeft de begin- en einddatum van het terugkeerpatroon. De begindatum moet in de toekomst zijn. Indien aanwezig, moet de einddatum groter zijn dan de begindatum.
status	StatusType	De status van de exportplanning. Als 'Inactief' is, wordt de planning van de export onderbroken.

ExportTimePeriod

Het datumbereik voor gegevens in de export. Dit moet alleen worden opgegeven met TimeFrame ingesteld op 'Aangepast'. Het maximale datumbereik is 3 maanden.

Name	Type	Description
from	string	De begindatum voor het exporteren van gegevens.
to	string	De einddatum voor het exporteren van gegevens.

ExportType

Het type export. Houd er rekening mee dat 'Usage' gelijk is aan 'ActualCost' en van toepassing is op exports die nog geen gegevens bieden voor kosten of afschrijving voor servicereserveringen.

Name	Type	Description
ActualCost	string
AmortizedCost	string
Usage	string

FormatType

De indeling van de export die wordt geleverd. Momenteel wordt alleen CSV ondersteund.

Name	Type	Description
Csv	string

GranularityType

De granulariteit van rijen in de export. Momenteel wordt alleen 'Dagelijks' ondersteund.

Name	Type	Description
Daily	string

RecurrenceType

Het schema-terugkeerpatroon.

Name	Type	Description
Annually	string
Daily	string
Monthly	string
Weekly	string

StatusType

De status van de exportplanning. Als 'Inactief' is, wordt de planning van de export onderbroken.

Name	Type	Description
Active	string
Inactive	string

SystemAssignedServiceIdentity

Beheerde service-identiteit (door het systeem toegewezen of geen)

Name	Type	Description
principalId	string	De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen opgegeven voor een door het systeem toegewezen identiteit.
tenantId	string	De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen opgegeven voor een door het systeem toegewezen identiteit.
type	SystemAssignedServiceIdentityType	Type beheerde service-identiteit (door het systeem toegewezen of geen).

SystemAssignedServiceIdentityType

Type beheerde service-identiteit (door het systeem toegewezen of geen).

Name	Type	Description
None	string
SystemAssigned	string

TimeframeType

Het tijdsbestek voor het ophalen van gegevens voor de export. Indien aangepast, moet een specifieke periode worden opgegeven.

Name	Type	Description
BillingMonthToDate	string
Custom	string
MonthToDate	string
TheLastBillingMonth	string
TheLastMonth	string
WeekToDate	string