1개의 조직 만들기
MongoDB Cloud에 조직 한 개를 생성하고 이를 요청하는 서비스 계정 또는 API 키의 조직에 연결합니다. 이 리소스를 사용하려면, 요청하는 서비스 계정 또는 API 키에 조직 소유자 역할이 있어야 합니다. 요청하는 서비스 계정 또는 API 키의 조직은 유료 조직이어야 합니다. 자세한 내용은 MongoDB Atlas 문서의 유료 조직 구성을 참조하세요.
쿼리 매개변수
-
애플리케이션이 응답을
envelopeJSON 객체로 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 결과 목록을 반환하는 엔드포인트는 결과 객체를 엔벨로프로 사용합니다. 애플리케이션은 응답 본문에 상태 매개변수를 추가합니다.기본값은
false입니다. -
응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다.
기본값은
false입니다.Prettyprint
body
필수 사항
생성하려는 조직입니다.
-
Atlas 이 조직 에 대해 생성하는 조직 서비스 계정입니다. 이를 생략하면 Atlas 이 조직 에 대한 조직 서비스 계정을 생성하지 않습니다. 지정된 경우 이 객체 에는 모든 본문 매개변수가 필요합니다. 동일한 요청 에 API 키를 지정할 수 없습니다.
-
새로 생성된 조직을 연결할 페더레이션을 식별하는 고유한 24자리 16진수 문자열입니다. 지정된 경우 새 조직의 제안된 조직 소유자는 페더레이션과 관련된 조직에서 조직 소유자 역할이 있어야 합니다.
형식은
^([a-f0-9]{24})$패턴 과 일치해야 합니다. -
조직을 식별하는 사람이 읽을 수 있는 레이블입니다.
형식은
^[\p{L}\p{N}\-_.(),:&@+']{1,64}$패턴 과 일치해야 합니다. -
조직 소유자 역할을 할당하려는 MongoDB Cloud 사용자를 식별하는 고유한 24자리 16진수 문자열입니다. 이 사용자는 호출하는 API 키와 동일한 조직의 구성원이어야 합니다.
federationSettingsId을(를) 제공하는 경우 대신 이 사용자는 지정된 페더레이션의 조직에 대한 조직 소유자 역할이 있어야 합니다. 이 매개변수는 프로그래밍 방식 API 키로 인증하는 경우에만 필요합니다.형식은
^([a-f0-9]{24})$패턴 과 일치해야 합니다. -
Atlas 이 조직 에 대해 생성하는 조직 서비스 계정입니다. 이를 생략하면 Atlas 이 조직 에 대한 조직 서비스 계정을 생성하지 않습니다. 지정된 경우 이 객체 에는 모든 본문 매개변수가 필요합니다. 동일한 요청 에 API 키를 지정할 수 없습니다.
-
자동 경고 생성을 비활성화합니다. true로 설정하다 하면 조직 수준 경고가 자동으로 생성되지 않습니다.
기본값은
false입니다.
atlas api organizations createOrg --helpimport (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20231001001/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.CreateOrgApiParams{}
sdkResp, httpResp, err := client.OrganizationsApi.
CreateOrgWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2023-10-01+json" \
--header "Content-Type: application/json" \
-X POST "https://cloud.mongodb.com/api/atlas/v2/orgs" \
-d '{ <Payload> }'curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2023-10-01+json" \
--header "Content-Type: application/json" \
-X POST "https://cloud.mongodb.com/api/atlas/v2/orgs" \
-d '{ <Payload> }'{
"apiKey": {
"desc": "string",
"roles": [
"ORG_OWNER"
]
},
"federationSettingsId": "32b6e34b3d91647abb20e7b8",
"name": "string",
"orgOwnerId": "32b6e34b3d91647abb20e7b8",
"serviceAccount": {
"description": "string",
"name": "string",
"roles": [
"ORG_MEMBER"
],
"secretExpiresAfterHours": 8
},
"skipDefaultAlertsSettings": false
}{
"apiKey": {
"desc": "string",
"id": "32b6e34b3d91647abb20e7b8",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"privateKey": "55c3bbb6-b4bb-0be1-e66d20841f3e",
"publicKey": "zmmrboas",
"roles": [
{
"groupId": "32b6e34b3d91647abb20e7b8",
"orgId": "32b6e34b3d91647abb20e7b8",
"roleName": "ORG_MEMBER"
}
]
},
"federationSettingsId": "32b6e34b3d91647abb20e7b8",
"orgOwnerId": "32b6e34b3d91647abb20e7b8",
"organization": {
"id": "32b6e34b3d91647abb20e7b8",
"isDeleted": true,
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"name": "string",
"skipDefaultAlertsSettings": false
},
"serviceAccount": {
"clientId": "mdb_sa_id_1234567890abcdef12345678",
"createdAt": "2025-05-04T09:42:00Z",
"description": "string",
"name": "string",
"roles": [
"ORG_MEMBER"
],
"secrets": [
{
"createdAt": "2025-05-04T09:42:00Z",
"expiresAt": "2025-05-04T09:42:00Z",
"id": "32b6e34b3d91647abb20e7b8",
"lastUsedAt": "2025-05-04T09:42:00Z",
"maskedSecretValue": "mdb_sa_sk_...",
"secret": "mdb_sa_sk_..."
}
]
},
"skipDefaultAlertsSettings": false
}{
"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": 409,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554",
"reason": "Conflict",
"errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}