Exports - Get

Dışarı aktarma adına göre tanımlı kapsamın dışarı aktarılmasını almak için işlem.

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}?api-version=2020-06-01
GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}?api-version=2020-06-01&$expand={$expand}

URI Parametreleri

Name In Required Type Description
exportName
path True
  • string

Dışarı aktarma adı.

scope
path True
  • string

Dışarı aktarma işlemleriyle ilişkili kapsam. Bu, abonelik kapsamı için '/Subscriptions/{SubscriptionID}/' içerir, ' resourceGroup kapsamı için/Subscriptions/{SubscriptionID}/ResourceGroups/{resourcegroupname} ', faturalandırma hesabı kapsamı için '/providers/Microsoft.Billing/billingAccounts/{billingAccountId} ' ve departman kapsamı için '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId} ', '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId} ', ınvoicesection kapsamı için '/Providers/Microsoft.billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} ' ve '/Providers/Microsoft.billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId} ' yönetim grubu kapsamındaki '/Providers/Microsoft.billing/' ve ' iş ortakları için özel olarak billingAccounts/{Billingaccountıd}/Customers/{CustomerID} '.

api-version
query True
  • string

İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2020-06-01 ' dir.

$expand
query
  • string

Dışarı aktarma içindeki özellikleri genişletmek için kullanılabilir. Şu anda yalnızca ' runHistory ' destekleniyor ve dışarı aktarmanın son 10 yürütmelerinin bilgilerini döndürecek.

Yanıtlar

Name Type Description
200 OK

Tamam ögesini seçin. İstek başarılı oldu.

Other Status Codes

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

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 Kullanıcı hesabınızın kimliğine bürün

Örnekler

ExportGetByBillingAccount
ExportGetByDepartment
ExportGetByEnrollmentAccount
ExportGetByManagementGroup
ExportGetByResourceGroup
ExportGetBySubscription

ExportGetByBillingAccount

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2020-06-01

Sample Response

{
  "id": "providers/Microsoft.Billing/billingAccounts/{billingAccount-Id}/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "properties": {
    "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": "Custom",
      "timePeriod": {
        "from": "2020-05-01T00:00:00Z",
        "to": "2020-05-31T00:00:00Z"
      },
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportGetByDepartment

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2020-06-01

Sample Response

{
  "id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "properties": {
    "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": "Custom",
      "timePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-06-30T00:00:00Z"
      },
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportGetByEnrollmentAccount

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2020-06-01

Sample Response

{
  "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "properties": {
    "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": "Custom",
      "timePeriod": {
        "from": "2019-09-01T00:00:00Z",
        "to": "2019-10-31T00:00:00Z"
      },
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportGetByManagementGroup

Sample Request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2020-06-01

Sample Response

{
  "id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "properties": {
    "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": "Custom",
      "timePeriod": {
        "from": "2019-09-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      },
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "UsageDate",
            "MeterId",
            "InstanceId",
            "ResourceLocation",
            "UsageQuantity"
          ]
        }
      }
    }
  }
}

ExportGetByResourceGroup

Sample Request

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

Sample Response

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "properties": {
    "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": "Custom",
      "timePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-06-30T00:00:00Z"
      },
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

ExportGetBySubscription

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2020-06-01

Sample Response

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "properties": {
    "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": "Custom",
      "timePeriod": {
        "from": "2019-06-01T00:00:00Z",
        "to": "2019-07-31T00:00:00Z"
      },
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Tanımlar

CommonExportProperties

Dışarı aktarmanın ortak özellikleri.

ErrorDetails

Hatanın ayrıntıları.

ErrorResponse

Hata yanıtı, hizmetin gelen isteği işleyemediğini belirtir. Bunun nedeni hata iletisinde verilmiştir.

Bazı hata yanıtları:

  • 429 TooManyRequests-Istek kısıtlandı. "X-MS-ratelimit-Microsoft. tüketim-retry-After" üst bilgisinde belirtilen süre bekledikten sonra yeniden deneyin.

  • 503 ServiceUnavailable-hizmet geçici olarak kullanılamıyor. "Yeniden dene-After" üst bilgisinde belirtilen süre bekledikten sonra yeniden deneyin.

ExecutionStatus

Dışarı aktarma yürütmenin bilinen son durumu.

ExecutionType

Dışarı aktarma yürütme türü.

Export

Dışarı aktarma kaynağı.

ExportDataset

Dışarı aktarma içindeki verilerin tanımı.

ExportDatasetConfiguration

Dışarı aktarma veri kümesi yapılandırması. Dışarı aktarma için sütunların seçili olmasına izin verir. Sağlanmazsa, dışa aktarma tüm kullanılabilir sütunları içerecektir.

ExportDefinition

Dışarı aktarma tanımı.

ExportDeliveryDestination

Dışarı aktarma tesliminin hedef bilgileri. Bir depolama hesabına erişime izin vermek için, hesabın aboneliğini Microsoft. CostManagementExports kaynak sağlayıcısına kaydetmeniz gerekir. Abonelik başına bir kez bu gereklidir. Azure portal bir dışarı aktarma oluştururken otomatik olarak yapılır, ancak API kullanıcılarının aboneliği kaydetmesi gerekir. Daha fazla bilgi için bkz https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ..

ExportDeliveryInfo

Bir dışarı aktarma ile ilişkili teslim bilgileri.

ExportExecution

Dışarı aktarma yürütme.

ExportExecutionListResult

Bir dışarı aktarmanın yürütme geçmişinin listelenmesinin sonucu.

ExportRecurrencePeriod

Yinelenme zamanlaması için başlangıç ve bitiş tarihi.

ExportSchedule

Dışarı aktarma ile ilişkili zamanlama.

ExportTimePeriod

Dışarı aktarma içindeki verilerin tarih aralığı. Bu yalnızca ' Custom ' olarak ayarlanmış zaman dilimi ile belirtilmelidir. En uzun tarih aralığı 3 aydır.

ExportType

Dışarı aktarma türü. ' Kullanım ' değerinin ' ActualCost ' ile eşdeğer olduğunu ve henüz hizmet ayırmaları için ücret veya itfası için veri sağlamayan dışarı aktarmalar için geçerli olduğunu unutmayın.

FormatType

Teslim edilen dışarı aktarmanın biçimi. Şu anda yalnızca ' CSV ' destekleniyor.

GranularityType

Dışarı aktarma içindeki satır ayrıntı düzeyi. Şu anda yalnızca ' Daily ' desteklenir.

RecurrenceType

Zamanlama tekrarı.

StatusType

Dışa aktarma zamanlamasının durumu. ' Etkin değil ' ise, dışa aktarma zamanlaması duraklatılır.

TimeframeType

Dışarı aktarma için veri çekme zaman dilimi. Özel ise, belirli bir süre belirtilmelidir.

CommonExportProperties

Dışarı aktarmanın ortak özellikleri.

Name Type Description
definition

Dışa aktarma tanımına sahiptir.

deliveryInfo

Dışa aktarma için teslimat bilgilerine sahiptir.

format

Teslim edilen dışarı aktarmanın biçimi. Şu anda yalnızca ' CSV ' destekleniyor.

nextRunTimeEstimate
  • string

Dışarı aktarmanın etkin bir zamanlaması varsa, bir sonraki yürütme zamanının tahminini sağlar.

runHistory

İstenirse, dışarı aktarma için en son yürütme geçmişine sahiptir.

ErrorDetails

Hatanın ayrıntıları.

Name Type Description
code
  • string

Hata kodu.

message
  • string

İşlemin neden başarısız olduğunu belirten hata iletisi.

ErrorResponse

Hata yanıtı, hizmetin gelen isteği işleyemediğini belirtir. Bunun nedeni hata iletisinde verilmiştir.

Bazı hata yanıtları:

  • 429 TooManyRequests-Istek kısıtlandı. "X-MS-ratelimit-Microsoft. tüketim-retry-After" üst bilgisinde belirtilen süre bekledikten sonra yeniden deneyin.

  • 503 ServiceUnavailable-hizmet geçici olarak kullanılamıyor. "Yeniden dene-After" üst bilgisinde belirtilen süre bekledikten sonra yeniden deneyin.

Name Type Description
error

Hatanın ayrıntıları.

ExecutionStatus

Dışarı aktarma yürütmenin bilinen son durumu.

Name Type Description
Completed
  • string
DataNotAvailable
  • string
Failed
  • string
InProgress
  • string
NewDataNotAvailable
  • string
Queued
  • string
Timeout
  • string

ExecutionType

Dışarı aktarma yürütme türü.

Name Type Description
OnDemand
  • string
Scheduled
  • string

Export

Dışarı aktarma kaynağı.

Name Type Description
eTag
  • string

kaynağın eTag 'i. Eşzamanlı güncelleştirme senaryosunu işlemek için bu alan, kullanıcının en son sürümü güncelleştirip güncelleştirmediğini belirlemede kullanılacaktır.

id
  • string

Kaynak kimliği.

name
  • string

Kaynak adı.

properties.definition

Dışa aktarma tanımına sahiptir.

properties.deliveryInfo

Dışa aktarma için teslimat bilgilerine sahiptir.

properties.format

Teslim edilen dışarı aktarmanın biçimi. Şu anda yalnızca ' CSV ' destekleniyor.

properties.nextRunTimeEstimate
  • string

Dışarı aktarmanın etkin bir zamanlaması varsa, bir sonraki yürütme zamanının tahminini sağlar.

properties.runHistory

İstenirse, dışarı aktarma için en son yürütme geçmişine sahiptir.

properties.schedule

Dışa aktarma için zamanlama bilgilerine sahiptir.

type
  • string

Kaynak türü.

ExportDataset

Dışarı aktarma içindeki verilerin tanımı.

Name Type Description
configuration

Dışarı aktarma veri kümesi yapılandırması.

granularity

Dışarı aktarma içindeki satır ayrıntı düzeyi. Şu anda yalnızca ' Daily ' desteklenir.

ExportDatasetConfiguration

Dışarı aktarma veri kümesi yapılandırması. Dışarı aktarma için sütunların seçili olmasına izin verir. Sağlanmazsa, dışa aktarma tüm kullanılabilir sütunları içerecektir.

Name Type Description
columns
  • string[]

Dışarı aktarmaya dahil edilecek sütun adları dizisi. Sağlanmazsa, dışa aktarma tüm kullanılabilir sütunları içerecektir. Kullanılabilir sütunlar müşteri kanalına göre farklılık gösterebilir (bkz. örnekler).

ExportDefinition

Dışarı aktarma tanımı.

Name Type Description
dataSet

Dışarı aktarma içindeki verilerin tanımı.

timePeriod

Dışa aktarma için veri çekmek için zaman aralığı vardır.

timeframe

Dışarı aktarma için veri çekme zaman dilimi. Özel ise, belirli bir süre belirtilmelidir.

type

Dışarı aktarma türü. ' Kullanım ' değerinin ' ActualCost ' ile eşdeğer olduğunu ve henüz hizmet ayırmaları için ücret veya itfası için veri sağlamayan dışarı aktarmalar için geçerli olduğunu unutmayın.

ExportDeliveryDestination

Dışarı aktarma tesliminin hedef bilgileri. Bir depolama hesabına erişime izin vermek için, hesabın aboneliğini Microsoft. CostManagementExports kaynak sağlayıcısına kaydetmeniz gerekir. Abonelik başına bir kez bu gereklidir. Azure portal bir dışarı aktarma oluştururken otomatik olarak yapılır, ancak API kullanıcılarının aboneliği kaydetmesi gerekir. Daha fazla bilgi için bkz https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ..

Name Type Description
container
  • string

Dışarı aktarımlarının karşıya yükleneceği kapsayıcının adı.

resourceId
  • string

Dışarı aktarmalar teslim edilecek depolama hesabının kaynak kimliği.

rootFolderPath
  • string

Dışarı aktarımlar karşıya yüklenecek dizinin adı.

ExportDeliveryInfo

Bir dışarı aktarma ile ilişkili teslim bilgileri.

Name Type Description
destination

Teslim edilen dışarı aktarmanın hedefi vardır.

ExportExecution

Dışarı aktarma yürütme.

Name Type Description
eTag
  • string

kaynağın eTag 'i. Eşzamanlı güncelleştirme senaryosunu işlemek için bu alan, kullanıcının en son sürümü güncelleştirip güncelleştirmediğini belirlemede kullanılacaktır.

id
  • string

Kaynak kimliği.

name
  • string

Kaynak adı.

properties.error

Herhangi bir hatanın ayrıntıları.

properties.executionType

Dışarı aktarma yürütme türü.

properties.fileName
  • string

İçe aktarılmış dosyanın adı.

properties.processingEndTime
  • string

Dışa aktarma yürütmesinin bittiği zaman.

properties.processingStartTime
  • string

Dışarı aktarmanın yürütülmesi için çekildiği zaman.

properties.runSettings

Bu yürütme için geçerli olan dışa aktarma ayarları.

properties.status

Dışarı aktarma yürütmenin bilinen son durumu.

properties.submittedBy
  • string

Dışarı aktarmayı yürüten varlıkla ilgili tanımlayıcı. OnDemand yürütmeler için kullanıcı e-postadır. Zamanlanmış yürütmeler için ' sistem '.

properties.submittedTime
  • string

Dışarı aktarmanın yürütülmesi için kuyruğa alındığı zaman.

type
  • string

Kaynak türü.

ExportExecutionListResult

Bir dışarı aktarmanın yürütme geçmişinin listelenmesinin sonucu.

Name Type Description
value

Dışa aktarma yürütmelerinin listesi.

ExportRecurrencePeriod

Yinelenme zamanlaması için başlangıç ve bitiş tarihi.

Name Type Description
from
  • string

Yinelenme başlangıç tarihi.

to
  • string

Yinelenme bitiş tarihi.

ExportSchedule

Dışarı aktarma ile ilişkili zamanlama.

Name Type Description
recurrence

Zamanlama tekrarı.

recurrencePeriod

Tekrarın başlangıç ve bitiş tarihi vardır. Başlangıç tarihi daha sonra olmalıdır. Varsa, bitiş tarihi başlangıç tarihinden büyük olmalıdır.

status

Dışa aktarma zamanlamasının durumu. ' Etkin değil ' ise, dışa aktarma zamanlaması duraklatılır.

ExportTimePeriod

Dışarı aktarma içindeki verilerin tarih aralığı. Bu yalnızca ' Custom ' olarak ayarlanmış zaman dilimi ile belirtilmelidir. En uzun tarih aralığı 3 aydır.

Name Type Description
from
  • string

Verilerin dışarı aktarılacağı başlangıç tarihi.

to
  • string

Verilerin dışarı aktarılacağı bitiş tarihi.

ExportType

Dışarı aktarma türü. ' Kullanım ' değerinin ' ActualCost ' ile eşdeğer olduğunu ve henüz hizmet ayırmaları için ücret veya itfası için veri sağlamayan dışarı aktarmalar için geçerli olduğunu unutmayın.

Name Type Description
ActualCost
  • string
AmortizedCost
  • string
Usage
  • string

FormatType

Teslim edilen dışarı aktarmanın biçimi. Şu anda yalnızca ' CSV ' destekleniyor.

Name Type Description
Csv
  • string

GranularityType

Dışarı aktarma içindeki satır ayrıntı düzeyi. Şu anda yalnızca ' Daily ' desteklenir.

Name Type Description
Daily
  • string

RecurrenceType

Zamanlama tekrarı.

Name Type Description
Annually
  • string
Daily
  • string
Monthly
  • string
Weekly
  • string

StatusType

Dışa aktarma zamanlamasının durumu. ' Etkin değil ' ise, dışa aktarma zamanlaması duraklatılır.

Name Type Description
Active
  • string
Inactive
  • string

TimeframeType

Dışarı aktarma için veri çekme zaman dilimi. Özel ise, belirli bir süre belirtilmelidir.

Name Type Description
BillingMonthToDate
  • string
Custom
  • string
MonthToDate
  • string
TheLastBillingMonth
  • string
TheLastMonth
  • string
WeekToDate
  • string