Exports - Create Or Update
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 |
---|---|---|---|---|
export
|
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 |
Heeft de definitie voor de export. |
|
properties.deliveryInfo | True |
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 |
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 |
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 |
Indien aangevraagd, heeft de meest recente uitvoeringsgeschiedenis voor de export. |
||
properties.schedule |
Bevat planningsgegevens voor de export. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK. De aanvraag is geslaagd. |
|
201 Created |
Gemaakt. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom.
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
ExportCreateOrUpdateByBillingAccount
Voorbeeldaanvraag
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"
]
}
}
}
}
}
Voorbeeldrespons
{
"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"
]
}
}
}
}
}
{
"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
Voorbeeldaanvraag
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"
]
}
}
}
}
}
Voorbeeldrespons
{
"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"
]
}
}
}
}
}
{
"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
Voorbeeldaanvraag
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"
]
}
}
}
}
}
Voorbeeldrespons
{
"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"
]
}
}
}
}
}
{
"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
Voorbeeldaanvraag
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"
]
}
}
}
}
}
Voorbeeldrespons
{
"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"
]
}
}
}
}
}
{
"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
Voorbeeldaanvraag
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"
]
}
}
}
}
}
Voorbeeldrespons
{
"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"
]
}
}
}
}
}
{
"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
Voorbeeldaanvraag
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"
]
}
}
}
}
}
Voorbeeldrespons
{
"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"
]
}
}
}
}
}
{
"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 |
---|---|
Common |
De algemene eigenschappen van de export. |
Error |
De details van de fout. |
Error |
Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht. Enkele foutberichten:
|
Execution |
De laatst bekende status van de exportuitvoering. |
Execution |
Het type exportuitvoering. |
Export |
Een exportresource. |
Export |
De definitie voor gegevens in de export. |
Export |
De configuratie van de exportgegevensset. Hiermee kunt u kolommen selecteren voor de export. Als deze niet is opgegeven, bevat de export alle beschikbare kolommen. |
Export |
De definitie van een export. |
Export |
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 ). |
Export |
De leveringsgegevens die zijn gekoppeld aan een export. |
Export |
Resultaat van het weergeven van de uitvoeringsgeschiedenis van een export. |
Export |
De begin- en einddatum voor het terugkeerschema. |
Export |
Een exportuitvoering. |
Export |
De planning die is gekoppeld aan de export. |
Export |
Het datumbereik voor gegevens in de export. Dit moet alleen worden opgegeven met TimeFrame ingesteld op 'Aangepast'. Het maximale datumbereik is 3 maanden. |
Export |
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. |
Format |
De indeling van de export die wordt geleverd. Momenteel wordt alleen CSV ondersteund. |
Granularity |
De granulariteit van rijen in de export. Momenteel wordt alleen 'Dagelijks' ondersteund. |
Recurrence |
Het schema-terugkeerpatroon. |
Status |
De status van de exportplanning. Als 'Inactief' is, wordt de planning van de export onderbroken. |
System |
Beheerde service-identiteit (door het systeem toegewezen of geen) |
System |
Type beheerde service-identiteit (door het systeem toegewezen of geen). |
Timeframe |
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 |
Heeft de definitie voor de export. |
|
deliveryInfo |
Heeft leveringsgegevens voor de export. |
|
format |
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 |
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 |
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 |
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 |
Bevat de definitie voor de export. |
|
properties.deliveryInfo |
Heeft leveringsgegevens voor de export. |
|
properties.format |
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 |
Indien aangevraagd, heeft de meest recente uitvoeringsgeschiedenis voor de export. |
|
properties.schedule |
Bevat planningsgegevens voor de export. |
|
type |
string |
Resourcetype. |
ExportDataset
De definitie voor gegevens in de export.
Name | Type | Description |
---|---|---|
configuration |
De configuratie van de exportgegevensset. |
|
granularity |
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 |
De definitie voor gegevens in de export. |
|
timePeriod |
Heeft een tijdsperiode voor het ophalen van gegevens voor de export. |
|
timeframe |
Het tijdsbestek voor het ophalen van gegevens voor de export. Indien aangepast, moet een specifieke periode worden opgegeven. |
|
type |
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 |
Heeft de bestemming voor de export die wordt geleverd. |
ExportExecutionListResult
Resultaat van het weergeven van de uitvoeringsgeschiedenis van een export.
Name | Type | Description |
---|---|---|
value |
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 |
De details van eventuele fouten. |
|
properties.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 |
De exportinstellingen die van kracht waren voor deze uitvoering. |
|
properties.status |
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 |
Het schema-terugkeerpatroon. |
|
recurrencePeriod |
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 |
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 |
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 |