자동화 구성 업데이트
- Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.
- 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.
PUT
을(를) 사용하여 프로젝트의 자동화 구성을 업데이트하세요. PATCH
을(를) 사용 하지 마세요 .
자동화 구성을 업데이트하는 방법에 대한 튜토리얼을 보려면 자동화 구성 업데이트를 참조하세요.
hostname
이외 의 MongoDB Agent를 업데이트하려면 다른 엔드포인트를 통해 업데이트해야 합니다.
업데이트를 제출하면 Cloud Manager는 데이터를 내부적으로 수정한 다음 새 구성 버전을 저장합니다.
예시
Cloud Manager는 지정된 각 커뮤니티 MongoDB 버전에 필드를 추가하여 에이전트가 이를 다운로드하는 위치를 나타낼 수 있습니다.
MongoDB 에이전트는 Cloud Manager를 지속적으로 폴링하여 구성 변경 사항이 발생하면 구성 업데이트를 가져옵니다. 그런 다음 에이전트는 라이브 프로세스의 상태를 일치하도록 조정합니다.
경고
Cloud Manager 관리 API에는 동시 수정을 방지하는 보호 기능이 없습니다 . 두 명의 관리자가 모두 현재 버전을 기반으로 하는 구성으로 시작하여 직접 수정한 다음 수정 사항을 제출하는 경우 나중에 수정한 것이 우선합니다.
경고
인증을 활성화하기 전에 에이전트 사용자 이름 업데이트
자동화 구성은 API 를 사용하여 클러스터에서 인증을 활성화할 수 있는 유일한 수단을 제공합니다. 인증을 활성화하려면 먼저 "username": "mms-automation" 으로 다음 엔드포인트를 호출합니다.
필수 역할
이 리소스에는 Project Automation Admin
역할이 필요합니다.
Resource
기본 URL: https://cloud.mongodb.com/api/public/v1.0
PUT /groups/{PROJECT-ID}/automationConfig
요청
경로 매개변수
이름 | 유형 | 필요성 | 설명 |
---|---|---|---|
프로젝트 ID | 문자열 | 필수 사항 | 자동화 구성을 소유한 그룹 의 고유 식별자입니다. |
쿼리 매개변수
다음 쿼리 매개변수는 선택 사항입니다.
본문 매개변수
이러한 매개변수를 검토하려면 자동화 구성 매개변수를 참조하세요.
응답
이러한 매개변수를 검토하려면 자동화 구성 매개변수를 참조하세요.
요청 예시
다음은 자동화 구성을 /Users/admin/updated-conf.json
에 저장된 업데이트된 구성으로 대체합니다. 업데이트된 구성 문서의 예는 자동화 구성 예제를 참조하세요.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PUT "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \ --data-binary "@/Users/admin/updated-conf.json"
응답 예시
응답 헤더
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}
응답 본문
이 구성의 예를 검토하려면 자동화 구성 예제를 참조하세요.