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

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

요구 사항

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

시작하기 전에

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

• 계정 및 용도
• UI를 통해 계정을 관리하고 추가 할 수도 있습니다.
• NerdGraph 사용의 기본
• New Relic 계정의 변경 사항을 추적 할 수 있습니다.

용어 및 필드에 대한 팁

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

• 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를 사용하여 취소할 수 있습니다. 계정 취소 옵션은 NerdGraph에서만 사용할 수 있습니다. UI에서는 계정을 취소할 수 없습니다.

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

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

오류

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

extensions: { nerdGraphExtensions: { errorClass: "ACCESS_DENIED" } }
    }

cannot create subaccount -- multiple parent account ids found. Please use Partnership API.", {
        extensions: { nerdGraphExtensions: { errorClass: "SERVER_ERROR" } }
      }