NerdGraph 튜토리얼: 계정 보기, 생성, 이름 바꾸기 또는 취소

뉴렐릭 UI사용 하는 대신 NerdGraph를 사용하여 조직의 계정을 확인하고 계정을 생성, 이름 변경, 취소할 수 있습니다.

요구 사항

NerdGraph를 통해 조직 수준 설정을 관리하기 위한 요구 사항은 계정 추가 를 참조하세요.

시작하기 전에

NerdGraph를 사용하여 계정을 관리하기 전에 다음 사항을 이해하는 데 도움이 될 것입니다.

용어 및 필드에 대한 팁

이러한 요청에 사용된 일부 필드에 대한 몇 가지 팁:

managedAccount 및 managedAccounts 필드는 단순히 조직의 계정에 대한 용어입니다. 그들은 "계정"과 동의어입니다.
regionCode 필드는 계정에서 사용하는 데이터 센터를나타냅니다. 유효한 값은 각각 US 및 EU 지역에 매핑되는 us01 및 eu01 입니다.

NerdGraph 탐색기 에는 필드를 정의하는 내장 문서가 있습니다.

계정 보기

다음은 조직의 계정을 반환하는 예입니다.

{
  actor {
    organization {
      accountManagement {
        managedAccounts {
          name
          id
          regionCode
        }
      }
    }
  }
}

계정 만들기

다음은 계정을 만드는 방법의 예입니다. 계정을 만들기 전에 계정이 무엇에 사용되는지 이해해야 합니다 .

mutation {
  accountManagementCreateAccount(managedAccount: { name: "NEW_ACCOUNT_NAME" }) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

계정 구조가 복잡한 경우 선택적 regionCode 매개변수를 사용하여 특정 데이터 센터를 타겟팅할 수 있습니다.

mutation {
  accountManagementCreateAccount(
    managedAccount: { name: "NEW_ACCOUNT_NAME", regionCode: "eu01" }
  ) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

계정 이름 바꾸기

다음은 계정 이름을 변경하는 방법의 예입니다.

mutation {
  accountManagementUpdateAccount(
    managedAccount: { name: "UPDATED_ACCOUNT_NAME", id: 101010101 }
  ) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

계정 취소

더 이상 계정을 활성화하지 않으려면 NerdGraph를 사용하여 취소할 수 있습니다.

계정을 취소하기 전에 계정 취소가 미치는 영향을 검토하세요. 계정을 취소하고 싶다고 확신하면 다음 변형을 사용할 수 있습니다.

mutation {
  accountManagementCancelAccount(id: $accountId) {
    id
    isCanceled
    name
    regionCode
  }
}

팁

계정을 취소하는 대신 모니터 엔터티를 삭제하는 것을 고려해 보세요.

오류

다음은 몇 가지 오류와 그 의미입니다.

Error message	Likely cause
`extensions: { nerdGraphExtensions: { errorClass: "ACCESS_DENIED" } } }`	이는 조직 구조(예: 조직 경계 외부에 있는 계정)에 문제가 있음을 나타냅니다. 이 메시지를 받으면 지원팀 이나 계정 담당자에게 문의하세요.
`cannot create subaccount -- multiple parent account ids found. Please use Partnership API.", { extensions: { nerdGraphExtensions: { errorClass: "SERVER_ERROR" } } }`	조직에 둘 이상의 "상위 계정"이 있을 때 반환되는 메시지입니다. 이는 조직에 Partnership API 로 설정된 복잡한 계정 구조가 있고 해당 API를 사용해야 한다는 표시입니다. 질문이 있으세요? 지원팀 이나 계정 담당자에게 문의하세요.
기타 오류	지원팀 이나 계정 담당자에게 문의하세요.

사용자의 편의를 위해 제공되는 기계 번역입니다.