AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu
Docs Home
/ /
S3-호환 블록 저장소 (v2.0)
Docs Home
/ /
백업 관리
/
S3-호환 블록 저장소 (v2.0)
Docs Home
/
관리
/
Ops Manager
/
API
/
리소스
/
백업 관리
/
S3-호환 블록 저장소 (v2.0)

ID로 1개의 S3 블록 저장소 구성 가져오기 (v2.0)

하나의 S3 호환 저장 블록 저장소 구성을 검색합니다. v2.0 리소스 S3 호환 저장 블록 저장소 HashiCorp Vault에서 AWS 자격 증명 읽을 때 keyVault 객체 반환합니다.

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v2.0/admin/backup

Resource

GET /snapshot/s3Configs/{S3-BLOCKSTORE-CONFIG-ID}

요청 경로 매개변수

이름
유형
설명

S3-블록 저장소-CONFIG-ID

문자열

이 S3호환 저장 블록 저장소 구성에 레이블을 지정하는 고유한 이름입니다.

요청 쿼리 매개변수

다음 쿼리 매개변수는 선택 사항입니다.

이름
유형
필요성
설명
기본값

pretty

부울

옵션

응답 본문이 프리티프린트 형식인지 여부를 나타내는 플래그입니다.

false

envelope

부울

옵션

응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다.

일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드 액세스 할 수 없습니다. 이 문제를 해결하려면 쿼리 에서 envelope=true 를 설정하다 .

하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.

  • status: HTTP 응답 코드

  • content예상되는 응답 본문

false

요청 본문 매개변수

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

응답

이름
유형
설명

acceptTos

부울

MongoDB Ops Manager에서 S3호환 저장을 사용하기 위한 서비스 약관에 동의했는지 여부를 나타내는 플래그입니다. S3호환 저장 스토어를 만들려면 이것을 true로 설정해야 합니다.

AssignmentEnabled

부울

이 데이터 저장소에 백업 작업을 할당할 수 있는지 여부를 나타내는 플래그.

AWS 액세스 키

문자열

s3BucketName에 지정된 S3호환 저장 버킷에 액세스 할 수 있는AWS 액세스 키 ID .

AWS 비밀 키

문자열

s3BucketName에 지정된 S3호환 저장 버킷에 액세스 할 수 있는AWS 시크릿 액세스 키입니다.

customCertificates

배열

연결된 S3 호환 저장소 버킷에 적용되는 유효한 인증 기관 인증서 목록입니다.

customCertificates[n].filename

문자열

인증 기관 PEM 파일을 식별하는 이름입니다.

customCertificates[n].certString

문자열

인증 기관 체인을 구성하는 인증 기관 PEM 파일의 콘텐츠입니다.

disableProxyS3

부울

S3호환 저장소에 연결할 때 HTTP proxy를 사용해야 하는지 여부를 나타내는 플래그입니다.

암호화된 자격증명

부울

이 S3 호환 저장소 블록 저장소의 사용자 이름과 비밀번호가 credentialstool을 사용하여 암호화되었는지 여부를 나타내는 플래그입니다.

id

문자열

이 S3 호환 저장소 블록 저장소를 고유하게 식별하는 이름입니다.

labels

문자열 배열

Ops Manager 어떤 S3 블록 저장소에 할당할 수 있는 백업 작업을 관리 위한 태그 배열입니다.

링크

객체 배열

하위 리소스 또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 links 배열에는 self 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에 설명되어 있습니다.

부하 계수

integer

이 스냅샷 저장소 가 다른 스냅샷 저장소와 비교하여 수행하는 백업 작업의 양을 나타내는 0이 아닌 양의 정수입니다. 이 옵션은 둘 이상의 스냅샷 저장소를 사용 중인 경우에만 필요합니다.

Load Factor 에 학습 보려면 기존 블록 저장소 1개 편집을 참조하세요.

objectLockEnabled

부울

S3 버킷의 객체가 삭제되지 않도록 객체 잠금 활성화할지 여부를 나타내는 플래그입니다.

OIDC

객체

이 저장 에 대한OIDC 인증 설정입니다. oidc 객체 에는 다음 필드가 포함되어 있습니다.

  • enabled: 부울. 이 저장 에 대해 OIDC 인증 사용할 수 있는지 여부를 나타냅니다.

  • method: string. callback, azure, gcp 또는 k8s 중 하나.

  • tokenUri: 문자열.IdP 토큰 엔드포인트입니다. method이 callback인 경우에만 표시됩니다.

  • clientId: 문자열.IdP에 등록된 클라이언트 ID .

  • clientSecret: string. MongoDB Ops Manager는 응답에서 이 값을 수정하며 원본 클라이언트 시크릿을 반환하지 않습니다.

  • scope: 문자열.IdP에서 요청한 OAuth2 범위입니다. method가 callback인 경우에만 표시됩니다.

  • tokenResource: string. 워크로드 인덴티티 토큰의 대상 또는 리소스 식별자입니다. method이 azure 또는 gcp인 경우에만 제시됩니다.

경로 스타일 액세스 활성화

부울

이 엔드포인트의 스타일을 나타내는 플래그입니다.

  • true: 경로 스타일 URL 엔드포인트입니다. 예시: s3.amazonaws.com/<bucket>

  • false: 가상 호스트 스타일의 URL 엔드포인트입니다. 예시: <bucket>.s3.amazonaws.com

S3호환 저장 버킷 URL 규칙을 검토 하려면 AWS S3 문서를 참조하세요.

s3AuthMethod

문자열

s3BucketName 에 지정된 S3 호환 스토리지 버킷에 대한 액세스 권한을 부여하는 데 사용되는 메서드입니다.

이 옵션에 허용되는 값은 KEYS, IAM_ROLE 입니다.

s3BucketEndpoint

문자열

Ops Manager 이 S3 호환 저장 버킷에 액세스 데 사용하는URL 입니다.

S3 버킷 이름

문자열

S3 호환 스토리지 블록 저장소를 호스팅하는 S3 호환 스토리지 버킷의 이름입니다.

S3 최대 연결

integer

이 S3 호환 저장소 블록 저장소에 대한 최대 연결 수를 나타내는 양의 정수입니다.

s3RegionOverride

문자열

S3 호환 스토리지 버킷이 있는 리전입니다. 이 필드는 S3 호환 스토리지 저장소의 s3BucketEndpoint 가 리전 범위를 지원하지 않는 경우에만 적용됩니다.

Ops Manager는 이 S3 호환 스토리지 블록 저장소를 생성 하거나 업데이트 할 때 포함한 경우에만 이 필드를 반환합니다.

sseEnabled

부울

이 S3호환 저장 블록 저장소 서버 측 암호화활성화하는지 여부를 나타내는 플래그입니다.

ssl

부울

이 S3 호환 저장 블록 저장소 TLS를 사용하여 암호화됨 연결만 허용하는지 여부를 나타내는 플래그입니다.

uri

문자열

이 S3호환 스토리지 저장 블록 저장소 의 메타데이터 데이터베이스 에 연결하는 연결 문자열입니다. 이 데이터베이스 블록의 위치를 AWS S3호환 저장 버킷에 저장합니다.

쓰기 고려

문자열

이 블록 저장소에 사용되는 쓰기 고려 (write concern)입니다.

Ops Manager는 다음 값 중 하나를 반환합니다.

  • ACKNOWLEDGED

  • W2

  • JOURNALED

  • MAJORITY

MongoDB 의 쓰기 (write) 승인 수준에 학습 보려면 쓰기 고려를 참조하세요 .

v2.0 리소스는 다음 키 볼트 필드를 추가합니다.

이름
유형
설명

keyVault

객체

이 S3호환 스냅샷 저장소의 Vault 기반 자격 증명 소스. MongoDB Ops Manager는 스냅샷 저장소가 키 보관소에서 자격 증명을 읽을 때에만 이 객체를 반환합니다.

keyVault.vaultId

문자열

자격 증명을 저장하는 키 보관소 구성의 고유 식별자.

keyVault.awsAccessKeyPath

문자열

키 볼트에 있는 AWS 액세스 키의 경로입니다.

keyVault.awsSecretKeyPath

문자열

키 볼트에 있는 AWS 비밀 키의 경로입니다.

요청 예시

curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
     --header 'Accept: application/json' \
     --include \
     --request GET 'https://<OpsManagerHost>:<Port>/api/public/v2.0/admin/backup/snapshot/s3Configs/{S3-BLOCKSTORE-CONFIG-ID}?pretty=true'

응답 예시

응답 헤더

HTTP/1.1 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
HTTP/1.1 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}

응답 본문

{
  "acceptedTos": true,
  "assignmentEnabled": true,
  "encryptedCredentials": false,
  "id": "{S3-BLOCKSTORE-CONFIG-ID}",
  "keyVault": {
    "vaultId": "{KEY-VAULT-ID}",
    "awsAccessKeyPath": "path/to/awsAccessKey",
    "awsSecretKeyPath": "path/to/awsSecretKey"
  },
  "links": [
    {
      "href": "https://<OpsManagerHost>:<Port>/api/public/v2.0/admin/backup/snapshot/s3Configs/{S3-BLOCKSTORE-CONFIG-ID}",
      "rel": "self"
    }
  ],
  "loadFactor": 1,
  "pathStyleAccessEnabled": false,
  "s3AuthMethod": "KEYS",
  "s3BucketEndpoint": "s3.amazonaws.com",
  "s3BucketName": "bucketname",
  "s3MaxConnections": 50,
  "sseEnabled": true,
  "ssl": false,
  "uri": "mongodb://127.0.0.1:27017",
  "writeConcern": "ACKNOWLEDGED"
}
돌아가기
S3-호환 블록 저장소 (v2.0)
다음
모두 가져오기
이 페이지 평가하기

이 페이지의 내용