

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 주제 작업
<a name="msk-topic-operations-information"></a>

Amazon MSK APIs 사용하면 Kafka 관리자 클라이언트를 설정하고 유지 관리할 필요 없이 MSK 프로비저닝 클러스터의 주제를 관리할 수 있습니다. 이러한 APIs 사용하면 보존 및 정리 정책과 같은 구성 설정과 함께 복제 인수 및 파티션 수와 같은 주제 속성을 정의하거나 읽을 수 있습니다. AWS CLI, AWS SDKs 및 AWS CloudFormation을 비롯한 친숙한 인터페이스를 사용하여 Kafka 주제를 프로그래밍 방식으로 관리할 수 있습니다. 이러한 APIs는 Amazon MSK 콘솔에도 통합되어 모든 주제 작업을 한 곳에서 수행할 수 있습니다. 이제 안내 기본값을 사용하여 몇 번의 클릭만으로 주제를 생성하거나 업데이트할 수 있으며 주제 구성, 파티션 수준 정보 및 지표에 대한 포괄적인 가시성을 얻을 수 있습니다.

**중요**  
이러한 주제 API 응답은 약 1분마다 업데이트되는 데이터를 반영합니다. 변경 후 최신 주제 상태의 경우 쿼리하기 전에 약 1분 정도 기다려야 합니다.

## 주제 APIs 사용 요구 사항
<a name="topic-operations-requirements"></a>
+ 클러스터는 MSK 프로비저닝 클러스터여야 합니다. MSK Serverless 클러스터에는 이러한 APIs를 사용할 수 없습니다.
+ 클러스터가 Apache Kafka 버전 3.6.0 이상을 실행 중이어야 합니다. 지원되는 버전에 대한 자세한 내용은 섹션을 참조하세요[지원되는 Apache Kafka 버전](supported-kafka-versions.md).
+ 클러스터가 `ACTIVE` 상태여야 합니다. 클러스터 상태에 대한 자세한 내용은 [MSK 프로비저닝된 클러스터의 상태 이해](msk-cluster-states.md) 섹션을 참조하세요.
+ 적절한 IAM 권한이 있어야 합니다. 자세한 내용은 [주제 작업 APIs에 대한 IAM 권한](#topic-operations-permissions) 단원을 참조하십시오.

## 주제 작업 APIs에 대한 IAM 권한
<a name="topic-operations-permissions"></a>

이러한 APIs 호출하려면 적절한 IAM 권한이 있어야 합니다. 다음 표에는 각 API에 필요한 권한이 나열되어 있습니다.


**주제 작업 APIs에 필요한 권한**  

| API | 필수 권한 | Resource | 
| --- | --- | --- | 
| ListTopics |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic`  | 클러스터 ARN, 주제 ARN | 
| DescribeTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration`  | 클러스터 ARN, 주제 ARN | 
| DescribeTopicPartitions |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration`  | 클러스터 ARN, 주제 ARN | 
| CreateTopic |  `kafka-cluster:Connect` `kafka-cluster:CreateTopic`  | 클러스터 ARN, 주제 ARN | 
| DeleteTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DeleteTopic`  | 클러스터 ARN, 주제 ARN | 
| UpdateTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:AlterTopic` `kafka-cluster:AlterTopicDynamicConfiguration`  | 클러스터 ARN, 주제 ARN | 

**참고**  
의 경우 IAM 정책에서 클러스터 ARN을 `kafka-cluster:Connect`지정합니다. 다른 모든 작업의 경우 IAM 정책에서 주제 ARN을 지정합니다.

**참고**  
의 경우 와일드카드(\$1)를 사용하여 클러스터의 모든 주제를 일치시킬 `ListTopics`수 있습니다. 예를 들어 `arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*`입니다.

Amazon MSK의 IAM 액세스 제어에 대한 자세한 내용은 섹션을 참조하세요[IAM 액세스 제어](iam-access-control.md).

**Topics**
+ [주제 APIs 사용 요구 사항](#topic-operations-requirements)
+ [주제 작업 APIs에 대한 IAM 권한](#topic-operations-permissions)
+ [Amazon MSK 클러스터의 주제 나열](msk-list-topics.md)
+ [주제에 대한 자세한 정보 가져오기](msk-describe-topic.md)
+ [주제에 대한 파티션 정보 보기](msk-describe-topic-partitions.md)
+ [Amazon MSK 클러스터에서 주제 생성](msk-create-topic.md)
+ [Amazon MSK 클러스터에서 주제 업데이트](msk-update-topic.md)
+ [Amazon MSK 클러스터에서 주제 삭제](msk-delete-topic.md)

# Amazon MSK 클러스터의 주제 나열
<a name="msk-list-topics"></a>

MSK 프로비저닝 클러스터의 모든 주제를 나열하여 파티션 수 및 복제 인자와 같은 기본 메타데이터를 볼 수 있습니다. 이는 클러스터의 주제를 모니터링하거나, 인벤토리 검사를 수행하거나, 추가 조사를 위한 주제를 식별하는 데 유용합니다.

**참고**  
`ListTopics` API는 기본 주제 메타데이터를 제공합니다. 현재 상태 및 구성을 포함하여 특정 주제에 대한 자세한 정보를 가져오려면 `DescribeTopic` API를 사용합니다. 자세한 내용은 [주제에 대한 자세한 정보 가져오기](msk-describe-topic.md) 단원을 참조하십시오.

**참고**  
이 API 응답은 약 1분마다 업데이트되는 데이터를 반영합니다. 변경 후 최신 주제 상태의 경우 쿼리하기 전에 약 1분 정도 기다려야 합니다.

**Topics**
+ [를 사용하여 주제 나열 AWS Management Console](list-topics-console.md)
+ [를 사용하여 주제 나열 AWS CLI](list-topics-cli.md)
+ [API를 사용하여 주제 나열](list-topics-api.md)

# 를 사용하여 주제 나열 AWS Management Console
<a name="list-topics-console"></a>

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.

1. 클러스터 목록에서 주제를 나열할 클러스터의 이름을 선택합니다.

1. 클러스터 세부 정보 페이지에서 **주제** 탭을 선택합니다.

1. 이 표에는 주제 이름, 파티션 수, 복제 인수, out-of-sync 복제본 수를 포함하여 클러스터의 모든 주제가 표시됩니다.

# 를 사용하여 주제 나열 AWS CLI
<a name="list-topics-cli"></a>

다음 명령을 실행하여 *ClusterArn*을 클러스터의 Amazon 리소스 이름(ARN)으로 바꿉니다. 클러스터에 대한 ARN이 없는 경우, 모든 클러스터를 나열하여 찾을 수 있습니다. 자세한 내용은 [Amazon MSK 클러스터 나열](msk-list-clusters.md) 단원을 참조하십시오.

```
aws kafka list-topics --cluster-arn ClusterArn
```

이 명령의 출력은 다음 JSON 예제와 같습니다.

```
{
    "topics": [
        {
            "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
            "topicName": "MyTopic",
            "partitionCount": 3,
            "replicationFactor": 3,
            "outOfSyncReplicaCount": 0
        },
        {
            "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/AnotherTopic",
            "topicName": "AnotherTopic",
            "partitionCount": 6,
            "replicationFactor": 3,
            "outOfSyncReplicaCount": 1
        }
    ]
}
```

## 결과 페이지 매김
<a name="list-topics-pagination"></a>

클러스터에 주제가 많은 경우 페이지 매김을 사용하여 더 작은 배치로 결과를 검색할 수 있습니다. `--max-results` 파라미터를 사용하여 반환할 최대 주제 수를 지정하고 `--next-token` 파라미터를 사용하여 결과의 다음 페이지를 검색합니다.

```
aws kafka list-topics --cluster-arn ClusterArn --max-results 10
```

사용 가능한 결과가 더 있는 경우 응답에 `nextToken` 값이 포함됩니다. 이 토큰을 사용하여 결과의 다음 페이지를 검색합니다.

```
aws kafka list-topics --cluster-arn ClusterArn --max-results 10 --next-token NextToken
```

## 이름을 기준으로 주제 필터링
<a name="list-topics-filter"></a>

`--topic-name-filter` 파라미터를 사용하여 접두사를 지정하여 주제 목록을 필터링할 수 있습니다. 그러면 이름이 지정된 접두사로 시작하는 주제만 반환됩니다.

```
aws kafka list-topics --cluster-arn ClusterArn --topic-name-filter "prod-"
```

이 명령은 `prod-orders` 또는 `prod-`와 같이 이름이 로 시작하는 주제만 반환합니다`prod-inventory`.

# API를 사용하여 주제 나열
<a name="list-topics-api"></a>

API를 사용하여 주제를 나열하려면 [ListTopics](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics.html#ListTopics)를 참조하세요.

# 주제에 대한 자세한 정보 가져오기
<a name="msk-describe-topic"></a>

현재 상태, 파티션 수, 복제 인수 및 구성을 포함하여 MSK 프로비저닝 클러스터의 특정 주제에 대한 자세한 정보를 검색할 수 있습니다. 이는 문제 해결, 주제 설정 검증 또는 작업 중 주제 상태 모니터링에 유용합니다.

**참고**  
이 API 응답은 약 1분마다 업데이트되는 데이터를 반영합니다. 변경 후 최신 주제 상태의 경우 쿼리하기 전에 약 1분 정도 기다려야 합니다.

**Topics**
+ [를 사용하여 주제 설명 AWS Management Console](describe-topic-console.md)
+ [를 사용하여 주제 설명 AWS CLI](describe-topic-cli.md)
+ [API를 사용하여 주제 설명](describe-topic-api.md)

# 를 사용하여 주제 설명 AWS Management Console
<a name="describe-topic-console"></a>

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.

1. 클러스터 목록에서 설명할 주제가 포함된 클러스터의 이름을 선택합니다.

1. 클러스터 세부 정보 페이지에서 **주제** 탭을 선택합니다.

1. 주제 목록에서 보려는 주제의 이름을 선택합니다.

1. 주제 세부 정보 페이지에는 상태, 파티션 수, 복제 인수, 구성 설정 등 주제에 대한 정보가 표시됩니다.

# 를 사용하여 주제 설명 AWS CLI
<a name="describe-topic-cli"></a>

다음 명령을 실행하여 *ClusterArn*을 클러스터의 Amazon 리소스 이름(ARN)으로 바꾸고 *TopicName*을 설명하려는 주제의 이름으로 바꿉니다.

```
aws kafka describe-topic --cluster-arn ClusterArn --topic-name TopicName
```

이 명령의 출력은 다음 JSON 예제와 같습니다.

```
{
    "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
    "topicName": "MyTopic",
    "partitionCount": 3,
    "replicationFactor": 3,
    "configs": "Y29tcHJlc3Npb24udHlwZT1wcm9kdWNlcgpyZXRlbnRpb24ubXM9NjA0ODAwMDAw",
    "status": "ACTIVE"
}
```

## 주제 상태 이해
<a name="describe-topic-status"></a>

`status` 필드는 주제의 현재 상태를 나타냅니다. 다음 표에서는 가능한 상태 값을 설명합니다.


**주제 상태 값**  

| Status | 설명 | 
| --- | --- | 
| 생성 | 주제가 생성 중입니다. | 
| ACTIVE | 주제가 활성 상태이고 사용할 준비가 되었습니다. | 
| 업데이트 중 | 주제 구성이 업데이트되고 있습니다. | 
| DELETING | 주제가 삭제되고 있습니다. | 

## 주제 구성 이해
<a name="describe-topic-configs"></a>

`configs` 필드에는 Base64 형식으로 인코딩된 주제의 Kafka 구성 속성이 포함되어 있습니다. 읽기 가능한 형식으로 구성을 보려면 Base64 문자열을 디코딩해야 합니다.

다음 예제에서는 Linux 또는 macOS에서 `base64` 명령을 사용하여 구성을 디코딩하는 방법을 보여줍니다.

```
echo "Y29tcHJlc3Npb24udHlwZT1wcm9kdWNlcgpyZXRlbnRpb24ubXM9NjA0ODAwMDAw" | base64 --decode
```

디코딩된 출력에는 주제 구성 속성이 키-값 형식으로 표시됩니다.

```
compression.type=producer
retention.ms=604800000
```

주제 수준 구성 속성에 대한 자세한 내용은 섹션을 참조하세요[주제 수준 Amazon MSK 구성](msk-configuration-properties.md#msk-topic-confinguration).

# API를 사용하여 주제 설명
<a name="describe-topic-api"></a>

API를 사용하여 주제를 설명하려면 [DescribeTopic](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname.html#DescribeTopic)을 참조하세요.

# 주제에 대한 파티션 정보 보기
<a name="msk-describe-topic-partitions"></a>

MSK 프로비저닝 클러스터에서 특정 주제의 파티션에 대한 자세한 정보를 검색할 수 있습니다. 이 정보에는 파티션 번호, 리더 브로커, 복제본 브로커 및 동기화 내 복제본(ISR)이 포함됩니다. 이는 파티션 배포를 모니터링하거나, 덜 복제된 파티션을 식별하거나, 복제 문제를 해결하는 데 유용합니다.

**참고**  
이 API 응답은 약 1분마다 업데이트되는 데이터를 반영합니다. 변경 후 최신 주제 상태를 보려면 쿼리하기 전에 약 1분 정도 기다려야 합니다.

**Topics**
+ [를 사용하여 파티션 정보 보기 AWS Management Console](describe-topic-partitions-console.md)
+ [를 사용하여 파티션 정보 보기 AWS CLI](describe-topic-partitions-cli.md)
+ [API를 사용하여 파티션 정보 보기](describe-topic-partitions-api.md)

# 를 사용하여 파티션 정보 보기 AWS Management Console
<a name="describe-topic-partitions-console"></a>

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.

1. 클러스터 목록에서 주제가 포함된 클러스터의 이름을 선택합니다.

1. 클러스터 세부 정보 페이지에서 **주제** 탭을 선택합니다.

1. 주제 목록에서 파티션 정보를 보려는 주제의 이름을 선택합니다.

1. 주제 세부 정보 페이지에 파티션 정보가 표시되며 각 파티션의 파티션 번호, 리더 브로커, 복제본 및 동기화된 복제본이 표시됩니다.

# 를 사용하여 파티션 정보 보기 AWS CLI
<a name="describe-topic-partitions-cli"></a>

다음 명령을 실행하여 *ClusterArn*을 클러스터의 Amazon 리소스 이름(ARN)으로 바꾸고 *TopicName*을 주제 이름으로 바꿉니다.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName
```

이 명령의 출력은 다음 JSON 예제와 같습니다.

```
{
    "partitions": [
        {
            "partition": 0,
            "leader": 1,
            "replicas": [1, 2, 3],
            "isr": [1, 2, 3]
        },
        {
            "partition": 1,
            "leader": 2,
            "replicas": [2, 3, 1],
            "isr": [2, 3, 1]
        },
        {
            "partition": 2,
            "leader": 3,
            "replicas": [3, 1, 2],
            "isr": [3, 1]
        }
    ]
}
```

## 파티션 정보 이해
<a name="describe-topic-partitions-fields"></a>

응답에는 각 파티션에 대한 다음 정보가 포함됩니다.
+ **파티션** - 파티션 번호입니다. 파티션은 0부터 번호가 매겨집니다.
+ **leader** -이 파티션에 대한 리더의 브로커 ID입니다. 리더는 파티션에 대한 모든 읽기 및 쓰기 요청을 처리합니다.
+ **복제본 **-이 파티션의 복제본이 있는 브로커 IDs 목록입니다. 여기에는 동기화 내 복제본과 out-of-sync 복제본이 모두 포함됩니다.
+ **isr** - 동기화된 복제본인 브로커 IDs 목록입니다. 이러한 복제본은 리더와 완전히 연결되며 필요한 경우 리더 역할을 맡을 수 있습니다.

위 예제에서 파티션 2에는 out-of-sync 복제본이 있습니다. `replicas` 목록에는 브로커 2가 포함되지만 `isr` 목록에는 포함되지 않습니다. 이는 브로커 2가이 파티션의 리더와 완전히 연결되지 않았음을 나타냅니다.

## 결과 페이지 매김
<a name="describe-topic-partitions-pagination"></a>

주제에 파티션이 많은 경우 페이지 매김을 사용하여 더 작은 배치로 결과를 검색할 수 있습니다. `--max-results` 파라미터를 사용하여 반환할 최대 파티션 수를 지정하고 `--next-token` 파라미터를 사용하여 결과의 다음 페이지를 검색합니다.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10
```

사용 가능한 결과가 더 있는 경우 응답에 `nextToken` 값이 포함됩니다. 이 토큰을 사용하여 결과의 다음 페이지를 검색합니다.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10 --next-token NextToken
```

## 일반 사용 사례
<a name="describe-topic-partitions-use-cases"></a>

파티션 정보 보기는 여러 시나리오에 유용합니다.
+ **과소 복제된 파티션 식별** - `replicas` 및 `isr` 목록을 비교하여 일부 복제본이 동기화되지 않은 파티션을 식별합니다. 이는 성능 문제 또는 브로커 문제를 나타낼 수 있습니다.
+ **파티션 배포 모니터링** - 파티션 리더가 브로커에 고르게 분산되어 있는지 확인하여 로드가 균형 잡힌지 확인합니다.
+ **복제 문제 해결 **- ISR 목록을 검사하여 복제를 따라잡는 데 문제가 있는 브로커를 식별합니다.
+ **파티션 리밸런싱 계획** - 리밸런싱 작업을 수행하기 전에이 정보를 사용하여 현재 파티션 레이아웃을 이해합니다.

# API를 사용하여 파티션 정보 보기
<a name="describe-topic-partitions-api"></a>

API를 사용하여 파티션 정보를 보려면 [DescribeTopicPartitions](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname-partitions.html#DescribeTopicPartitions)를 참조하세요.

# Amazon MSK 클러스터에서 주제 생성
<a name="msk-create-topic"></a>

사용자 지정 Kafka AdminClient를 설정하지 않고도이 API를 직접 사용하여 MSK 프로비저닝된 클러스터에서 주제를 생성할 수 있습니다. 주제를 생성할 때 주제 이름, 파티션 수, 복제 인수 및 선택적으로 주제 구성을 지정합니다.

**Topics**
+ [를 사용하여 주제 생성 AWS Management Console](create-topic-console.md)
+ [를 사용하여 주제 생성 AWS CLI](create-topic-cli.md)
+ [API를 사용하여 주제 생성](create-topic-api.md)

# 를 사용하여 주제 생성 AWS Management Console
<a name="create-topic-console"></a>

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.

1. 클러스터 목록에서 주제를 생성할 클러스터의 이름을 선택합니다.

1. 클러스터 세부 정보 페이지에서 **주제** 탭을 선택합니다.

1. **주제 생성**을 선택합니다.

1. 주제 이름, 파티션 수 및 복제 인수를 입력합니다. 선택적으로 구성을 추가합니다. 한 번에 여러 주제를 생성할 수 있습니다.

1. **주제 생성**을 선택합니다.

# 를 사용하여 주제 생성 AWS CLI
<a name="create-topic-cli"></a>

다음 명령을 실행하여 *ClusterArn*을 클러스터의 Amazon 리소스 이름(ARN)으로 바꿉니다. 클러스터에 대한 ARN이 없는 경우, 모든 클러스터를 나열하여 찾을 수 있습니다. 자세한 내용은 [Amazon MSK 클러스터 나열](msk-list-clusters.md) 단원을 참조하십시오.

```
aws kafka create-topic --cluster-arn ClusterArn --topic-name MyTopic --partition-count 3 --replication-factor 3
```

이 명령의 출력은 다음 JSON 예제와 같습니다.

```
{
    "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
    "topicName": "MyTopic",
    "status": "CREATING"
}
```

# API를 사용하여 주제 생성
<a name="create-topic-api"></a>

API를 사용하여 주제를 생성하려면 [CreateTopic](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics.html#CreateTopic)을 참조하세요.

# Amazon MSK 클러스터에서 주제 업데이트
<a name="msk-update-topic"></a>

기존 주제에 대한 파티션 수 또는 주제 수준 구성을 업데이트합니다. 이 작업은 재생성 없이 주제를 수정합니다.

**참고**  
단일 API 호출에서 파티션 수 또는 주제 구성을 업데이트할 수 있지만 둘 다 동시에 업데이트할 수는 없습니다. 둘 다 업데이트하려면 별도의 API 직접 호출을 수행합니다.

**Topics**
+ [를 사용하여 주제 업데이트 AWS Management Console](update-topic-console.md)
+ [를 사용하여 주제 업데이트 AWS CLI](update-topic-cli.md)
+ [API를 사용하여 주제 업데이트](update-topic-api.md)

# 를 사용하여 주제 업데이트 AWS Management Console
<a name="update-topic-console"></a>

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.

1. 클러스터 목록에서 업데이트하려는 주제가 포함된 클러스터의 이름을 선택합니다.

1. 클러스터 세부 정보 페이지에서 **주제** 탭을 선택합니다.

1. 업데이트할 주제를 선택한 다음 **작업**에서 **파티션 설정 편집** 또는 **구성 편집**을 선택합니다.

1. 필요에 따라 파티션 수 또는 구성을 업데이트합니다.

1. **저장**을 선택합니다.

# 를 사용하여 주제 업데이트 AWS CLI
<a name="update-topic-cli"></a>

다음 명령을 실행하여 *ClusterArn*을 클러스터의 Amazon 리소스 이름(ARN)으로 바꾸고 *TopicName*을 업데이트하려는 주제의 이름으로 바꿉니다.

```
aws kafka update-topic --cluster-arn ClusterArn --topic-name TopicName --partition-count 6
```

이 명령의 출력은 다음 JSON 예제와 같습니다.

```
{
    "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
    "topicName": "MyTopic",
    "status": "UPDATING"
}
```

# API를 사용하여 주제 업데이트
<a name="update-topic-api"></a>

API를 사용하여 주제를 업데이트하려면 [UpdateTopic](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname.html#UpdateTopic)을 참조하세요.

# Amazon MSK 클러스터에서 주제 삭제
<a name="msk-delete-topic"></a>

주제를 삭제하면 모든 데이터, 메타데이터 및 파티션 정보가 영구적으로 제거됩니다. 이 작업은 실행 취소할 수 없습니다.

**Topics**
+ [를 사용하여 주제 삭제 AWS Management Console](delete-topic-console.md)
+ [를 사용하여 주제 삭제 AWS CLI](delete-topic-cli.md)
+ [API를 사용하여 주제 삭제](delete-topic-api.md)

# 를 사용하여 주제 삭제 AWS Management Console
<a name="delete-topic-console"></a>

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.

1. 클러스터 목록에서 삭제하려는 주제가 포함된 클러스터의 이름을 선택합니다.

1. 클러스터 세부 정보 페이지에서 **주제** 탭을 선택합니다.

1. 삭제할 주제를 선택한 다음 **작업**에서 **삭제**를 선택합니다.

1. 삭제를 확인한 다음 **삭제**를 선택합니다.

# 를 사용하여 주제 삭제 AWS CLI
<a name="delete-topic-cli"></a>

다음 명령을 실행하여 *ClusterArn*을 클러스터의 Amazon 리소스 이름(ARN)으로 바꾸고 *TopicName*을 삭제하려는 주제의 이름으로 바꿉니다.

```
aws kafka delete-topic --cluster-arn ClusterArn --topic-name TopicName
```

이 명령의 출력은 다음 JSON 예제와 같습니다.

```
{
    "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
    "topicName": "MyTopic",
    "status": "DELETING"
}
```

# API를 사용하여 주제 삭제
<a name="delete-topic-api"></a>

API를 사용하여 주제를 삭제하려면 [DeleteTopic](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname.html#DeleteTopic)을 참조하세요.