Amazon EC2 역할용 인스턴스 프로필 태그 지정

Amazon EC2 역할용 인스턴스 프로필 태그 지정 (Tag instance profiles for Amazon EC2 roles)

Amazon EC2 인스턴스를 시작할 때 인스턴스와 연결할 IAM 역할을 지정해요. 인스턴스 프로필(instance profile)은 IAM 역할의 컨테이너로, 인스턴스가 시작될 때 역할 정보를 Amazon EC2 인스턴스에 전달하는 데 사용해요. 인스턴스 프로필 태그는 AWS CLI 또는 AWS API를 쓸 때 지정할 수 있어요.

출처: 문서

본문

IAM 태그 키-값 쌍을 사용해 인스턴스 프로필에 커스텀 속성을 추가할 수 있어요. 예를 들어 인스턴스 프로필에 부서 정보를 추가하려면 태그 키 access-team과 태그 값 eng를 넣으면 돼요. 이렇게 하면 일치하는 태그를 가진 프린시펄에게 같은 태그를 가진 인스턴스 프로필에 대한 접근 권한이 생겨요. 팀과 프로젝트를 지정하려면 여러 태그 키-값 쌍을 쓸 수 있어요: access-team = eng, project = peg. 태그로 사용자의 리소스 접근을 제어하거나, 사용자에 붙일 수 있는 태그를 제어할 수 있어요. 태그로 접근을 제어하는 방법은 태그를 이용한 IAM 사용자와 역할에 대한 접근 제어를 참고하세요.

AWS STS에서 태그를 사용해 역할을 수임하거나 사용자를 페더레이션할 때 커스텀 속성을 추가할 수도 있어요. 자세한 내용은 AWS STS에서 세션 태그 전달을 참고하세요.

인스턴스 프로필 태그 지정에 필요한 권한

IAM 엔터티(사용자·역할)가 인스턴스 프로필에 태그를 달려면 권한을 구성해야 해요. IAM 정책에서 다음 IAM 태그 작업 중 하나 또는 전부를 지정할 수 있어요.

  • iam:ListInstanceProfileTags
  • iam:TagInstanceProfile
  • iam:UntagInstanceProfile
인스턴스 프로필에 태그를 추가·나열·제거하도록 IAM 엔터티(사용자·역할) 허용

태그를 관리해야 하는 IAM 엔터티의 권한 정책에 다음 스테이트먼트를 추가해요. 계정 번호를 쓰고, 태그를 관리할 인스턴스 프로필의 이름으로 <InstanceProfileName>을 바꿔요. 만들기 방법은 JSON 에디터로 정책 만들기를 참고하세요.

{
    "Effect": "Allow",
    "Action": [
        "iam:ListInstanceProfileTags",
        "iam:TagInstanceProfile",
        "iam:UntagInstanceProfile"
    ],
    "Resource": "arn:aws:iam::<account-number>:instance-profile/<InstanceProfileName>"
}
특정 인스턴스 프로필에 태그를 추가하도록 IAM 엔터티(사용자·역할) 허용

특정 인스턴스 프로필의 태그를 추가(제거는 안 함)할 IAM 엔터티에게 필요한 권한 정책에 다음 스테이트먼트를 추가해요.

참고

iam:TagInstanceProfile 작업은 iam:ListInstanceProfileTags 작업도 함께 포함해야 해요.

이 정책을 쓰려면 태그를 관리할 인스턴스 프로필의 이름으로 <InstanceProfileName>을 바꿔요. 만들기 방법은 JSON 에디터로 정책 만들기를 참고하세요.

{
    "Effect": "Allow",
    "Action": [
        "iam:ListInstanceProfileTags",
        "iam:TagInstanceProfile"
    ],
    "Resource": "arn:aws:iam::<account-number>:instance-profile/<InstanceProfileName>"
}

대안으로, IAMFullAccess 같은 AWS 관리형 정책을 사용해 IAM에 대한 전체 접근을 제공할 수도 있어요.

인스턴스 프로필 태그 관리 (AWS CLI 또는 AWS API)

인스턴스 프로필 태그를 나열·연결·제거할 수 있어요. AWS CLI 또는 AWS API로 관리할 수 있어요.

인스턴스 프로필에 현재 연결된 태그 나열 (AWS CLI 또는 AWS API)
  • AWS CLI: aws iam list-instance-profile-tags
  • AWS API: ListInstanceProfileTags
인스턴스 프로필에 태그 연결 (AWS CLI 또는 AWS API)
  • AWS CLI: aws iam tag-instance-profile
  • AWS API: TagInstanceProfile
인스턴스 프로필에서 태그 제거 (AWS CLI 또는 AWS API)
  • AWS CLI: aws iam untag-instance-profile
  • AWS API: UntagInstanceProfile

다른 AWS 서비스의 리소스에 태그를 연결하는 방법은 각 서비스의 문서를 참고하세요.

IAM 권한 정책으로 더 세분화된 권한을 설정하기 위해 태그를 사용하는 방법은 IAM 정책 요소: 변수와 태그를 참고하세요.

더 알아보기 (Learn more)