기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 서비스 연결 역할을 사용하여 OpenSearch Ingestion 파이프라인 생성
Amazon OpenSearch Ingestion은 AWS Identity and Access Management (IAM) [서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) 사용합니다. 서비스 연결 역할은 OpenSearch Ingestion에 직접 연결된 고유한 유형의 IAM 역할입니다. 서비스 연결 역할은 OpenSearch Ingestion에서 사전 정의하며 사용자를 대신하여 서비스에서 다른 AWS 서비스를 호출하는 데 필요한 모든 권한을 포함합니다.
자체 관리형 VPC를 사용하는 경우 **AWSServiceRoleForOpensearchIngestionSelfManagedVpce**라는 서비스 연결 역할을 사용할 때를 제외하면 OpenSearch Ingestion은 **AWSServiceRoleForAmazonOpenSearchIngestionService**라는 서비스 연결 역할을 사용합니다. 첨부된 정책은 계정과 OpenSearch Ingestion 간에 Virtual Private Cloud(VPC)를 생성하고 CloudWatch 지표를 계정에 게시하는 데 필요한 권한을 제공합니다.
## 권한
`AWSServiceRoleForAmazonOpenSearchIngestionService` 서비스 연결 역할은 역할을 수임하기 위해 다음 서비스를 신뢰합니다.
+ `osis.amazonaws.com`
`AmazonOpenSearchIngestionServiceRolePolicy`라는 이름의 역할 권한 정책은 OpenSearch Ingestion이 지정된 리소스에서 다음 작업을 완료하도록 허용합니다.
+ 작업: `cloudwatch:namespace": "AWS/OSIS"`에 대한 `cloudwatch:PutMetricData`
+ 작업: `arn:aws:ec2:*:*:network-interface/*`에 대한 `ec2:CreateTags`
+ 작업: `*`에 대한 `ec2:CreateVpcEndpoint`
+ 작업: `*`에 대한 `ec2:DeleteVpcEndpoints`
+ 작업: `*`에 대한 `ec2:DescribeSecurityGroups`
+ 작업: `*`에 대한 `ec2:DescribeSubnets`
+ 작업: `*`에 대한 `ec2:DescribeVpcEndpoints`
+ 작업: `*`에 대한 `ec2:ModifyVpcEndpoint`
`AWSServiceRoleForOpensearchIngestionSelfManagedVpce` 서비스 연결 역할은 역할을 수임하기 위해 다음 서비스를 신뢰합니다.
+ `self-managed-vpce.osis.amazonaws.com`
`OpenSearchIngestionSelfManagedVpcePolicy`라는 이름의 역할 권한 정책은 OpenSearch Ingestion이 지정된 리소스에서 다음 작업을 완료하도록 허용합니다.
+ 작업: `*`에 대한 `ec2:DescribeSubnets`
+ 작업: `*`에 대한 `ec2:DescribeSecurityGroups`
+ 작업: `*`에 대한 `ec2:DescribeVpcEndpoints`
+ 작업: `cloudwatch:namespace": "AWS/OSIS"`에 대한 `cloudwatch:PutMetricData`
IAM 엔터티(사용자, 그룹, 역할 등)가 서비스 링크 역할을 생성하고 편집하거나 삭제할 수 있도록 권한을 구성할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [서비스 연결 역할 권한](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)을 참조하세요.
## OpenSearch Ingestion에 대한 서비스 연결 역할 생성
서비스 연결 역할은 수동으로 생성할 필요가 없습니다. AWS Management Console, AWS CLI또는 AWS API에서 [ OpenSearch Ingestion 파이프라인을 생성](creating-pipeline.md#create-pipeline)하면 OpenSearch Ingestion이 서비스 연결 역할을 생성합니다.
이 서비스 연결 역할을 삭제했다가 다시 생성해야 하는 경우 동일한 프로세스를 사용하여 계정에서 역할을 다시 생성할 수 있습니다. OpenSearch Ingestion 파이프라인을 생성할 때 OpenSearch Ingestion은 서비스 연결 역할을 다시 생성합니다.
## OpenSearch Ingestion에 대한 서비스 연결 역할 편집
DAX에서는 `AWSServiceRoleForAmazonOpenSearchIngestionService` 서비스 연결 역할을 편집하도록 허용하지 않습니다. 서비스 연결 역할을 생성한 후에는 다양한 개체가 역할을 참조할 수 있기 때문에 역할 이름을 변경할 수 없습니다. 하지만 IAM을 사용하여 역할의 설명을 편집할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [서비스 연결 역할 편집](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)을 참조하세요.
## OpenSearch Ingestion에 대한 서비스 연결 역할 삭제
서비스 연결 역할이 필요한 기능 또는 서비스가 더 이상 필요 없는 경우에는 해당 역할을 삭제할 것을 권합니다. 이렇게 하면 적극적으로 모니터링하거나 유지 관리하지 않은 미사용 엔터티가 없습니다. 단, 서비스 연결 역할에 대한 리소스를 먼저 정리해야 수동으로 삭제할 수 있습니다.
### 서비스 연결 역할을 정리
IAM을 사용하여 서비스 연결 역할을 삭제하기 전에 먼저 역할에서 사용되는 리소스를 삭제해야 합니다.
**참고**
리소스를 삭제하려고 할 때 OpenSearch Ingestion이 역할을 사용 중이면 삭제에 실패할 수 있습니다. 이 문제가 발생하면 몇 분 기다렸다가 작업을 다시 시도하세요.
**`AWSServiceRoleForAmazonOpenSearchIngestionService` 또는 `AWSServiceRoleForOpensearchIngestionSelfManagedVpce` 역할에서 사용하는 OpenSearch Ingestion 리소스를 삭제하는 방법**
1. Amazon OpenSearch Service 콘솔로 이동하고 **수집**을 선택합니다.
1. 모든 파이프라인을 삭제합니다. 지침은 [Amazon OpenSearch Ingestion 파이프라인 삭제](delete-pipeline.md) 섹션을 참조하세요.
### OpenSearch Ingestion에 대한 서비스 연결 역할 삭제
콘솔을 사용하여 서비스 연결 역할을 삭제할 수 있습니다.
**서비스 연결 역할을 삭제하는 방법(콘솔)**
1. IAM 콘솔로 이동합니다.
1. **역할**을 선택하고 **AWSServiceRoleForAmazonOpenSearchIngestionService** 또는 **AWSServiceRoleForOpensearchIngestionSelfManagedVpce** 역할을 검색합니다.
1. 역할을 선택하고 **삭제**를 선택합니다.