Útmutató az Azure Monitor REST API-hoz

Ez a cikk bemutatja, hogyan végezhet hitelesítést, hogy a kód használni tudja a Microsoft Azure Monitor REST API-referenciáját.

Az Azure Monitor API lehetővé teszi az elérhető alapértelmezett metrikadefiníciók, dimenzióértékek és metrikaértékek programozott lekérését. Az adatok külön adattárba menthetők, például Azure SQL Database, Azure Cosmos DB vagy Azure Data Lake. Innen szükség szerint további elemzések is elvégezhetők.

A Monitor API amellett, hogy különböző metrika-adatpontokkal dolgozik, lehetővé teszi a riasztási szabályok listázását, a tevékenységnaplók megtekintését és sok más elemet is. Az elérhető műveletek teljes listáját a Microsoft Azure Monitor REST API-referenciában találja.

Azure Monitor-kérések hitelesítése

Az Azure Monitor API-val végrehajtott összes feladat az Azure Resource Manager hitelesítési modellt használja. Ezért minden kérést hitelesíteni kell Azure Active Directory (Azure AD). Az ügyfélalkalmazás hitelesítésének egyik módszere egy Azure AD szolgáltatásnév létrehozása és a hitelesítési (JWT) jogkivonat lekérése. Az alábbi példaszkript bemutatja, hogyan hozható létre Azure AD szolgáltatásnév a PowerShell-lel. Részletesebb útmutatóért tekintse meg a dokumentációt, amely azt ismerteti, hogy a Azure PowerShell használatával hozhat létre egyszerű szolgáltatást az erőforrások eléréséhez. Szolgáltatásnevet is létrehozhat a Azure Portal.

$subscriptionId = "{azure-subscription-id}"
$resourceGroupName = "{resource-group-name}"

# Authenticate to a specific Azure subscription.
Connect-AzAccount -SubscriptionId $subscriptionId

# Password for the service principal
$pwd = "{service-principal-password}"
$secureStringPassword = ConvertTo-SecureString -String $pwd -AsPlainText -Force

# Create a new Azure AD application
$azureAdApplication = New-AzADApplication `
                        -DisplayName "My Azure Monitor" `
                        -HomePage "https://localhost/azure-monitor" `
                        -IdentifierUris "https://localhost/azure-monitor" `
                        -Password $secureStringPassword

# Create a new service principal associated with the designated application
New-AzADServicePrincipal -ApplicationId $azureAdApplication.ApplicationId

# Assign Reader role to the newly created service principal
New-AzRoleAssignment -RoleDefinitionName Reader `
                          -ServicePrincipalName $azureAdApplication.ApplicationId.Guid

Az Azure Monitor API lekérdezéséhez az ügyfélalkalmazásnak a korábban létrehozott szolgáltatásnevet kell használnia a hitelesítéshez. Az alábbi PowerShell-példaszkript egy módszert mutat be a hitelesítési jogkivonat beszerzéséhez a Microsoft Authentication Library (MSAL) használatával.

$ClientID           = "{client_id}"
$loginURL           = "https://login.microsoftonline.com"
$tenantdomain       = "{tenant_id}"
$CertPassWord       = "{password_for_cert}"
$certPath           = "C:\temp\Certs\testCert_01.pfx"
 
[string[]] $Scopes  = "https://graph.microsoft.com/.default"
 
Function Load-MSAL {
    if ($PSVersionTable.PSVersion.Major -gt 5)
    { 
        $core = $true
        $foldername =  "netcoreapp2.1"
    }
    else
    { 
        $core = $false
        $foldername = "net45"
    }
 
    # Download MSAL.Net module to a local folder if it does not exist there
    if ( ! (Get-ChildItem $HOME/MSAL/lib/Microsoft.Identity.Client.* -erroraction ignore) ) {
        install-package -Source nuget.org -ProviderName nuget -SkipDependencies Microsoft.Identity.Client -Destination $HOME/MSAL/lib -force -forcebootstrap | out-null
    }
   
    # Load the MSAL assembly -- needed once per PowerShell session
    [System.Reflection.Assembly]::LoadFrom((Get-ChildItem $HOME/MSAL/lib/Microsoft.Identity.Client.*/lib/$foldername/Microsoft.Identity.Client.dll).fullname) | out-null
  }
  
Function Get-GraphAccessTokenFromMSAL {
 
    Load-MSAL
 
    $global:app = $null
 
    $x509cert = [System.Security.Cryptography.X509Certificates.X509Certificate2] (GetX509Certificate_FromPfx -CertificatePath $certPath -CertificatePassword $CertPassWord)
    write-host "Cert = {$x509cert}"
 
    $ClientApplicationBuilder = [Microsoft.Identity.Client.ConfidentialClientApplicationBuilder]::Create($ClientID)
        [void]$ClientApplicationBuilder.WithAuthority($("$loginURL/$tenantdomain"))
        [void]$ClientApplicationBuilder.WithCertificate($x509cert)
    $global:app = $ClientApplicationBuilder.Build()
 
    [Microsoft.Identity.Client.AuthenticationResult] $authResult  = $null
    $AquireTokenParameters = $global:app.AcquireTokenForClient($Scopes)
    try {
        $authResult = $AquireTokenParameters.ExecuteAsync().GetAwaiter().GetResult()
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Host $ErrorMessage
    }
     
    return $authResult
}
 
function GetX509Certificate_FromPfx($CertificatePath, $CertificatePassword){
    #write-host "Path: '$CertificatePath'"
    
    if(![System.IO.Path]::IsPathRooted($CertificatePath))
    {
        $LocalPath = Get-Location
        $CertificatePath = "$LocalPath\$CertificatePath"
    }
 
    #Write-Host "Looking for '$CertificatePath'"
 
    $certificate = [System.Security.Cryptography.X509Certificates.X509Certificate2]::new($CertificatePath, $CertificatePassword)
     
    Return $certificate
}
 
$myvar = Get-GraphAccessTokenFromMSAL
Write-Host "Access Token: " $myvar.AccessToken
 

Ha a tanúsítványt egy .pfx fájlból tölti be a PowerShellben, a rendszergazda egyszerűbben kezelheti a tanúsítványokat anélkül, hogy telepítenie kellene a tanúsítványt a tanúsítványtárolóba. Ez azonban nem végezhető el az ügyfélszámítógépen, mivel a felhasználó esetleg felderítheti a fájlt és a hozzá tartozó jelszót, valamint a hitelesítés módját. Az ügyfél hitelesítő adatainak folyamata csak olyan háttérszolgáltatásban futtatható, ahol csak a rendszergazdák férhetnek hozzá a géphez.

A hitelesítés után a lekérdezések az Azure Monitor REST API-val hajthatók végre. Két hasznos lekérdezés létezik:

  1. Erőforrás metrikadefinícióinak listázása
  2. A metrikaértékek lekérése

Megjegyzés

Az Azure REST API-val történő hitelesítéssel kapcsolatos további információkért tekintse meg az Azure REST API-referenciát.

Metrikadefiníciók lekérése

Az Azure Monitor metrikadefiníciók REST API-jának használatával elérheti a szolgáltatáshoz elérhető metrikák listáját.

Metódus: GET

Kérelem URI-ja: https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}/providers/microsoft.insights/metricDefinitions?api-version={apiVersion}

Egy Azure-Storage-fiók metrikadefinícióinak lekéréséhez például a kérés a következőképpen jelenik meg:

$request = "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01"


Invoke-RestMethod -Uri $request ` 
                  -Headers $authHeader `
                  -Method Get `
                  -OutFile ".\contosostorage-metricdef-results.json" `
                  -Verbose

Megjegyzés

A metrikadefiníciók API régebbi verziói nem támogatták a dimenziókat. Javasoljuk, hogy a "2018-01-01" vagy újabb API-verziót használja.

Az eredményként kapott JSON-választörzs a következő példához hasonló lesz: (Vegye figyelembe, hogy a második metrika dimenziókkal rendelkezik)

{
    "value": [
        {
            "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/UsedCapacity",
            "resourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Capacity",
            "name": {
                "value": "UsedCapacity",
                "localizedValue": "Used capacity"
            },
            "isDimensionRequired": false,
            "unit": "Bytes",
            "primaryAggregationType": "Average",
            "supportedAggregationTypes": [
                "Total",
                "Average",
                "Minimum",
                "Maximum"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT6H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT12H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ]
        },
        {
            "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/Transactions",
            "resourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Transaction",
            "name": {
                "value": "Transactions",
                "localizedValue": "Transactions"
            },
            "isDimensionRequired": false,
            "unit": "Count",
            "primaryAggregationType": "Total",
            "supportedAggregationTypes": [
                "Total"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT5M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT15M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT30M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT6H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT12H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ],
            "dimensions": [
                {
                    "value": "ResponseType",
                    "localizedValue": "Response type"
                },
                {
                    "value": "GeoType",
                    "localizedValue": "Geo type"
                },
                {
                    "value": "ApiName",
                    "localizedValue": "API name"
                }
            ]
        },
        ...
    ]
}

Dimenzióértékek lekérése

Az elérhető metrikadefiníciók ismerete után előfordulhat, hogy vannak dimenziókkal rendelkező metrikák. A metrika lekérdezése előtt érdemes lehet felderíteni, hogy a dimenzió milyen értéktartománysal rendelkezik. Ezek alapján a dimenzióértékek alapján dönthet úgy, hogy dimenzióértékek alapján szűri vagy szegmentálta a metrikákat a metrikák lekérdezése során. Az Azure Monitor Metrics REST API használatával megkeresheti egy adott metrikadimenzió összes lehetséges értékét.

A szűrési kérésekhez használja a metrika "value" (érték) nevét (nem a "localizedValue"-t). Ha nincs megadva szűrő, a rendszer az alapértelmezett metrikát adja vissza. Ennek az API-nak a használata csak egy dimenziót engedélyez helyettesítő karakteres szűrővel. A dimenzióérték-kérés és a metrikaadat-kérelem közötti fő különbség a "resultType=metadata" lekérdezési paraméter megadása.

Megjegyzés

Ha az Azure Monitor REST API-val szeretné lekérni a dimenzióértékeket, használja a "2019-07-01" api-verziót vagy újabb verziót.

Metódus: GET

Kérelem URI-ja: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider-namespace}/{resource-type}/{resource-name}/providers/microsoft.insights/metrics?metricnames={metric}&timespan={starttime/endtime}&$filter={filter}&resultType=metadata&api-version={apiVersion}

Ha például le szeretné kérni a "Transactions" metrika "API Name" dimenziója által kibocsátott dimenzióértékek listáját, ahol a GeoType dimenzió = "Elsődleges" a megadott időtartományban, a kérés a következő lesz:

$filter = "APIName eq '*' and GeoType eq 'Primary'"
$request = "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics?metricnames=Transactions&timespan=2018-03-01T00:00:00Z/2018-03-02T00:00:00Z&resultType=metadata&`$filter=GeoType eq 'Primary' and ApiName eq '*'&api-version=2019-07-01"
Invoke-RestMethod -Uri $request `
    -Headers $authHeader `
    -Method Get `
    -OutFile ".\contosostorage-dimension-values.json" `
    -Verbose

Az eredményként kapott JSON-választörzs az alábbi példához hasonló lesz:

{
  "timespan": "2018-03-01T00:00:00Z/2018-03-02T00:00:00Z",
  "value": [
    {
      "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "DeleteBlob"
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "SetBlobProperties"
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

Metrikaértékek lekérése

A rendelkezésre álló metrikadefiníciók és a lehetséges dimenzióértékek ismerete után lekérheti a kapcsolódó metrikaértékeket. Ehhez használja az Azure Monitor Metrics REST API-t .

A szűrési kérésekhez használja a metrika "value" (érték) nevét (nem a "localizedValue"-t). Ha nincs megadva dimenziószűrő, a rendszer az összesített összesített metrikát adja vissza. Ha több idősort szeretne beolvasni adott dimenzióértékekkel, adjon meg egy szűrőlekérdezési paramétert, amely mindkét dimenzióértéket megadja, például: "&$filter=ApiName eq 'ListContainers' vagy ApiName eq 'GetBlobServiceProperties''. Ha egy adott dimenzió minden értékéhez idősort szeretne visszaadni, használjon olyan "" szűrőt, mint a "&$filter=ApiName eq ''". A "Top" és az "OrderBy" lekérdezési paraméterekkel korlátozható és rendezhető a visszaadott idősorok száma.

Megjegyzés

Ha többdimenziós metrikák értékeit szeretné lekérni az Azure Monitor REST API-val, használja a "2019-07-01" api-verziót vagy újabbat.

Metódus: GET

Kérelem URI-ja: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider-namespace}/{resource-type}/{resource-name}/providers/microsoft.insights/metrics?metricnames={metric}&timespan={starttime/endtime}&$filter={filter}&interval={timeGrain}&aggregation={aggreation}&api-version= {apiVersion}

Ha például az első 3 API-t szeretné lekérni csökkenő értékben, a "Tranzakciók" száma alapján egy 5 perces tartományon belül, ahol a GeotType az "Elsődleges" volt, a kérés a következő lesz:

$filter = "APIName eq '*' and GeoType eq 'Primary'"
$request = "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics?metricnames=Transactions&timespan=2018-03-01T02:00:00Z/2018-03-01T02:05:00Z&`$filter=apiname eq 'GetBlobProperties'&interval=PT1M&aggregation=Total&top=3&orderby=Total desc&api-version=2019-07-01"
Invoke-RestMethod -Uri $request `
    -Headers $authHeader `
    -Method Get `
    -OutFile ".\contosostorage-metric-values.json" `
    -Verbose

Az eredményként kapott JSON-választörzs az alábbi példához hasonló lesz:

{
  "cost": 0,
  "timespan": "2018-03-01T02:00:00Z/2018-03-01T02:05:00Z",
  "interval": "PT1M",
  "value": [
    {
      "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "GetBlobProperties"
            }
          ],
          "data": [
            {
              "timeStamp": "2017-09-19T02:00:00Z",
              "total": 2
            },
            {
              "timeStamp": "2017-09-19T02:01:00Z",
              "total": 1
            },
            {
              "timeStamp": "2017-09-19T02:02:00Z",
              "total": 3
            },
            {
              "timeStamp": "2017-09-19T02:03:00Z",
              "total": 7
            },
            {
              "timeStamp": "2017-09-19T02:04:00Z",
              "total": 2
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

AZ ARMClient használata

Egy másik módszer az ARMClient használata a Windows gépen. Az ARMClient automatikusan kezeli a Azure AD hitelesítést (és az eredményül kapott JWT-jogkivonatot). A következő lépések az ARMClient használatát ismertetik a metrikaadatok lekéréséhez:

  1. Telepítse a Chocolateyt és az ARMClientet.
  2. Egy terminálablakba írja be armclient.exe bejelentkezést. Ez arra kéri, hogy jelentkezzen be az Azure-ba.
  3. Írja be az armclient GET [your_resource_id]/providers/microsoft.insights/metricdefinitions?api-version=2016-03-01 parancsot
  4. Írja be az armclient GET [your_resource_id]/providers/microsoft.insights/metrics?api-version=2016-09-01 parancsot

Egy adott logikai alkalmazás metrikadefinícióinak lekéréséhez például adja ki a következő parancsot:

armclient GET /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Logic/workflows/ContosoTweets/providers/microsoft.insights/metricDefinitions?api-version=2016-03-01

Az erőforrás-azonosító lekérése

A REST API használata segíthet megérteni az elérhető metrikadefiníciókat, részletességet és a kapcsolódó értékeket. Ezek az információk az Azure Management Library használatakor hasznosak.

Az előző kód esetében a használni kívánt erőforrás-azonosító a kívánt Azure-erőforrás teljes elérési útja. Egy Azure-webalkalmazás lekérdezéséhez például az erőforrás-azonosító a következő:

/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Web/sites/{site-name}/

Az alábbi lista néhány példát tartalmaz a különböző Azure-erőforrások erőforrás-azonosító formátumára:

  • IoT Hub – /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Devices/IotHubs/{iot-hub-name}
  • Rugalmas SQL-készlet – /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{pool-db}/elasticpools/{sql-pool-name}
  • SQL Database (v12) – /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{server-name}/databases/{database-name}
  • Service Bus - /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.ServiceBus/{namespace}/{servicebus-name}
  • Virtuálisgép-méretezési csoportok – /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Compute/virtualMachineScaleSets/{vm-name}
  • Virtuális gépek – /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}
  • Event Hubs – /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.EventHub/namespaces/{eventhub-namespace}

Alternatív módszerekkel is lekéri az erőforrás-azonosítót, például az Azure Resource Explorer használatával, a kívánt erőforrás megtekintésével a Azure Portal, illetve a PowerShell vagy az Azure CLI használatával.

Azure Resource Explorer

Egy kívánt erőforrás erőforrás-azonosítójának megkereséséhez hasznos módszer az Azure Resource Explorer eszköz használata. Keresse meg a kívánt erőforrást, majd tekintse meg a megjelenített azonosítót, az alábbi képernyőképen látható módon:

Alt

Azure Portal

Az erőforrás-azonosító a Azure Portal is beszerezhető. Ehhez keresse meg a kívánt erőforrást, majd válassza a Tulajdonságok lehetőséget. Az erőforrás-azonosító megjelenik a Tulajdonságok szakaszban, az alábbi képernyőképen látható módon:

Alt

Azure PowerShell

Az erőforrás-azonosító Azure PowerShell parancsmagokkal is lekérhető. Egy Azure Logic Apps-alkalmazás erőforrás-azonosítójának lekéréséhez például hajtsa végre a Get-AzureLogicApp parancsmagot, az alábbi példához hasonlóan:

Get-AzLogicApp -ResourceGroupName azmon-rest-api-walkthrough -Name contosotweets

Az eredménynek az alábbi példához hasonlónak kell lennie:

Id             : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Logic/workflows/ContosoTweets
Name           : ContosoTweets
Type           : Microsoft.Logic/workflows
Location       : centralus
ChangedTime    : 8/21/2017 6:58:57 PM
CreatedTime    : 8/18/2017 7:54:21 PM
AccessEndpoint : https://prod-08.centralus.logic.azure.com:443/workflows/f3a91b352fcc47e6bff989b85446c5db
State          : Enabled
Definition     : {$schema, contentVersion, parameters, triggers...}
Parameters     : {[$connections, Microsoft.Azure.Management.Logic.Models.WorkflowParameter]}
SkuName        :
AppServicePlan :
PlanType       :
PlanId         :
Version        : 08586982649483762729

Azure CLI

Ha egy Azure Storage-fiók erőforrás-azonosítóját szeretné lekérni az Azure CLI használatával, hajtsa végre a az storage account show parancsot az alábbi példában látható módon:

az storage account show -g azmon-rest-api-walkthrough -n contosotweets2017

Az eredménynek az alábbi példához hasonlónak kell lennie:

{
  "accessTier": null,
  "creationTime": "2017-08-18T19:58:41.840552+00:00",
  "customDomain": null,
  "enableHttpsTrafficOnly": false,
  "encryption": null,
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/contosotweets2017",
  "identity": null,
  "kind": "Storage",
  "lastGeoFailoverTime": null,
  "location": "centralus",
  "name": "contosotweets2017",
  "networkAcls": null,
  "primaryEndpoints": {
    "blob": "https://contosotweets2017.blob.core.windows.net/",
    "file": "https://contosotweets2017.file.core.windows.net/",
    "queue": "https://contosotweets2017.queue.core.windows.net/",
    "table": "https://contosotweets2017.table.core.windows.net/"
  },
  "primaryLocation": "centralus",
  "provisioningState": "Succeeded",
  "resourceGroup": "azmon-rest-api-walkthrough",
  "secondaryEndpoints": null,
  "secondaryLocation": "eastus2",
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  },
  "statusOfPrimary": "available",
  "statusOfSecondary": "available",
  "tags": {},
  "type": "Microsoft.Storage/storageAccounts"
}

Megjegyzés

Azure Logic Apps még nem érhetők el az Azure CLI-vel, így az előző példában egy Azure Storage-fiók jelenik meg.

Tevékenységnapló adatainak lekérése

A metrikadefiníciók és a kapcsolódó értékek mellett az Azure Monitor REST API-val is lekérhetők az Azure-erőforrásokhoz kapcsolódó egyéb érdekes megállapítások. Például lekérdezhetőek a tevékenységnaplók adatai. Az alábbi mintakérések az Azure Monitor REST API használatával kérdezik le a tevékenységnaplót.

Tevékenységnaplók lekérése szűrővel:

GET https://management.azure.com/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2018-01-21T20:00:00Z' and eventTimestamp le '2018-01-23T20:00:00Z' and resourceGroupName eq 'MSSupportGroup'

Tevékenységnaplók lekérése szűrővel, majd válassza a következőt:

GET https://management.azure.com/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2015-01-21T20:00:00Z' and eventTimestamp le '2015-01-23T20:00:00Z' and resourceGroupName eq 'MSSupportGroup'&$select=eventName,id,resourceGroupName,resourceProviderName,operationName,status,eventTimestamp,correlationId,submissionTimestamp,level

Tevékenységnaplók lekérése a kiválasztással:

GET https://management.azure.com/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01&$select=eventName,id,resourceGroupName,resourceProviderName,operationName,status,eventTimestamp,correlationId,submissionTimestamp,level

Tevékenységnaplók lekérése szűrő nélkül, vagy válassza a következőt:

GET https://management.azure.com/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01

Hibaelhárítás

Ha 429-es, 503-es vagy 504-es hibát kap, próbálkozzon újra az API-val egy percen belül.

Következő lépések