tag-policies 命令组

tag-policies Databricks CLI 中的命令组包含用于管理 Databricks 中受治理标记的策略的命令。 请参阅 受管控的标签。

databricks 标记策略 create-tag-policy

创建新的标记策略，使关联的标记密钥受到控制。

databricks tag-policies create-tag-policy TAG_KEY [flags]

Arguments

TAG_KEY

    要为其创建策略的标记键。

选项

--description string

    标记策略的说明。

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件

全局标志

示例

以下示例为标记键创建标记策略：

databricks tag-policies create-tag-policy environment --description "Policy for environment tags"

以下示例使用 JSON 创建标记策略：

databricks tag-policies create-tag-policy department --json '{"description": "Policy for department classification", "allowed_values": ["engineering", "sales", "marketing"]}'

以下示例使用 JSON 文件创建标记策略：

databricks tag-policies create-tag-policy compliance --json @tag-policy.json

databricks tag-policies delete-tag-policy

通过标记的关联标记的密钥删除标记策略，使该标记键未恢复。

databricks tag-policies delete-tag-policy TAG_KEY [flags]

Arguments

TAG_KEY

    要为其删除策略的标记键。

选项

全局标志

示例

以下示例删除标记策略：

databricks tag-policies delete-tag-policy environment

databricks 标记策略 get-tag-policy

按其关联的受治理标记的密钥获取单个标记策略。

databricks tag-policies get-tag-policy TAG_KEY [flags]

Arguments

TAG_KEY

    要为其检索策略的标记键。

选项

全局标志

示例

以下示例获取标记策略：

databricks tag-policies get-tag-policy environment

databricks tag-policies list-tag-policies

列出帐户中所有受治理标记的标记策略。

databricks tag-policies list-tag-policies [flags]

选项

--page-size int

    每个页面要返回的最大标记策略数。

--page-token string

    用于检索下一页结果的令牌。

全局标志

示例

以下示例列出所有标记策略：

databricks tag-policies list-tag-policies

以下示例列出具有分页的标记策略：

databricks tag-policies list-tag-policies --page-size 10

databricks 标记策略 update-tag-policy

更新单个受管理标记的现有标记策略。

databricks tag-policies update-tag-policy TAG_KEY UPDATE_MASK [flags]

Arguments

TAG_KEY

    要为其更新策略的标记键。

UPDATE_MASK

    字段掩码必须是单个字符串，多个字段用逗号分隔（无空格）。 字段路径是相对于资源对象而言的，通过点（.）来导航子字段（例如，author.given_name）。 不允许对序列或映射字段中的元素进行规范，因为只能指定整个集合字段。 字段名称必须与资源字段名称完全匹配。

    星号 （*） 字段掩码指示完全替换。 建议始终显式列出要更新的字段，避免使用通配符，因为如果 API 将来发生更改，可能会导致意外结果。

选项

--description string

    标记策略的说明。

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件

全局标志

示例

以下示例更新标记策略的说明：

databricks tag-policies update-tag-policy environment "description" --description "Updated policy for environment tags"

以下示例使用 JSON 更新标记策略：

databricks tag-policies update-tag-policy department "allowed_values" --json '{"allowed_values": ["engineering", "sales", "marketing", "operations"]}'

以下示例使用 JSON 文件更新标记策略：

databricks tag-policies update-tag-policy compliance "description,allowed_values" --json @updated-policy.json

全局标志

--debug

  是否启用调试日志记录。

-h 或 --help

    显示 Databricks CLI、相关命令组或相关命令的帮助。

--log-file 字符串

    一个字符串，表示要将输出日志写入到的文件。 如果未指定此标志，则默认会将输出日志写入到 stderr。

--log-format 格式

    日志格式类型，text 或 json。 默认值为 text。

--log-level 字符串

    一个表示日志格式级别的字符串。 如果未指定，则禁用日志格式级别。

-o, --output 类型

    命令输出类型为 text 或 json。 默认值为 text。

-p, --profile 字符串

    要用于运行命令的 ~/.databrickscfg 文件中的配置文件名称。 如果未指定此标志，并且存在命名为 DEFAULT 的配置文件，则使用该配置文件。

--progress-format 格式

    显示进度日志的格式： default、 append、 inplace或 json

-t, --target 字符串

    如果适用，要使用的捆绑包目标