Atlas 임시 클러스터 생성

임시 클러스터 생성합니다.

다음 엔드포인트로 POST 요청 보냅니다.

https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create

요청 다음 Accept 헤더가 필요합니다.

Accept: application/vnd.atlas.preview+json

다음 예시 요청 Cluster0이라는 이름의 임시 클러스터 생성합니다.

curl -sS -X POST 'https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create' \
  -H 'Accept: application/vnd.atlas.preview+json' \
  -H 'Content-Type: application/json' \
  -d '{"clusterName": "Cluster0"}'

엔드포인트 생성은 다음 형식의 응답을 반환합니다.

{
  "claimUrl": "https://account.mongodb.com/account/register?claimId={claimId}",
  "clusterId": "{clusterId}",
  "connectionString": "mongodb+srv://{username}:{password}@{host}/",
  "expiresAt": "{timestamp}",
  "status": "PROVISIONING",
  "termsOfService": "By using this API and any resources provisioned through it, you agree to be bound by MongoDB's Cloud Terms of Service at https://www.mongodb.com/legal/terms-and-conditions/cloud; and Privacy Policy at https://www.mongodb.com/legal/privacy/privacy-policy."
}

응답에는 다음 필드가 포함됩니다.

• claimUrl: 이 임시 클러스터 요청하기 위한 고유 URL . 사람이 브라우저에서 이 URL 열어야 합니다. 클러스터 생성된 후 7일 동안 유효합니다.

• clusterId: 임시 클러스터 의 고유 식별자입니다. 클러스터의 status, claimUrl 및 기타 세부 정보를 조회 하려면 다음 엔드포인트에 GET 요청 보내고 {clusterId}을 이 값으로 바꿉니다.

  https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters/{clusterId}

  자세한 학습 은 1개의 임시 Atlas 클러스터 반환을 참조하세요.

• connectionString: mongodb+srv:// 프로토콜 사용하여 임시 클러스터 에 연결하는 연결 문자열입니다. 클러스터 의 데이터를 읽고 쓰기 (write) 수 있는 자동 생성된 데이터베이스 사용자의 사용자 이름 과 비밀번호를 포함합니다. 이 연결 문자열 사용하는 모든 클라이언트 이 데이터베이스 사용자로 인증합니다. 생성 응답은 Atlas 수정되지 않은 비밀번호를 반환하는 유일한 경우입니다.

• expiresAt: 클러스터가 요청되지 않은 경우 Atlas 클러스터 를 일시 중지하는 날짜 및 시간입니다. 일시 중지된 임시 클러스터 는 청구할 때까지 액세스할 수 없습니다. 타임스탬프는 UTC의 ISO 8601 형식을 사용합니다.

• status: 임시 클러스터 의 상태입니다. PROVISIONING, ACTIVE 또는 PAUSED 중 하나입니다.

• termsOfService: 이 API 사용하면 MongoDB의 클라우드 서비스 약관 및 개인정보처리방침에 동의하게 됩니다. 전체 약관에 대한 링크가 포함되어 있습니다.

엔드포인트 생성에 대해 자세히 학습 임시 Atlas 클러스터 1개 생성을 참조하세요.

연결 문자열 과 클레임 값을 저장합니다.

생성 응답에서 connectionString, claimUrl 및 clusterId를 저장합니다. 클러스터에 연결하고, 클러스터 의 세부 정보를 요청하고, 조회 필요합니다.

임시 클러스터 에 연결합니다.

생성 응답의 connectionString 값을 사용하여 다음과 같은 호환되는 환경에서 임시 클러스터 에 연결합니다.

• 애플리케이션 코드: 클러스터 에 연결하는 클라이언트 객체 초기화할 때 프로그래밍 언어 의 MongoDB 운전자 에 대한 연결 문자열 제공합니다. 이는 애플리케이션 에서 연결할 때 일반적으로 선택되는 방법입니다. 자세한 학습 은 클라이언트 라이브러리를 통해 클러스터에 연결을 참조하세요.

• 명령줄: 연결 문자열 MongoDB Shell (mongosh)에 인수로 제공하여 대화형으로 연결하고 명령을 실행 .

  명령줄 연결 예시

  mongosh "<connectionString>"

사용 가능한 연결 방법에 대해 자세히 학습 고려 사항을 참조하세요.

(선택 사항) 임시 클러스터 요청합니다.

임시 클러스터 대한 클레임은 선택 사항입니다. 클러스터 를 청구하지 않으면 Atlas 생성 2일 후에 일시 중지하고 생성 7일 후에 삭제합니다. 클러스터 를 요청하면 Atlas 만료 날짜가 없는 표준 무료 클러스터 로 변환합니다. 클레임된 클러스터 모든 데이터를 유지하며, 저장한 연결 문자열 동일한 자격 증명 으로 계속 작동합니다. 클레임의 효과에 대해 자세히 학습 임시 클러스터 클레임을 참조하세요.

클러스터 를 요청하려면 브라우저에서 Atlas 에 로그인해야 합니다. 다음 옵션 중 하나를 선택합니다.

• 지금 클레임: 클러스터 를 클레임할 사람과만 claimUrl를 공유합니다. 임시 클러스터 클레임 절차에 따라 클러스터 를 클레임할 수 있습니다.

• 나중에 클레임: 클러스터 를 클레임할 사람이 사용할 수 있는 안전한 위치 에 claimUrl를 저장합니다. 그러면 해당 사용자는 생성 후 7일 이내에 언제든지 클러스터 를 요청할 수 있습니다.

• 클레임 안 함: 조치 취하지 않습니다. Atlas 생성 후 7일이 지나면 클러스터 를 삭제합니다.

클레임 URL 에서 Atlas 에 로그인합니다.

1. 웹 브라우저에서 생성 응답에서 저장한 claimUrl를 열어 Atlas 로그인 페이지로 이동합니다. 클레임 URL 형식은 다음과 같으며, 여기서 {claimId}은(는) 임시 클러스터 의 고유 식별자입니다.

   https://account.mongodb.com/account/register?claimId={claimId}

2. 로그인 페이지에서 기존 계정으로 Atlas 에 로그인하거나 새 계정을 만듭니다. 다음 단계에서 클러스터 요청하면 이 계정은 클러스터 에 대한 데이터베이스 및 관리 액세스 모두 얻습니다.

   새 계정을 만드는 경우 계속하기 전에 이메일 확인하세요.

임시 클러스터 구성하고 클레임합니다.

로그인하면 Atlas 클레임 페이지가 표시됩니다. 이 페이지에서 다음을 수행합니다.

1. 드롭다운에서 기존 조직 선택하거나 Create new org for this cluster을 선택하여 조직을 생성합니다. 클러스터 를 클레임하면 Atlas 해당 조직을 선택한 조직 으로 이동하고 해당 조직에 프로젝트 생성합니다.

   중요

   이 드롭다운에는 Atlas 계정에 Organization Owner 역할 있는 조직만 나열됩니다. 클러스터 를 요청하면 선택한 조직 의 모든 조직 소유자가 클러스터 와 해당 데이터를 관리 할 수 있습니다.

2. IP 액세스 구성합니다. 액세스 제한하려면 0.0.0.0/0을(를) 제거 하고 현재 IP 주소 만 허용합니다(권장). 모든 IP 주소 에서 연결을 허용하려면 0.0.0.0/0을(를) 유지합니다. 나중에 프로젝트의 Network Access 설정에서 IP 액세스 제한할 수 있습니다.

3. Claim Cluster을 클릭합니다. 이 작업은 실행 취소할 수 없는 일회성 조치 입니다.

확인 페이지를 검토합니다.

클러스터 를 요청하면 Atlas 조직 및 프로젝트 이름, 클러스터 세부 정보, 선택한 IP 액세스 구성이 포함된 확인 페이지를 표시합니다.

Atlas UI 에서 클레임된 클러스터 보려면 Go To Project Overview을 클릭합니다.

(선택 사항) 클레임된 클러스터 재구성합니다.

Atlas UI, Atlas CLI 또는 Atlas 관리 API 사용하여 클레임된 클러스터 와 해당 프로젝트 재구성할 수 있습니다. 클러스터 수준에서 클러스터 더 높은 계층 으로 확장하다 저장 늘릴 수 있습니다. 프로젝트 수준에서 데이터베이스 사용자를 관리 하고 IP 액세스 제한하여 보안을 강화할 수 있습니다.자세한 학습 은 클러스터 관리를 참조하세요.