Microsoft.DocumentDB cassandraClusters/dataCenters 2023-09-15-preview
- Mais recente
- 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
- 01-2021-07-01-preview
- 01-2021-04-01-preview
- 2021-03-01-preview
Definição de recurso do Bicep
O tipo de recurso cassandraClusters/dataCenters pode ser implementado com operações direcionadas:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.DocumentDB/cassandraClusters/dataCenters, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.DocumentDB/cassandraClusters/dataCenters@2023-09-15-preview' = {
name: 'string'
parent: resourceSymbolicName
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
provisionError: {
additionalErrorInfo: 'string'
code: 'string'
message: 'string'
target: 'string'
}
provisioningState: 'string'
sku: 'string'
}
}
Valores de propriedade
cassandraClusters/dataCenters
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados no Bicep. |
cadeia (obrigatório) |
| principal | No Bicep, pode especificar o recurso principal de um recurso subordinado. Só tem de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal. Para obter mais informações, veja Recurso subordinado fora do recurso principal. |
Nome simbólico para recurso do tipo: cassandraClusters |
| propriedades | Propriedades de um datacenter do Cassandra gerido. | DataCenterResourceProperties |
DataCenterResourceProperties
| Nome | Descrição | Valor |
|---|---|---|
| authenticationMethodLdapProperties | Propriedades do método de autenticação Ldap. Esta funcionalidade está em pré-visualização. | AuthenticationMethodLdapProperties |
| availabilityZone | Se o datacenter tiver suporte para a Zona de Disponibilidade, aplique-o ao Conjunto de Dimensionamento de Máquinas Virtuais que aloja as máquinas virtuais do datacenter do cassandra. | bool |
| backupStorageCustomerKeyUri | Indica o Uri de Chave da chave do cliente a utilizar para encriptação da conta de armazenamento de cópias de segurança. | string |
| base64EncodedCassandraYamlFragment | Um fragmento de um ficheiro de configuração cassandra.yaml a ser incluído no cassandra.yaml para todos os nós neste datacenter. O fragmento deve ser codificado em Base64 e só é permitido um subconjunto de chaves. | string |
| dataCenterLocation | A região em que este datacenter deve ser criado. | string |
| desalocado | Se o datacenter foi desalocado. | bool |
| delegatedSubnetId | ID de recurso de uma sub-rede a que os nós neste datacenter devem ter as respetivas interfaces de rede ligadas. A sub-rede tem de estar na mesma região especificada em "dataCenterLocation" e tem de ser capaz de encaminhar para a sub-rede especificada na propriedade "delegatedManagementSubnetId" do cluster. Este ID de recurso será do formulário "/subscriptions/{subscription id}/resourceGroups/{resource group}/providers/Microsoft.Network/virtualNetworks/{virtual network}/subnets/{subnet}". | string |
| diskCapacity | Número de discos anexados a cada nó. A predefinição é 4. | int |
| diskSku | SKU de disco utilizado para datacenters. O valor predefinido é P30. | string |
| managedDiskCustomerKeyUri | URI de chave a utilizar para encriptação de discos geridos. Certifique-se de que a identidade atribuída pelo sistema do cluster foi atribuída às permissões adequadas (permissões de obtenção/moldagem/anulação de moldagem da chave) na chave. | string |
| nodeCount | O número de nós que o datacenter deve ter. Este é o número pretendido. Depois de definido, pode demorar algum tempo até que o datacenter seja dimensionado para corresponder. Para monitorizar o número de nós e o respetivo estado, utilize o método fetchNodeStatus no cluster. | int |
| provisionError | Erro relacionado com o aprovisionamento de recursos. | CassandraError |
| provisioningState | O estado do recurso no momento em que a operação foi chamada. | "Cancelado" "A criar" "A eliminar" "Com falhas" "Com êxito" "A atualizar" |
| sku | SKU de Máquina Virtual utilizado para datacenters. O valor predefinido é Standard_DS14_v2 | string |
AuthenticationMethodLdapProperties
| Nome | Descrição | Valor |
|---|---|---|
| connectionTimeoutInMs | Tempo limite para ligar ao servidor LDAP em milissegundos. A predefinição é 5000 ms. | int |
| searchBaseDistinguishedName | Nome único do objeto a partir do qual iniciar a pesquisa recursiva de utilizadores. | string |
| searchFilterTemplate | Modelo a utilizar para procurar. A predefinição é (cn=%s) em que %s será substituído pelo nome de utilizador utilizado para iniciar sessão. | string |
| serverCertificates | Certificado[] | |
| serverHostname | Nome do anfitrião do servidor LDAP. | string |
| serverPort | Porta do servidor LDAP. | int |
| serviceUserDistinguishedName | Nome único da conta de utilizador de pesquisa, que pode procurar detalhes do utilizador sobre a autenticação. | string |
| serviceUserPassword | Palavra-passe do utilizador de pesquisa. | string |
Certificado
| Nome | Descrição | Valor |
|---|---|---|
| pem | Chave pública formatada PEM. | string |
CassandraError
| Nome | Descrição | Valor |
|---|---|---|
| additionalErrorInfo | Informações adicionais sobre o erro. | string |
| code | O código de erro que ocorreu. | string |
| message | A mensagem do erro. | string |
| destino | O recurso de destino do erro. | string |
Definição de recurso do modelo arm
O tipo de recurso cassandraClusters/dataCenters pode ser implementado com operações direcionadas:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.DocumentDB/cassandraClusters/dataCenters, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.DocumentDB/cassandraClusters/dataCenters",
"apiVersion": "2023-09-15-preview",
"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",
"provisionError": {
"additionalErrorInfo": "string",
"code": "string",
"message": "string",
"target": "string"
},
"provisioningState": "string",
"sku": "string"
}
}
Valores de propriedade
cassandraClusters/dataCenters
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.DocumentDB/cassandraClusters/dataCenters" |
| apiVersion | A versão da API de recursos | '2023-09-15-preview' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados em modelos arm JSON. |
cadeia (obrigatório) |
| propriedades | Propriedades de um datacenter do Cassandra gerido. | DataCenterResourceProperties |
DataCenterResourceProperties
| Nome | Descrição | Valor |
|---|---|---|
| authenticationMethodLdapProperties | Propriedades do método de autenticação Ldap. Esta funcionalidade está em pré-visualização. | AuthenticationMethodLdapProperties |
| availabilityZone | Se o datacenter tiver suporte para a Zona de Disponibilidade, aplique-o ao Conjunto de Dimensionamento de Máquinas Virtuais que aloja as máquinas virtuais do datacenter do cassandra. | bool |
| backupStorageCustomerKeyUri | Indica o Uri de Chave da chave de cliente a utilizar para encriptação da conta de armazenamento de cópias de segurança. | string |
| base64EncodedCassandraYamlFragment | Um fragmento de um ficheiro de configuração cassandra.yaml a ser incluído no cassandra.yaml para todos os nós neste datacenter. O fragmento deve ser codificado com Base64 e só é permitido um subconjunto de chaves. | string |
| dataCenterLocation | A região onde este datacenter deve ser criado. | string |
| desalocado | Se o datacenter foi desalocado. | bool |
| delegatedSubnetId | ID de recurso de uma sub-rede a que os nós neste datacenter devem ter as respetivas interfaces de rede ligadas. A sub-rede tem de estar na mesma região especificada em "dataCenterLocation" e tem de ser capaz de encaminhar para a sub-rede especificada na propriedade "delegatedManagementSubnetId" do cluster. Este ID de recurso será do formulário "/subscriptions/{subscription id}/resourceGroups/{resource group}/providers/Microsoft.Network/virtualNetworks/{virtual network}/subnets/{subnet}". | string |
| diskCapacity | Número de discos anexados a cada nó. A predefinição é 4. | int |
| diskSku | SKU de disco utilizado para datacenters. O valor predefinido é P30. | string |
| managedDiskCustomerKeyUri | URI de chave a utilizar para encriptação de discos geridos. Certifique-se de que a identidade atribuída pelo sistema do cluster foi atribuída às permissões adequadas (permissões de obtenção/moldagem/desembrulhar chave) na chave. | string |
| nodeCount | O número de nós que o datacenter deve ter. Este é o número pretendido. Depois de definido, pode demorar algum tempo até que o datacenter seja dimensionado para corresponder. Para monitorizar o número de nós e o respetivo estado, utilize o método fetchNodeStatus no cluster. | int |
| provisionError | Erro relacionado com o aprovisionamento de recursos. | CassandraError |
| provisioningState | O estado do recurso no momento em que a operação foi chamada. | "Cancelado" "A criar" "A eliminar" "Falha" "Bem-sucedido" "A atualizar" |
| sku | SKU de Máquina Virtual utilizado para datacenters. O valor predefinido é Standard_DS14_v2 | string |
AuthenticationMethodLdapProperties
| Nome | Descrição | Valor |
|---|---|---|
| connectionTimeoutInMs | Tempo limite para ligar ao servidor LDAP em milissegundos. A predefinição é 5000 ms. | int |
| searchBaseDistinguishedName | Nome distinto do objeto a partir do qual iniciar a pesquisa recursiva dos utilizadores. | string |
| searchFilterTemplate | Modelo a utilizar para procurar. Predefinição para (cn=%s) em que %s será substituído pelo nome de utilizador utilizado para iniciar sessão. | string |
| serverCertificates | Certificado[] | |
| serverHostname | Nome do anfitrião do servidor LDAP. | string |
| serverPort | Porta do servidor LDAP. | int |
| serviceUserDistinguishedName | Nome distinto da conta de utilizador de pesquisa, que pode procurar detalhes do utilizador na autenticação. | string |
| serviceUserPassword | Palavra-passe do utilizador de pesquisa. | string |
Certificado
| Nome | Descrição | Valor |
|---|---|---|
| pem | Chave pública formatada PEM. | string |
CassandraError
| Nome | Descrição | Valor |
|---|---|---|
| additionalErrorInfo | Informações adicionais sobre o erro. | string |
| code | O código de erro que ocorreu. | string |
| message | A mensagem do erro. | string |
| destino | O recurso de destino do erro. | string |
Definição de recurso terraform (fornecedor AzAPI)
O tipo de recurso cassandraClusters/dataCenters pode ser implementado com operações direcionadas:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.DocumentDB/cassandraClusters/dataCenters, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/cassandraClusters/dataCenters@2023-09-15-preview"
name = "string"
parent_id = "string"
body = jsonencode({
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
provisionError = {
additionalErrorInfo = "string"
code = "string"
message = "string"
target = "string"
}
provisioningState = "string"
sku = "string"
}
})
}
Valores de propriedade
cassandraClusters/dataCenters
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.DocumentDB/cassandraClusters/dataCenters@2023-09-15-preview" |
| name | O nome do recurso | cadeia (obrigatório) |
| parent_id | O ID do recurso que é o principal para este recurso. | ID do recurso do tipo: cassandraClusters |
| propriedades | Propriedades de um datacenter do Cassandra gerido. | DataCenterResourceProperties |
DataCenterResourceProperties
| Nome | Descrição | Valor |
|---|---|---|
| authenticationMethodLdapProperties | Propriedades do método de autenticação Ldap. Esta funcionalidade está em pré-visualização. | AuthenticationMethodLdapProperties |
| availabilityZone | Se o datacenter tiver suporte para a Zona de Disponibilidade, aplique-o ao Conjunto de Dimensionamento de Máquinas Virtuais que aloja as máquinas virtuais do datacenter do cassandra. | bool |
| backupStorageCustomerKeyUri | Indica o Uri de Chave da chave do cliente a utilizar para encriptação da conta de armazenamento de cópias de segurança. | string |
| base64EncodedCassandraYamlFragment | Um fragmento de um ficheiro de configuração cassandra.yaml a ser incluído no cassandra.yaml para todos os nós neste datacenter. O fragmento deve ser codificado em Base64 e só é permitido um subconjunto de chaves. | string |
| dataCenterLocation | A região em que este datacenter deve ser criado. | string |
| desalocado | Se o datacenter foi desalocado. | bool |
| delegatedSubnetId | ID de recurso de uma sub-rede a que os nós neste datacenter devem ter as respetivas interfaces de rede ligadas. A sub-rede tem de estar na mesma região especificada em "dataCenterLocation" e tem de ser capaz de encaminhar para a sub-rede especificada na propriedade "delegatedManagementSubnetId" do cluster. Este ID de recurso será do formulário "/subscriptions/{subscription id}/resourceGroups/{resource group}/providers/Microsoft.Network/virtualNetworks/{virtual network}/subnets/{subnet}". | string |
| diskCapacity | Número de discos anexados a cada nó. A predefinição é 4. | int |
| diskSku | SKU de disco utilizado para datacenters. O valor predefinido é P30. | string |
| managedDiskCustomerKeyUri | URI de chave a utilizar para encriptação de discos geridos. Certifique-se de que a identidade atribuída pelo sistema do cluster foi atribuída às permissões adequadas (permissões de obtenção/moldagem/anulação de moldagem da chave) na chave. | string |
| nodeCount | O número de nós que o datacenter deve ter. Este é o número pretendido. Depois de definido, pode demorar algum tempo até que o datacenter seja dimensionado para corresponder. Para monitorizar o número de nós e o respetivo estado, utilize o método fetchNodeStatus no cluster. | int |
| provisionError | Erro relacionado com o aprovisionamento de recursos. | CassandraError |
| provisioningState | O estado do recurso no momento em que a operação foi chamada. | "Cancelado" "A criar" "A eliminar" "Falhou" "Com êxito" "A atualizar" |
| sku | SKU de Máquina Virtual utilizado para datacenters. O valor predefinido é Standard_DS14_v2 | string |
AuthenticationMethodLdapProperties
| Nome | Descrição | Valor |
|---|---|---|
| connectionTimeoutInMs | Tempo limite para ligar ao servidor LDAP em milissegundos. A predefinição é 5000 ms. | int |
| searchBaseDistinguishedName | Nome único do objeto a partir do qual iniciar a pesquisa recursiva de utilizadores. | string |
| searchFilterTemplate | Modelo a utilizar para procurar. A predefinição é (cn=%s) em que %s será substituído pelo nome de utilizador utilizado para iniciar sessão. | string |
| serverCertificates | Certificado[] | |
| serverHostname | Nome do anfitrião do servidor LDAP. | string |
| serverPort | Porta do servidor LDAP. | int |
| serviceUserDistinguishedName | Nome único da conta de utilizador de pesquisa, que pode procurar detalhes do utilizador sobre a autenticação. | string |
| serviceUserPassword | Palavra-passe do utilizador de pesquisa. | string |
Certificado
| Nome | Descrição | Valor |
|---|---|---|
| pem | Chave pública formatada PEM. | string |
CassandraError
| Nome | Descrição | Valor |
|---|---|---|
| additionalErrorInfo | Informações adicionais sobre o erro. | string |
| code | O código de erro que ocorreu. | string |
| message | A mensagem do erro. | string |
| destino | O recurso de destino do erro. | string |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários