Delen via

Exports - Create Or Update

  • Referentie
Service:
Cost Management
API-versie:
2024-08-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 nieuwste eTag verkrijgen door een get-bewerking uit te voeren. Voor het maken is geen eTag vereist.

PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}?api-version=2024-08-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 het bereik van de factureringsrekening en /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/afdelingen/{departmentId} voor afdelingsbereik, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId} voor het bereik EnrollmentAccount, '/providers/Microsoft.Management/managementGroups/{managementGroupId} voor het bereik van de beheergroep, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' voor het bereik billingProfile, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' voor het bereik van invoiceSection en /providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specifiek voor partners.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
properties.definition True

ExportDefinition

Bevat de definitie voor de export.
properties.deliveryInfo True

ExportDeliveryInfo

Bevat leveringsgegevens voor de export.
eTag

string

eTag van de resource. Voor het afhandelen van een gelijktijdig updatescenario 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 Exporteren
location

string

De locatie van de beheerde identiteit van de export. Alleen vereist bij het gebruik van 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 waar, worden geëxporteerde gegevens gepartitioneerd op grootte en in een blobmap samen met een manifestbestand geplaatst. Opmerking: deze optie is momenteel alleen beschikbaar voor handelsbereiken van Microsoft-klantovereenkomsten.
properties.runHistory

ExportExecutionListResult

Indien aangevraagd, heeft u 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 voltooid.
201 Created

Export

Geschapen.
Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

ExportCreateOrUpdateByBillingAccount
ExportCreateOrUpdateByDepartment
ExportCreateOrUpdateByEnrollmentAccount
ExportCreateOrUpdateByManagementGroup
ExportCreateOrUpdateByResourceGroup
ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
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"
          ]
        }
      }
    }
  }
}
Statuscode:
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 is 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 hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.
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 kunnen kolommen worden geselecteerd voor de export. Als dit 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 de export van kosten wordt geleverd. Er zijn twee manieren om de bestemming te configureren. De methode die voor de meeste klanten wordt aanbevolen, is om de resourceId van het opslagaccount op te geven. Hiervoor is een eenmalige registratie van het accountabonnement met de resourceprovider Microsoft.CostManagementExports vereist om Cost Management-services toegang te geven tot de opslag. Bij het maken van een export in Azure Portal wordt deze registratie automatisch uitgevoerd, maar API-gebruikers moeten 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-overeenkomstabonnement 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 blobservice met resourcetypen Service/Container/Object en met 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 terugkeerschema.
ExportRun

Een exportuitvoering.
ExportSchedule

Het schema dat is gekoppeld aan de export.
ExportTimePeriod

Het datumbereik voor gegevens in de export. Dit mag alleen worden opgegeven met het tijdsbestek dat is ingesteld op 'Aangepast'. Het maximale datumbereik is 3 maanden.
ExportType

Het type export. 'Gebruik' is gelijk aan 'ActualCost' en is van toepassing 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 schemapatroon.
StatusType

De status van de exportplanning. Als 'Inactief' is, wordt het exportschema 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. Als dit aangepast is, moet er een specifieke periode worden opgegeven.

CommonExportProperties

Object

De algemene eigenschappen van de export.

Name Type Description
definition

ExportDefinition

Bevat de definitie voor de export.
deliveryInfo

ExportDeliveryInfo

Bevat leveringsgegevens voor de export.
format

FormatType

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

string (date-time)

Als de export een actief schema heeft, geeft u een schatting van de volgende uitvoeringstijd.
partitionData

boolean

Als deze optie is ingesteld op waar, worden geëxporteerde gegevens gepartitioneerd op grootte en in een blobmap samen met een manifestbestand geplaatst. Opmerking: deze optie is momenteel alleen beschikbaar voor handelsbereiken van Microsoft-klantovereenkomsten.
runHistory

ExportExecutionListResult

Indien aangevraagd, heeft u de meest recente uitvoeringsgeschiedenis voor de export.

ErrorDetails

Object

De details van de fout.

Name Type Description
code

string

Foutcode.
message

string

Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Object

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is 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 hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

Name Type Description
error

ErrorDetails

De details van de fout.

ExecutionStatus

Inventarisatie

De laatst bekende status van de exportuitvoering.

Waarde Description
Completed
DataNotAvailable
Failed
InProgress
NewDataNotAvailable
Queued
Timeout

ExecutionType

Inventarisatie

Het type exportuitvoering.

Waarde Description
OnDemand
Scheduled

Export

Object

Een exportresource.

Name Type Description
eTag

string

eTag van de resource. Voor het afhandelen van een gelijktijdig updatescenario wordt dit veld 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 Exporteren
location

string

De locatie van de beheerde identiteit van de export. Alleen vereist bij het gebruik van beheerde identiteit.
name

string

Resourcenaam.
properties.definition

ExportDefinition

Bevat de definitie voor de export.
properties.deliveryInfo

ExportDeliveryInfo

Bevat leveringsgegevens voor de export.
properties.format

FormatType

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

string (date-time)

Als de export een actief schema heeft, geeft u een schatting van de volgende uitvoeringstijd.
properties.partitionData

boolean

Als deze optie is ingesteld op waar, worden geëxporteerde gegevens gepartitioneerd op grootte en in een blobmap samen met een manifestbestand geplaatst. Opmerking: deze optie is momenteel alleen beschikbaar voor handelsbereiken van Microsoft-klantovereenkomsten.
properties.runHistory

ExportExecutionListResult

Indien aangevraagd, heeft u de meest recente uitvoeringsgeschiedenis voor de export.
properties.schedule

ExportSchedule

Bevat planningsgegevens voor de export.
type

string

Resourcetype.

ExportDataset

Object

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

Object

De configuratie van de exportgegevensset. Hiermee kunnen kolommen worden geselecteerd voor de export. Als dit 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 dit niet is opgegeven, bevat de export alle beschikbare kolommen. De beschikbare kolommen kunnen per klantkanaal variëren (zie voorbeelden).

ExportDefinition

Object

De definitie van een export.

Name Type Description
dataSet

ExportDataset

De definitie voor gegevens in de export.
timePeriod

ExportTimePeriod

Heeft een periode voor het ophalen van gegevens voor de export.
timeframe

TimeframeType

Het tijdsbestek voor het ophalen van gegevens voor de export. Als dit aangepast is, moet er een specifieke periode worden opgegeven.
type

ExportType

Het type export. 'Gebruik' is gelijk aan 'ActualCost' en is van toepassing op exports die nog geen gegevens bieden voor kosten of afschrijving voor servicereserveringen.

ExportDeliveryDestination

Object

Dit vertegenwoordigt de locatie van het blob-opslagaccount waar de export van kosten wordt geleverd. Er zijn twee manieren om de bestemming te configureren. De methode die voor de meeste klanten wordt aanbevolen, is om de resourceId van het opslagaccount op te geven. Hiervoor is een eenmalige registratie van het accountabonnement met de resourceprovider Microsoft.CostManagementExports vereist om Cost Management-services toegang te geven tot de opslag. Bij het maken van een export in Azure Portal wordt deze registratie automatisch uitgevoerd, maar API-gebruikers moeten 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-overeenkomstabonnement 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 blobservice met resourcetypen Service/Container/Object en met 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 waarin 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

Object

De leveringsgegevens die zijn gekoppeld aan een export.

Name Type Description
destination

ExportDeliveryDestination

Heeft de bestemming voor de export die wordt geleverd.

ExportExecutionListResult

Object

Resultaat van het weergeven van de uitvoeringsgeschiedenis van een export.

Name Type Description
value

ExportRun[]

Een lijst met exportuitvoeringen.

ExportRecurrencePeriod

Object

De begin- en einddatum voor terugkeerschema.

Name Type Description
from

string (date-time)

De begindatum van het terugkeerpatroon.
to

string (date-time)

De einddatum van het terugkeerpatroon.

ExportRun

Object

Een exportuitvoering.

Name Type Description
eTag

string

eTag van de resource. Voor het afhandelen van een gelijktijdig updatescenario 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 een fout.
properties.executionType

ExecutionType

Het type exportuitvoering.
properties.fileName

string

De naam van het geëxporteerde bestand.
properties.processingEndTime

string (date-time)

Het tijdstip waarop de exportbewerking is voltooid.
properties.processingStartTime

string (date-time)

Het tijdstip waarop de export werd 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 het systeem.
properties.submittedTime

string (date-time)

Het tijdstip waarop de export in de wachtrij is geplaatst om te worden uitgevoerd.
type

string

Resourcetype.

ExportSchedule

Object

Het schema dat is gekoppeld aan de export.

Name Type Description
recurrence

RecurrenceType

Het schemapatroon.
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 het exportschema onderbroken.

ExportTimePeriod

Object

Het datumbereik voor gegevens in de export. Dit mag alleen worden opgegeven met het tijdsbestek dat is ingesteld op 'Aangepast'. Het maximale datumbereik is 3 maanden.

Name Type Description
from

string (date-time)

De begindatum voor het exporteren van gegevens.
to

string (date-time)

De einddatum voor het exporteren van gegevens.

ExportType

Inventarisatie

Het type export. 'Gebruik' is gelijk aan 'ActualCost' en is van toepassing op exports die nog geen gegevens bieden voor kosten of afschrijving voor servicereserveringen.

Waarde Description
ActualCost
AmortizedCost
Usage

FormatType

Inventarisatie

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

Waarde Description
Csv

GranularityType

Inventarisatie

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

Waarde Description
Daily

RecurrenceType

Inventarisatie

Het schemapatroon.

Waarde Description
Annually
Daily
Monthly
Weekly

StatusType

Inventarisatie

De status van de exportplanning. Als 'Inactief' is, wordt het exportschema onderbroken.

Waarde Description
Active
Inactive

SystemAssignedServiceIdentity

Object

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

Name Type Description
principalId

string (uuid)

De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
tenantId

string (uuid)

De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
type

SystemAssignedServiceIdentityType

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

SystemAssignedServiceIdentityType

Inventarisatie

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

Waarde Description
None
SystemAssigned

TimeframeType

Inventarisatie

Het tijdsbestek voor het ophalen van gegevens voor de export. Als dit aangepast is, moet er een specifieke periode worden opgegeven.

Waarde Description
BillingMonthToDate
Custom
MonthToDate
TheLastBillingMonth
TheLastMonth
WeekToDate