Exports - Create Or Update

Service:

Cost Management

API Version:

2023-11-01

Exportálás létrehozásához vagy frissítéséhez szükséges művelet. A frissítési művelethez be kell állítani a legújabb eTaget a kérelemben. Lekérési művelet végrehajtásával beszerezheti a legújabb eTaget. A létrehozási művelethez nincs szükség eTagre.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
exportName	path	True	string	Exportálás neve.
scope	path	True	string	Az exportálási műveletekhez társított hatókör. Ide tartozik a resourceGroup-hatókör "/subscriptions/{subscriptionId}/" előfizetési hatóköre, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}", "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" a számlázási fiók hatóköréhez és a "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}" osztály hatóköréhez, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}" a Felügyeleti csoport hatóköréhez tartozó EnrollmentAccount hatókörhöz: "/providers/Microsoft.Management/managementGroups/{managementGroupId} "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" a billingProfile hatókörhöz, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}" a invoiceSection scope és a "/providers/Microsoft. Számlázás/billingAccounts/{billingAccountId}/customers/{customerId}' a partnerekre vonatkozóan.
api-version	query	True	string	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
properties.definition	True	ExportDefinition	Rendelkezik az exportálás definícióval.
properties.deliveryInfo	True	ExportDeliveryInfo	Rendelkezik az exportálás kézbesítési adataival.
eTag		string	Az erőforrás eTagje. Az egyidejű frissítési forgatókönyv kezeléséhez ez a mező határozza meg, hogy a felhasználó frissíti-e a legújabb verziót.
identity		SystemAssignedServiceIdentity	Az Exportáláshoz társított felügyelt identitás
location		string	Az Exportálás felügyelt identitásának helye. Csak felügyelt identitás használatakor szükséges.
properties.format		FormatType	A kézbesített exportálás formátuma. Jelenleg csak a Csv támogatott.
properties.partitionData		boolean	Ha igaz értékre van állítva, az exportált adatok mérete szerint particionálódnak, és egy blobkönyvtárba kerülnek egy jegyzékfájllal együtt. Megjegyzés: ez a beállítás jelenleg csak Microsoft Ügyfélszerződés kereskedelmi hatókörökhöz érhető el.
properties.runHistory		ExportExecutionListResult	Ha szükséges, az exportálás legutóbbi futtatási előzményei vannak.
properties.schedule		ExportSchedule	Az exportálás ütemezési adataival rendelkezik.

Válaszok

Name	Típus	Description
200 OK	Export	OK gombra. A kérés sikeres volt.
201 Created	Export	Létrehozott.
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

ExportCreateOrUpdateByBillingAccount

ExportCreateOrUpdateByDepartment

ExportCreateOrUpdateByEnrollmentAccount

ExportCreateOrUpdateByManagementGroup

ExportCreateOrUpdateByResourceGroup

ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

201

{
  "id": "providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Status code:

200

{
  "id": "providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByDepartment

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

201

{
  "id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Status code:

200

{
  "id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByEnrollmentAccount

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

201

{
  "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Status code:

200

{
  "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByManagementGroup

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

201

{
  "id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Status code:

200

{
  "id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateByResourceGroup

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

201

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Status code:

200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportCreateOrUpdateBySubscription

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Sample Response

Status code:

201

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Status code:

200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Definíciók

Name	Description
CommonExportProperties	Az exportálás gyakori tulajdonságai.
ErrorDetails	A hiba részletei.
ErrorResponse	A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. Néhány hibaválasz: 429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után. 503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Várjon a „Retry-After” fejlécben megadott ideig, majd próbálkozzon újra.
ExecutionStatus	Az exportálási futtatás utolsó ismert állapota.
ExecutionType	Az exportálási futtatás típusa.
Export	Egy exportálási erőforrás.
ExportDataset	Az exportálásban lévő adatok definíciója.
ExportDatasetConfiguration	Az adathalmaz exportálási konfigurációja. Lehetővé teszi az oszlopok kijelölését az exportáláshoz. Ha nincs megadva, az exportálás az összes elérhető oszlopot tartalmazza.
ExportDefinition	Az exportálás definíciója.
ExportDeliveryDestination	Ez a Blob Storage-fiók azon helyét jelöli, ahol a költségek exportálása le lesz kézbesítve. A célhely kétféleképpen konfigurálható. A legtöbb ügyfél számára ajánlott a tárfiók resourceId azonosítójának megadása. Ehhez a fiók előfizetésének egyszeri regisztrációjára van szükség a Microsoft.CostManagementExports erőforrás-szolgáltatónál, hogy a Cost Management-szolgáltatások hozzáférhessenek a tárterülethez. Amikor exportálást hoz létre a Azure Portal a regisztráció automatikusan megtörténik, de előfordulhat, hogy az API-felhasználóknak explicit módon kell regisztrálniuk az előfizetést (további információ: https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). A célhely konfigurálásának másik módja csak azoknak a partnereknek érhető el, akik Microsoft Partnerszerződés csomagot használnak, akik a számlázási fiók globális rendszergazdái. Ezek a partnerek a tárfiók erőforrás-azonosítójának megadása helyett megadhatják a tárfiók nevét és a fiók SAS-jogkivonatát. Ez lehetővé teszi a költségek exportálását bármely bérlő tárfiókjába. Az SAS-jogkivonatot létre kell hozni a blobszolgáltatáshoz szolgáltatás-/tároló-/objektum-erőforrástípusokkal és olvasási/írási/törlési/listázási/hozzáadási/létrehozási engedélyekkel (további információ: https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).
ExportDeliveryInfo	Az exportáláshoz társított szállítási információk.
ExportExecutionListResult	Egy exportálás futtatási előzményeinek listázásának eredménye.
ExportRecurrencePeriod	Az ismétlődési ütemezés kezdő és záró dátuma.
ExportRun	Exportálási futtatás.
ExportSchedule	Az exportáláshoz társított ütemezés.
ExportTimePeriod	Az exportálásban lévő adatok dátumtartománya. Ezt csak akkor szabad megadni, ha a timeFrame értéke "Egyéni". A maximális dátumtartomány 3 hónap.
ExportType	Az exportálás típusa. Vegye figyelembe, hogy a "Használat" egyenértékű az "ActualCost" értékekkel, és olyan exportálásokra vonatkozik, amelyek még nem szolgáltatnak adatokat a szolgáltatásfoglalások díjairól vagy amortizációiról.
FormatType	A kézbesített exportálás formátuma. Jelenleg csak a Csv támogatott.
GranularityType	Az exportálás sorainak részletessége. Jelenleg csak a "Napi" támogatott.
RecurrenceType	Az ütemezés ismétlődése.
StatusType	Az exportálás ütemezésének állapota. Ha "Inaktív", az exportálás ütemezése szünetel.
SystemAssignedServiceIdentity	Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt vagy nincs)
SystemAssignedServiceIdentityType	A felügyeltszolgáltatás-identitás típusa (rendszer által hozzárendelt vagy egyik sem).
TimeframeType	Az adatok exportáláshoz való lekérésének időkerete. Ha egyéni, akkor meg kell adni egy adott időszakot.

CommonExportProperties

Az exportálás gyakori tulajdonságai.

Name	Típus	Description
definition	ExportDefinition	Rendelkezik az exportálás definícióval.
deliveryInfo	ExportDeliveryInfo	Rendelkezik az exportálás kézbesítési adataival.
format	FormatType	A kézbesített exportálás formátuma. Jelenleg csak a Csv támogatott.
nextRunTimeEstimate	string	Ha az exportálás aktív ütemezéssel rendelkezik, becslést ad a következő futtatási időpontról.
partitionData	boolean	Ha igaz értékre van állítva, az exportált adatok mérete szerint particionálódnak, és egy blobkönyvtárba kerülnek egy jegyzékfájllal együtt. Megjegyzés: ez a beállítás jelenleg csak Microsoft Ügyfélszerződés kereskedelmi hatókörökhöz érhető el.
runHistory	ExportExecutionListResult	Ha szükséges, az exportálás legutóbbi futtatási előzményei vannak.

ErrorDetails

A hiba részletei.

Name	Típus	Description
code	string	Hibakód.
message	string	Hibaüzenet jelzi, hogy a művelet miért nem sikerült.

ErrorResponse

A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.

Néhány hibaválasz:

• 429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után.

• 503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Várjon a „Retry-After” fejlécben megadott ideig, majd próbálkozzon újra.

Name	Típus	Description
error	ErrorDetails	A hiba részletei.

ExecutionStatus

Az exportálási futtatás utolsó ismert állapota.

Name	Típus	Description
Completed	string
DataNotAvailable	string
Failed	string
InProgress	string
NewDataNotAvailable	string
Queued	string
Timeout	string

ExecutionType

Az exportálási futtatás típusa.

Name	Típus	Description
OnDemand	string
Scheduled	string

Export

Egy exportálási erőforrás.

Name	Típus	Description
eTag	string	Az erőforrás eTagje. Az egyidejű frissítési forgatókönyv kezeléséhez ez a mező határozza meg, hogy a felhasználó a legújabb verziót frissíti-e.
id	string	Erőforrás-azonosító.
identity	SystemAssignedServiceIdentity	Az Exportáláshoz társított felügyelt identitás
location	string	Az exportálás felügyelt identitásának helye. Csak felügyelt identitás használatakor szükséges.
name	string	Erőforrás neve.
properties.definition	ExportDefinition	Rendelkezik az exportálás definícióval.
properties.deliveryInfo	ExportDeliveryInfo	Rendelkezik az exportálás szállítási adataival.
properties.format	FormatType	A kézbesített exportálás formátuma. Jelenleg csak a Csv támogatott.
properties.nextRunTimeEstimate	string	Ha az exportálás aktív ütemezéssel rendelkezik, megbecsüli a következő futási időt.
properties.partitionData	boolean	Ha igaz értékre van állítva, az exportált adatok mérete szerint lesznek particionálva, és egy blobkönyvtárba kerülnek egy jegyzékfájllal együtt. Megjegyzés: ez a beállítás jelenleg csak Microsoft Ügyfélszerződés kereskedelmi hatókörökhöz érhető el.
properties.runHistory	ExportExecutionListResult	Ha a kérelem kéri, az exportálás legutóbbi futtatási előzményei vannak.
properties.schedule	ExportSchedule	Az exportálás ütemezési adataival rendelkezik.
type	string	Erőforrástípus.

ExportDataset

Az exportálásban lévő adatok definíciója.

Name	Típus	Description
configuration	ExportDatasetConfiguration	Az adathalmaz exportálási konfigurációja.
granularity	GranularityType	Az exportálás sorainak részletessége. Jelenleg csak a "Daily" támogatott.

ExportDatasetConfiguration

Az adathalmaz exportálási konfigurációja. Lehetővé teszi az oszlopok kijelölését az exportáláshoz. Ha nincs megadva, az exportálás az összes elérhető oszlopot tartalmazza.

Name	Típus	Description
columns	string[]	Az exportálásban szerepeltetni kívánt oszlopnevek tömbje. Ha nincs megadva, az exportálás az összes elérhető oszlopot tartalmazza. Az elérhető oszlopok ügyfélcsatornánként változhatnak (lásd a példákat).

ExportDefinition

Az exportálás definíciója.

Name	Típus	Description
dataSet	ExportDataset	Az exportálásban lévő adatok definíciója.
timePeriod	ExportTimePeriod	Van idő az adatok exportáláshoz való lekérésére.
timeframe	TimeframeType	Az adatok exportáláshoz való lekérésének időkerete. Ha egyéni, akkor meg kell adni egy adott időszakot.
type	ExportType	Az exportálás típusa. Vegye figyelembe, hogy a "Használat" egyenértékű az "ActualCost" értékekkel, és olyan exportálásokra vonatkozik, amelyek még nem szolgáltatnak adatokat a szolgáltatásfoglalások díjairól vagy amortizációiról.

ExportDeliveryDestination

Ez a Blob Storage-fiók azon helyét jelöli, ahol a költségek exportálása le lesz kézbesítve. A célhely kétféleképpen konfigurálható. A legtöbb ügyfél számára ajánlott a tárfiók resourceId azonosítójának megadása. Ehhez a fiók előfizetésének egyszeri regisztrációjára van szükség a Microsoft.CostManagementExports erőforrás-szolgáltatónál, hogy a Cost Management-szolgáltatások hozzáférhessenek a tárterülethez. Amikor exportálást hoz létre a Azure Portal a regisztráció automatikusan megtörténik, de előfordulhat, hogy az API-felhasználóknak explicit módon kell regisztrálniuk az előfizetést (további információ: https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). A célhely konfigurálásának másik módja csak azoknak a partnereknek érhető el, akik Microsoft Partnerszerződés csomagot használnak, akik a számlázási fiók globális rendszergazdái. Ezek a partnerek a tárfiók erőforrás-azonosítójának megadása helyett megadhatják a tárfiók nevét és a fiók SAS-jogkivonatát. Ez lehetővé teszi a költségek exportálását bármely bérlő tárfiókjába. Az SAS-jogkivonatot létre kell hozni a blobszolgáltatáshoz szolgáltatás-/tároló-/objektum-erőforrástípusokkal és olvasási/írási/törlési/listázási/hozzáadási/létrehozási engedélyekkel (további információ: https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).

Name	Típus	Description
container	string	Annak a tárolónak a neve, amelyben az exportálások fel lesznek töltve. Ha a tároló nem létezik, létrejön.
resourceId	string	Annak a tárfióknak az erőforrás-azonosítója, ahol az exportálások kézbesítésre kerülnek. Ez nem szükséges, ha sasToken és storageAccount van megadva.
rootFolderPath	string	Annak a könyvtárnak a neve, amelyben az exportálások fel lesznek töltve.
sasToken	string	Sas-jogkivonat a tárfiókhoz. Az Azure-ügyfelek korlátozott készlete esetében ez a storageAccountkal együtt megadható a resourceId helyett. Megjegyzés: Az API által a tulajdonsághoz visszaadott érték mindig el lesz rejtve. Ha ugyanazt az elrejtett értéket adja vissza, az nem eredményezi az SAS-jogkivonat frissítését. Az érték frissítéséhez új SAS-jogkivonatot kell megadni.
storageAccount	string	A tárfiók, ahol az exportálások fel lesznek töltve. Korlátozott Azure-ügyfelek esetén ez a sasTokennel együtt megadható a resourceId helyett.

ExportDeliveryInfo

Az exportáláshoz társított szállítási információk.

Name	Típus	Description
destination	ExportDeliveryDestination	Rendelkezik a kézbesített exportálás célhelyével.

ExportExecutionListResult

Egy exportálás futtatási előzményeinek listázásának eredménye.

Name	Típus	Description
value	ExportRun[]	Az exportálási futtatások listája.

ExportRecurrencePeriod

Az ismétlődési ütemezés kezdő és záró dátuma.

Name	Típus	Description
from	string	Az ismétlődés kezdő dátuma.
to	string	Az ismétlődés záró dátuma.

ExportRun

Exportálási futtatás.

Name	Típus	Description
eTag	string	Az erőforrás eTagje. Az egyidejű frissítési forgatókönyv kezeléséhez ez a mező határozza meg, hogy a felhasználó frissíti-e a legújabb verziót.
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.error	ErrorDetails	A hibák részletei.
properties.executionType	ExecutionType	Az exportálási futtatás típusa.
properties.fileName	string	Az exportált fájl neve.
properties.processingEndTime	string	Az exportálási futtatás befejezésének időpontja.
properties.processingStartTime	string	Az exportálás indításának időpontja.
properties.runSettings	CommonExportProperties	A futtatáshoz érvényben lévő exportálási beállítások.
properties.status	ExecutionStatus	Az exportálási futtatás utolsó ismert állapota.
properties.submittedBy	string	Az exportálást kiváltó entitás azonosítója. Igény szerinti futtatások esetén ez a felhasználói e-mail-cím. Ütemezett futtatások esetén ez a "Rendszer".
properties.submittedTime	string	Az exportálás várólistára helyezésének időpontja.
type	string	Erőforrástípus.

ExportSchedule

Az exportáláshoz társított ütemezés.

Name	Típus	Description
recurrence	RecurrenceType	Az ütemezés ismétlődése.
recurrencePeriod	ExportRecurrencePeriod	Az ismétlődés kezdő és záró dátuma. A kezdési dátumnak a jövőben kell lennie. Ha van ilyen, a záró dátumnak nagyobbnak kell lennie a kezdő dátumnál.
status	StatusType	Az exportálás ütemezésének állapota. Ha "Inaktív", az exportálás ütemezése szünetel.

ExportTimePeriod

Az exportálásban lévő adatok dátumtartománya. Ezt csak akkor szabad megadni, ha a timeFrame értéke "Egyéni". A maximális dátumtartomány 3 hónap.

Name	Típus	Description
from	string	Az adatok exportálásának kezdő dátuma.
to	string	Az adatok exportálásának záró dátuma.

ExportType

Az exportálás típusa. Vegye figyelembe, hogy a "Használat" egyenértékű az "ActualCost" értékekkel, és olyan exportálásokra vonatkozik, amelyek még nem szolgáltatnak adatokat a szolgáltatásfoglalások díjairól vagy amortizációiról.

Name	Típus	Description
ActualCost	string
AmortizedCost	string
Usage	string

FormatType

A kézbesített exportálás formátuma. Jelenleg csak a Csv támogatott.

Name	Típus	Description
Csv	string

GranularityType

Az exportálás sorainak részletessége. Jelenleg csak a "Napi" támogatott.

Name	Típus	Description
Daily	string

RecurrenceType

Az ütemezés ismétlődése.

Name	Típus	Description
Annually	string
Daily	string
Monthly	string
Weekly	string

StatusType

Az exportálás ütemezésének állapota. Ha "Inaktív", az exportálás ütemezése szünetel.

Name	Típus	Description
Active	string
Inactive	string

SystemAssignedServiceIdentity

Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt vagy nincs)

Name	Típus	Description
principalId	string	A rendszer által hozzárendelt identitás szolgáltatásnév-azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.
tenantId	string	A rendszer által hozzárendelt identitás bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.
type	SystemAssignedServiceIdentityType	A felügyeltszolgáltatás-identitás típusa (rendszer által hozzárendelt vagy egyik sem).

SystemAssignedServiceIdentityType

A felügyeltszolgáltatás-identitás típusa (rendszer által hozzárendelt vagy egyik sem).

Name	Típus	Description
None	string
SystemAssigned	string

TimeframeType

Az adatok exportáláshoz való lekérésének időkerete. Ha egyéni, akkor meg kell adni egy adott időszakot.

Name	Típus	Description
BillingMonthToDate	string
Custom	string
MonthToDate	string
TheLastBillingMonth	string
TheLastMonth	string
WeekToDate	string