مشاركة عبر

الحصول على مقاييس استخدام جهاز ظاهري باستخدام واجهة برمجة تطبيقات REST

  • مقالة

ينطبق على: ✔️ أجهزة Linux الظاهرية ✔️ مجموعات مقياس مرنة

يوضح هذا المثال كيفية استرداد استخدام CPU لجهاز Linux الظاهري باستخدام واجهة برمجة تطبيقات REST في Azure.

تتوفر الوثائق المرجعية الكاملة والعينات لواجهة برمجة تطبيقات REST في مقالة مرجع AZURE Monitor REST.

قم ببناء الطلب

استخدم طلب GET التالي لجمع مقياس النسبة المئوية لوحدة المعالجة المركزية من جهاز ظاهري.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

عناوين الطلبات

الرؤوس التالية مطلوبة:

عنوان الطلب ‏‏الوصف
نوع المحتوى: مطلوب. تعيين إلى application/json.
التفويض: مطلوب. قم بالتعيين إلى Bearer رمز وصول صالح.

معلمات URI

Name ‏‏الوصف
subscriptionId معرف الاشتراك الذي يعرّف اشتراك Azure. إذا كانت لديك اشتراكات متعددة، فراجع العمل مع الاشتراكات المتعددة.
resourceGroupName اسم مجموعة موارد Azure المقترنة بالمورد. يمكنك الحصول على هذه القيمة من واجهة برمجة تطبيقات Azure Resource Manager أو CLI أو المدخل.
vmname اسم جهاز Azure الظاهري.
أسماء المقاييس قائمة مفصولة بفواصل لـ مقاييس موازن التحميل الصالحة.
نسخة واجهة برمجة التطبيقات إصدار API المراد استخدامه للطلب.

يغطي هذا المستند إصدار api 2018-01-01، المضمن في عنوان URL أعلاه.
timespan سلسلة بالتنسيق التالي startDateTime_ISO/endDateTime_ISO الذي يحدد النطاق الزمني للمقاييس التي تم إرجاعها. تم تعيين هذه المعلمة الاختيارية لإرجاع بيانات اليوم في المثال.
   

نص الطلب

ليست هناك حاجة إلى نص طلب لهذه العملية.

معالجة الاستجابة

يتم إرجاع رمز الحالة 200 عند إرجاع قائمة قيم المقاييس بنجاح. تتوفر قائمة كاملة برموز الخطأ في الوثائق المرجعية .

مثال على الاستجابة

{
    "cost": 0,
    "timespan": "2018-06-08T23:48:10Z/2018-06-09T00:48:10Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-08T23:48:00Z",
                            "average": 0.44
                        },
                        {
                            "timeStamp": "2018-06-08T23:49:00Z",
                            "average": 0.31
                        },
                        {
                            "timeStamp": "2018-06-08T23:50:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:51:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:52:00Z",
                            "average": 0.285
                        } ]
                } ]
        } ]
}