[comment]: # ({856c911b-856c911b})
# 1 アイテムキーのフォーマット

キーパラメーターを含むアイテムキーのフォーマットは、構文規則に従う必要があります。次の図は、サポートされている構文を示しています。各ポイントで許可される要素と文字は、矢印に従って決定できます。矢印の先にあるブロックに到達できる場合は許可され、到達できない場合は許可されません。

![](../../../../../assets/en/manual/config/item_key_2.png){width="600"}

有効なアイテムキーを作成するには、キー名を指定し、次にパラメーターの有無を選択します。

[comment]: # ({/856c911b-856c911b})

[comment]: # ({63ccf8e4-63ccf8e4})
#### キー名

キー名自体には、使用できる文字の範囲が限られており、その文字が相互に続くだけです。
許容される文字は、

    0-9a-zA-Z_-.

つまり、以下の文字種を指します。

- すべての数字
- すべての小文字
- すべての大文字
- アンダースコア
- ダッシュ
- ドット

![](../../../../../assets/en/manual/config/key_name.png)

[comment]: # ({/63ccf8e4-63ccf8e4})

[comment]: # ({7262f26f-af5ae7f1})
#### キーパラメーター

アイテムキーは、カンマ区切りで複数のパラメーターを持つことができます。

![](../../../../../assets/en/manual/config/key_parameters.png)

各キーパラメーターは、引用符で囲まれた文字列、引用符で囲まれていない文字列、または配列のいずれかになります。

![](../../../../../assets/en/manual/config/item_parameter.png)

また、パラメーターを空にして、デフォルト値を使用することも可能です。その場合、さらにパラメーターを指定する場合は、適切な数のカンマを追加する必要があります。例えば、アイテムキー**icmpping\[,,200,,500\]**は、個々のpingの間隔が200ミリ秒、pingのタイムアウトが500ミリ秒、その他のパラメーターはデフォルトのままです。 

パラメーターにマクロを含めることができます。マクロは[ユーザーマクロ](/manual/appendix/macros/supported_by_location_user#items-item-prototypes)または組み込みマクロの一部です。アイテムキーパラメーターでサポートされている特定の組み込みマクロを確認するには、[サポートされているマクロ](/manual/appendix/macros/supported_by_location)ページで"アイテムキーパラメーター"を検索してください。

[comment]: # ({/7262f26f-af5ae7f1})

[comment]: # ({816c672d-b4a70ec9})
#### パラメーター -  二重引用符(")で囲まれた文字列

キーパラメーターが二重引用符で囲まれた文字列の場合、任意のUnicode文字が使用可能です。
キーパラメーターが二重引用符を含む場合、このパラメーターを二重引用符で囲み、パラメーター文字列の一部である各二重引用符はバックスラッシュ(`\`)でエスケープする必要があります。 
キーパラメーターがカンマを含む場合、このパラメーターは二重引用符で囲む必要があります。

![](../../../../../assets/en/manual/config/key_param_quoted_string.png)

::: notewarning
アイテムのキーパラメーターを引用符で囲むには、二重引用符(")のみを使用してください。一重引用符(')はサポートされていません。 
:::

::: noteimportant
`[a,[b,[c,d]],e]`のようなマルチレベルパラメーター配列は許可されていません。
:::

[comment]: # ({/816c672d-b4a70ec9})

[comment]: # ({3376836e-3376836e})
#### パラメーター - 二重引用符(")がない文字列

キーパラメーターに二重引用符がない文字列の場合、カンマと右大括弧(\])を除く全てのUnicode文字が使用可能です。
二重引用符で囲まれていないパラメータで、左大括弧(\[)で始まる文字列は使用できません。

![](../../../../../assets/en/manual/config/key_param_unquoted_string.png)

[comment]: # ({/3376836e-3376836e})

[comment]: # ({43e6bef7-5289a973})
#### パラメーター - 配列

キーパラメーターが配列の場合、これも角括弧で囲まれ、個々のパラメーターは複数のパラメーターを指定する規則と構文に従います。

![](../../../../../assets/en/manual/config/key_param_array.png)

[comment]: # ({/43e6bef7-5289a973})