1개의 클러스터에 대해 고급 구성 옵션 업데이트
더 이상 사용되지 않습니다.
지정된 프로젝트 의 한 클러스터 에 대한 고급 구성 세부 정보를 업데이트합니다. 클러스터에는 동일한 데이터 세트 유지하는 호스트 그룹 포함되어 있습니다. 고급 구성 세부 정보에는 읽기/ 쓰기 고려 (write concern), 인덱스 및 oplog 제한, 기타 데이터베이스 설정이 포함됩니다. 이 리소스 사용하려면 요청하는 서비스 계정 또는 API 키에 프로젝트 클러스터 관리자 역할 있어야 합니다. 이 기능 M0 무료 클러스터, M2 및 M5 공유 계층 클러스터, flex 클러스터 또는 서버리스 클러스터에서는 사용할 수 없습니다.
경로 매개변수
-
프로젝트 식별하는 고유한 24-16진수 문자열입니다. 인증된 사용자가 액세스 할 수 있는 모든 프로젝트를 조회 하려면 /groups 엔드포인트를 사용합니다.
참고: 그룹과 프로젝트는 동의어입니다. 그룹 ID는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 리소스 및 해당 엔드포인트는 그룹이라는 용어를 사용합니다.
형식은
^([a-f0-9]{24})$패턴 과 일치해야 합니다. -
클러스터를 식별하는 사람이 읽을 수 있는 라벨입니다.
형식은
^[a-zA-Z0-9][a-zA-Z0-9-]*$패턴 과 일치해야 합니다.
쿼리 매개변수
-
애플리케이션이 응답을
envelopeJSON 객체로 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 결과 목록을 반환하는 엔드포인트는 결과 객체를 엔벨로프로 사용합니다. 애플리케이션은 응답 본문에 상태 매개변수를 추가합니다.기본값은
false입니다. -
응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다.
기본값은
false입니다.Prettyprint
body
필수 사항
지정된 프로젝트의 클러스터 하나에 추가할 고급 구성 세부정보.
-
최소 이미지 사전 및 사후 보존 시간(초)입니다.
기본값은
-1입니다.이 옵션은 ``changeStreamOptionspreAndPostImagesexpireAfterSeconds`` 클러스터 매개변수에 해당합니다. 이 설정은 변경 스트림 사전 및 사후 이미지의 보존 정책을 제어합니다. 사전 및 사후 이미지는 각각 문서 수정 ``expireAfterSeconds` 전후의 문서 버전입니다. ` MongoDB 사전 및 사후 이미지를 보존하는 기간을 제어합니다. -1 (해제)로 설정하다 MongoDB 기본값 보존 정책을 사용합니다. 사전 및 사후 이미지는 해당 변경 스트림 이벤트가 oplog 에서 제거될 때까지 보존됩니다. 이미지 전후의 최소 보존 시간을 설정하다 0보다 큰 정수 값을 지정합니다. 이 값을 너무 낮게 설정하면 Realm 동기화 중단되거나 처리 가 트리거될 위험이 커질 수 있습니다. 기본값 은 -1 (해제) -
청크 마이그레이션을 위한 소스 샤드 및 수신 샤드의 스레드 수. 스레드 수는 샤딩된 클러스터에 있는 총 CPU 코어 수의 절반을 초과할 수 없습니다.
이 옵션은 구성 파일 옵션 `chunkMigrationConcurrency` ` mongod `에 해당합니다. -
TLS 1.2에 대한 사용자 지정 OpenSSL 암호 제품군 목록입니다. 이 필드
tlsCipherConfigMode가CUSTOM로 설정하다 경우에만 유효합니다.값은
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384또는TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256입니다. -
개별 읽기 작업을 완료하는 데 걸리는 기본 시간 제한 (밀리초).
이 옵션은 defaultMaxTimeMS 클러스터 매개변수에 해당합니다. -
이 클러스터에 대해 설정된 읽기 작업에 대해 MongoDB에서 요청하는 기본값 승인 수준입니다.
MongoDB 4.4 클러스터의 기본값은
available입니다. MongoDB 5.0 이상 클러스터의 기본값은local입니다.값은
local또는available입니다. 기본값은available입니다.이 옵션은 전역 기본값 읽기 고려 (read concern) 에 해당합니다. -
드라이버에서 아무것도 지정하지 않은 경우 쓰기 작업을 위해 MongoDB에 요청하는 기본 승인 수준입니다.
이 옵션은 암시적 기본값 쓰기 고려 (write concern) 에 해당합니다. -
인덱싱된 모든 항목이 1024 바이트를 초과하지 않는 문서를 삽입하거나 업데이트 할 수 있는지 여부를 나타내는 플래그입니다. 이 값을 false로 설정하다 하면 mongod 이 제한을 초과하는 문서를 작성하지만 인덱스 하지는 않습니다. 이 매개 변수는 MongoDB 4.4부터 제거되었습니다.
기본값은
true입니다.이 옵션은 구성 파일 옵션 `failIndexKeyTooLong` ` mongod `에 해당합니다. -
클러스터가 서버 측 JavaScript 실행을 수행하는 작업의 실행을 허용하는지 여부를 나타내는 플래그입니다. 8.0+를 사용하는 경우 서버 측 JavaScript를 비활성화하고 집계 파이프라인의 연산자를 사용하는 것이 더 나은 대안입니다.
이 옵션은 클러스터 의 각 ` mongod` 및 `mongos `에 대한 `securityjavascriptEnabled` 구성 파일 옵션을 수정하는 것에 해당합니다. -
클러스터가 수신 연결 시 허용하는 최소 TLS(전송 계층 보안) 버전. TLS 1.0 또는 1.1을 사용하는 클러스터에서는 TLS 1.2를 최소 TLS 프로토콜 버전으로 설정하는 것이 좋습니다.
값은
TLS1_0,TLS1_1또는TLS1_2입니다.이 옵션은 `netssldisabledProtocols` `mongod` 구성 파일 옵션에 해당합니다. -
클러스터가 결과 반환 시 컬렉션 스캔을 요하는 쿼리의 실행을 비활성화할지 여부를 나타내는 플래그입니다.
이 옵션은 구성 파일 옵션 `notablescan` ` mongod `에 해당합니다. -
시간 단위로 표현된 클러스터 oplog의 최소 보존 기간. null 값은 클러스터가 MongoDB Cloud가 계산하는 기본 최소 oplog window를 사용함을 나타냅니다.
이 옵션은 구성 파일 옵션 `storageoplogMinRetentionHours` ` mongod `에 해당합니다. -
메가바이트 단위로 표시한 클러스터의 Oplog 저장 용량 한도. null 값은 클러스터가 MongoDB Cloud가 계산하는 기본 Oplog 크기를 사용함을 나타냅니다.
이 옵션은 구성 파일 옵션 `replicationoplogSizeMB` ` mongod `에 해당합니다. -
1(비활성화) 또는 3(활성화)으로 설정할 수 있습니다. 3으로 설정하면 Atlas는 편집되고 익명화된 $queryStats 출력을 MongoDB 로그에 포함합니다. $queryStats 출력에 리터럴 또는 필드 값이 포함되어 있지 않습니다. 이 설정을 활성화하면 클러스터 성능에 영향을 미칠 수 있습니다.
이 옵션은 logComponentVerbosity 서버 매개변수의 queryStats 구성 요소에 해당합니다. -
mongosqld 프로세스가 데이터를 다시 샘플링하여 관계형 스키마를 생성하는 간격(초).
최소값은
0입니다. 기본값은0입니다.이 옵션은 `sampleRefreshIntervalSecs` `mongosqld` 옵션에 해당합니다. -
스키마 정보를 수집할 때 샘플링할 데이터베이스당 문서 수.
최소값은
0입니다.이 옵션은 `sampleSize` `mongosqld` 옵션에 해당합니다. -
TLS 암호 제품군 구성 모드. 기본값 모드 기본값 암호 제품군을 사용합니다. 사용자 지정 모드 사용하면 TLS 1.2 및 TLS 1.3 모두에 대한 사용자 지정 암호 제품군을 지정할 수 있습니다.
값은
CUSTOM또는DEFAULT입니다. -
다중 문서 트랜잭션의 수명, 초 단위. Atlas는 이 한도를 초과하는 트랜잭션을 만료된 것으로 간주하여 주기적인 정리 프로세스를 통해 트랜잭션을 중단합니다.
최소값은
1입니다.이 옵션은 구성 파일 옵션 `transactionLifetimeLimitSeconds` ` mongod `에 해당합니다.
atlas api clusters updateGroupClusterProcessArgs --helpimport (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20240530001/admin"
)
func main() {
ctx := context.Background()
clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")
// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))
if err != nil {
log.Fatalf("Error: %v", err)
}
params = &sdk.UpdateGroupClusterProcessArgsApiParams{}
sdkResp, httpResp, err := client.ClustersApi.
UpdateGroupClusterProcessArgsWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2024-05-30+json" \
--header "Content-Type: application/json" \
-X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs" \
-d '{ <Payload> }'curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2024-05-30+json" \
--header "Content-Type: application/json" \
-X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs" \
-d '{ <Payload> }'{
"changeStreamOptionsPreAndPostImagesExpireAfterSeconds": -1,
"chunkMigrationConcurrency": 42,
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"defaultMaxTimeMS": 42,
"defaultReadConcern": "available",
"defaultWriteConcern": "string",
"failIndexKeyTooLong": true,
"javascriptEnabled": true,
"minimumEnabledTlsProtocol": "TLS1_0",
"noTableScan": true,
"oplogMinRetentionHours": 42.0,
"oplogSizeMB": 42,
"queryStatsLogVerbosity": 42,
"sampleRefreshIntervalBIConnector": 0,
"sampleSizeBIConnector": 42,
"tlsCipherConfigMode": "CUSTOM",
"transactionLifetimeLimitSeconds": 42
}{
"changeStreamOptionsPreAndPostImagesExpireAfterSeconds": -1,
"chunkMigrationConcurrency": 42,
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"defaultMaxTimeMS": 42,
"defaultReadConcern": "available",
"defaultWriteConcern": "string",
"failIndexKeyTooLong": true,
"javascriptEnabled": true,
"minimumEnabledTlsProtocol": "TLS1_0",
"noTableScan": true,
"oplogMinRetentionHours": 42.0,
"oplogSizeMB": 42,
"queryStatsLogVerbosity": 42,
"sampleRefreshIntervalBIConnector": 0,
"sampleSizeBIConnector": 42,
"tlsCipherConfigMode": "CUSTOM",
"transactionLifetimeLimitSeconds": 42
}{
"error": 400,
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"reason": "Bad Request",
"errorCode": "VALIDATION_ERROR"
}{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}