.nh
.TH "GH-RUN-VIEW" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-run-view \- مشاهده خلاصه اجرای یک گردش‌کار


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh run view [<run-id>] [flags]\fR


.SH "توضیحات (DESCRIPTION)"
مشاهده خلاصه اجرای یک گردش‌کار\&.

.PP
به دلیل محدودیت‌های پلتفرم، \fBgh\fR ممکن است هنگام استفاده از روش اصلی دریافت لاگ‌ها در قالب zip، همیشه قادر به مرتبط ساختن جاب‌ها با لاگ‌های مربوطه‌شان نباشد\&.

.PP
در چنین مواردی، \fBgh\fR تلاش خواهد کرد تا لاگ‌ها را برای هر جاب به صورت جداگانه از طریق API واکشی کند\&. این راهکار جایگزین، کندتر بوده و منابع بیشتری مصرف می‌کند\&. اگر بیش از ۲۵ لاگ جاب وجود نداشته باشد، عملیات با خطا متوقف خواهد شد\&.

.PP
علاوه بر این، به دلیل محدودیت‌های پلتفرمی مشابه، ممکن است برخی از خطوط لاگ با مرحله مشخصی از یک جاب مرتبط نباشند\&. در این موارد، نام مرحله در خروجی لاگ به صورت \fBUNKNOWN STEP\fR نمایش داده می‌شود\&.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-a\fR, \fB--attempt\fR \fB<uint> (default 0)\fR
شماره تلاش اجرای گردش‌کار

.TP
\fB--exit-status\fR
خروج با وضعیت غیرصفر در صورت ناموفق بودن اجرا

.TP
\fB-j\fR, \fB--job\fR \fB<string>\fR
مشاهده یک شناسه جاب مشخص از یک اجرا

.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
فیلتر کردن خروجی JSON با استفاده از عبارت jq

.TP
\fB--json\fR \fB<fields>\fR
خروجی JSON با فیلدهای مشخص‌شده

.TP
\fB--log\fR
مشاهده لاگ کامل برای یک اجرا یا یک جاب مشخص

.TP
\fB--log-failed\fR
مشاهده لاگ برای مراحل ناموفق در یک اجرا یا یک جاب مشخص

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
قالب‌بندی خروجی JSON با استفاده از قالب Go؛ به "gh help formatting" مراجعه کنید

.TP
\fB-v\fR, \fB--verbose\fR
نمایش مراحل جاب

.TP
\fB-w\fR, \fB--web\fR
باز کردن اجرا در مرورگر


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO


.SH "فیلدهای JSON (JSON FIELDS)"
\fBattempt\fR, \fBconclusion\fR, \fBcreatedAt\fR, \fBdatabaseId\fR, \fBdisplayTitle\fR, \fBevent\fR, \fBheadBranch\fR, \fBheadSha\fR, \fBjobs\fR, \fBname\fR, \fBnumber\fR, \fBstartedAt\fR, \fBstatus\fR, \fBupdatedAt\fR, \fBurl\fR, \fBworkflowDatabaseId\fR, \fBworkflowName\fR


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند\&. برای اطلاعات بیشتر به راهنمای دستور مربوطه مراجعه کنید\&.


.SH "مثال‌ها (EXAMPLES)"
.EX
# انتخاب تعاملی یک اجرا برای مشاهده، با قابلیت انتخاب یک جاب مشخص به صورت اختیاری
$ gh run view

# مشاهده یک اجرای مشخص
$ gh run view 12345

# مشاهده یک اجرای مشخص با شماره تلاش مشخص
$ gh run view 12345 --attempt 3

# مشاهده یک جاب مشخص در یک اجرا
$ gh run view --job 456789

# مشاهده لاگ کامل برای یک جاب مشخص
$ gh run view --log --job 456789

# خروج با وضعیت غیرصفر در صورت ناموفق بودن اجرا
$ gh run view 0451 --exit-status && echo "run pending or passed"

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-run(1)\fR