3 oplog 저장소의 구성을 업데이트합니다.
기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup
Resource
PUT /oplog/s3Configs/{S3-OPLOG-CONFIG-ID}
요청 경로 매개변수
이름 | 유형 | 설명 |
|---|---|---|
S3-OPLOG-CONFIG-ID | 문자열 | 이 S3 oplog 구성을 나타내는 고유 식별자입니다. |
요청 쿼리 매개변수
다음 쿼리 매개변수는 선택 사항입니다.
이름 | 유형 | 필요성 | 설명 | 기본값 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | 부울 | 옵션 | 응답 본문이 pretty-print 형식이어야 하는지 여부를 나타내는 플래그입니다. |
| ||||||
envelope | 부울 | 옵션 | 응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.
|
|
요청 본문 매개변수
이름 | 유형 | 필요성 | 설명 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
acceptTos | 부울 | 필수 사항 | Ops Manager에서 S3 호환 스토리지 스토어를 사용하기 위한 서비스 약관에 동의했는지 여부를 나타내는 플래그입니다. S3 호환 스토리지 저장소를 생성하려면 이 값을 이 값을 | |||||||||
AssignmentEnabled | 부울 | 옵션 | 이 데이터 저장소에 백업 작업을 할당할 수 있는지 여부를 나타내는 플래그. | |||||||||
AWS 액세스 키 | 문자열 | 조건부 | s3BucketName 에 지정된 S3 호환 스토리지 버킷에 액세스할 수 있는 Amazon Web Services 액세스 키 ID입니다.
| |||||||||
AWS 비밀 키 | 문자열 | 조건부 |
| |||||||||
customCertificates | 배열 | 옵션 | 연결된 S3 호환 저장소 버킷에 적용되는 유효한 인증 기관 인증서 목록입니다. | |||||||||
customCertificates[n].filename | 문자열 | 옵션 | 인증 기관 PEM 파일을 식별하는 이름입니다. | |||||||||
customCertificates[n].certString | 문자열 | 옵션 | 인증 기관 체인을 구성하는 인증 기관 PEM 파일의 콘텐츠입니다. | |||||||||
disableProxyS3 | 부울 | 옵션 | S3호환 저장 에 연결할 때 HTTP proxy 를 사용해야 하는지 여부를 나타내는 플래그입니다. 를 사용하도록 를 구성한 경우가 아니라면 이 값을 설정하다 MongoDB Ops Manager 필요가 HTTP proxy 없습니다. | |||||||||
암호화된 자격증명 | 부울 | 옵션 | 이 S3호환 저장 oplog 저장 의 사용자 이름 과 비밀번호가 credentialstool을 사용하여 암호화됨 되었는지 여부를 나타내는 플래그입니다 . | |||||||||
labels | 문자열 배열 | 옵션 | ||||||||||
경로 스타일 액세스 활성화 | 부울 | 필수 사항 | 이 엔드포인트의 스타일을 나타내는 플래그입니다.
S3호환 저장 버킷 URL 규칙을 검토 하려면 Amazon Web Services S3 설명서를참조하세요. | |||||||||
s3AuthMethod | 문자열 | 옵션 | s3BucketName 에 지정된 S3 호환 스토리지 버킷에 대한 액세스 권한을 부여하는 데 사용되는 메서드입니다. Ops Manager는 다음 값을 허용합니다.
| |||||||||
s3BucketEndpoint | 문자열 | 필수 사항 | 이 S3 호환 스토리지 버킷에 액세스하는 데 사용되는 URL 입니다. | |||||||||
S3 버킷 이름 | 문자열 | 필수 사항 | S3호환 스토리지 oplog 저장소를 호스팅하는 S3호환 스토리지 버킷의 이름입니다. | |||||||||
S3 최대 연결 | 숫자 | 필수 사항 | 이 S3호환 스토리지 oplog 저장소에 대한 최대 연결 수를 나타내는 양의 정수입니다. | |||||||||
s3RegionOverride | 문자열 | 조건부 | S3 호환 스토리지 버킷이 있는 리전입니다. 이 필드는 S3 호환 스토리지 저장소의 s3BucketEndpoint 가 리전 범위를 지원하지 않는 경우에만 사용하세요. 이 필드를 Amazon Web Services S3 버킷과 함께 사용하지 마세요. | |||||||||
sseEnabled | 부울 | 필수 사항 | 이 S3호환 저장 oplog 저장 서버 측 암호화 활성화하는지 여부를 나타내는 플래그입니다. | |||||||||
uri | 문자열 | 필수 사항 | 이 S3호환 스토리지 oplog 저장소에 액세스할 수 있는 | |||||||||
ssl | 부울 | 옵션 | 이 S3호환 스토리지 oplog 저장소가 TLS 를 사용하여 암호화된 연결만 허용하는지 여부를 나타내는 플래그입니다. | |||||||||
쓰기 고려 | 문자열 | 옵션 | 이 oplog 스토어에 사용되는 쓰기 고려입니다. Ops Manager는 다음 값을 허용합니다.
MongoDB 의 쓰기 (write) 승인 수준에 학습 보려면 쓰기 고려를 참조하세요 . |
응답
이름 | 유형 | 설명 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
acceptTos | 부울 | Ops Manager에서 S3 호환 스토리지 스토어를 사용하기 위한 서비스 약관에 동의했는지 여부를 나타내는 플래그입니다. S3 호환 스토리지 저장소를 생성하려면 이 값을 | |||||||||
AssignmentEnabled | 부울 | 이 데이터 저장소에 백업 작업을 할당할 수 있는지 여부를 나타내는 플래그. | |||||||||
AWS 액세스 키 | 문자열 | s3BucketName 에 지정된 S3 호환 스토리지 버킷에 액세스할 수 있는 Amazon Web Services 액세스 키 ID입니다. | |||||||||
AWS 비밀 키 | 문자열 | s3BucketName 에 지정된 S3 호환 스토리지 버킷에 액세스할 수 있는 Amazon Web Services 비밀 액세스 키입니다. | |||||||||
customCertificates | 배열 | 연결된 S3 호환 저장소 버킷에 적용되는 유효한 인증 기관 인증서 목록입니다. | |||||||||
customCertificates[n].filename | 문자열 | 인증 기관 PEM 파일을 식별하는 이름입니다. | |||||||||
customCertificates[n].certString | 문자열 | 인증 기관 체인을 구성하는 인증 기관 PEM 파일의 콘텐츠입니다. | |||||||||
disableProxyS3 | 부울 | S3 호환 스토리지에 연결할 때 HTTP 프록시 를 사용해야 하는지 여부를 나타내는 플래그입니다. | |||||||||
암호화된 자격증명 | 부울 | 이 S3호환 저장 oplog 저장 의 사용자 이름 과 비밀번호가 credentialstool을 사용하여 암호화됨 되었는지 여부를 나타내는 플래그입니다 . | |||||||||
id | 문자열 | 이 S3호환 스토리지 oplog 저장소를 고유하게 식별하는 이름입니다. | |||||||||
labels | 문자열 배열 | ||||||||||
링크 | 객체 배열 | 하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 | |||||||||
경로 스타일 액세스 활성화 | 부울 | 이 엔드포인트의 스타일을 나타내는 플래그입니다.
S3호환 저장 버킷 URL 규칙을 검토 하려면 Amazon Web Services S3 설명서를참조하세요. | |||||||||
s3BucketEndpoint | 문자열 | Ops Manager가 이 S3 호환 스토리지 버킷에 액세스할 때 사용하는 URL 입니다. | |||||||||
S3 버킷 이름 | 문자열 | S3호환 스토리지 oplog 저장소를 호스팅하는 S3호환 스토리지 버킷의 이름입니다. | |||||||||
s3RegionOverride | 문자열 | ||||||||||
sseEnabled | 부울 | 이 S3호환 저장 oplog 저장 서버 측 암호화 활성화하는지 여부를 나타내는 플래그입니다. | |||||||||
ssl | 부울 | 이 S3호환 스토리지 oplog 저장소가 TLS 를 사용하여 암호화된 연결만 허용하는지 여부를 나타내는 플래그입니다. | |||||||||
uri | 문자열 | 이 S호환 스토리지 저장소의 메타데이터 데이터베이스에 연결하는 연결 입니다.string 3 oplog 이 데이터베이스는 S3호환 스토리지 버킷에 블록의 위치를 저장합니다. | |||||||||
쓰기 고려 | 문자열 | 이 oplog 스토어에 사용되는 쓰기 고려입니다. Ops Manager는 다음 값 중 하나를 반환합니다.
MongoDB 의 쓰기 (write) 승인 수준에 학습 보려면 쓰기 고려를 참조하세요 . |
요청 예시
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --include \ --request PUT 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/oplog/s3Configs/{S3-OPLOG-CONFIG-ID}?pretty=true' \ --data '{ "assignmentEnabled": true, "awsAccessKey": "access", "awsSecretKey": "secret", "encryptedCredentials": false, "labels": [ "l1", "l2" ], "s3BucketEndpoint": "http://backup.example.com/oplog", "s3BucketName": "oplog", "uri": "mongodb://localhost:27017", "ssl": true, "writeConcern": "W2" }'
응답 예시
응답 헤더
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
응답 본문
{ "assignmentEnabled": true, "awsAccessKey": "access", "awsSecretKey": "secret", "encryptedCredentials": false, "id": "id", "labels": [ "l1", "l2" ], "links": [ { "href": "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/oplog/s3Configs/{S3-OPLOG-CONFIG-ID}", "rel": "self" } ], "s3BucketEndpoint": "http://backup.example.com/oplog", "s3BucketName": "oplog", "uri": "mongodb://localhost:27017", "ssl": true, "writeConcern": "W2" }