Userオブジェクト

次のオブジェクトは、userAPIに直接関連しています。

ユーザー

ユーザーオブジェクトには以下のプロパティがあります。

Property Type Description
userid ID ユーザーのID。

プロパティの動作:
- 読み取り専用
- 更新操作では 必須
username string ユーザー名。

プロパティの動作:
- 作成操作では 必須
- ユーザーが ユーザーディレクトリ にリンクされており（userdirectoryid が "0" ではない有効な値に設定されている）、ユーザーディレクトリのプロビジョニングステータスが有効であり（ユーザーディレクトリオブジェクト の provision_status が "1" に設定されている）、かつすべてのLDAPまたはSAMLプロビジョニングの認証ステータスが有効である場合（認証オブジェクト の ldap_jit_status が "Enabled for configured LDAP IdPs" に設定されている、または 認証オブジェクト の saml_jit_status が "Enabled for configured SAML IdPs" に設定されている）、プロビジョニングされたユーザー では 読み取り専用
passwd string ユーザーのパスワード。

ユーザーが ユーザーディレクトリ にリンクされている場合、このパラメータの値は空文字列にできます。

プロパティの動作:
- 書き込み専用
roleid ID ユーザーのロールのID。

ロールを持たないユーザーは、LDAP/SAML情報がZabbixで設定されたユーザーグループマッピングと一致する場合に限り、LDAP または SAML 認証を使用してのみZabbixにログインできます。
attempt_clock timestamp 最後にログインに失敗した試行の時刻。

プロパティの動作:
- 読み取り専用
attempt_failed integer 直近のログイン失敗回数。

プロパティの動作:
- 読み取り専用
attempt_ip string 最後にログインに失敗した試行元のIPアドレス。

プロパティの動作:
- 読み取り専用
autologin integer 自動ログインを有効にするかどうか。

指定可能な値:
0 - (デフォルト) 自動ログイン無効;
1 - 自動ログイン有効。
autologout string ユーザーセッションの有効期間。秒、または接尾辞付きの時間単位を受け付けます。0s に設定すると、セッションは期限切れになりません。

デフォルト: 15m。
lang string ユーザーの言語の言語コード。例: en_US。

デフォルト: default - システムデフォルト。
name string ユーザーの名。
provisioned integer ユーザーがプロビジョニングされているかどうか。

指定可能な値:
0 - プロビジョニングされていない;
1 - プロビジョニング済み。

このプロパティは Zabbix 7.0.9 以降でサポートされています。

プロパティの動作:
- 読み取り専用
refresh string 自動更新間隔。秒、または接尾辞付きの時間単位（例: 30s, 90s, 1m, 1h）を受け付けます。

デフォルト: 30s。
rows_per_page integer 1ページあたりに表示するオブジェクト行数。

デフォルト: 50。
surname string ユーザーの姓。
theme string ユーザーのテーマ。

指定可能な値:
default - (デフォルト) システムデフォルト;
blue-theme - Blue;
dark-theme - Dark;
hc-light - High-contrast light;
hc-dark - High-contrast dark.
ts_provisioned timestamp 最新のプロビジョニング操作が実行された時刻。

プロパティの動作:
- 読み取り専用
- Super admin タイプのユーザーで サポート（Zabbix 7.0.9 以降）
url string ログイン後にユーザーをリダイレクトするページのURL。
userdirectoryid ID ユーザーがリンクされている ユーザーディレクトリ のID。

プロビジョニング（作成または更新）、およびユーザーディレクトリにリンクされたユーザーのログインに使用されます。

ログイン操作では、このプロパティの値は、ユーザーが所属する ユーザーグループ の userdirectoryid プロパティよりも優先されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
- Super admin タイプのユーザーで サポート（Zabbix 7.0.9 以降）
timezone string ユーザーのタイムゾーン。例: Europe/London, UTC。

デフォルト: default - システムデフォルト。

サポートされているタイムゾーンの完全な一覧については、PHP documentation を参照してください。

メディア

メディアオブジェクトには、以下のプロパティがあります。

Property Type Description
mediaid ID ユーザーのメディアのID。

プロパティの動作:
- 読み取り専用
mediatypeid ID ユーザーのメディアで使用されるメディアタイプのID。

プロパティの動作:
- 必須
sendto string/array 受信者のアドレス、ユーザー名、またはその他の識別子。

メディアタイプ の type が「Email」に設定されている場合、値は配列として表されます。メディアタイプ のその他のタイプでは、値は文字列として表されます。

プロパティの動作:
- 必須
active integer メディアが有効かどうか。

指定可能な値:
0 - (デフォルト) 有効;
1 - 無効。
severity integer 通知を送信するトリガーの深刻度。

指定可能なビットマップ値:
1 - 未分類;
2 - 情報;
4 - 警告;
8 - 軽度の障害;
16 - 重度の障害;
32 - 致命的な障害。

これはビットマスクフィールドです。指定可能なビットマップ値の任意の合計を指定できます（たとえば、軽度の障害、重度の障害、致命的な障害の場合は 48）。

デフォルト: 63。
period string 通知を送信できる時間。time period またはセミコロンで区切られたユーザーマクロで指定します。

デフォルト: 1-7,00:00-24:00。
provisioned integer ユーザーがプロビジョニングされているかどうか。

指定可能な値:
0 - プロビジョニングされていない;
1 - プロビジョニング済み。

このプロパティは Zabbix 7.0.9 以降でサポートされています。
userdirectory_mediaid ID プロビジョニングされたメディアのユーザーディレクトリメディアマッピングID。

プロパティの動作:
- 読み取り専用
- Super admin タイプのユーザーで サポート（Zabbix 7.0.9 以降）