你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Microsoft.DocumentDB cassandraClusters 2023-09-15-preview
- 最新
- 2024-12-01-preview
- 2024-11-15
- 2024-09-01-preview
- 2024-08-15
- 2024-05-15
- 2024-05-15-preview
- 2024-02-15-preview
- 2023-11-15
- 2023-11-15-preview
- 2023-09-15
- 2023-09-15-preview
- 2023-04-15
- 2023-03-15
- 2023-03-15-preview
- 2023-03-01-preview
- 2022-11-15
- 2022-11-15-preview
- 2022-08-15
- 2022-08-15-preview
- 2022-05-15
- 2022-05-15-preview
- 2022-02-15-preview
- 2021-11-15-preview
- 2021-10-15
- 2021-10-15-preview
- 2021-07-01-preview
- 2021-04-01-preview
- 2021-03-01-preview
Bicep 资源定义
cassandraClusters 资源类型可以使用目标操作进行部署：
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.DocumentDB/cassandraClusters 资源，请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.DocumentDB/cassandraClusters@2023-09-15-preview' = {
identity: {
type: 'string'
}
location: 'string'
name: 'string'
properties: {
authenticationMethod: 'string'
backupSchedules: [
{
cronExpression: 'string'
retentionInHours: int
scheduleName: 'string'
}
]
cassandraAuditLoggingEnabled: bool
cassandraVersion: 'string'
clientCertificates: [
{
pem: 'string'
}
]
clusterNameOverride: 'string'
clusterType: 'string'
deallocated: bool
delegatedManagementSubnetId: 'string'
extensions: [
'string'
]
externalGossipCertificates: [
{
pem: 'string'
}
]
externalSeedNodes: [
{
ipAddress: 'string'
}
]
hoursBetweenBackups: int
initialCassandraAdminPassword: 'string'
prometheusEndpoint: {
ipAddress: 'string'
}
provisionError: {
additionalErrorInfo: 'string'
code: 'string'
message: 'string'
target: 'string'
}
provisioningState: 'string'
repairEnabled: bool
restoreFromBackupId: 'string'
}
tags: {
{customized property}: 'string'
}
}
属性值
BackupSchedule
| 名字 | 描述 | 价值 |
|---|---|---|
| cronExpression | 定义何时备份数据的 cron 表达式。 | 字符串 |
| retentionInHours | 备份的保留期（小时）。 如果要永久保留数据，请将保留期设置为 0。 | int |
| scheduleName | 备份计划的唯一标识符。 | 字符串 |
CassandraError
| 名字 | 描述 | 价值 |
|---|---|---|
| additionalErrorInfo | 有关错误的其他信息。 | 字符串 |
| 法典 | 发生的错误代码。 | 字符串 |
| 消息 | 错误的消息。 | 字符串 |
| 目标 | 错误的目标资源。 | 字符串 |
证书
| 名字 | 描述 | 价值 |
|---|---|---|
| pem | PEM 格式的公钥。 | 字符串 |
ClusterResourceProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| authenticationMethod | Cassandra 应使用哪种身份验证方法对客户端进行身份验证。 “无”会关闭身份验证，因此不应在紧急情况下使用。 “Cassandra”是基于密码的默认身份验证。 默认值为“Cassandra”。 | “Cassandra” “Ldap” “None” |
| backupSchedules | 用于定义何时备份数据的备份计划列表。 | BackupSchedule[] |
| cassandraAuditLoggingEnabled | 是否启用 Cassandra 审核日志记录 | bool |
| cassandraVersion | 此群集应聚合到正在运行的 Cassandra 版本（例如 3.11）。 更新后，群集可能需要一些时间才能迁移到新版本。 | 字符串 |
| clientCertificates | 用于授权连接到群集的客户端的 TLS 证书列表。 无论是否设置 clientCertificates，所有连接都经过 TLS 加密，但如果设置了 clientCertificates，托管 Cassandra 群集将拒绝所有不带有 TLS 客户端证书的连接，该证书可从此属性中的一个或多个公共证书进行验证。 | 证书[] |
| clusterNameOverride | 如果需要将 cassandra.yaml 中的 clusterName 属性设置为群集的资源名称以外的内容，请设置要在此属性上使用的值。 | 字符串 |
| clusterType | 群集的类型。 如果设置为“生产”，则群集上可能不允许某些操作。 | “NonProduction” “生产” |
| 已解除分配 | 群集和关联的数据中心是否已解除分配。 | bool |
| delegatedManagementSubnetId | 此群集管理服务应附加到其网络接口的子网的资源 ID。 子网必须可路由到将委托给数据中心的所有子网。 资源 ID 必须采用 “/subscriptions/<订阅 ID>/resourceGroups/<资源组>/providers/Microsoft.Network/virtualNetworks/<虚拟网络>/subnets/<子网>” | 字符串 |
| 扩展 | 在群集上添加或更新的扩展。 | string[] |
| externalGossipCertificates | 用于从非托管数据中心授权八卦的 TLS 证书列表。 非托管数据中心内所有节点的 TLS 证书必须使用此属性中提供的证书之一进行验证。 | 证书[] |
| externalSeedNodes | 非托管数据中心种子节点的 IP 地址列表。 这些项将添加到所有托管节点的种子节点列表中。 | SeedNode[] |
| hoursBetweenBackups | （已弃用）在备份群集之间等待的小时数。 | int |
| initialCassandraAdminPassword | 作为管理员连接到群集的客户端的初始密码。 应在创建群集后进行更改。 在 GET 上返回 null。 仅当 authenticationMethod 字段为“Cassandra”时，此字段才适用。 | 字符串 约束： 敏感值。 以安全参数的形式传入。 |
| prometheusEndpoint | 可以访问 Prometheus 终结点的主机名或 IP 地址，其中包含有关托管 Cassandra 节点的数据。 | SeedNode |
| provisionError | 与资源预配相关的错误。 | CassandraError |
| provisioningState | 调用操作时资源的状态。 | “Canceled” “创建” “删除” “Failed” “Succeeded” “正在更新” |
| repairEnabled | 是否应在此群集上运行自动修复？ 如果省略，则为 true，并且应保持 true，除非你正在运行一个已执行自己的修复的混合群集。 | bool |
| restoreFromBackupId | 若要创建空群集，请省略此字段或将其设置为 null。 若要将备份还原到新群集，请将此字段设置为备份的资源 ID。 | 字符串 |
ManagedCassandraManagedServiceIdentity
| 名字 | 描述 | 价值 |
|---|---|---|
| 类型 | 资源的类型。 | “None” “SystemAssigned” |
Microsoft.DocumentDB/cassandraClusters
| 名字 | 描述 | 价值 |
|---|---|---|
| 身份 | 资源的标识。 | ManagedCassandraManagedServiceIdentity |
| 位置 | 资源所属的资源组的位置。 | 字符串 |
| 名字 | 资源名称 | 字符串 约束： 最小长度 = 1 最大长度 = 1 模式 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$ （必需） |
| 性能 | 托管 Cassandra 群集的属性。 | ClusterResourceProperties |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
SeedNode
| 名字 | 描述 | 价值 |
|---|---|---|
| ipAddress | 此种子节点的 IP 地址。 | 字符串 |
标签
| 名字 | 描述 | 价值 |
|---|
ARM 模板资源定义
cassandraClusters 资源类型可以使用目标操作进行部署：
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.DocumentDB/cassandraClusters 资源，请将以下 JSON 添加到模板。
{
"type": "Microsoft.DocumentDB/cassandraClusters",
"apiVersion": "2023-09-15-preview",
"name": "string",
"identity": {
"type": "string"
},
"location": "string",
"properties": {
"authenticationMethod": "string",
"backupSchedules": [
{
"cronExpression": "string",
"retentionInHours": "int",
"scheduleName": "string"
}
],
"cassandraAuditLoggingEnabled": "bool",
"cassandraVersion": "string",
"clientCertificates": [
{
"pem": "string"
}
],
"clusterNameOverride": "string",
"clusterType": "string",
"deallocated": "bool",
"delegatedManagementSubnetId": "string",
"extensions": [ "string" ],
"externalGossipCertificates": [
{
"pem": "string"
}
],
"externalSeedNodes": [
{
"ipAddress": "string"
}
],
"hoursBetweenBackups": "int",
"initialCassandraAdminPassword": "string",
"prometheusEndpoint": {
"ipAddress": "string"
},
"provisionError": {
"additionalErrorInfo": "string",
"code": "string",
"message": "string",
"target": "string"
},
"provisioningState": "string",
"repairEnabled": "bool",
"restoreFromBackupId": "string"
},
"tags": {
"{customized property}": "string"
}
}
属性值
BackupSchedule
| 名字 | 描述 | 价值 |
|---|---|---|
| cronExpression | 定义何时备份数据的 cron 表达式。 | 字符串 |
| retentionInHours | 备份的保留期（小时）。 如果要永久保留数据，请将保留期设置为 0。 | int |
| scheduleName | 备份计划的唯一标识符。 | 字符串 |
CassandraError
| 名字 | 描述 | 价值 |
|---|---|---|
| additionalErrorInfo | 有关错误的其他信息。 | 字符串 |
| 法典 | 发生的错误代码。 | 字符串 |
| 消息 | 错误的消息。 | 字符串 |
| 目标 | 错误的目标资源。 | 字符串 |
证书
| 名字 | 描述 | 价值 |
|---|---|---|
| pem | PEM 格式的公钥。 | 字符串 |
ClusterResourceProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| authenticationMethod | Cassandra 应使用哪种身份验证方法对客户端进行身份验证。 “无”会关闭身份验证，因此不应在紧急情况下使用。 “Cassandra”是基于密码的默认身份验证。 默认值为“Cassandra”。 | “Cassandra” “Ldap” “None” |
| backupSchedules | 用于定义何时备份数据的备份计划列表。 | BackupSchedule[] |
| cassandraAuditLoggingEnabled | 是否启用 Cassandra 审核日志记录 | bool |
| cassandraVersion | 此群集应聚合到正在运行的 Cassandra 版本（例如 3.11）。 更新后，群集可能需要一些时间才能迁移到新版本。 | 字符串 |
| clientCertificates | 用于授权连接到群集的客户端的 TLS 证书列表。 无论是否设置 clientCertificates，所有连接都经过 TLS 加密，但如果设置了 clientCertificates，托管 Cassandra 群集将拒绝所有不带有 TLS 客户端证书的连接，该证书可从此属性中的一个或多个公共证书进行验证。 | 证书[] |
| clusterNameOverride | 如果需要将 cassandra.yaml 中的 clusterName 属性设置为群集的资源名称以外的内容，请设置要在此属性上使用的值。 | 字符串 |
| clusterType | 群集的类型。 如果设置为“生产”，则群集上可能不允许某些操作。 | “NonProduction” “生产” |
| 已解除分配 | 群集和关联的数据中心是否已解除分配。 | bool |
| delegatedManagementSubnetId | 此群集管理服务应附加到其网络接口的子网的资源 ID。 子网必须可路由到将委托给数据中心的所有子网。 资源 ID 必须采用 “/subscriptions/<订阅 ID>/resourceGroups/<资源组>/providers/Microsoft.Network/virtualNetworks/<虚拟网络>/subnets/<子网>” | 字符串 |
| 扩展 | 在群集上添加或更新的扩展。 | string[] |
| externalGossipCertificates | 用于从非托管数据中心授权八卦的 TLS 证书列表。 非托管数据中心内所有节点的 TLS 证书必须使用此属性中提供的证书之一进行验证。 | 证书[] |
| externalSeedNodes | 非托管数据中心种子节点的 IP 地址列表。 这些项将添加到所有托管节点的种子节点列表中。 | SeedNode[] |
| hoursBetweenBackups | （已弃用）在备份群集之间等待的小时数。 | int |
| initialCassandraAdminPassword | 作为管理员连接到群集的客户端的初始密码。 应在创建群集后进行更改。 在 GET 上返回 null。 仅当 authenticationMethod 字段为“Cassandra”时，此字段才适用。 | 字符串 约束： 敏感值。 以安全参数的形式传入。 |
| prometheusEndpoint | 可以访问 Prometheus 终结点的主机名或 IP 地址，其中包含有关托管 Cassandra 节点的数据。 | SeedNode |
| provisionError | 与资源预配相关的错误。 | CassandraError |
| provisioningState | 调用操作时资源的状态。 | “Canceled” “创建” “删除” “Failed” “Succeeded” “正在更新” |
| repairEnabled | 是否应在此群集上运行自动修复？ 如果省略，则为 true，并且应保持 true，除非你正在运行一个已执行自己的修复的混合群集。 | bool |
| restoreFromBackupId | 若要创建空群集，请省略此字段或将其设置为 null。 若要将备份还原到新群集，请将此字段设置为备份的资源 ID。 | 字符串 |
ManagedCassandraManagedServiceIdentity
| 名字 | 描述 | 价值 |
|---|---|---|
| 类型 | 资源的类型。 | “None” “SystemAssigned” |
Microsoft.DocumentDB/cassandraClusters
| 名字 | 描述 | 价值 |
|---|---|---|
| apiVersion | API 版本 | '2023-09-15-preview' |
| 身份 | 资源的标识。 | ManagedCassandraManagedServiceIdentity |
| 位置 | 资源所属的资源组的位置。 | 字符串 |
| 名字 | 资源名称 | 字符串 约束： 最小长度 = 1 最大长度 = 1 模式 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$ （必需） |
| 性能 | 托管 Cassandra 群集的属性。 | ClusterResourceProperties |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
| 类型 | 资源类型 | “Microsoft.DocumentDB/cassandraClusters” |
SeedNode
| 名字 | 描述 | 价值 |
|---|---|---|
| ipAddress | 此种子节点的 IP 地址。 | 字符串 |
标签
| 名字 | 描述 | 价值 |
|---|
Terraform （AzAPI 提供程序）资源定义
cassandraClusters 资源类型可以使用目标操作进行部署：
- 资源组
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.DocumentDB/cassandraClusters 资源，请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/cassandraClusters@2023-09-15-preview"
name = "string"
identity = {
type = "string"
}
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
authenticationMethod = "string"
backupSchedules = [
{
cronExpression = "string"
retentionInHours = int
scheduleName = "string"
}
]
cassandraAuditLoggingEnabled = bool
cassandraVersion = "string"
clientCertificates = [
{
pem = "string"
}
]
clusterNameOverride = "string"
clusterType = "string"
deallocated = bool
delegatedManagementSubnetId = "string"
extensions = [
"string"
]
externalGossipCertificates = [
{
pem = "string"
}
]
externalSeedNodes = [
{
ipAddress = "string"
}
]
hoursBetweenBackups = int
initialCassandraAdminPassword = "string"
prometheusEndpoint = {
ipAddress = "string"
}
provisionError = {
additionalErrorInfo = "string"
code = "string"
message = "string"
target = "string"
}
provisioningState = "string"
repairEnabled = bool
restoreFromBackupId = "string"
}
})
}
属性值
BackupSchedule
| 名字 | 描述 | 价值 |
|---|---|---|
| cronExpression | 定义何时备份数据的 cron 表达式。 | 字符串 |
| retentionInHours | 备份的保留期（小时）。 如果要永久保留数据，请将保留期设置为 0。 | int |
| scheduleName | 备份计划的唯一标识符。 | 字符串 |
CassandraError
| 名字 | 描述 | 价值 |
|---|---|---|
| additionalErrorInfo | 有关错误的其他信息。 | 字符串 |
| 法典 | 发生的错误代码。 | 字符串 |
| 消息 | 错误的消息。 | 字符串 |
| 目标 | 错误的目标资源。 | 字符串 |
证书
| 名字 | 描述 | 价值 |
|---|---|---|
| pem | PEM 格式的公钥。 | 字符串 |
ClusterResourceProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| authenticationMethod | Cassandra 应使用哪种身份验证方法对客户端进行身份验证。 “无”会关闭身份验证，因此不应在紧急情况下使用。 “Cassandra”是基于密码的默认身份验证。 默认值为“Cassandra”。 | “Cassandra” “Ldap” “None” |
| backupSchedules | 用于定义何时备份数据的备份计划列表。 | BackupSchedule[] |
| cassandraAuditLoggingEnabled | 是否启用 Cassandra 审核日志记录 | bool |
| cassandraVersion | 此群集应聚合到正在运行的 Cassandra 版本（例如 3.11）。 更新后，群集可能需要一些时间才能迁移到新版本。 | 字符串 |
| clientCertificates | 用于授权连接到群集的客户端的 TLS 证书列表。 无论是否设置 clientCertificates，所有连接都经过 TLS 加密，但如果设置了 clientCertificates，托管 Cassandra 群集将拒绝所有不带有 TLS 客户端证书的连接，该证书可从此属性中的一个或多个公共证书进行验证。 | 证书[] |
| clusterNameOverride | 如果需要将 cassandra.yaml 中的 clusterName 属性设置为群集的资源名称以外的内容，请设置要在此属性上使用的值。 | 字符串 |
| clusterType | 群集的类型。 如果设置为“生产”，则群集上可能不允许某些操作。 | “NonProduction” “生产” |
| 已解除分配 | 群集和关联的数据中心是否已解除分配。 | bool |
| delegatedManagementSubnetId | 此群集管理服务应附加到其网络接口的子网的资源 ID。 子网必须可路由到将委托给数据中心的所有子网。 资源 ID 必须采用 “/subscriptions/<订阅 ID>/resourceGroups/<资源组>/providers/Microsoft.Network/virtualNetworks/<虚拟网络>/subnets/<子网>” | 字符串 |
| 扩展 | 在群集上添加或更新的扩展。 | string[] |
| externalGossipCertificates | 用于从非托管数据中心授权八卦的 TLS 证书列表。 非托管数据中心内所有节点的 TLS 证书必须使用此属性中提供的证书之一进行验证。 | 证书[] |
| externalSeedNodes | 非托管数据中心种子节点的 IP 地址列表。 这些项将添加到所有托管节点的种子节点列表中。 | SeedNode[] |
| hoursBetweenBackups | （已弃用）在备份群集之间等待的小时数。 | int |
| initialCassandraAdminPassword | 作为管理员连接到群集的客户端的初始密码。 应在创建群集后进行更改。 在 GET 上返回 null。 仅当 authenticationMethod 字段为“Cassandra”时，此字段才适用。 | 字符串 约束： 敏感值。 以安全参数的形式传入。 |
| prometheusEndpoint | 可以访问 Prometheus 终结点的主机名或 IP 地址，其中包含有关托管 Cassandra 节点的数据。 | SeedNode |
| provisionError | 与资源预配相关的错误。 | CassandraError |
| provisioningState | 调用操作时资源的状态。 | “Canceled” “创建” “删除” “Failed” “Succeeded” “正在更新” |
| repairEnabled | 是否应在此群集上运行自动修复？ 如果省略，则为 true，并且应保持 true，除非你正在运行一个已执行自己的修复的混合群集。 | bool |
| restoreFromBackupId | 若要创建空群集，请省略此字段或将其设置为 null。 若要将备份还原到新群集，请将此字段设置为备份的资源 ID。 | 字符串 |
ManagedCassandraManagedServiceIdentity
| 名字 | 描述 | 价值 |
|---|---|---|
| 类型 | 资源的类型。 | “None” “SystemAssigned” |
Microsoft.DocumentDB/cassandraClusters
| 名字 | 描述 | 价值 |
|---|---|---|
| 身份 | 资源的标识。 | ManagedCassandraManagedServiceIdentity |
| 位置 | 资源所属的资源组的位置。 | 字符串 |
| 名字 | 资源名称 | 字符串 约束： 最小长度 = 1 最大长度 = 1 模式 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$ （必需） |
| 性能 | 托管 Cassandra 群集的属性。 | ClusterResourceProperties |
| 标签 | 资源标记 | 标记名称和值的字典。 |
| 类型 | 资源类型 | “Microsoft.DocumentDB/cassandraClusters@2023-09-15-preview” |
SeedNode
| 名字 | 描述 | 价值 |
|---|---|---|
| ipAddress | 此种子节点的 IP 地址。 | 字符串 |
标签
| 名字 | 描述 | 价值 |
|---|