Microsoft.DocumentDB cassandraClusters 2023-03-15
- 최신
- 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-03-15' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
identity: {
type: 'string'
}
properties: {
authenticationMethod: 'string'
cassandraAuditLoggingEnabled: bool
cassandraVersion: 'string'
clientCertificates: [
{
pem: 'string'
}
]
clusterNameOverride: 'string'
deallocated: bool
delegatedManagementSubnetId: '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'
}
}
속성 값
cassandraClusters
| Name | Description | 값 |
|---|---|---|
| name | 리소스 이름 | string(필수) |
| 위치 | 리소스가 속한 리소스 그룹의 위치입니다. | string |
| tags | 태그는 리소스를 설명하는 키-값 쌍의 목록입니다. 여러 리소스 그룹에서 이 리소스를 보고 그룹화할 때 이러한 태그를 사용할 수 있습니다. 리소스에 대해 최대 15개의 태그를 제공할 수 있습니다. 각 태그에는 128자 이하의 키와 256자 이하의 값이 포함되어야 합니다. 예를 들어 템플릿 형식의 기본 환경은 "defaultExperience": "Cassandra"로 설정됩니다. 현재 "defaultExperience" 값에는 "Table", "Graph", "DocumentDB" 및 "MongoDB"도 포함됩니다. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| identity | 리소스의 ID입니다. | ManagedCassandraManagedServiceIdentity |
| properties | 관리되는 Cassandra 클러스터의 속성입니다. | ClusterResourceProperties |
ManagedCassandraManagedServiceIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 형식입니다. | 'None' 'SystemAssigned' |
ClusterResourceProperties
| Name | Description | 값 |
|---|---|---|
| authenticationMethod | Cassandra가 클라이언트를 인증하는 데 사용해야 하는 인증 방법입니다. 'None'은 인증을 해제하므로 비상 시를 제외하고는 사용하지 않아야 합니다. 'Cassandra'는 기본 암호 기반 인증입니다. 기본값은 'Cassandra'입니다. | 'Cassandra' 'Ldap' 'None' |
| cassandraAuditLoggingEnabled | Cassandra 감사 로깅을 사용할 수 있는지 여부 | bool |
| cassandraVersion | 이 클러스터가 실행 중으로 수렴되어야 하는 Cassandra 버전(예: 3.11). 업데이트되면 클러스터가 새 버전으로 마이그레이션하는 데 다소 시간이 걸릴 수 있습니다. | string |
| clientCertificates | 클러스터에 연결하는 클라이언트에 권한을 부여하는 데 사용되는 TLS 인증서 목록입니다. 모든 연결은 clientCertificates가 설정되었는지 여부에 관계없이 TLS 암호화되지만 clientCertificates가 설정된 경우 관리되는 Cassandra 클러스터는 이 속성의 하나 이상의 공용 인증서에서 유효성을 검사할 수 있는 TLS 클라이언트 인증서를 포함하지 않는 모든 연결을 거부합니다. | Certificate[] |
| clusterNameOverride | cassandra.yaml의 clusterName 속성을 클러스터의 리소스 이름 외에 다른 항목으로 설정해야 하는 경우 이 속성에 사용할 값을 설정합니다. | string |
| 할당 | 클러스터 및 관련 데이터 센터의 할당이 취소되었는지 여부입니다. | bool |
| delegatedManagementSubnetId | 이 클러스터의 관리 서비스에 네트워크 인터페이스가 연결되어 있어야 하는 서브넷의 리소스 ID입니다. 서브넷은 데이터 센터에 위임될 모든 서브넷으로 라우팅할 수 있어야 합니다. 리소스 ID는 '/subscriptions/{subscription id}/resourceGroups/{resource group}/providers/Microsoft.Network/virtualNetworks/{virtual network}/subnets/{subnet}' 형식이어야 합니다. | 문자열 |
| externalGossipCertificates | 관리되지 않는 데이터 센터에서 가십을 승인하는 데 사용되는 TLS 인증서 목록입니다. 관리되지 않는 데이터 센터에 있는 모든 노드의 TLS 인증서는 이 속성에 제공된 인증서 중 하나를 사용하여 확인할 수 있어야 합니다. | Certificate[] |
| externalSeedNodes | 관리되지 않는 데이터 센터에 있는 시드 노드의 IP 주소 목록입니다. 이러한 노드는 모든 관리되는 노드의 시드 노드 목록에 추가됩니다. | SeedNode[] |
| hoursBetweenBackups | (사용되지 않음) 클러스터의 백업을 수행하는 동안 대기하는 시간 수입니다. | int |
| initialCassandraAdminPassword | 클러스터에 관리자로 연결하는 클라이언트의 초기 암호입니다. 클러스터를 만든 후에 변경해야 합니다. GET에서 null을 반환합니다. 이 필드는 authenticationMethod 필드가 'Cassandra'인 경우에만 적용됩니다. | string 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다. |
| prometheusEndpoint | 관리되는 Cassandra 노드에 대한 데이터를 포함하는 Prometheus 엔드포인트에 연결할 수 있는 호스트 이름 또는 IP 주소입니다. | SeedNode |
| provisionError | 리소스 프로비저닝과 관련된 오류입니다. | CassandraError |
| provisioningState | 작업이 호출되었을 때 리소스의 상태. | 'Canceled' '만들기' '삭제 중' '실패' '성공' '업데이트 중' |
| repairEnabled | 이 클러스터에서 자동 복구를 실행해야 하나요? 생략하면 true이며, 이미 자체 복구를 수행하고 있는 하이브리드 클러스터를 실행하지 않는 한 true로 유지되어야 합니다. | bool |
| restoreFromBackupId | 빈 클러스터를 만들려면 이 필드를 생략하거나 null로 설정합니다. 백업을 새 클러스터로 복원하려면 이 필드를 백업의 리소스 ID로 설정합니다. | 문자열 |
인증서
| Name | Description | 값 |
|---|---|---|
| Pem | PEM 형식 공개 키입니다. | 문자열 |
SeedNode
| Name | Description | 값 |
|---|---|---|
| ipAddress | 이 시드 노드의 IP 주소입니다. | 문자열 |
CassandraError
| Name | Description | 값 |
|---|---|---|
| additionalErrorInfo | 오류에 대한 추가 정보입니다. | string |
| 코드 | 발생한 오류 코드입니다. | 문자열 |
| message | 오류의 메시지입니다. | 문자열 |
| 대상 | 오류의 대상 리소스입니다. | string |
ARM 템플릿 리소스 정의
cassandraClusters 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.DocumentDB/cassandraClusters 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.DocumentDB/cassandraClusters",
"apiVersion": "2023-03-15",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string"
},
"properties": {
"authenticationMethod": "string",
"cassandraAuditLoggingEnabled": "bool",
"cassandraVersion": "string",
"clientCertificates": [
{
"pem": "string"
}
],
"clusterNameOverride": "string",
"deallocated": "bool",
"delegatedManagementSubnetId": "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"
}
}
속성 값
cassandraClusters
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | 'Microsoft.DocumentDB/cassandraClusters' |
| apiVersion | 리소스 api 버전 | '2023-03-15' |
| name | 리소스 이름 | string(필수) |
| 위치 | 리소스가 속한 리소스 그룹의 위치입니다. | string |
| tags | 태그는 리소스를 설명하는 키-값 쌍의 목록입니다. 여러 리소스 그룹에서 이 리소스를 보고 그룹화할 때 이러한 태그를 사용할 수 있습니다. 리소스에 대해 최대 15개의 태그를 제공할 수 있습니다. 각 태그에는 128자 이하의 키와 256자 이하의 값이 포함되어야 합니다. 예를 들어 템플릿 형식의 기본 환경은 "defaultExperience": "Cassandra"로 설정됩니다. 현재 "defaultExperience" 값에는 "Table", "Graph", "DocumentDB" 및 "MongoDB"도 포함됩니다. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| identity | 리소스의 ID입니다. | ManagedCassandraManagedServiceIdentity |
| properties | 관리되는 Cassandra 클러스터의 속성입니다. | ClusterResourceProperties |
ManagedCassandraManagedServiceIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 형식입니다. | 'None' 'SystemAssigned' |
ClusterResourceProperties
| Name | Description | 값 |
|---|---|---|
| authenticationMethod | Cassandra가 클라이언트를 인증하는 데 사용해야 하는 인증 방법입니다. 'None'은 인증을 해제하므로 비상 시를 제외하고는 사용하지 않아야 합니다. 'Cassandra'는 기본 암호 기반 인증입니다. 기본값은 'Cassandra'입니다. | 'Cassandra' 'Ldap' 'None' |
| cassandraAuditLoggingEnabled | Cassandra 감사 로깅을 사용할 수 있는지 여부 | bool |
| cassandraVersion | 이 클러스터가 실행 중으로 수렴되어야 하는 Cassandra 버전(예: 3.11). 업데이트되면 클러스터가 새 버전으로 마이그레이션하는 데 다소 시간이 걸릴 수 있습니다. | string |
| clientCertificates | 클러스터에 연결하는 클라이언트에 권한을 부여하는 데 사용되는 TLS 인증서 목록입니다. 모든 연결은 clientCertificates가 설정되었는지 여부에 관계없이 TLS 암호화되지만 clientCertificates가 설정된 경우 관리되는 Cassandra 클러스터는 이 속성의 하나 이상의 공용 인증서에서 유효성을 검사할 수 있는 TLS 클라이언트 인증서를 포함하지 않는 모든 연결을 거부합니다. | Certificate[] |
| clusterNameOverride | cassandra.yaml의 clusterName 속성을 클러스터의 리소스 이름 외에 다른 항목으로 설정해야 하는 경우 이 속성에 사용할 값을 설정합니다. | string |
| 할당 | 클러스터 및 관련 데이터 센터의 할당이 취소되었는지 여부입니다. | bool |
| delegatedManagementSubnetId | 이 클러스터의 관리 서비스에 네트워크 인터페이스가 연결되어 있어야 하는 서브넷의 리소스 ID입니다. 서브넷은 데이터 센터에 위임될 모든 서브넷으로 라우팅할 수 있어야 합니다. 리소스 ID는 '/subscriptions/{subscription id}/resourceGroups/{resource group}/providers/Microsoft.Network/virtualNetworks/{virtual network}/subnets/{subnet}' 형식이어야 합니다. | string |
| externalGossipCertificates | 관리되지 않는 데이터 센터에서 가십을 승인하는 데 사용되는 TLS 인증서 목록입니다. 관리되지 않는 데이터 센터에 있는 모든 노드의 TLS 인증서는 이 속성에 제공된 인증서 중 하나를 사용하여 확인할 수 있어야 합니다. | Certificate[] |
| externalSeedNodes | 관리되지 않는 데이터 센터에 있는 시드 노드의 IP 주소 목록입니다. 이러한 노드는 모든 관리되는 노드의 시드 노드 목록에 추가됩니다. | SeedNode[] |
| hoursBetweenBackups | (사용되지 않음) 클러스터의 백업을 수행하는 동안 대기하는 시간 수입니다. | int |
| initialCassandraAdminPassword | 클러스터에 관리자로 연결하는 클라이언트의 초기 암호입니다. 클러스터를 만든 후에 변경해야 합니다. GET에서 null을 반환합니다. 이 필드는 authenticationMethod 필드가 'Cassandra'인 경우에만 적용됩니다. | string 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다. |
| prometheusEndpoint | 관리되는 Cassandra 노드에 대한 데이터를 포함하는 Prometheus 엔드포인트에 연결할 수 있는 호스트 이름 또는 IP 주소입니다. | SeedNode |
| provisionError | 리소스 프로비저닝과 관련된 오류입니다. | CassandraError |
| provisioningState | 작업이 호출되었을 때 리소스의 상태. | 'Canceled' '만들기' '삭제 중' '실패' '성공' '업데이트 중' |
| repairEnabled | 이 클러스터에서 자동 복구를 실행해야 하나요? 생략하면 true이며, 이미 자체 복구를 수행하고 있는 하이브리드 클러스터를 실행하지 않는 한 true로 유지되어야 합니다. | bool |
| restoreFromBackupId | 빈 클러스터를 만들려면 이 필드를 생략하거나 null로 설정합니다. 백업을 새 클러스터로 복원하려면 이 필드를 백업의 리소스 ID로 설정합니다. | string |
인증서
| Name | Description | 값 |
|---|---|---|
| Pem | PEM 형식의 공개 키입니다. | 문자열 |
SeedNode
| Name | Description | 값 |
|---|---|---|
| ipAddress | 이 시드 노드의 IP 주소입니다. | 문자열 |
CassandraError
| Name | Description | 값 |
|---|---|---|
| additionalErrorInfo | 오류에 대한 추가 정보입니다. | 문자열 |
| 코드 | 발생한 오류 코드입니다. | 문자열 |
| message | 오류의 메시지입니다. | 문자열 |
| 대상 | 오류의 대상 리소스입니다. | 문자열 |
Terraform(AzAPI 공급자) 리소스 정의
cassandraClusters 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.DocumentDB/cassandraClusters 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/cassandraClusters@2023-03-15"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "SystemAssigned"
}
body = jsonencode({
properties = {
authenticationMethod = "string"
cassandraAuditLoggingEnabled = bool
cassandraVersion = "string"
clientCertificates = [
{
pem = "string"
}
]
clusterNameOverride = "string"
deallocated = bool
delegatedManagementSubnetId = "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"
}
})
}
속성 값
cassandraClusters
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | "Microsoft.DocumentDB/cassandraClusters@2023-03-15" |
| name | 리소스 이름 | string(필수) |
| 위치 | 리소스가 속한 리소스 그룹의 위치입니다. | string |
| parent_id | 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. | string(필수) |
| tags | 태그는 리소스를 설명하는 키-값 쌍의 목록입니다. 여러 리소스 그룹에서 이 리소스를 보고 그룹화할 때 이러한 태그를 사용할 수 있습니다. 리소스에 대해 최대 15개의 태그를 제공할 수 있습니다. 각 태그에는 128자 이하의 키와 256자 이하의 값이 포함되어야 합니다. 예를 들어 템플릿 형식의 기본 환경은 "defaultExperience": "Cassandra"로 설정됩니다. 현재 "defaultExperience" 값에는 "Table", "Graph", "DocumentDB" 및 "MongoDB"도 포함됩니다. | 태그 이름 및 값의 사전입니다. |
| identity | 리소스의 ID입니다. | ManagedCassandraManagedServiceIdentity |
| properties | 관리되는 Cassandra 클러스터의 속성입니다. | ClusterResourceProperties |
ManagedCassandraManagedServiceIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 형식입니다. | "SystemAssigned" |
ClusterResourceProperties
| Name | Description | 값 |
|---|---|---|
| authenticationMethod | Cassandra가 클라이언트를 인증하는 데 사용해야 하는 인증 방법입니다. 'None'은 인증을 해제하므로 비상 시를 제외하고는 사용하지 않아야 합니다. 'Cassandra'는 기본 암호 기반 인증입니다. 기본값은 'Cassandra'입니다. | "Cassandra" "Ldap" “None” |
| cassandraAuditLoggingEnabled | Cassandra 감사 로깅을 사용할 수 있는지 여부 | bool |
| cassandraVersion | 이 클러스터가 실행에 수렴해야 하는 Cassandra 버전(예: 3.11)입니다. 업데이트되면 클러스터가 새 버전으로 마이그레이션하는 데 다소 시간이 걸릴 수 있습니다. | 문자열 |
| clientCertificates | 클러스터에 연결하는 클라이언트에 권한을 부여하는 데 사용되는 TLS 인증서 목록입니다. 모든 연결은 clientCertificates가 설정되었는지 여부에 관계없이 TLS 암호화되지만 clientCertificates가 설정된 경우 관리되는 Cassandra 클러스터는 이 속성의 하나 이상의 공용 인증서에서 유효성을 검사할 수 있는 TLS 클라이언트 인증서를 포함하지 않는 모든 연결을 거부합니다. | Certificate[] |
| clusterNameOverride | cassandra.yaml의 clusterName 속성을 클러스터의 리소스 이름 외에 다른 항목으로 설정해야 하는 경우 이 속성에 사용할 값을 설정합니다. | string |
| 할당 | 클러스터 및 관련 데이터 센터의 할당이 취소되었는지 여부입니다. | bool |
| delegatedManagementSubnetId | 이 클러스터의 관리 서비스에 연결된 네트워크 인터페이스가 있어야 하는 서브넷의 리소스 ID입니다. 서브넷은 데이터 센터에 위임될 모든 서브넷으로 라우팅할 수 있어야 합니다. 리소스 ID는 '/subscriptions/{subscription id}/resourceGroups/{resource group}/providers/Microsoft.Network/virtualNetworks/{virtual network}/subnets/{subnet}' 형식이어야 합니다. | 문자열 |
| externalGossipCertificates | 관리되지 않는 데이터 센터에서 가십을 승인하는 데 사용되는 TLS 인증서 목록입니다. 관리되지 않는 데이터 센터에 있는 모든 노드의 TLS 인증서는 이 속성에 제공된 인증서 중 하나를 사용하여 확인할 수 있어야 합니다. | Certificate[] |
| externalSeedNodes | 관리되지 않는 데이터 센터에 있는 시드 노드의 IP 주소 목록입니다. 이러한 노드는 모든 관리되는 노드의 시드 노드 목록에 추가됩니다. | SeedNode[] |
| hoursBetweenBackups | (사용되지 않음) 클러스터의 백업을 수행하는 동안 대기하는 시간 수입니다. | int |
| initialCassandraAdminPassword | 클러스터에 관리자로 연결하는 클라이언트의 초기 암호입니다. 클러스터를 만든 후에 변경해야 합니다. GET에서 null을 반환합니다. 이 필드는 authenticationMethod 필드가 'Cassandra'인 경우에만 적용됩니다. | string 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다. |
| prometheusEndpoint | 관리되는 Cassandra 노드에 대한 데이터를 포함하는 Prometheus 엔드포인트에 연결할 수 있는 호스트 이름 또는 IP 주소입니다. | SeedNode |
| provisionError | 리소스 프로비저닝과 관련된 오류입니다. | CassandraError |
| provisioningState | 작업이 호출되었을 때 리소스의 상태. | "취소됨" "만들기" "삭제 중" "실패" "성공" "업데이트 중" |
| repairEnabled | 이 클러스터에서 자동 복구를 실행해야 하나요? 생략하면 true이며, 이미 자체 복구를 수행하고 있는 하이브리드 클러스터를 실행하지 않는 한 true로 유지되어야 합니다. | bool |
| restoreFromBackupId | 빈 클러스터를 만들려면 이 필드를 생략하거나 null로 설정합니다. 백업을 새 클러스터로 복원하려면 이 필드를 백업의 리소스 ID로 설정합니다. | 문자열 |
인증서
| Name | Description | 값 |
|---|---|---|
| Pem | PEM 형식 공개 키입니다. | 문자열 |
SeedNode
| Name | Description | 값 |
|---|---|---|
| ipAddress | 이 시드 노드의 IP 주소입니다. | 문자열 |
CassandraError
| Name | Description | 값 |
|---|---|---|
| additionalErrorInfo | 오류에 대한 추가 정보입니다. | 문자열 |
| 코드 | 발생한 오류 코드입니다. | 문자열 |
| message | 오류의 메시지입니다. | 문자열 |
| 대상 | 오류의 대상 리소스입니다. | string |
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기