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=2019-11-01

URI Parametreleri

Name In Required Type Description
exportName
path True
  • string

Dışarı aktarma adı.

scope
path True
  • string

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

api-version
query True
  • string

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

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

OAuth2 Flow Azure Active Directory.

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

BillingAccountExport
DepartmentExport
EnrollmentAccountExport
ManagementGroupExport
ResourceGroupExport
SubscriptionExport

BillingAccountExport

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2019-11-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": "Usage",
      "timeframe": "Custom",
      "timePeriod": {
        "from": "2018-06-01T00:00:00Z",
        "to": "2018-10-31T00:00:00Z"
      },
      "dataset": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "UsageDate",
            "MeterId",
            "InstanceId",
            "ResourceLocation",
            "UsageQuantity"
          ]
        },
        "aggregation": {
          "usageSum": {
            "name": "UsageQuantity",
            "function": "Sum"
          }
        },
        "grouping": [
          {
            "type": "Dimension",
            "name": "SubscriptionName"
          },
          {
            "type": "Tag",
            "name": "Environment"
          }
        ],
        "filter": {
          "and": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "Contains",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

DepartmentExport

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2019-11-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": "Usage",
      "timeframe": "Custom",
      "timePeriod": {
        "from": "2018-06-01T00:00:00Z",
        "to": "2018-10-31T00:00:00Z"
      },
      "dataset": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "UsageDate",
            "MeterId",
            "InstanceId",
            "ResourceLocation",
            "UsageQuantity"
          ]
        },
        "aggregation": {
          "usageSum": {
            "name": "UsageQuantity",
            "function": "Sum"
          }
        },
        "grouping": [
          {
            "type": "Dimension",
            "name": "SubscriptionName"
          },
          {
            "type": "Tag",
            "name": "Environment"
          }
        ],
        "filter": {
          "and": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "Contains",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

EnrollmentAccountExport

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2019-11-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": "Usage",
      "timeframe": "Custom",
      "timePeriod": {
        "from": "2018-06-01T00:00:00Z",
        "to": "2018-10-31T00:00:00Z"
      },
      "dataset": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "UsageDate",
            "MeterId",
            "InstanceId",
            "ResourceLocation",
            "UsageQuantity"
          ]
        },
        "aggregation": {
          "usageSum": {
            "name": "UsageQuantity",
            "function": "Sum"
          }
        },
        "grouping": [
          {
            "type": "Dimension",
            "name": "SubscriptionName"
          },
          {
            "type": "Tag",
            "name": "Environment"
          }
        ],
        "filter": {
          "and": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "Contains",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

ManagementGroupExport

Sample Request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2019-11-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": "Usage",
      "timeframe": "Custom",
      "timePeriod": {
        "from": "2018-06-01T00:00:00Z",
        "to": "2018-10-31T00:00:00Z"
      },
      "dataset": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "UsageDate",
            "MeterId",
            "InstanceId",
            "ResourceLocation",
            "UsageQuantity"
          ]
        },
        "aggregation": {
          "usageSum": {
            "name": "UsageQuantity",
            "function": "Sum"
          }
        },
        "grouping": [
          {
            "type": "Dimension",
            "name": "SubscriptionName"
          },
          {
            "type": "Tag",
            "name": "Environment"
          }
        ],
        "filter": {
          "and": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "Contains",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

ResourceGroupExport

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2019-11-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": "Usage",
      "timeframe": "Custom",
      "timePeriod": {
        "from": "2018-06-01T00:00:00Z",
        "to": "2018-10-31T00:00:00Z"
      },
      "dataset": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "UsageDate",
            "MeterId",
            "InstanceId",
            "ResourceLocation",
            "UsageQuantity"
          ]
        },
        "aggregation": {
          "usageSum": {
            "name": "UsageQuantity",
            "function": "Sum"
          }
        },
        "grouping": [
          {
            "type": "Dimension",
            "name": "SubscriptionName"
          },
          {
            "type": "Tag",
            "name": "Environment"
          }
        ],
        "filter": {
          "and": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "Contains",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

SubscriptionExport

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2019-11-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": "Usage",
      "timeframe": "Custom",
      "timePeriod": {
        "from": "2018-06-01T00:00:00Z",
        "to": "2018-10-31T00:00:00Z"
      },
      "dataset": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "UsageDate",
            "MeterId",
            "InstanceId",
            "ResourceLocation",
            "UsageQuantity"
          ]
        },
        "aggregation": {
          "usageSum": {
            "name": "UsageQuantity",
            "function": "Sum"
          }
        },
        "grouping": [
          {
            "type": "Dimension",
            "name": "SubscriptionName"
          },
          {
            "type": "Tag",
            "name": "Environment"
          }
        ],
        "filter": {
          "and": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "Contains",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Tanımlar

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.

Export

Dışarı aktarma kaynağı.

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.

ExportRecurrencePeriod

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

ExportSchedule

Bir dışarı aktarma ile ilişkili zamanlama.

ExportType

Sorgunun türü.

FormatType

Teslim edilen dışarı aktarmanın biçimi.

FunctionType

Kullanılacak toplama işlevinin adı.

GranularityType

Sorgudaki satırların ayrıntı düzeyi.

OperatorType

Karşılaştırma için kullanılacak işleç.

QueryAggregation

Sorguda kullanılacak toplama ifadesi.

QueryColumnType

Dışarı aktarma içindeki sütunun türü.

QueryComparisonExpression

Sorguda kullanılacak karşılaştırma ifadesi.

QueryDataset

Sorguda bulunan verilerin tanımı.

QueryDatasetConfiguration

Sorgudaki veri kümesinin yapılandırması.

QueryDefinition

Bir sorgunun tanımı.

QueryFilter

Dışarı aktarmada kullanılacak filtre ifadesi.

QueryGrouping

Sorguda kullanılacak gruplandırma ölçütü ifadesi.

QueryTimePeriod

Sorgu için veri çekme başlangıç ve bitiş tarihi.

RecurrenceType

Zamanlama tekrarı.

StatusType

Zamanlamanın durumu. Etkin olup olmadığı. Devre dışı bırakılırsa, dışa aktarmanın zamanlanan yürütmesi duraklatılır.

TimeframeType

Sorgu için veri çekme zaman çerçevesi. Özel ise, belirli bir süre belirtilmelidir.

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

Export

Dışarı aktarma kaynağı.

Name Type Description
id
  • string

Kaynak kimliği.

name
  • string

Kaynak adı.

properties.definition

Dışarı 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.

properties.schedule

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

tags
  • object

Kaynak etiketleri.

type
  • string

Kaynak türü.

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.

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

Bir 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

Zamanlamanın durumu. Etkin olup olmadığı. Devre dışı bırakılırsa, dışa aktarmanın zamanlanan yürütmesi duraklatılır.

ExportType

Sorgunun türü.

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

FormatType

Teslim edilen dışarı aktarmanın biçimi.

Name Type Description
Csv
  • string

FunctionType

Kullanılacak toplama işlevinin adı.

Name Type Description
Sum
  • string

GranularityType

Sorgudaki satırların ayrıntı düzeyi.

Name Type Description
Daily
  • string

OperatorType

Karşılaştırma için kullanılacak işleç.

Name Type Description
Contains
  • string
In
  • string

QueryAggregation

Sorguda kullanılacak toplama ifadesi.

Name Type Description
function

Kullanılacak toplama işlevinin adı.

name
  • string

Toplanacak sütunun adı.

QueryColumnType

Dışarı aktarma içindeki sütunun türü.

Name Type Description
Dimension
  • string
Tag
  • string

QueryComparisonExpression

Sorguda kullanılacak karşılaştırma ifadesi.

Name Type Description
name
  • string

Karşılaştırmada kullanılacak sütunun adı.

operator

Karşılaştırma için kullanılacak işleç.

values
  • string[]

Karşılaştırma için kullanılacak değerler dizisi

QueryDataset

Sorguda bulunan verilerin tanımı.

Name Type Description
aggregation

Sorguda kullanılacak toplama ifadesinin sözlüğü. Sözlükteki her öğenin anahtarı, toplanan sütun için diğer addır. Sorguda en fazla 2 toplama yan tümcesi bulunabilir.

configuration

Dışarı aktarma içindeki veriler için yapılandırma bilgilerine sahiptir. Toplama ve gruplandırma sağlandıysa yapılandırma yok sayılır.

filter

Sorguda kullanılacak filtre ifadesi vardır.

granularity

Sorgudaki satırların ayrıntı düzeyi.

grouping

Sorguda kullanılacak olan gruplandırma ölçütü ifadesi dizisi. Sorguda en fazla 2 Group by yan tümcesi bulunabilir.

QueryDatasetConfiguration

Sorgudaki veri kümesinin yapılandırması.

Name Type Description
columns
  • string[]

Sorguya eklenecek sütun adları dizisi. Geçerli bir sorgu sütunu adına izin verilir. Sağlanmazsa, sorgu tüm sütunları içerir.

QueryDefinition

Bir sorgunun tanımı.

Name Type Description
dataset

Bu sorgudaki veri tanımına sahip.

timePeriod

Sorgu için veri çekmek için zaman aralığı vardır.

timeframe

Sorgu için veri çekme zaman çerçevesi. Özel ise, belirli bir süre belirtilmelidir.

type

Sorgunun türü.

QueryFilter

Dışarı aktarmada kullanılacak filtre ifadesi.

Name Type Description
and

Mantıksal "AND" ifadesi. En az 2 öğe olmalıdır.

dimension

Boyut için karşılaştırma ifadesi vardır

not

Mantıksal "NOT" ifadesi.

or

Mantıksal "OR" ifadesi. En az 2 öğe olmalıdır.

tag

Etiket için karşılaştırma ifadesi vardır

QueryGrouping

Sorguda kullanılacak gruplandırma ölçütü ifadesi.

Name Type Description
name
  • string

Gruplandıryapılacak sütunun adı.

type

Gruplamak için sütunun türü vardır.

QueryTimePeriod

Sorgu için veri çekme başlangıç ve bitiş tarihi.

Name Type Description
from
  • string

Verilerin çekme başlangıç tarihi.

to
  • string

Verilerin çekeceğini bitiş tarihi.

RecurrenceType

Zamanlama tekrarı.

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

StatusType

Zamanlamanın durumu. Etkin olup olmadığı. Devre dışı bırakılırsa, dışa aktarmanın zamanlanan yürütmesi duraklatılır.

Name Type Description
Active
  • string
Inactive
  • string

TimeframeType

Sorgu için veri çekme zaman çerçevesi. Özel ise, belirli bir süre belirtilmelidir.

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