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

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

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

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

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

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

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

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

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

بوابة

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

   

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

   

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

   

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

   

بوويرشيل

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

Azure PowerShell

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

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

Azure PowerShell

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

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

Azure PowerShell

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

Azure CLI

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

Azure CLI

az deployment group list --resource-group ExampleGroup

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

Azure CLI

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

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

Azure CLI

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

HTTP

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

rest

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

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

rest

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

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

JSON

{
 ...
 "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.

Azure PowerShell

Get-AzSubscriptionDeployment

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

Azure PowerShell

Get-AzSubscriptionDeployment -Name ExampleDeployment

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

Azure PowerShell

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

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

Azure CLI

az deployment sub list

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

Azure CLI

az deployment sub show --name ExampleDeployment

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

Azure CLI

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

HTTP

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

rest

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

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

rest

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

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

JSON

{
 ...
 "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. إذا لم تكن لديك أذونات كافية لعرض عمليات التوزيع لمجموعة الإدارة، فستحصل على خطأ.

Azure PowerShell

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

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

Azure PowerShell

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

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

Azure PowerShell

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

Azure CLI

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

Azure CLI

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

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

Azure CLI

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

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

Azure CLI

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

HTTP

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

rest

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

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

rest

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

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

JSON

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

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

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

بوابة

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

بوويرشيل

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

Azure PowerShell

Get-AzTenantDeployment

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

Azure PowerShell

Get-AzTenantDeployment -Name ExampleDeployment

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

Azure PowerShell

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

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

Azure CLI

az deployment tenant list

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

Azure CLI

az deployment tenant show --name ExampleDeployment

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

Azure CLI

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

HTTP

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

rest

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

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

rest

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

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

JSON

{
 ...
 "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.

Azure PowerShell

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

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

Azure PowerShell

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

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

Azure PowerShell

(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 أو أحدث.

Azure CLI

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

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

Azure CLI

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

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

Azure CLI

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

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

rest

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}

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

JSON

{
  "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.