نوشتن داده

فیلدهای سفارشی و پنجره‌های تعمیر و نگهداری را به‌روزرسانی کنید، اتوماسیون را اجرا کنید و نوشتن‌ها را با خیال راحت دوباره امتحان کنید.

API و MCP از کارهای صف‌بندی شده، زمان‌بندی روشن/خاموش، حذف عامل، تشخیص نقطه پایانی، لغو فرمان و سیاست‌های وصله‌ی طرف سوم پشتیبانی می‌کنند. کلیدهای ایندمپنوتنس را دوباره استفاده کنید و رسیدها را بررسی کنید. اطلاعات ورود موقت مدیر تنها یک بار بازگردانده می‌شوند. مانیتورینگ ترافیک نیازمند امتیاز موجود است؛ صورتحساب در برنامه باقی می‌ماند.

1. مجوزهای خود را بررسی کنید

   تنظیمات پیش‌فرض، قابلیت‌های فردی را انتخاب می‌کنند؛ آنها سطح دسترسی را تغییر نمی‌دهند. اعتبارنامه‌های جدید در تنظیمات به طور پیش‌فرض از FullAccess استفاده می‌کنند، اما فقط قابلیت‌های انتخاب شده مجاز هستند. اعتبارنامه‌های قدیمی‌تر ReadWrite اجازه تغییرات تأیید شده در فیلدهای سفارشی و تعمیر و نگهداری را می‌دهند. اتوماسیون و کنترل دستگاه به FullAccess به علاوه قابلیت‌های خاص خود نیاز دارند. قبل از نوشتن، GET /v1/operations/capabilities را بررسی کنید. دامنه شرکت و مجوزهای مالک فعلی همچنان اعمال می‌شوند.

2. از بازنویسی تغییر دیگری خودداری کنید

   فیلد سفارشی و نسخه آن را بخوانید. مقدار جدید و نسخه‌ای که خوانده‌اید را به PATCH /v1/custom-fields/{fieldId}. ارسال کنید. A 409 version_conflict به این معنی است که ابتدا کسی آن را تغییر داده است. دوباره آن را بخوانید و تصمیم بگیرید که آیا به‌روزرسانی شما هنوز مناسب است یا خیر.

3. با خیال راحت دوباره امتحان کنید

   برای POST /v1/maintenance-windows، یک هدر Idempotency-Key ارسال کنید. پس از یک نتیجه نامشخص، همان کلید و بدنه را برای بازیابی پنجره اصلی تکرار کنید تا یک نسخه تکراری ایجاد نکنید. بدنه تغییر یافته با همان کلید رد می‌شود. DELETE /v1/maintenance-windows/{windowId} یک پنجره را لغو می‌کند.

4. رسیدهای اقدام را دنبال کنید

   نوشتن‌های اتوماسیون و مدیریت از idempotencyKey در بدنه JSON استفاده می‌کنند و رسید عملیات را برمی‌گردانند. Completed به معنی پایان کار کنترل‌کننده درخواست است؛ نتیجه یا اجرای دامنه را بررسی کنید تا ببینید آیا دستگاه کار را تمام کرده است یا خیر. برای OutcomeUnknown، قبل از تصمیم‌گیری در مورد کاری که باید انجام دهید، رسید و وضعیت فعلی را بررسی کنید. هرگز به طور خودکار تحت یک کلید جدید دوباره ارسال نکنید: این اقدام می‌تواند دو بار اجرا شود.