# 클라우드 계정 관리

## 개요

Panther API는 다음과 같은 클라우드 계정 작업을 지원합니다:

* 클라우드 계정 통합 목록 보기
* 특정 클라우드 계정 통합의 세부 정보 가져오기
* 새 클라우드 계정 통합 생성하기
* 기존 클라우드 계정 통합 업데이트하기
* 클라우드 계정 통합 삭제하기

Console의 API Playground 또는 GraphQL-over-HTTP API를 사용하여 Panther의 API를 호출할 수 있습니다. 다음에서 이러한 방법에 대해 자세히 알아보세요. [Panther API](/ko/panther/api.md#step-1-choose-a-method-for-invoking-the-api).

보기 [Cloud Security Scanning](/ko/cloud-scanning.md) Panther로 클라우드 리소스 구성을 모니터링하는 방법에 대해 자세히 알아보세요.

## 일반적인 클라우드 계정 작업

아래는 Panther에서 가장 일반적인 GraphQL 클라우드 계정 작업 중 일부입니다. 이 예시는 GraphQL 클라이언트(또는 `curl`)를 사용해 Panther의 GraphQL API를 호출할 때 전송해야 하는 문서를 보여줍니다.

#### 클라우드 계정 목록 보기

```graphql
query cloudAccounts {
  cloudAccounts {
    edges {
      node {
        awsAccountId
        awsRegionIgnoreList
        awsScanConfig {
          auditRole
        }
        awsStackName
        createdAt
        createdBy {
          ... on User {
            id
          }
          ... on APIToken {
            id
          }
        }
        id
        isEditable
        isRealtimeScanningEnabled
        label
        lastModifiedAt
        resourceRegexIgnoreList
        resourceTypeIgnoreList
      }
    }
  }
}

```

#### 클라우드 계정 조회하기

```graphql
query cloudAccount {
  cloudAccount(id:"CLOUD_ACCOUNT_ID") {
    awsAccountId
    awsRegionIgnoreList
    awsScanConfig {
      auditRole
    }
    awsStackName
    createdAt
    createdBy {
      ... on User {
        id
      }
      ... on APIToken {
        id
      }
    }
    id
    isEditable
    isRealtimeScanningEnabled
    label
    lastModifiedAt
    resourceRegexIgnoreList
    resourceTypeIgnoreList
  }
}

```

#### 클라우드 계정 생성하기

Panther의 [Cloud Security Scanning](/ko/cloud-scanning.md) 클라우드 계정을 다음을 사용하여 온보딩할 때 자동으로 활성화됩니다. `CreateCloudAccount`. 하지만 여전히 다음 작업은 수행해야 합니다. [AWS 계정에 Panther용 IAM 역할 생성](/ko/cloud-scanning.md#creating-an-iam-role-manually-or-with-other-automation).

```graphql
mutation CreateCloudAccount {
  createCloudAccount(input: {
    awsAccountId: "AWS_ACCOUNT_ID"
    awsScanConfig: {
      auditRole: "AUDIT_ROLE"
    }
    label: "new cloud account source"
  }) {
    cloudAccount {
      id
    }
  }
}

```

#### 클라우드 계정 업데이트하기

```graphql
mutation UpdateCloudAccount {
  updateCloudAccount(
    input: {
      awsRegionIgnoreList: [
        "us-west-1"
      ]
      awsScanConfig: {
        auditRole: "ROLE_ARN"
      }
      id:"CLOUD_ACCOUNT_INTEGRATION_ID"
      label: "some updated label"
      resourceRegexIgnoreList: [".*west-1*"]
      resourceTypeIgnoreList: ["AWS.KMS.Key"]
  }) {
    cloudAccount {
      id
    }
  }
}

```

#### 클라우드 계정 삭제하기

```graphql
mutation DeleteCloudAccount {
  deleteCloudAccount(input: {id: "CLOUD_ACCOUNT_ID"}) {
    id
  }
}

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.panther.com/ko/panther/api/graphql/cloud-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.