

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

# 구성 요소 세부 정보 나열 및 보기
<a name="component-details"></a>

이 섹션에서는 EC2 Image Builder 레시피에서 사용하는 구성 요소에 대한 정보를 찾고 세부 정보를 보는 방법을 설명합니다.

**Topics**
+ [Image Builder 구성 요소 나열](#list-components)
+ [에서 구성 요소 빌드 버전 나열 AWS CLI](#cli-list-component-versions)
+ [에서 구성 요소 세부 정보 가져오기 AWS CLI](#cli-get-component)
+ [에서 구성 요소 정책 세부 정보 가져오기 AWS CLI](#cli-get-component-policy)

## Image Builder 구성 요소 나열
<a name="list-components"></a>

다음 방법 중 하나를 사용하여 Image Builder 구성 요소를 나열하고 필터링할 수 있습니다.

------
#### [ AWS Management Console ]

에 구성 요소 목록을 표시하려면 다음 단계를 AWS Management Console따릅니다.

1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)에서 EC2 Image Builder 콘솔을 엽니다.

1. 탐색 창에서 **구성 요소**를 선택합니다. 기본적으로 Image Builder는 사용자 계정이 소유한 구성 요소 목록을 표시합니다.

1. 구성 요소 소유권을 기준으로 필터링할 수도 있습니다. 소유하지는 않지만 액세스할 수 있는 구성 요소를 보려면 소유자 유형 드롭다운 목록을 확장하고 값 중 하나를 선택하십시오. 소유자 유형 목록은 검색 표시줄의 검색 텍스트 상자 옆에 있습니다. 다음 값을 사용할 수 있습니다.
   + **AWS Marketplace** - AWS Marketplace 제품 구독과 직접 연결된 구성 요소입니다.
   + **빠른 시작(Amazon 관리)** - Amazon이 생성하고 유지 관리하는 공개적으로 사용 가능한 구성 요소입니다.
   + **본인 소유** - 사용자가 만든 구성 요소입니다. 이는 기본 선택입니다.
   + **나와 공유한 구성 요소** - 다른 사용자가 자신의 계정으로 생성하고 사용자와 공유한 구성 요소입니다.
   + **타사 관리**형 - 사용자가 구독한 타사가 소유한 구성 요소입니다 AWS Marketplace.

------
#### [ AWS CLI ]

다음 예제는 **[list-components](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-components.html)** 명령을 사용하여 계정이 소유한 Image Builder 구성 요소 목록을 반환하는 방법을 보여줍니다.

```
aws imagebuilder list-components
```

구성 요소 소유권을 기준으로 필터링할 수도 있습니다. 사용자 속성은 나열하려는 구성 요소를 소유하는 사람을 정의합니다. 기본적으로 이 요청은 계정이 소유한 구성 요소 목록을 반환합니다. 구성 요소 소유자별로 결과를 필터링하려면, **list-components** 명령을 실행할 때 `--owner` 매개 변수와 함께 다음 값 중 하나를 지정하십시오.

**구성 요소 소유자 값**
+ `AWSMarketplace`
+ `Amazon`
+ `Self`
+ `Shared`
+ `ThirdParty`

다음 예제는 결과를 필터링하기 위한 `--owner` 매개 변수가 포함된 **list-components** 명령을 보여줍니다.

```
aws imagebuilder list-components --owner Self
{
    "requestId": "012a3456-b789-01cd-e234-fa5678b9012b",
    "componentVersionList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.0",
            "name": "sample-component01",
            "version": "1.0.0",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2020-09-24T16:58:24.444Z"
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.1",
            "name": "sample-component01",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2021-07-10T03:38:46.091Z"
        }
    ]
}
```

```
aws imagebuilder list-components --owner Amazon
```

```
aws imagebuilder list-components --owner Shared
```

```
aws imagebuilder list-components --owner ThirdParty
```

------

## 에서 구성 요소 빌드 버전 나열 AWS CLI
<a name="cli-list-component-versions"></a>

다음 예시는 **[list-component-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-component-build-versions.html)** 명령을 사용하여 특정 의미 체계 버전이 있는 구성 요소 빌드 버전을 나열하는 방법을 보여줍니다. Image Builder 리소스의 시맨틱 버전 관리에 대한 자세한 내용은 [Image Builder의 의미 체계 버전 관리](ibhow-semantic-versioning.md)(을)를 참조하십시오.

```
aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1
{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "componentSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
            "name": "examplecomponent",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "description": "An example component that builds, validates and tests an image",
            "changeDescription": "Updated version.",
            "dateCreated": "2020-02-19T18:53:45.940Z",
            "tags": {
                "KeyName": "KeyValue"
            }
        }
    ]
}
```

## 에서 구성 요소 세부 정보 가져오기 AWS CLI
<a name="cli-get-component"></a>

다음 예제는 구성 요소의 Amazon 리소스 이름(ARN)을 지정할 때 **[get-component](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component.html)** 명령을 사용하여 구성 요소 세부 정보를 가져오는 방법을 보여줍니다.

```
aws imagebuilder get-component --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1/1
			{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11112",
    "component": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
        "name": "examplecomponent",
        "version": "1.0.1",
        "type": "BUILD",
        "platform": "Linux",
        "owner": "123456789012",
        "data": "name: HelloWorldTestingDocument\ndescription: This is hello world testing document... etc.\"\n",
        "encrypted": true,
        "dateCreated": "2020-09-24T16:58:24.444Z",
        "tags": {}
    }
}
```

## 에서 구성 요소 정책 세부 정보 가져오기 AWS CLI
<a name="cli-get-component-policy"></a>

다음 예제는 구성 요소의 ARN을 지정할 때 **[get-component-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component-policy.html)** 명령을 사용하여 구성 요소 정책의 세부 정보를 가져오는 방법을 보여줍니다.

```
aws imagebuilder get-component-policy --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1
```