Sağlayıcı kaynak kullanım API’si

Makale
06/19/2024

Sağlayıcı terimi, hizmet yöneticisi ve temsilci olarak atanan sağlayıcılar için geçerlidir. Azure Stack Hub operatörleri ve temsilci sağlayıcılar, doğrudan kiracılarının kullanımını görüntülemek için sağlayıcı kullanım API'sini kullanabilir. Örneğin, aşağıdaki diyagramda gösterildiği gibi P0, P1 ve P2'de doğrudan kullanım bilgilerini almak için sağlayıcı API'sini çağırabilir ve P1, P3 ve P4'teki kullanım bilgilerini çağırabilir.

Sağlayıcı hiyerarşisinin kavramsal modeli

API çağrısı başvurusu

İstek

İstek, istenen abonelikler ve istenen zaman çerçevesi için tüketim ayrıntılarını alır. İstek gövdesi yok.

Bu kullanım API'si bir sağlayıcı API'sine sahip olduğundan, çağıranın sağlayıcının aboneliğinde Sahip, Katkıda Bulunan veya Okuyucu rolüne atanması gerekir.

Yöntem	İstek URI'si
GET	`https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value}`

Bağımsız değişkenler

Bağımsız Değişken	Description
`armendpoint`	Azure Stack Hub ortamınızın Azure Resource Manager uç noktası. Azure Stack Hub kuralı, Azure Resource Manager uç noktasının adının biçiminde `https://adminmanagement.{domain-name}`olmasıdır. Örneğin, Azure Stack Geliştirme Seti (ASDK) için etki alanı adı local.azurestack.external ise Resource Manager uç noktası olur`https://adminmanagement.local.azurestack.external`.
`subId`	Aramayı yapan kullanıcının abonelik kimliği.
`reportedStartTime`	Sorgunun başlangıç saati. değeri `DateTime` Eşgüdümlü Evrensel Saat (UTC) ve saatin başında olmalıdır; örneğin, 13:00. Günlük toplama için bu değeri UTC gece yarısı olarak ayarlayın. Biçimi ISO 8601 kaçış; örneğin, `2015-06-16T18%3a53%3a11%2b00%3a00Z`iki nokta üst üstenin kaçıldığı `%3a` ve artının URI kullanımına uygun olması için `%2b` öğesine kaçıldığı yerdir.
`reportedEndTime`	Sorgunun bitiş saati. için geçerli `reportedStartTime` olan kısıtlamalar bu bağımsız değişken için de geçerlidir. değeri `reportedEndTime` gelecekte veya geçerli tarihte olamaz. Bu durumda sonuç "işleme tamamlanmadı" olarak ayarlanır.
`aggregationGranularity`	İki ayrı olası değere sahip isteğe bağlı parametre: günlük ve saatlik. Değerlerden de anlaşılacağı gibi, biri verileri günlük ayrıntı düzeyinde, diğeri ise saatlik çözünürlükte döndürür. Günlük seçeneği varsayılan seçenektir.
`subscriberId`	Abonelik kimliği. Filtrelenmiş verileri almak için sağlayıcının doğrudan kiracısının abonelik kimliği gereklidir. Abonelik kimliği parametresi belirtilmezse çağrı, sağlayıcının tüm doğrudan kiracıları için kullanım verilerini döndürür.
`api-version`	Bu isteği yapmak için kullanılan protokolün sürümü. Bu değer olarak `2015-06-01-preview`ayarlanır.
`continuationToken`	Kullanım API'sinin sağlayıcısına yapılan son çağrıdan alınan belirteç. Bu belirteç, bir yanıt 1.000 satırdan büyük olduğunda gereklidir. İlerleme için bir yer işareti işlevi görür. Belirteç yoksa, veriler geçirilen ayrıntı düzeyine bağlı olarak günün veya saatin başından alınır.

Yanıt

GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0

{
"value": [
{

"id":
"/subscriptions/sub1.1/providers/Microsoft.Commerce.Admin/UsageAggregate/sub1.1-

meterID1",
"name": "sub1.1-meterID1",
"type": "Microsoft.Commerce.Admin/UsageAggregate",

"properties": {
"subscriptionId":"sub1.1",
"usageStartTime": "2015-03-03T00:00:00+00:00",
"usageEndTime": "2015-03-04T00:00:00+00:00",
"instanceData":"{\"Microsoft.Resources\":{\"resourceUri\":\"resourceUri1\",\"location\":\"Alaska\",\"tags\":null,\"additionalInfo\":null}}",
"quantity":2.4000000000,
"meterId":"meterID1"

}
},

. . .

Yanıt ayrıntıları

Bağımsız Değişken	Description
`id`	Kullanım toplamının benzersiz kimliği.
`name`	Kullanım toplamının adı.
`type`	Kaynak tanımı.
`subscriptionId`	Azure Stack Hub kullanıcısının abonelik tanımlayıcısı.
`usageStartTime`	Bu kullanım toplamasının ait olduğu kullanım demetinin UTC başlangıç saati.
`usageEndTime`	Bu kullanım toplamasının ait olduğu kullanım demetinin UTC bitiş saati.
`instanceData`	Örnek ayrıntılarının anahtar-değer çiftleri (yeni bir biçimde): `resourceUri`: Kaynak gruplarını ve örnek adını içeren tam kaynak kimliği. `location`: Bu hizmetin çalıştırıldığı bölge. `tags`: Kullanıcı tarafından belirtilen kaynak etiketleri. `additionalInfo`: Kullanılan kaynak hakkında daha fazla ayrıntı; örneğin, işletim sistemi sürümü veya görüntü türü.
`quantity`	Bu zaman diliminde gerçekleşen kaynak tüketimi miktarı.
`meterId`	Kullanılan kaynağın benzersiz kimliği (olarak da adlandırılır `ResourceID`).

Kullanım bilgilerini alma

PowerShell

Kullanım verilerini oluşturmak için, çalışan ve sistemi etkin bir şekilde kullanan kaynaklarınız olmalıdır; örneğin, etkin bir sanal makine (VM) veya bazı veriler içeren bir depolama hesabı. Azure Stack Hub Marketi'nde çalışan kaynaklarınız olup olmadığından emin değilseniz bir VM dağıtın ve çalıştığından emin olmak için VM izleme dikey penceresini doğrulayın. Kullanım verilerini görüntülemek için aşağıdaki PowerShell cmdlet'lerini kullanın:

Azure Stack Hub için PowerShell'i yükleyin.
Azure Stack Hub kullanıcısını veya Azure Stack Hub işleci PowerShell ortamını yapılandırın.

Kullanım verilerini almak için Get-AzsSubscriberUsage PowerShell cmdlet'ini çağırın:

Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"

REST API

Microsoft.Commerce.Yönetici hizmetini arayarak silinen abonelikler için kullanım bilgilerini toplayabilirsiniz.

Etkin kullanıcılar için silinen tüm kiracı kullanımını döndürme

Yöntem	İstek URI'si
GET	`https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview`

Silinen veya etkin kiracı için kullanımı iade etme

Yöntem	İstek URI'si
GET	`https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview`

Aracılığıyla paylaş