Delen via


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

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

{
  "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

Sample Request

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

{
  "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

Sample Request

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

{
  "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

Sample Request

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

{
  "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

Sample Request

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

{
  "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

Sample Request

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

{
  "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
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