Twins - DigitalTwins DeleteRelationship

Service:

Azure Digital Twins

API Version:

2023-10-31

حذف علاقة بين توأمين رقميين. رموز الحالة:

• 204 لا يوجد محتوى
• 400 طلب غير صالح
  • InvalidArgument - معرف التوأم الرقمي أو معرف العلاقة غير صالح.
• 404 لم يتم العثور
  • DigitalTwinNotFound - لم يتم العثور على التوأم الرقمي.
  • RelationshipNotFound - لم يتم العثور على العلاقة.
• فشل الشرط المسبق 412
  • PreconditionFailed - فشل فحص الشرط المسبق (If-Match أو If-None-Match).

DELETE https://digitaltwins-hostname/digitaltwins/{id}/relationships/{relationshipId}?api-version=2023-10-31

معلمات URI

الاسم	في	مطلوب	النوع	الوصف
id	path	True	string	معرف التوأم الرقمي. المعرف فريد داخل الخدمة وتحسس حالة الأحرف.
relationshipId	path	True	string	معرف العلاقة. المعرف فريد داخل التوأم الرقمي وتحسس حالة الأحرف.
api-version	query	True	string	إصدار واجهة برمجة التطبيقات المطلوب.

رأس الطلب

الاسم	مطلوب	النوع	الوصف
If-Match		string	قم بتنفيذ العملية فقط إذا كان etag للكيان يطابق إحدى علامات etag المقدمة أو * يتم توفيرها.
traceparent		string	يحدد الطلب في نظام تتبع موزع.
tracestate		string	يوفر معلومات تعريف التتبع الخاصة بالمورد وهو مصاحب ل traceparent.

الاستجابات

الاسم	النوع	الوصف
204 No Content		نجاح
Other Status Codes	ErrorResponse	الاستجابة الافتراضية. Headers x-ms-error-code: string

الأمان

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

أمثلة

Delete a relationship

Sample Request

HTTP

DELETE https://digitaltwins-hostname/digitaltwins/myTwinId/relationships/myRelationshipId?api-version=2023-10-31

Sample Response

Status code:

204

التعريفات

الاسم	الوصف
Error	تعريف الخطأ.
ErrorResponse	استجابة الخطأ.
InnerError	وصف خطأ أكثر تحديدا مما تم توفيره بواسطة الخطأ المحتوي.

Error

تعريف الخطأ.

الاسم	النوع	الوصف
code	string	رمز الخطأ الخاص بالخدمة الذي يعمل بمثابة الإحصائيات الفرعية لرمز خطأ HTTP.
details	Error[]	تفاصيل الخطأ الداخلي.
innererror	InnerError	كائن يحتوي على معلومات أكثر تحديدا من الكائن الحالي حول الخطأ.
message	string	تمثيل يمكن للبشر قراءته للخطأ.

ErrorResponse

استجابة الخطأ.

الاسم	النوع	الوصف
error	Error	تفاصيل الخطأ.

InnerError

وصف خطأ أكثر تحديدا مما تم توفيره بواسطة الخطأ المحتوي.

الاسم	النوع	الوصف
code	string	رمز خطأ أكثر تحديدا مما تم توفيره بواسطة الخطأ المحتوي.
innererror	InnerError	كائن يحتوي على معلومات أكثر تحديدا من الكائن الحالي حول الخطأ.