Exports - Create Or Update

Referenz

Dienst:: Cost Management

API-Version:: 2024-08-01

Der Vorgang zum Erstellen oder Aktualisieren eines Exports. Für den Aktualisierungsvorgang muss das neueste eTag in der Anforderung festgelegt werden. Sie können das neueste eTag abrufen, indem Sie einen Get-Vorgang ausführen. Für den Erstellungsvorgang ist kein eTag erforderlich.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
exportName	path	True	string	Exportname.
scope	path	True	string	Der Bereich, der Exportvorgängen zugeordnet ist. Dies schließt "/subscriptions/{subscriptionId}/" für den Abonnementbereich ein, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' für resourceGroup-Bereich, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' für Abrechnungskontobereich und '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' für Abteilungsbereich, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' für enrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}, for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' für billingProfile scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' für invoiceSection scope, and '/providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' speziell für Partner.
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.definition	True	ExportDefinition	Weist die Definition für den Export auf.
properties.deliveryInfo	True	ExportDeliveryInfo	Enthält Übermittlungsinformationen für den Export.
eTag		string	eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
identity		SystemAssignedServiceIdentity	Die verwaltete Identität, die dem Export zugeordnet ist
location		string	Der Speicherort der verwalteten Identität des Exports. Nur erforderlich, wenn verwaltete Identität verwendet wird.
properties.format		FormatType	Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.
properties.partitionData		boolean	Bei Festlegung auf "true" werden exportierte Daten nach Größe partitioniert und in einem BLOB-Verzeichnis zusammen mit einer Manifestdatei platziert. Hinweis: Diese Option ist derzeit nur für Microsoft Customer Agreement Commerce-Bereiche verfügbar.
properties.runHistory		ExportExecutionListResult	Falls angefordert, weist den letzten Ausführungsverlauf für den Export auf.
properties.schedule		ExportSchedule	Enthält Zeitplaninformationen für den Export.

Antworten

Name	Typ	Beschreibung
200 OK	Export	OKAY. Die Anforderung ist erfolgreich.
201 Created	Export	Erstellt.
Other Status Codes	ErrorResponse	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

ExportCreateOrUpdateByBillingAccount

ExportCreateOrUpdateByDepartment

ExportCreateOrUpdateByEnrollmentAccount

ExportCreateOrUpdateByManagementGroup

ExportCreateOrUpdateByResourceGroup

ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
CommonExportProperties	Die allgemeinen Eigenschaften des Exports.
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten: 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit. 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.
ExecutionStatus	Der letzte bekannte Status der Exportausführung.
ExecutionType	Der Typ der Exportausführung.
Export	Eine Exportressource.
ExportDataset	Die Definition für Daten im Export.
ExportDatasetConfiguration	Die Konfiguration des Export-Datasets. Ermöglicht die Auswahl von Spalten für den Export. Wenn nicht angegeben, enthält der Export alle verfügbaren Spalten.
ExportDefinition	Die Definition eines Exports.
ExportDeliveryDestination	Dies stellt den Speicherort des BLOB-Speicherkontos dar, an den Exporte von Kosten übermittelt werden. Es gibt zwei Möglichkeiten zum Konfigurieren des Ziels. Der für die meisten Kunden empfohlene Ansatz besteht darin, die resourceId des Speicherkontos anzugeben. Dies erfordert eine einmalige Registrierung des Kontoabonnements beim Microsoft.CostManagementExports-Ressourcenanbieter, um Kostenverwaltungsdienste Zugriff auf den Speicher zu gewähren. Beim Erstellen eines Exports im Azure-Portal wird diese Registrierung automatisch ausgeführt, API-Benutzer müssen das Abonnement jedoch möglicherweise explizit registrieren (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Eine weitere Möglichkeit zum Konfigurieren des Ziels ist NUR für Partner mit einem Microsoft Partner Agreement-Plan verfügbar, der globale Administratoren ihres Abrechnungskontos sind. Diese Partner können anstelle der resourceId eines Speicherkontos den Namen des Speicherkontos zusammen mit einem SAS-Token für das Konto angeben. Auf diese Weise können Kosten in ein Speicherkonto in jedem Mandanten exportiert werden. Das SAS-Token sollte für den BLOB-Dienst mit Dienst-/Container-/Objektressourcentypen und mit Lese-/Schreibzugriff/Delete/List/Add/Create-Berechtigungen erstellt werden (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).
ExportDeliveryInfo	Die Übermittlungsinformationen, die einem Export zugeordnet sind.
ExportExecutionListResult	Ergebnis der Auflistung des Ausführungsverlaufs eines Exports.
ExportRecurrencePeriod	Das Start- und Enddatum für den Serienzeitplan.
ExportRun	Ein Exportlauf.
ExportSchedule	Der mit dem Export verknüpfte Zeitplan.
ExportTimePeriod	Der Datumsbereich für Daten im Export. Dies sollte nur mit timeFrame angegeben werden, der auf "Benutzerdefiniert" festgelegt ist. Der maximale Datumsbereich beträgt 3 Monate.
ExportType	Der Typ des Exports. Beachten Sie, dass "Usage" gleichbedeutend mit "ActualCost" ist und für Exporte gilt, die noch keine Daten für Gebühren oder Amortisierungen für Servicereservierungen bereitstellen.
FormatType	Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.
GranularityType	Die Granularität der Zeilen im Export. Derzeit wird nur "Täglich" unterstützt.
RecurrenceType	Die Terminserie.
StatusType	Der Status des Exportzeitplans. Wenn "Inaktiv" ist der Exportzeitplan angehalten.
SystemAssignedServiceIdentity	Identität des verwalteten Diensts (entweder vom System zugewiesen oder ohne)
SystemAssignedServiceIdentityType	Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne).
TimeframeType	Der Zeitrahmen zum Abrufen von Daten für den Export. Wenn benutzerdefiniert, muss ein bestimmter Zeitraum angegeben werden.

CommonExportProperties

Die allgemeinen Eigenschaften des Exports.

Name	Typ	Beschreibung
definition	ExportDefinition	Weist die Definition für den Export auf.
deliveryInfo	ExportDeliveryInfo	Enthält Übermittlungsinformationen für den Export.
format	FormatType	Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.
nextRunTimeEstimate	string	Wenn der Export über einen aktiven Zeitplan verfügt, wird eine Schätzung der nächsten Laufzeit bereitgestellt.
partitionData	boolean	Bei Festlegung auf "true" werden exportierte Daten nach Größe partitioniert und in einem BLOB-Verzeichnis zusammen mit einer Manifestdatei platziert. Hinweis: Diese Option ist derzeit nur für Microsoft Customer Agreement Commerce-Bereiche verfügbar.
runHistory	ExportExecutionListResult	Falls angefordert, weist den letzten Ausführungsverlauf für den Export auf.

ErrorDetails

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode.
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.
503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

ExecutionStatus

Der letzte bekannte Status der Exportausführung.

Name	Typ	Beschreibung
Completed	string
DataNotAvailable	string
Failed	string
InProgress	string
NewDataNotAvailable	string
Queued	string
Timeout	string

ExecutionType

Der Typ der Exportausführung.

Name	Typ	Beschreibung
OnDemand	string
Scheduled	string

Export

Eine Exportressource.

Name	Typ	Beschreibung
eTag	string	eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
id	string	Ressourcen-ID.
identity	SystemAssignedServiceIdentity	Die verwaltete Identität, die dem Export zugeordnet ist
location	string	Der Speicherort der verwalteten Identität des Exports. Nur erforderlich, wenn verwaltete Identität verwendet wird.
name	string	Ressourcenname.
properties.definition	ExportDefinition	Weist die Definition für den Export auf.
properties.deliveryInfo	ExportDeliveryInfo	Enthält Übermittlungsinformationen für den Export.
properties.format	FormatType	Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.
properties.nextRunTimeEstimate	string	Wenn der Export über einen aktiven Zeitplan verfügt, wird eine Schätzung der nächsten Laufzeit bereitgestellt.
properties.partitionData	boolean	Bei Festlegung auf "true" werden exportierte Daten nach Größe partitioniert und in einem BLOB-Verzeichnis zusammen mit einer Manifestdatei platziert. Hinweis: Diese Option ist derzeit nur für Microsoft Customer Agreement Commerce-Bereiche verfügbar.
properties.runHistory	ExportExecutionListResult	Falls angefordert, weist den letzten Ausführungsverlauf für den Export auf.
properties.schedule	ExportSchedule	Enthält Zeitplaninformationen für den Export.
type	string	Ressourcentyp.

ExportDataset

Die Definition für Daten im Export.

Name	Typ	Beschreibung
configuration	ExportDatasetConfiguration	Die Konfiguration des Export-Datasets.
granularity	GranularityType	Die Granularität der Zeilen im Export. Derzeit wird nur "Täglich" unterstützt.

ExportDatasetConfiguration

Die Konfiguration des Export-Datasets. Ermöglicht die Auswahl von Spalten für den Export. Wenn nicht angegeben, enthält der Export alle verfügbaren Spalten.

Name	Typ	Beschreibung
columns	string[]	Array von Spaltennamen, die im Export enthalten sein sollen. Wenn nicht angegeben, enthält der Export alle verfügbaren Spalten. Die verfügbaren Spalten können je nach Kundenkanal variieren (siehe Beispiele).

ExportDefinition

Die Definition eines Exports.

Name	Typ	Beschreibung
dataSet	ExportDataset	Die Definition für Daten im Export.
timePeriod	ExportTimePeriod	Hat einen Zeitraum für das Abrufen von Daten für den Export.
timeframe	TimeframeType	Der Zeitrahmen zum Abrufen von Daten für den Export. Wenn benutzerdefiniert, muss ein bestimmter Zeitraum angegeben werden.
type	ExportType	Der Typ des Exports. Beachten Sie, dass "Usage" gleichbedeutend mit "ActualCost" ist und für Exporte gilt, die noch keine Daten für Gebühren oder Amortisierungen für Servicereservierungen bereitstellen.

ExportDeliveryDestination

Dies stellt den Speicherort des BLOB-Speicherkontos dar, an den Exporte von Kosten übermittelt werden. Es gibt zwei Möglichkeiten zum Konfigurieren des Ziels. Der für die meisten Kunden empfohlene Ansatz besteht darin, die resourceId des Speicherkontos anzugeben. Dies erfordert eine einmalige Registrierung des Kontoabonnements beim Microsoft.CostManagementExports-Ressourcenanbieter, um Kostenverwaltungsdienste Zugriff auf den Speicher zu gewähren. Beim Erstellen eines Exports im Azure-Portal wird diese Registrierung automatisch ausgeführt, API-Benutzer müssen das Abonnement jedoch möglicherweise explizit registrieren (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Eine weitere Möglichkeit zum Konfigurieren des Ziels ist NUR für Partner mit einem Microsoft Partner Agreement-Plan verfügbar, der globale Administratoren ihres Abrechnungskontos sind. Diese Partner können anstelle der resourceId eines Speicherkontos den Namen des Speicherkontos zusammen mit einem SAS-Token für das Konto angeben. Auf diese Weise können Kosten in ein Speicherkonto in jedem Mandanten exportiert werden. Das SAS-Token sollte für den BLOB-Dienst mit Dienst-/Container-/Objektressourcentypen und mit Lese-/Schreibzugriff/Delete/List/Add/Create-Berechtigungen erstellt werden (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).

Name	Typ	Beschreibung
container	string	Der Name des Containers, in den Exporte hochgeladen werden. Wenn der Container nicht vorhanden ist, wird er erstellt.
resourceId	string	Die Ressourcen-ID des Speicherkontos, in dem Exporte übermittelt werden. Dies ist nicht erforderlich, wenn ein sasToken und storageAccount angegeben sind.
rootFolderPath	string	Der Name des Verzeichnisses, in das Exporte hochgeladen werden.
sasToken	string	Ein SAS-Token für das Speicherkonto. Für einen eingeschränkten Satz von Azure-Kunden kann dies zusammen mit storageAccount anstelle von resourceId angegeben werden. Hinweis: Der von der API für diese Eigenschaft zurückgegebene Wert wird immer verschleiert. Das Zurückgeben dieses verschleierten Werts führt nicht dazu, dass das SAS-Token aktualisiert wird. Um diesen Wert zu aktualisieren, muss ein neues SAS-Token angegeben werden.
storageAccount	string	Das Speicherkonto, für das Exporte hochgeladen werden. Für einen eingeschränkten Satz von Azure-Kunden kann dies zusammen mit sasToken anstelle von resourceId angegeben werden.

ExportDeliveryInfo

Die Übermittlungsinformationen, die einem Export zugeordnet sind.

Name	Typ	Beschreibung
destination	ExportDeliveryDestination	Hat das Ziel für den zugestellten Export.

ExportExecutionListResult

Ergebnis der Auflistung des Ausführungsverlaufs eines Exports.

Name	Typ	Beschreibung
value	ExportRun[]	Eine Liste der Exportausführungen.

ExportRecurrencePeriod

Das Start- und Enddatum für den Serienzeitplan.

Name	Typ	Beschreibung
from	string	Das Startdatum der Serie.
to	string	Das Enddatum der Serie.

ExportRun

Ein Exportlauf.

Name	Typ	Beschreibung
eTag	string	eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.error	ErrorDetails	Die Details eines Fehlers.
properties.executionType	ExecutionType	Der Typ der Exportausführung.
properties.fileName	string	Der Name der exportierten Datei.
properties.processingEndTime	string	Der Zeitpunkt, zu dem der Exportvorgang abgeschlossen ist.
properties.processingStartTime	string	Die Zeit, zu der der Export aufgenommen wurde, um ausgeführt zu werden.
properties.runSettings	CommonExportProperties	Die Exporteinstellungen, die für diese Ausführung wirksam waren.
properties.status	ExecutionStatus	Der letzte bekannte Status der Exportausführung.
properties.submittedBy	string	Der Bezeichner für die Entität, die den Export ausgelöst hat. Bei bedarfsgesteuerten Ausführungen handelt es sich um die Benutzer-E-Mail. Bei geplanten Ausführungen ist es "System".
properties.submittedTime	string	Die Zeit, zu der der Export in die Warteschlange gestellt wurde, um ausgeführt zu werden.
type	string	Ressourcentyp.

ExportSchedule

Der mit dem Export verknüpfte Zeitplan.

Name	Typ	Beschreibung
recurrence	RecurrenceType	Die Terminserie.
recurrencePeriod	ExportRecurrencePeriod	Hat das Start- und Enddatum der Serie. Das Startdatum muss in Zukunft sein. Wenn vorhanden, muss das Enddatum größer als das Startdatum sein.
status	StatusType	Der Status des Exportzeitplans. Wenn "Inaktiv" ist der Exportzeitplan angehalten.

ExportTimePeriod

Der Datumsbereich für Daten im Export. Dies sollte nur mit timeFrame angegeben werden, der auf "Benutzerdefiniert" festgelegt ist. Der maximale Datumsbereich beträgt 3 Monate.

Name	Typ	Beschreibung
from	string	Das Startdatum für Exportdaten.
to	string	Das Enddatum für exportdaten.

ExportType

Der Typ des Exports. Beachten Sie, dass "Usage" gleichbedeutend mit "ActualCost" ist und für Exporte gilt, die noch keine Daten für Gebühren oder Amortisierungen für Servicereservierungen bereitstellen.

Name	Typ	Beschreibung
ActualCost	string
AmortizedCost	string
Usage	string

FormatType

Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.

Name	Typ	Beschreibung
Csv	string

GranularityType

Die Granularität der Zeilen im Export. Derzeit wird nur "Täglich" unterstützt.

Name	Typ	Beschreibung
Daily	string

RecurrenceType

Die Terminserie.

Name	Typ	Beschreibung
Annually	string
Daily	string
Monthly	string
Weekly	string

StatusType

Der Status des Exportzeitplans. Wenn "Inaktiv" ist der Exportzeitplan angehalten.

Name	Typ	Beschreibung
Active	string
Inactive	string

SystemAssignedServiceIdentity

Identität des verwalteten Diensts (entweder vom System zugewiesen oder ohne)

Name	Typ	Beschreibung
principalId	string	Die Dienstprinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.
tenantId	string	Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.
type	SystemAssignedServiceIdentityType	Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne).

SystemAssignedServiceIdentityType

Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne).

Name	Typ	Beschreibung
None	string
SystemAssigned	string

TimeframeType

Der Zeitrahmen zum Abrufen von Daten für den Export. Wenn benutzerdefiniert, muss ein bestimmter Zeitraum angegeben werden.

Name	Typ	Beschreibung
BillingMonthToDate	string
Custom	string
MonthToDate	string
TheLastBillingMonth	string
TheLastMonth	string
WeekToDate	string

Freigeben über

Exports - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

ExportCreateOrUpdateByBillingAccount

Beispielanforderung

Beispiel für eine Antwort

ExportCreateOrUpdateByDepartment

Beispielanforderung

Beispiel für eine Antwort

ExportCreateOrUpdateByEnrollmentAccount

Beispielanforderung

Beispiel für eine Antwort

ExportCreateOrUpdateByManagementGroup

Beispielanforderung

Beispiel für eine Antwort

ExportCreateOrUpdateByResourceGroup

Beispielanforderung

Beispiel für eine Antwort

ExportCreateOrUpdateBySubscription

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CommonExportProperties

ErrorDetails

ErrorResponse

ExecutionStatus

ExecutionType

Export

ExportDataset

ExportDatasetConfiguration

ExportDefinition

ExportDeliveryDestination

ExportDeliveryInfo

ExportExecutionListResult

ExportRecurrencePeriod

ExportRun

ExportSchedule

ExportTimePeriod

ExportType

FormatType

GranularityType

RecurrenceType

StatusType

SystemAssignedServiceIdentity

SystemAssignedServiceIdentityType

TimeframeType

Zusätzliche Ressourcen