-
-
创建和使用自定义样书
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
创建和使用自定义样书
您可以为部署编写自己的样书，将其导入到 NetScaler Application Delivery Management (ADM)，然后创建配置对象。还可以使用 API 根据您的样书创建配置。
本文档包含以下信息：
开始之前的准备工作
开始创建样书之前，请确保您了解以下内容：
- NITRO API。有关更多信息，请参阅 Nitro API 文档
- YAML
样书文件使用 YAML 格式。有关 YAML 格式的信息，请参阅 YAML 语法。
下面是创建样书时必须了解的 YAML 准则列表：
- YAML 区分大小写。
- YAML 要求使用正确的行首缩进。
- 使用
<spacebar>键创建正确的缩进。不要使用<tab>键。在将样书导入 MA Service 时，使用<tab>键会导致编译错误。 - 请勿在字符串两边加引号。仅当字符串包含标点符号（破折号、冒号等）时才在字符串两边加引号。如果要将数字解释为字符串，请在数字两边加引号或使用样书的内置函数 str()。
-
YES/Yes/yes/Y/y/NO/no/No/n/N、ON/On/on/OFF/Off/off 和 TRUE/true/truthy/FALSE/False/false/falsely 等字面值被视为布尔值，分别等同于 true 和 false。要将它们解释为字符串，请在其两边加引号。例如：
- “YES”
- “No”
- “True”
- “False” 等等。
注意
在将样书文件导入 NetScaler ADM 之前，建议您验证您的文件是否符合 YAML 格式。Citrix 建议您使用样书中的内置 YAML 验证程序来验证和导入 YAML 内容。
配置样本时，您只能使用支持创建和删除操作的 Nitro 配置资源（POST 和 DELETE HTTP 方法）。有关更多信息，请参阅 Nitro API 文档。
样书解析
编写样本要求您了解样本的语法、句法和结构。典型的样书包含以下部分：
- 标题：本节允许您定义样书的标识并描述其用途。这是必需的部分。
- 导入样书：此部分用于声明要在当前样书中引用哪个其他样书。编写样书需要导入 NetScaler NITRO 配置样书或其他样书。这是必需的部分。
- 参数：此部分用于定义样书中所需的参数以创建配置。它描述样书接收的输入。这是可选部分。
-
组件：此部分允许您定义样书为特定配置创建的实体（配置对象）。此部分被视为样本的核心。组件通常使用 parameters 部分中提供的输入来改写样本生成的配置。这是可选部分。
样书可以包含参数部分或组件部分，也可以同时包含两者。如果要定义其他样本可以使用的一组参数，可以使用仅含 parameters 部分的样本。这有利于在一组样本之间重用参数组。如果要在样本中指定属性值，而不是定义参数来接收用户输入，可以使用仅含 components 部分的样本。
- 输出：参数部分定义样书的输入时，此可选部分定义其输出。在此可选输出部分，可以指定要向基于此样本创建配置的用户和导入此样本的其他样本呈现的组件。之后，用户和导入样书可以引用呈现的组件的属性。
- 操作：样书可能包含一个可选部分，用于在作为样书一部分的任何虚拟服务器上在 NetScaler ADM 中启用 Analytics。
下图显示了一个简单的样书概况。
以下示例帮助您了解样书的语法和结构，以及如何编写复杂程度不断增加的样书。
共享
共享
This Preview product documentation is Cloud Software Group Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Cloud Software Group Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Cloud Software Group product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.