Exports - Create Or Update

Ссылка

Служба:: Cost Management

Версия API:: 2024-08-01

Операция создания или обновления экспорта. Для операции обновления требуется установить в запросе последнюю версию eTag. Вы можете получить последнюю версию eTag, выполнив операцию получения. Операция создания не требует eTag.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
exportName	path	True	string	Имя экспорта.
scope	path	True	string	Область, связанная с операциями экспорта. Это включает в себя "/subscriptions/{subscriptionId}/" для области подписки, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}" для области resourceGroup, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' для области учетной записи выставления счетов и "/поставщики/Microsoft.Billing/billingAccounts/{billingAccountId}/departmentId}" для области отдела, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' для области EnrollmentAccount, "/providers/Microsoft.Management/managementGroups/{managementGroupId} для области группы управления, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" для области выставления счетов, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceProfileId/accountSections/{invoiceSectionId}" для области выставления счетов и "/поставщики/Майкрософт". Выставление счетов,выставление счетов/выставление счетов/{billingAccountId}/customers/{customerId}" для партнеров.
api-version	query	True	string	Версия API, используемая для этой операции.

Текст запроса

Имя	Обязательно	Тип	Описание
properties.definition	True	ExportDefinition	Имеет определение для экспорта.
properties.deliveryInfo	True	ExportDeliveryInfo	Содержит сведения о доставке для экспорта.
eTag		string	eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет.
identity		SystemAssignedServiceIdentity	Управляемое удостоверение, связанное с экспортом
location		string	Расположение управляемого удостоверения экспорта. Требуется только при использовании управляемого удостоверения.
properties.format		FormatType	Формат доставки экспорта. В настоящее время поддерживается только csv-файл.
properties.partitionData		boolean	Если задано значение true, экспортированные данные будут секционированы по размеру и помещены в каталог BLOB-объектов вместе с файлом манифеста. Примечание. В настоящее время этот параметр доступен только для областей торговли клиентского соглашения Майкрософт.
properties.runHistory		ExportExecutionListResult	При запросе используется самый последний журнал выполнения для экспорта.
properties.schedule		ExportSchedule	Содержит сведения о расписании экспорта.

Ответы

Имя	Тип	Описание
200 OK	Export	ХОРОШО. Запрос выполнен успешно.
201 Created	Export	Созданный.
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

ExportCreateOrUpdateByBillingAccount

ExportCreateOrUpdateByDepartment

ExportCreateOrUpdateByEnrollmentAccount

ExportCreateOrUpdateByManagementGroup

ExportCreateOrUpdateByResourceGroup

ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Образец запроса

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

Пример ответа

Код состояния:: 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"
          ]
        }
      }
    }
  }
}

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
          ]
        }
      }
    }
  }
}

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
          ]
        }
      }
    }
  }
}

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
          ]
        }
      }
    }
  }
}

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
          ]
        }
      }
    }
  }
}

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
          ]
        }
      }
    }
  }
}

Код состояния:: 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"
          ]
        }
      }
    }
  }
}

Определения

Имя	Описание
CommonExportProperties	Общие свойства экспорта.
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. Некоторые ответы на ошибки: 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.
ExecutionStatus	Последнее известное состояние выполнения экспорта.
ExecutionType	Тип выполнения экспорта.
Export	Ресурс экспорта.
ExportDataset	Определение данных в экспорте.
ExportDatasetConfiguration	Конфигурация экспортируемых наборов данных. Позволяет выбирать столбцы для экспорта. Если экспорт не указан, он будет содержать все доступные столбцы.
ExportDefinition	Определение экспорта.
ExportDeliveryDestination	Это представляет расположение учетной записи хранения BLOB-объектов, в которой будут доставлены экспорт затраты. Существует два способа настройки назначения. Рекомендуемый для большинства клиентов подход — указать идентификатор ресурса учетной записи хранения. Для этого требуется однократная регистрация подписки учетной записи с помощью поставщика ресурсов Microsoft.CostManagementExports, чтобы предоставить службам управления затратами доступ к хранилищу. При создании экспорта на портале Azure эта регистрация выполняется автоматически, но пользователям API может потребоваться явно зарегистрировать подписку (дополнительные сведения см. в https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Другой способ настройки назначения доступен только партнерам с планом соглашения о партнере Майкрософт, которые являются глобальными администраторами своей учетной записи выставления счетов. Эти партнеры вместо указания идентификатора ресурса учетной записи хранения могут указать имя учетной записи хранения вместе с маркером SAS для учетной записи. Это позволяет экспортировать затраты в учетную запись хранения в любом клиенте. Маркер SAS должен быть создан для службы BLOB-объектов с типами ресурсов Service/Container/Object и с разрешениями read/Write/Delete/List/Add/Create (дополнительные сведения см. в https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).
ExportDeliveryInfo	Сведения о доставке, связанные с экспортом.
ExportExecutionListResult	Результат перечисления журнала выполнения экспорта.
ExportRecurrencePeriod	Дата начала и окончания расписания повторения.
ExportRun	Запуск экспорта.
ExportSchedule	Расписание, связанное с экспортом.
ExportTimePeriod	Диапазон дат для данных в экспорте. Это должно быть указано только с интервалом времени, равным Custom. Максимальный диапазон дат составляет 3 месяца.
ExportType	Тип экспорта. Обратите внимание, что "Использование" эквивалентно "ActualCost" и применимо к экспорту, которые еще не предоставляют данные для оплаты или амортизации для резервирований служб.
FormatType	Формат доставки экспорта. В настоящее время поддерживается только csv-файл.
GranularityType	Степень детализации строк в экспорте. В настоящее время поддерживается только "Daily".
RecurrenceType	Повторение расписания.
StatusType	Состояние расписания экспорта. Если значение неактивно, расписание экспорта приостановлено.
SystemAssignedServiceIdentity	Управляемое удостоверение службы (назначаемое системой или нет)
SystemAssignedServiceIdentityType	Тип управляемого удостоверения службы (назначенный системой или нет).
TimeframeType	Интервал времени для извлечения данных для экспорта. Если это настраивается, необходимо указать определенный период времени.

CommonExportProperties

Общие свойства экспорта.

Имя	Тип	Описание
definition	ExportDefinition	Имеет определение для экспорта.
deliveryInfo	ExportDeliveryInfo	Содержит сведения о доставке для экспорта.
format	FormatType	Формат доставки экспорта. В настоящее время поддерживается только csv-файл.
nextRunTimeEstimate	string	Если экспорт имеет активное расписание, предоставляет оценку следующего времени выполнения.
partitionData	boolean	Если задано значение true, экспортированные данные будут секционированы по размеру и помещены в каталог BLOB-объектов вместе с файлом манифеста. Примечание. В настоящее время этот параметр доступен только для областей торговли клиентского соглашения Майкрософт.
runHistory	ExportExecutionListResult	При запросе используется самый последний журнал выполнения для экспорта.

ErrorDetails

Сведения об ошибке.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ErrorResponse

Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Некоторые ответы на ошибки:

429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.

Имя	Тип	Описание
error	ErrorDetails	Сведения об ошибке.

ExecutionStatus

Последнее известное состояние выполнения экспорта.

Имя	Тип	Описание
Completed	string
DataNotAvailable	string
Failed	string
InProgress	string
NewDataNotAvailable	string
Queued	string
Timeout	string

ExecutionType

Тип выполнения экспорта.

Имя	Тип	Описание
OnDemand	string
Scheduled	string

Export

Ресурс экспорта.

Имя	Тип	Описание
eTag	string	eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет.
id	string	Идентификатор ресурса.
identity	SystemAssignedServiceIdentity	Управляемое удостоверение, связанное с экспортом
location	string	Расположение управляемого удостоверения экспорта. Требуется только при использовании управляемого удостоверения.
name	string	Имя ресурса.
properties.definition	ExportDefinition	Имеет определение для экспорта.
properties.deliveryInfo	ExportDeliveryInfo	Содержит сведения о доставке для экспорта.
properties.format	FormatType	Формат доставки экспорта. В настоящее время поддерживается только csv-файл.
properties.nextRunTimeEstimate	string	Если экспорт имеет активное расписание, предоставляет оценку следующего времени выполнения.
properties.partitionData	boolean	Если задано значение true, экспортированные данные будут секционированы по размеру и помещены в каталог BLOB-объектов вместе с файлом манифеста. Примечание. В настоящее время этот параметр доступен только для областей торговли клиентского соглашения Майкрософт.
properties.runHistory	ExportExecutionListResult	При запросе используется самый последний журнал выполнения для экспорта.
properties.schedule	ExportSchedule	Содержит сведения о расписании экспорта.
type	string	Тип ресурса.

ExportDataset

Определение данных в экспорте.

Имя	Тип	Описание
configuration	ExportDatasetConfiguration	Конфигурация экспортируемых наборов данных.
granularity	GranularityType	Степень детализации строк в экспорте. В настоящее время поддерживается только "Daily".

ExportDatasetConfiguration

Конфигурация экспортируемых наборов данных. Позволяет выбирать столбцы для экспорта. Если экспорт не указан, он будет содержать все доступные столбцы.

Имя	Тип	Описание
columns	string[]	Массив имен столбцов для включения в экспорт. Если экспорт не указан, он будет содержать все доступные столбцы. Доступные столбцы могут отличаться по каналу клиента (см. примеры).

ExportDefinition

Определение экспорта.

Имя	Тип	Описание
dataSet	ExportDataset	Определение данных в экспорте.
timePeriod	ExportTimePeriod	Имеет период времени для извлечения данных для экспорта.
timeframe	TimeframeType	Интервал времени для извлечения данных для экспорта. Если это настраивается, необходимо указать определенный период времени.
type	ExportType	Тип экспорта. Обратите внимание, что "Использование" эквивалентно "ActualCost" и применимо к экспорту, которые еще не предоставляют данные для оплаты или амортизации для резервирований служб.

ExportDeliveryDestination

Это представляет расположение учетной записи хранения BLOB-объектов, в которой будут доставлены экспорт затраты. Существует два способа настройки назначения. Рекомендуемый для большинства клиентов подход — указать идентификатор ресурса учетной записи хранения. Для этого требуется однократная регистрация подписки учетной записи с помощью поставщика ресурсов Microsoft.CostManagementExports, чтобы предоставить службам управления затратами доступ к хранилищу. При создании экспорта на портале Azure эта регистрация выполняется автоматически, но пользователям API может потребоваться явно зарегистрировать подписку (дополнительные сведения см. в https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Другой способ настройки назначения доступен только партнерам с планом соглашения о партнере Майкрософт, которые являются глобальными администраторами своей учетной записи выставления счетов. Эти партнеры вместо указания идентификатора ресурса учетной записи хранения могут указать имя учетной записи хранения вместе с маркером SAS для учетной записи. Это позволяет экспортировать затраты в учетную запись хранения в любом клиенте. Маркер SAS должен быть создан для службы BLOB-объектов с типами ресурсов Service/Container/Object и с разрешениями read/Write/Delete/List/Add/Create (дополнительные сведения см. в https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).

Имя	Тип	Описание
container	string	Имя контейнера, в котором будут отправлены экспорты. Если контейнер не существует, он будет создан.
resourceId	string	Идентификатор ресурса учетной записи хранения, в которой будут доставлены экспорты. Это не обязательно, если задан sasToken и storageAccount.
rootFolderPath	string	Имя каталога, в котором будут отправлены экспорты.
sasToken	string	Маркер SAS для учетной записи хранения. Для ограниченного набора клиентов Azure, которые вместе с storageAccount можно указать вместо resourceId. Примечание. Значение, возвращаемое API для этого свойства, всегда будет зафиксировано. При возврате этого же запутываемого значения не будет обновляться маркер SAS. Чтобы обновить это значение, необходимо указать новый маркер SAS.
storageAccount	string	Учетная запись хранения, в которой будут отправлены экспорты. Для ограниченного набора клиентов Azure это вместе с sasToken можно указать вместо resourceId.

ExportDeliveryInfo

Сведения о доставке, связанные с экспортом.

Имя	Тип	Описание
destination	ExportDeliveryDestination	Имеет место назначения для доставки экспорта.

ExportExecutionListResult

Результат перечисления журнала выполнения экспорта.

Имя	Тип	Описание
value	ExportRun[]	Список запусков экспорта.

ExportRecurrencePeriod

Дата начала и окончания расписания повторения.

Имя	Тип	Описание
from	string	Дата начала повторения.
to	string	Дата окончания повторения.

ExportRun

Запуск экспорта.

Имя	Тип	Описание
eTag	string	eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет.
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.error	ErrorDetails	Сведения о любой ошибке.
properties.executionType	ExecutionType	Тип выполнения экспорта.
properties.fileName	string	Имя экспортированного файла.
properties.processingEndTime	string	Время завершения выполнения экспорта.
properties.processingStartTime	string	Время выполнения экспорта.
properties.runSettings	CommonExportProperties	Параметры экспорта, которые были в действии для этого запуска.
properties.status	ExecutionStatus	Последнее известное состояние выполнения экспорта.
properties.submittedBy	string	Идентификатор сущности, которая активировала экспорт. Для запуска по запросу это электронная почта пользователя. Для запланированных запусков используется system.
properties.submittedTime	string	Время выполнения экспорта.
type	string	Тип ресурса.

ExportSchedule

Расписание, связанное с экспортом.

Имя	Тип	Описание
recurrence	RecurrenceType	Повторение расписания.
recurrencePeriod	ExportRecurrencePeriod	Имеет дату начала и окончания повторения. Дата начала должна быть в будущем. При наличии дата окончания должна быть больше даты начала.
status	StatusType	Состояние расписания экспорта. Если значение неактивно, расписание экспорта приостановлено.

ExportTimePeriod

Диапазон дат для данных в экспорте. Это должно быть указано только с интервалом времени, равным Custom. Максимальный диапазон дат составляет 3 месяца.

Имя	Тип	Описание
from	string	Дата начала экспорта данных.
to	string	Дата окончания экспорта данных.

ExportType

Тип экспорта. Обратите внимание, что "Использование" эквивалентно "ActualCost" и применимо к экспорту, которые еще не предоставляют данные для оплаты или амортизации для резервирований служб.

Имя	Тип	Описание
ActualCost	string
AmortizedCost	string
Usage	string

FormatType

Формат доставки экспорта. В настоящее время поддерживается только csv-файл.

Имя	Тип	Описание
Csv	string

GranularityType

Степень детализации строк в экспорте. В настоящее время поддерживается только "Daily".

Имя	Тип	Описание
Daily	string

RecurrenceType

Повторение расписания.

Имя	Тип	Описание
Annually	string
Daily	string
Monthly	string
Weekly	string

StatusType

Состояние расписания экспорта. Если значение неактивно, расписание экспорта приостановлено.

Имя	Тип	Описание
Active	string
Inactive	string

SystemAssignedServiceIdentity

Управляемое удостоверение службы (назначаемое системой или нет)

Имя	Тип	Описание
principalId	string	Идентификатор субъекта-службы назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.
tenantId	string	Идентификатор клиента назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.
type	SystemAssignedServiceIdentityType	Тип управляемого удостоверения службы (назначенный системой или нет).

SystemAssignedServiceIdentityType

Тип управляемого удостоверения службы (назначенный системой или нет).

Имя	Тип	Описание
None	string
SystemAssigned	string

TimeframeType

Интервал времени для извлечения данных для экспорта. Если это настраивается, необходимо указать определенный период времени.

Имя	Тип	Описание
BillingMonthToDate	string
Custom	string
MonthToDate	string
TheLastBillingMonth	string
TheLastMonth	string
WeekToDate	string

Поделиться через

Exports - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

ExportCreateOrUpdateByBillingAccount

Образец запроса

Пример ответа

ExportCreateOrUpdateByDepartment

Образец запроса

Пример ответа

ExportCreateOrUpdateByEnrollmentAccount

Образец запроса

Пример ответа

ExportCreateOrUpdateByManagementGroup

Образец запроса

Пример ответа

ExportCreateOrUpdateByResourceGroup

Образец запроса

Пример ответа

ExportCreateOrUpdateBySubscription

Образец запроса

Пример ответа

Определения

CommonExportProperties

ErrorDetails

ErrorResponse

ExecutionStatus

ExecutionType

Export

ExportDataset

ExportDatasetConfiguration

ExportDefinition

ExportDeliveryDestination

ExportDeliveryInfo

ExportExecutionListResult

ExportRecurrencePeriod

ExportRun

ExportSchedule

ExportTimePeriod

ExportType

FormatType

GranularityType

RecurrenceType

StatusType

SystemAssignedServiceIdentity

SystemAssignedServiceIdentityType

TimeframeType

Дополнительные ресурсы