عرض محفوظات التوزيع باستخدام Azure Resource Manager

يمكّنك Azure Resource Manager من عرض محفوظات التوزيع الخاصة بك. يمكنك فحص عمليات محددة في عمليات التوزيع السابقة ومعرفة الموارد التي تم توزيعها. يحتوي هذا التاريخ على معلومات حول أي أخطاء.

يقتصر تاريخ التوزيع لمجموعة الموارد على 800 عملية توزيع. عندما تقترب من الحد، يتم حذف عمليات التوزيع تلقائياً من السجل. لمزيد من المعلومات، راجع عمليات الحذف التلقائية من محفوظات التوزيع.

للحصول على تعليمات حول حل أخطاء توزيع معينة، راجع استكشاف أخطاء توزيع Azure الشائعة وإصلاحها.

معرف الارتباط والدعم

لكل عملية توزيع معرف ارتباط، يتم استخدامه لتتبع الأحداث ذات الصلة. إذا قمت بإنشاء طلب دعم Azure، فقد يطلب منك الدعم معرف الارتباط. يستخدم الدعم معرف الارتباط لتعريف عمليات التوزيع الفاشل.

توضح الأمثلة في هذه المقالة كيفية استرداد معرف الارتباط.

عمليات توزيع مجموعة الموارد

يمكنك عرض تفاصيل حول توزيع مجموعة موارد من خلال مدخل Azure أو PowerShell أو Azure CLI أو واجهة برمجة تطبيقات REST.

بوابة

1. حدد مجموعة الموارد التي تريد فحصها.

   

2. حدد الارتباط الموجود أسفل Deployments.

   

3. حدد إحدى عمليات التوزيع من محفوظات التوزيع.

   

4. يتم عرض ملخص للتوزيع، بما في ذلك معرف الارتباط.

   

بوويرشيل

لسرد جميع عمليات التوزيع لمجموعة موارد، استخدم الأمر Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

للحصول على توزيع محدد من مجموعة موارد، أضف المعلمة DeploymentName.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

للحصول على معرف الارتباط، استخدم:

(Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment).CorrelationId

Azure CLI

لسرد جميع عمليات التوزيع لمجموعة الموارد، استخدم az deployment group list.

az deployment group list --resource-group ExampleGroup

للحصول على عملية توزيع محددة، استخدم az deployment group show.

az deployment group show --resource-group ExampleGroup --name ExampleDeployment

للحصول على معرف الارتباط، استخدم:

az deployment group show --resource-group ExampleGroup --name ExampleDeployment --query properties.correlationId

HTTP

لسرد عمليات التوزيع لمجموعة موارد، استخدم العملية التالية. للحصول على أحدث رقم إصدار لواجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - القائمة حسب مجموعة الموارد.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/?api-version={api-version}

للحصول على توزيع معين، استخدم العملية التالية. للحصول على أحدث رقم إصدار لواجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - الحصول على.

GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}?api-version={api-version}

تتضمن الاستجابة معرف الارتباط.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

عمليات توزيع الاشتراك

يمكنك عرض محفوظات عمليات التوزيع إلى اشتراك.

بوابة

1. حدد الاشتراك الذي ترغب في فحصه.

   

2. في الجزء الأيمن، حدد عمليات التوزيع.

   

3. حدد إحدى عمليات التوزيع من محفوظات التوزيع.

   

4. يتم عرض ملخص للتوزيع، بما في ذلك معرف الارتباط.

   

بوويرشيل

لسرد كافة عمليات التوزيع للاشتراك الحالي، استخدم الأمر Get-AzSubscriptionDeployment. هذا الأمر يعادل Get-AzDeployment.

Get-AzSubscriptionDeployment

للحصول على توزيع محدد من الاشتراك، أضف المعلمة Name.

Get-AzSubscriptionDeployment -Name ExampleDeployment

للحصول على معرف الارتباط، استخدم:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

لسرد كافة عمليات التوزيع للاشتراك الحالي، استخدم az deployment sub list.

az deployment sub list

للحصول على توزيع محدد، استخدم az deployment sub show

az deployment sub show --name ExampleDeployment

للحصول على معرف الارتباط، استخدم:

az deployment sub show --name ExampleDeployment --query properties.correlationId

HTTP

لسرد عمليات التوزيع لاشتراك، استخدم العملية التالية. للحصول على أحدث رقم إصدار لواجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - قائمة في نطاق الاشتراك.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

للحصول على توزيع معين، استخدم العملية التالية. للحصول على أحدث رقم إصدار لواجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - الحصول في نطاق الاشتراك.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

تتضمن الاستجابة معرف الارتباط.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

عمليات نشر مجموعة الإدارة

يمكنك عرض محفوظات عمليات التوزيع إلى مجموعة إدارة.

بوابة

1. حدد مجموعة الإدارة التي تريد فحصها. إذا لم تكن لديك أذونات كافية لعرض تفاصيل حول مجموعة الإدارة، فلن تتمكن من تحديدها.

   

2. في الجزء الأيمن، حدد عمليات التوزيع.

   

3. حدد إحدى عمليات التوزيع من محفوظات التوزيع.

   

4. يتم عرض ملخص للتوزيع، بما في ذلك معرف الارتباط.

   

بوويرشيل

لسرد كافة عمليات التوزيع لمجموعة إدارة، استخدم الأمر Get-AzManagementGroupDeployment. إذا لم تكن لديك أذونات كافية لعرض عمليات التوزيع لمجموعة الإدارة، فستحصل على خطأ.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

للحصول على توزيع معين من مجموعة إدارة، أضف المعلمة Name.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

للحصول على معرف الارتباط، استخدم:

(Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment).CorrelationId

Azure CLI

لسرد كافة عمليات التوزيع لمجموعة إدارة، استخدم az deployment mg list. إذا لم تكن لديك أذونات كافية لعرض عمليات التوزيع لمجموعة الإدارة، فستحصل على خطأ.

az deployment mg list --management-group-id examplemg

للحصول على توزيع محدد، استخدم az deployment mg show.

az deployment mg show --management-group-id examplemg --name ExampleDeployment

للحصول على معرف الارتباط، استخدم:

az deployment mg show --management-group-id examplemg --name ExampleDeployment --query properties.correlationId

HTTP

لسرد عمليات التوزيع لمجموعة الإدارة، استخدم العملية التالية. للحصول على أحدث رقم إصدار واجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - قائمة في نطاق مجموعة الإدارة. إذا لم تكن لديك أذونات كافية لعرض عمليات التوزيع لمجموعة الإدارة، فستحصل على خطأ.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

للحصول على توزيع معين، استخدم العملية التالية. للحصول على أحدث رقم إصدار واجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - الحصول في نطاق مجموعة الإدارة.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

تتضمن الاستجابة معرف الارتباط.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

عمليات نشر للمستأجرين

يمكنك عرض محفوظات عمليات التوزيع إلى مستأجر.

بوابة

لا يعرض المدخل حاليًا عمليات توزيع المستأجرين.

بوويرشيل

لسرد كافة عمليات التوزيع للمستأجر الحالي، استخدم الأمر Get-AzTenantDeployment. إذا لم تكن لديك أذونات كافية لعرض عمليات التوزيع للمستأجر، فستحصل على خطأ.

Get-AzTenantDeployment

للحصول على توزيع معين من المستأجر الحالي، أضف المعلمة Name.

Get-AzTenantDeployment -Name ExampleDeployment

للحصول على معرف الارتباط، استخدم:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

لسرد كافة عمليات التوزيع للمستأجر الحالي، استخدم az deployment tenant list. إذا لم تكن لديك أذونات كافية لعرض عمليات التوزيع للمستأجر، فستحصل على خطأ.

az deployment tenant list

للحصول على عملية توزيع محددة، az deployment tenant show.

az deployment tenant show --name ExampleDeployment

للحصول على معرف الارتباط، استخدم:

az deployment tenant show --name ExampleDeployment --query properties.correlationId

HTTP

لسرد عمليات التوزيع للمستأجر الحالي، استخدم العملية التالية. للحصول على أحدث رقم إصدار لواجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - القائمة حسب نطاق المستأجر. إذا لم تكن لديك أذونات كافية لعرض عمليات التوزيع للمستأجر، فستحصل على خطأ.

GET https://management.azure.com/providers/Microsoft.Resources/deployments/?api-version={api-version}

للحصول على توزيع معين، استخدم العملية التالية. للحصول على أحدث رقم إصدار لواجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - الحصول حسب نطاق المستأجر.

GET https://management.azure.com/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

تتضمن الاستجابة معرف الارتباط.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

عمليات التوزيع ورسالة الخطأ

يمكن أن تتضمن كل عملية توزيع عمليات متعددة. للاطلاع على مزيد من التفاصيل حول عملية التوزيع، قم بعرض عمليات التوزيع. عند فشل التوزيع، تتضمن عمليات التوزيع رسالة خطأ.

بوابة

1. في ملخص التوزيع، حدد Operation details.

   

2. ترى التفاصيل الخاصة بهذه الخطوة من التوزيع. عند حدوث خطأ، تتضمن التفاصيل رسالة الخطأ.

   

بوويرشيل

لعرض عمليات التوزيع للتوزيع إلى مجموعة موارد، استخدم الأمر Get-AzResourceGroupDeploymentOperation.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

لعرض العمليات الفاشلة، قم بتصفية العمليات بالحالة Failed.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }

للحصول على رسالة حالة العمليات الفاشلة، استخدم الأمر التالي:

(Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }).StatusMessage

لعرض عمليات التوزيع لنطاقات أخرى، استخدم:

• Get-AzDeploymentOperation
• Get-AzManagementGroupDeploymentOperation
• Get-AzTenantDeploymentOperation

Azure CLI

لعرض عمليات التوزيع للتوزيع إلى مجموعة موارد، استخدم الأمر az deployment operation group list. يجب أن يكون لديك Azure CLI 2.6.0 أو أحدث.

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment

لعرض العمليات الفاشلة، قم بتصفية العمليات بالحالة Failed.

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed']"

للحصول على رسالة حالة العمليات الفاشلة، استخدم الأمر التالي:

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed'].properties.statusMessage.error"

لعرض عمليات التوزيع لنطاقات أخرى، استخدم:

• az deployment operation sub list
• az deployment operation mg list
• az deployment operation tenant list.

HTTP

للحصول على عمليات التوزيع، استخدم العملية التالية. للحصول على أحدث رقم إصدار لواجهة برمجة التطبيقات لاستخدامه في الطلب، راجع عمليات التوزيع - القائمة.

GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}/operations?$skiptoken={skiptoken}&api-version={api-version}

الرد يتضمن رسالة خطأ.

{
  "value": [
    {
      "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/examplegroup/providers/Microsoft.Resources/deployments/exampledeployment/operations/1234567890ABCDEF",
      "operationId": "1234567890ABCDEF",
      "properties": {
        "provisioningOperation": "Create",
        "provisioningState": "Failed",
        "timestamp": "2019-11-26T14:18:36.3177613Z",
        "duration": "PT21.0580179S",
        "trackingId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "serviceRequestId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "statusCode": "BadRequest",
        "statusMessage": {
          "error": {
            "code": "InvalidAccountType",
            "message": "The AccountType Standard_LRS1 is invalid. For more information, see - https://aka.ms/storageaccountskus"
          }
        },
        "targetResource": {
          "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/examplegroup/providers/Microsoft.Storage/storageAccounts/storage",
          "resourceType": "Microsoft.Storage/storageAccounts",
          "resourceName": "storage"
        }
      }
    },
    ...
  ]
}

لعرض عمليات التوزيع لنطاقات أخرى، استخدم:

• عمليات التوزيع - قائمة في نطاق الاشتراك
• عمليات التوزيع - قائمة في نطاق مجموعة الإدارة
• عمليات التوزيع - قائمة في نطاق المستأجر

الخطوات التالية

• للمساعدة في حل أخطاء توزيع معينة، راجع استكشاف أخطاء توزيع Azure الشائعة وإصلاحها.
• للتعرف على كيفية إدارة عمليات التوزيع في المحفوظات، راجع عمليات الحذف التلقائية من محفوظات التوزيع.
• لمعاينة التغييرات التي سيقوم بها القالب قبل التوزيع، راجع عملية what-if لتوزيع قالب ARM.