Generate Cost Details Report - Get Operation Results

Başvuru

Hizmet:: Cost Management

API Sürümü:: 2023-11-01

Belirtilen işlemin sonucunu alın. Bu bağlantı CostDetails oluşturma isteği yanıtı Konum üst bilgisinde sağlanır.

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/costDetailsOperationResults/{operationId}?api-version=2023-11-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
operationId	path	True	string	Hedef işlem kimliği.
scope	path	True	string	Abonelik, ödeme hesabı veya diğer faturalama kapsamları için ARM Kaynak Kimliği. Şu anda Kaynak Grubu ve Yönetim Grubu desteklenmiyor. Ayrıntılar için bkz. https://aka.ms/costmgmt/scopes.
api-version	query	True	string	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	CostDetailsOperationResults	Tamam ögesini seçin. İstek başarılı oldu.
202 Accepted		Kabul. İşlem devam ediyor.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Get details of the operation result

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
  "name": "00000000-0000-0000-0000-000000000000",
  "status": "Completed",
  "manifest": {
    "manifestVersion": "2023-11-01",
    "dataFormat": "Csv",
    "blobCount": 1,
    "byteCount": 32741,
    "compressData": false,
    "requestContext": {
      "requestScope": "subscriptions/00000000-0000-0000-0000-000000000000",
      "requestBody": {
        "metric": "ActualCost",
        "timePeriod": {
          "start": "2020-03-01",
          "end": "2020-03-15"
        }
      }
    },
    "blobs": [
      {
        "blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
        "byteCount": 32741
      }
    ]
  },
  "validTill": "2022-05-10T08:08:46.1973252Z"
}

Durum kodu:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-11-01
Retry-After: 60

Tanımlar

Name	Description
BlobInfo	Bu işlem tarafından oluşturulan blob bilgileri.
CostDetailsDataFormat	Raporun veri biçimi
CostDetailsMetricType	Ayrıntılı raporun türü. Varsayılan olarak ActualCost sağlanır
CostDetailsOperationResults	Maliyet ayrıntıları API'sine yönelik uzun süre çalışan işlemin sonucu.
CostDetailsStatusType	Maliyet ayrıntıları işleminin durumu
CostDetailsTimePeriod	Maliyetle ilgili ayrıntılı rapor için veri çekme işleminin başlangıç ve bitiş tarihi. API, verilerin yalnızca 1 ay veya daha kısa süreyle çekilmesine ve 13 aydan eski olmamasına izin verir.
ErrorDetails	Hatanın ayrıntıları.
ErrorResponse	Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir. Bazı Hata yanıtları: 429 TooManyRequests - İstek kısıtlandı. "x-ms-ratelimit-microsoft.consumption-retry-after" üst bilgisinde belirtilen süreyi bekledikten sonra yeniden deneyin. 503 ServiceUnavailable - Hizmet geçici olarak kullanılamıyor. "Retry-After" üst bilgisinde belirtilen süre bekledikten sonra yeniden deneyin.
GenerateCostDetailsReportRequestDefinition	Maliyet ayrıntılı raporunun tanımı.

BlobInfo

Bu işlem tarafından oluşturulan blob bilgileri.

Name	Tür	Description
blobLink	string	Dosyayı indirmek için blob bağlantısı.
byteCount	integer	Blobdaki bayt sayısı.

CostDetailsDataFormat

Raporun veri biçimi

Name	Tür	Description
Csv	string	Csv veri biçimi.

CostDetailsMetricType

Ayrıntılı raporun türü. Varsayılan olarak ActualCost sağlanır

Name	Tür	Description
ActualCost	string	Gerçek maliyet verileri.
AmortizedCost	string	Amorti edilmiş maliyet verileri.

CostDetailsOperationResults

Maliyet ayrıntıları API'sine yönelik uzun süre çalışan işlemin sonucu.

Name	Tür	Description
error	ErrorDetails	Hatanın ayrıntıları.
id	string	Uzun süre çalışan işlemin kimliği.
manifest.blobCount	integer	Toplam blob sayısı.
manifest.blobs	BlobInfo[]	Bu işlem tarafından oluşturulan blob bilgilerinin listesi.
manifest.byteCount	integer	Tüm bloblardaki toplam bayt sayısı.
manifest.compressData	boolean	Veriler sıkıştırılmış biçimde mi?
manifest.dataFormat	CostDetailsDataFormat	Raporun veri biçimi
manifest.manifestVersion	string	Bildirim sürümü.
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	Maliyet Ayrıntıları çağrısında sağlanan istek yükü gövdesi
manifest.requestContext.requestScope	string	İsteğin istek kapsamı.
name	string	Uzun süre çalışan işlemin adı.
status	CostDetailsStatusType	Maliyet ayrıntıları işleminin durumu
type	string	Uzun süre çalışan işlemin türü.
validTill	string	Rapor URL'sinin geçersiz olduğu/UTC'de sona erdiği saat( örneğin, 2020-12-08T05:55:59.4394737Z).

CostDetailsStatusType

Maliyet ayrıntıları işleminin durumu

Name	Tür	Description
Completed	string	İşlem Tamamlandı.
Failed	string	İşlem Başarısız Oldu.
NoDataFound	string	İşlem Tamamlandı ve hiçbir maliyet verisi bulunamadı.

CostDetailsTimePeriod

Maliyetle ilgili ayrıntılı rapor için veri çekme işleminin başlangıç ve bitiş tarihi. API, verilerin yalnızca 1 ay veya daha kısa süreyle çekilmesine ve 13 aydan eski olmamasına izin verir.

Name	Tür	Description
end	string	Verilerin çekisinin bitiş tarihi. örnek biçim 2020-03-15
start	string	Verilerin çekisinin başlangıç tarihi. örnek biçim 2020-03-15

ErrorDetails

Hatanın ayrıntıları.

Name	Tür	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 gösterir. Nedeni hata iletisinde verilmiştir.

Bazı Hata yanıtları:

429 TooManyRequests - İstek kısıtlandı. "x-ms-ratelimit-microsoft.consumption-retry-after" üst bilgisinde belirtilen süreyi bekledikten sonra yeniden deneyin.
503 ServiceUnavailable - Hizmet geçici olarak kullanılamıyor. "Retry-After" üst bilgisinde belirtilen süre bekledikten sonra yeniden deneyin.

Name	Tür	Description
error	ErrorDetails	Hatanın ayrıntıları.

GenerateCostDetailsReportRequestDefinition

Maliyet ayrıntılı raporunun tanımı.

Name	Tür	Description
billingPeriod	string	Bu parametre yalnızca Kurumsal Anlaşma müşteriler tarafından kullanılabilir. YearMonth(örneğin 202008) biçimini kullanın. Bu parametre invoiceId veya timePeriod parametreleriyle birlikte kullanılamaz. İstek gövdesinde timePeriod, invoiceId veya billingPeriod parametresi sağlanmazsa API geçerli ayın maliyetini döndürür.
invoiceId	string	Bu parametre yalnızca Microsoft Müşteri Sözleşmesi müşteriler tarafından kullanılabilir. Ayrıca, yalnızca Faturalama Profili veya Müşteri kapsamında kullanılabilir. Bu parametre billingPeriod veya timePeriod parametreleriyle birlikte kullanılamaz. İstek gövdesinde timePeriod, invoiceId veya billingPeriod parametresi sağlanmazsa API geçerli ayın maliyetini döndürür.
metric	CostDetailsMetricType	Ayrıntılı raporun türü. Varsayılan olarak ActualCost sağlanır
timePeriod	CostDetailsTimePeriod	Rapor için istenen maliyet ayrıntılarının belirli tarih aralığı. Bu parametre invoiceId veya billingPeriod parametreleriyle birlikte kullanılamaz. İstek gövdesinde timePeriod, invoiceId veya billingPeriod parametresi sağlanmazsa API geçerli ayın maliyetini döndürür. API, verilerin yalnızca 1 ay veya daha kısa süreyle çekilmesine ve 13 aydan eski olmamasına izin verir. TimePeriod veya billingPeriod veya invoiceId değeri sağlanmazsa API varsayılan olarak açık ay süresine ayarlanır

Aracılığıyla paylaş