- 最近的
- 2025-05-01-預覽版
- 2025-04-15
- 2024-12-01-預覽版
- 2024-11-15
- 2024-09-01-預覽版
- 2024-08-15
- 2024-05-15
- 2024-05-15-預覽版
- 2024-02-15-預覽版
- 2023-11-15
- 2023-11-15-預覽版
- 2023-09-15
- 2023-09-15-預覽版
- 2023-04-15
- 2023-03-15
- 2023-03-15-預覽版
- 2023-03-01-預覽版
- 2022-11-15
- 2022-11-15-預覽版
- 2022-08-15
- 2022-08-15-預覽版
- 2022-05-15
- 2022-05-15-預覽版
- 2022-02-15-預覽版
- 2021-11-15-預覽版
- 2021-10-15
- 2021-10-15-預覽版
- 2021-07-01-預覽版
- 2021-04-01-預覽版
- 2021-03-01-預覽版
Bicep 資源定義
cassandraClusters/dataCenters 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.DocumentDB/cassandraClusters/dataCenters 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.DocumentDB/cassandraClusters/dataCenters@2025-04-15' = {
parent: resourceSymbolicName
name: 'string'
properties: {
authenticationMethodLdapProperties: {
connectionTimeoutInMs: int
searchBaseDistinguishedName: 'string'
searchFilterTemplate: 'string'
serverCertificates: [
{
pem: 'string'
}
]
serverHostname: 'string'
serverPort: int
serviceUserDistinguishedName: 'string'
serviceUserPassword: 'string'
}
availabilityZone: bool
backupStorageCustomerKeyUri: 'string'
base64EncodedCassandraYamlFragment: 'string'
dataCenterLocation: 'string'
deallocated: bool
delegatedSubnetId: 'string'
diskCapacity: int
diskSku: 'string'
managedDiskCustomerKeyUri: 'string'
nodeCount: int
privateEndpointIpAddress: 'string'
provisionError: {
additionalErrorInfo: 'string'
code: 'string'
message: 'string'
target: 'string'
}
provisioningState: 'string'
sku: 'string'
}
}
屬性值
Microsoft.DocumentDB/cassandraClusters/數據中心
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 資源名稱 | 字串 約束： 最小長度 = 1 最大長度 = 100 模式 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$ （必要） |
| 家長 | 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。 如需詳細資訊，請參閱 父資源外部的子資源。 |
類型資源的符號名稱：cassandraClusters |
| 屬性 | 受控 Cassandra 資料中心的屬性。 | DataCenterResourceProperties |
AuthenticationMethodLdapProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| connectionTimeoutInMs | 在 miliseconds 中連線到 LDAP 伺服器的逾時。 預設值為 5000 毫秒。 | 整數 (int) |
| searchBaseDistinguishedName | 對象的辨別名稱，以啟動使用者的遞歸搜尋。 | 字符串 |
| searchFilter範本 | 要用於搜尋的範本。 默認為 （cn=%s），其中 %s 將取代為用來登入的用戶名稱。 | 字符串 |
| 伺服器證書 | 憑證[] | |
| serverHostname （伺服器主機名） | LDAP 伺服器的主機名。 | 字符串 |
| 伺服器端口 (serverPort) | LDAP 伺服器的埠。 | 整數 (int) |
| serviceUserDistinguishedName 服務 | 查閱用戶帳戶的辨別名稱，誰可以查閱驗證的使用者詳細數據。 | 字符串 |
| serviceUserPassword | 查閱用戶的密碼。 | 字符串 |
CassandraError
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| additionalErrorInfo | 有關錯誤的其他資訊。 | 字符串 |
| 程式碼 | 發生的錯誤碼。 | 字符串 |
| 訊息 | 錯誤的訊息。 | 字符串 |
| 目標 | 錯誤的目標資源。 | 字符串 |
證書
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| PEM | PEM 格式化的公鑰。 | 字符串 |
DataCenterResourceProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| authenticationMethodLdap屬性 | Ldap 驗證方法屬性。 此功能為預覽版。 | AuthenticationMethodLdapProperties |
| 可用性區域 | 如果數據中心具有可用性區域支援，請將它套用至裝載 cassandra 數據中心虛擬機的虛擬機器 ScaleSet。 | 布爾 (bool) |
| backupStorageCustomerKeyUri 的 | 指出要用於備份記憶體帳戶加密之客戶金鑰的金鑰 URI。 | 字符串 |
| base64EncodedCassandraYamlFragment | 此數據中心內所有節點的 cassandra.yaml 組態檔片段，要包含在 cassandra.yaml 中。 片段應為Base64編碼，而且只允許一部分的索引鍵。 | 字符串 |
| 數據中心位置 | 應該在此數據中心建立的區域。 | 字符串 |
| 已解除分配 | 數據中心是否已解除分配。 | 布爾 (bool) |
| 委託子網ID | 此數據中心節點應已連線到其網路介面的子網資源標識碼。 子網必須位於 『dataCenterLocation』 中指定的相同區域，而且必須能夠路由傳送至叢集 'delegatedManagementSubnetId' 屬性中指定的子網。 此資源標識符的格式為 '/subscriptions/<訂用帳戶標識符，>/resourceGroups/<資源群組>/providers/Microsoft.Network/virtualNetworks/<虛擬網络>/subnets/<子網>'。 | 字符串 |
| diskCapacity 磁碟容量 | 連結至每個節點的磁碟數目。 預設值為 4。 | 整數 (int) |
| diskSku 磁碟 | 用於數據中心的磁碟 SKU。 預設值為 P30。 | 字符串 |
| managedDiskCustomerKeyUri | 用於加密受控磁碟的金鑰 URI。 請確定系統指派的叢集身分識別已獲指派適當的許可權（金鑰取得/包裝/解除包裝許可權）密鑰。 | 字符串 |
| nodeCount 節點計數 | 數據中心應該擁有的節點數目。 這是所需的數位。 設定之後，可能需要一些時間來調整數據中心才能比對。 若要監視節點數目及其狀態，請在叢集上使用 fetchNodeStatus 方法。 | 整數 (int) |
| privateEndpointIpAddress（私有端點 IpAddress） | 此資料中心的 VPN 端點 IP。 | 字符串 |
| provisionError | 與資源布建相關的錯誤。 | CassandraError |
| 佈建狀態 | 呼叫作業時的資源狀態。 | “已取消” “創造” '刪除' “失敗” “成功” 'Updateing' |
| SKU | 用於資料中心的虛擬機 SKU。 預設值為 Standard_DS14_v2 | 字符串 |
ARM 樣本資源定義
cassandraClusters/dataCenters 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.DocumentDB/cassandraClusters/dataCenters 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.DocumentDB/cassandraClusters/dataCenters",
"apiVersion": "2025-04-15",
"name": "string",
"properties": {
"authenticationMethodLdapProperties": {
"connectionTimeoutInMs": "int",
"searchBaseDistinguishedName": "string",
"searchFilterTemplate": "string",
"serverCertificates": [
{
"pem": "string"
}
],
"serverHostname": "string",
"serverPort": "int",
"serviceUserDistinguishedName": "string",
"serviceUserPassword": "string"
},
"availabilityZone": "bool",
"backupStorageCustomerKeyUri": "string",
"base64EncodedCassandraYamlFragment": "string",
"dataCenterLocation": "string",
"deallocated": "bool",
"delegatedSubnetId": "string",
"diskCapacity": "int",
"diskSku": "string",
"managedDiskCustomerKeyUri": "string",
"nodeCount": "int",
"privateEndpointIpAddress": "string",
"provisionError": {
"additionalErrorInfo": "string",
"code": "string",
"message": "string",
"target": "string"
},
"provisioningState": "string",
"sku": "string"
}
}
屬性值
Microsoft.DocumentDB/cassandraClusters/數據中心
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| apiVersion | API 版本 | '2025-04-15' |
| 名稱 | 資源名稱 | 字串 約束： 最小長度 = 1 最大長度 = 100 模式 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$ （必要） |
| 屬性 | 受控 Cassandra 資料中心的屬性。 | DataCenterResourceProperties |
| 類型 | 資源類型 | “Microsoft.DocumentDB/cassandraClusters/dataCenters” |
AuthenticationMethodLdapProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| connectionTimeoutInMs | 在 miliseconds 中連線到 LDAP 伺服器的逾時。 預設值為 5000 毫秒。 | 整數 (int) |
| searchBaseDistinguishedName | 對象的辨別名稱，以啟動使用者的遞歸搜尋。 | 字符串 |
| searchFilter範本 | 要用於搜尋的範本。 默認為 （cn=%s），其中 %s 將取代為用來登入的用戶名稱。 | 字符串 |
| 伺服器證書 | 憑證[] | |
| serverHostname （伺服器主機名） | LDAP 伺服器的主機名。 | 字符串 |
| 伺服器端口 (serverPort) | LDAP 伺服器的埠。 | 整數 (int) |
| serviceUserDistinguishedName 服務 | 查閱用戶帳戶的辨別名稱，誰可以查閱驗證的使用者詳細數據。 | 字符串 |
| serviceUserPassword | 查閱用戶的密碼。 | 字符串 |
CassandraError
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| additionalErrorInfo | 有關錯誤的其他資訊。 | 字符串 |
| 程式碼 | 發生的錯誤碼。 | 字符串 |
| 訊息 | 錯誤的訊息。 | 字符串 |
| 目標 | 錯誤的目標資源。 | 字符串 |
證書
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| PEM | PEM 格式化的公鑰。 | 字符串 |
DataCenterResourceProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| authenticationMethodLdap屬性 | Ldap 驗證方法屬性。 此功能為預覽版。 | AuthenticationMethodLdapProperties |
| 可用性區域 | 如果數據中心具有可用性區域支援，請將它套用至裝載 cassandra 數據中心虛擬機的虛擬機器 ScaleSet。 | 布爾 (bool) |
| backupStorageCustomerKeyUri 的 | 指出要用於備份記憶體帳戶加密之客戶金鑰的金鑰 URI。 | 字符串 |
| base64EncodedCassandraYamlFragment | 此數據中心內所有節點的 cassandra.yaml 組態檔片段，要包含在 cassandra.yaml 中。 片段應為Base64編碼，而且只允許一部分的索引鍵。 | 字符串 |
| 數據中心位置 | 應該在此數據中心建立的區域。 | 字符串 |
| 已解除分配 | 數據中心是否已解除分配。 | 布爾 (bool) |
| 委託子網ID | 此數據中心節點應已連線到其網路介面的子網資源標識碼。 子網必須位於 『dataCenterLocation』 中指定的相同區域，而且必須能夠路由傳送至叢集 'delegatedManagementSubnetId' 屬性中指定的子網。 此資源標識符的格式為 '/subscriptions/<訂用帳戶標識符，>/resourceGroups/<資源群組>/providers/Microsoft.Network/virtualNetworks/<虛擬網络>/subnets/<子網>'。 | 字符串 |
| diskCapacity 磁碟容量 | 連結至每個節點的磁碟數目。 預設值為 4。 | 整數 (int) |
| diskSku 磁碟 | 用於數據中心的磁碟 SKU。 預設值為 P30。 | 字符串 |
| managedDiskCustomerKeyUri | 用於加密受控磁碟的金鑰 URI。 請確定系統指派的叢集身分識別已獲指派適當的許可權（金鑰取得/包裝/解除包裝許可權）密鑰。 | 字符串 |
| nodeCount 節點計數 | 數據中心應該擁有的節點數目。 這是所需的數位。 設定之後，可能需要一些時間來調整數據中心才能比對。 若要監視節點數目及其狀態，請在叢集上使用 fetchNodeStatus 方法。 | 整數 (int) |
| privateEndpointIpAddress（私有端點 IpAddress） | 此資料中心的 VPN 端點 IP。 | 字符串 |
| provisionError | 與資源布建相關的錯誤。 | CassandraError |
| 佈建狀態 | 呼叫作業時的資源狀態。 | “已取消” “創造” '刪除' “失敗” “成功” 'Updateing' |
| SKU | 用於資料中心的虛擬機 SKU。 預設值為 Standard_DS14_v2 | 字符串 |
使用範例
Terraform （AzAPI 提供者） 資源定義
cassandraClusters/dataCenters 資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.DocumentDB/cassandraClusters/dataCenters 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/cassandraClusters/dataCenters@2025-04-15"
name = "string"
parent_id = "string"
body = {
properties = {
authenticationMethodLdapProperties = {
connectionTimeoutInMs = int
searchBaseDistinguishedName = "string"
searchFilterTemplate = "string"
serverCertificates = [
{
pem = "string"
}
]
serverHostname = "string"
serverPort = int
serviceUserDistinguishedName = "string"
serviceUserPassword = "string"
}
availabilityZone = bool
backupStorageCustomerKeyUri = "string"
base64EncodedCassandraYamlFragment = "string"
dataCenterLocation = "string"
deallocated = bool
delegatedSubnetId = "string"
diskCapacity = int
diskSku = "string"
managedDiskCustomerKeyUri = "string"
nodeCount = int
privateEndpointIpAddress = "string"
provisionError = {
additionalErrorInfo = "string"
code = "string"
message = "string"
target = "string"
}
provisioningState = "string"
sku = "string"
}
}
}
屬性值
Microsoft.DocumentDB/cassandraClusters/數據中心
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 資源名稱 | 字串 約束： 最小長度 = 1 最大長度 = 100 模式 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$ （必要） |
| 父項識別碼 | 此資源為父系之資源的標識碼。 | 類型資源的標識碼：cassandraClusters |
| 屬性 | 受控 Cassandra 資料中心的屬性。 | DataCenterResourceProperties |
| 類型 | 資源類型 | “Microsoft.DocumentDB/cassandraClusters/dataCenters@2025-04-15” |
AuthenticationMethodLdapProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| connectionTimeoutInMs | 在 miliseconds 中連線到 LDAP 伺服器的逾時。 預設值為 5000 毫秒。 | 整數 (int) |
| searchBaseDistinguishedName | 對象的辨別名稱，以啟動使用者的遞歸搜尋。 | 字符串 |
| searchFilter範本 | 要用於搜尋的範本。 默認為 （cn=%s），其中 %s 將取代為用來登入的用戶名稱。 | 字符串 |
| 伺服器證書 | 憑證[] | |
| serverHostname （伺服器主機名） | LDAP 伺服器的主機名。 | 字符串 |
| 伺服器端口 (serverPort) | LDAP 伺服器的埠。 | 整數 (int) |
| serviceUserDistinguishedName 服務 | 查閱用戶帳戶的辨別名稱，誰可以查閱驗證的使用者詳細數據。 | 字符串 |
| serviceUserPassword | 查閱用戶的密碼。 | 字符串 |
CassandraError
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| additionalErrorInfo | 有關錯誤的其他資訊。 | 字符串 |
| 程式碼 | 發生的錯誤碼。 | 字符串 |
| 訊息 | 錯誤的訊息。 | 字符串 |
| 目標 | 錯誤的目標資源。 | 字符串 |
證書
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| PEM | PEM 格式化的公鑰。 | 字符串 |
DataCenterResourceProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| authenticationMethodLdap屬性 | Ldap 驗證方法屬性。 此功能為預覽版。 | AuthenticationMethodLdapProperties |
| 可用性區域 | 如果數據中心具有可用性區域支援，請將它套用至裝載 cassandra 數據中心虛擬機的虛擬機器 ScaleSet。 | 布爾 (bool) |
| backupStorageCustomerKeyUri 的 | 指出要用於備份記憶體帳戶加密之客戶金鑰的金鑰 URI。 | 字符串 |
| base64EncodedCassandraYamlFragment | 此數據中心內所有節點的 cassandra.yaml 組態檔片段，要包含在 cassandra.yaml 中。 片段應為Base64編碼，而且只允許一部分的索引鍵。 | 字符串 |
| 數據中心位置 | 應該在此數據中心建立的區域。 | 字符串 |
| 已解除分配 | 數據中心是否已解除分配。 | 布爾 (bool) |
| 委託子網ID | 此數據中心節點應已連線到其網路介面的子網資源標識碼。 子網必須位於 『dataCenterLocation』 中指定的相同區域，而且必須能夠路由傳送至叢集 'delegatedManagementSubnetId' 屬性中指定的子網。 此資源標識符的格式為 '/subscriptions/<訂用帳戶標識符，>/resourceGroups/<資源群組>/providers/Microsoft.Network/virtualNetworks/<虛擬網络>/subnets/<子網>'。 | 字符串 |
| diskCapacity 磁碟容量 | 連結至每個節點的磁碟數目。 預設值為 4。 | 整數 (int) |
| diskSku 磁碟 | 用於數據中心的磁碟 SKU。 預設值為 P30。 | 字符串 |
| managedDiskCustomerKeyUri | 用於加密受控磁碟的金鑰 URI。 請確定系統指派的叢集身分識別已獲指派適當的許可權（金鑰取得/包裝/解除包裝許可權）密鑰。 | 字符串 |
| nodeCount 節點計數 | 數據中心應該擁有的節點數目。 這是所需的數位。 設定之後，可能需要一些時間來調整數據中心才能比對。 若要監視節點數目及其狀態，請在叢集上使用 fetchNodeStatus 方法。 | 整數 (int) |
| privateEndpointIpAddress（私有端點 IpAddress） | 此資料中心的 VPN 端點 IP。 | 字符串 |
| provisionError | 與資源布建相關的錯誤。 | CassandraError |
| 佈建狀態 | 呼叫作業時的資源狀態。 | “已取消” “創造” '刪除' “失敗” “成功” 'Updateing' |
| SKU | 用於資料中心的虛擬機 SKU。 預設值為 Standard_DS14_v2 | 字符串 |