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

# 인스턴스 데이터 백(aws\$1opsworks\$1instance)
<a name="data-bag-json-instance"></a>

**중요**  
이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요.

인스턴스의 설정을 나타냅니다.

다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 인스턴스의 호스트 이름과 ID를 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다.

```
instance = search("aws_opsworks_instance").first
Chef::Log.info("********** The instance's hostname is '#{instance['hostname']}' **********")
Chef::Log.info("********** The instance's ID is '#{instance['instance_id']}' **********")

search("aws_opsworks_instance").each do |instance|
  Chef::Log.info("********** The instance's hostname is '#{instance['hostname']}' **********")
  Chef::Log.info("********** The instance's ID is '#{instance['instance_id']}' **********")
end
```

다음 예제는 다중 데이터 백 항목을 검색하여 지정된 Amazon EC2 인스턴스 ID를 포함하는 데이터 백 항목을 찾기 위해 Chef 검색을 사용하는 다양한 방법을 보여줍니다. 그런 다음 이 예제는 데이터 백 항목의 콘텐츠를 사용하여 해당 인스턴스의 퍼블릭 IP 주소를 포함하는 메시지를 Chef 로그에 기록합니다.

```
instance = search("aws_opsworks_instance", "ec2_instance_id:i-12345678").first
Chef::Log.info("********** For instance '#{instance['ec2_instance_id']}', the instance's public IP address is '#{instance['public_ip']}' **********")
 
search("aws_opsworks_instance").each do |instance|
  if instance['ec2_instance_id'] == 'i-12345678'
    Chef::Log.info("********** For instance '#{instance['ec2_instance_id']}', the instance's public IP address is '#{instance['public_ip']}' **********")
  end
end
```

다음 예제는 `self:true`로 설정된 Chef 검색을 사용하여 레시피가 실행되는 인스턴스와 관련된 정보를 포함하는 데이터 항목을 찾는 방법을 보여줍니다. 그런 다음이 예제에서는 데이터 백 항목의 콘텐츠를 사용하여 해당 인스턴스의 OpsWorks Stacks 생성 ID와 인스턴스의 퍼블릭 IP 주소를 사용하여 Chef 로그에 메시지를 작성합니다.

```
instance = search("aws_opsworks_instance", "self:true").first
Chef::Log.info("********** For instance '#{instance['instance_id']}', the instance's public IP address is '#{instance['public_ip']}' **********")
```


****  

|  |  |  | 
| --- |--- |--- |
| [ami\$1id](#data-bag-json-instance-ami) | [구조](#data-bag-json-instance-arch) | [auto\$1scaling\$1type](#data-bag-json-instance-autoscaling) | 
| [availability\$1zone](#data-bag-json-instance-az) | [created\$1at](#data-bag-json-instance-created-at) | [ebs\$1optimized](#data-bag-json-instance-ebs-optimized) | 
| [ec2\$1instance\$1id](#data-bag-json-instance-ec2-id) | [elastic\$1ip](#data-bag-json-instance-elastic-ip) | [hostname](#data-bag-json-instance-hostname) | 
| [instance-id](#data-bag-json-instance-id) | [instance\$1type](#data-bag-json-instance-type) | [layer\$1ids](#data-bag-json-instance-layers) | 
| [os](#data-bag-json-instance-os) | [private\$1dns](#data-bag-json-instance-private-dns) | [private\$1ip](#data-bag-json-instance-private-ip) | 
| [public\$1dns](#data-bag-json-instance-public-dns) | [public\$1ip](#data-bag-json-instance-public-ip) | [root\$1device\$1type](#data-bag-json-instance-root-device-type) | 
| [root\$1device\$1volume\$1id](#data-bag-json-instance-root-device-volume-id) | [self](#data-bag-json-instance-self) | [ssh\$1host\$1dsa\$1key\$1fingerprint](#data-bag-json-instance-ssh-host-dsa-key-fingerprint) | 
| [ssh\$1host\$1dsa\$1key\$1private](#data-bag-json-instance-ssh-host-dsa-key-private) | [ssh\$1host\$1dsa\$1key\$1public](#data-bag-json-instance-ssh-host-dsa-key-public) | [ssh\$1host\$1rsa\$1key\$1fingerprint](#data-bag-json-instance-ssh-host-rsa-key-fingerprint) | 
| [ssh\$1host\$1rsa\$1key\$1private](#data-bag-json-instance-ssh-host-rsa-key-private) | [ssh\$1host\$1rsa\$1key\$1public](#data-bag-json-instance-ssh-host-rsa-key-public) | [status](#data-bag-json-instance-status) | 
| [subnet\$1id](#data-bag-json-instance-subnet-id) | [virtualization\$1type](#data-bag-json-instance-virt-type) |  | 

**ami\$1id**  <a name="data-bag-json-instance-ami"></a>
인스턴스의 AMI(Amazon 머신 이미지) ID(문자열).

**구조**  <a name="data-bag-json-instance-arch"></a>
인스턴스의 아키텍처(문자열). 항상 `"x86_64"`로 설정됩니다.

**auto\$1scaling\$1type**  <a name="data-bag-json-instance-autoscaling"></a>
인스턴스의 조정 유형(문자열): `null`, `timer` 또는 `load`.

**availability\$1zone**  <a name="data-bag-json-instance-az"></a>
인스턴스의 가용 영역(AZ)(문자열), 예: `"us-west-2a"`.

**created\$1at**  <a name="data-bag-json-instance-created-at"></a>
인스턴스가 생성된 UTC `"yyyy-mm-dddThh:mm:ss+hh:mm"` 형식 시간(문자열). 예를 들어 `"2013-10-01T08:35:22+00:00"`은 2013년 10월 10일 8:35:22에 해당합니다(시간대 오프셋 없음). 자세한 정보는 [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601)를 참조하세요.

**ebs\$1optimized**  <a name="data-bag-json-instance-ebs-optimized"></a>
인스턴스가 EBS 최적화되었는지 여부(부울).

**ec2\$1instance\$1id**  <a name="data-bag-json-instance-ec2-id"></a>
EC2 인스턴스 ID(문자열).

**elastic\$1ip**  <a name="data-bag-json-instance-elastic-ip"></a>
탄력적 IP 주소(문자열). 인스턴스에 탄력적 IP 주소가 없으면 `"null"`로 설정됩니다.

**hostname**  <a name="data-bag-json-instance-hostname"></a>
호스트 이름(문자열), 예: `"demo1"`.

**instance-id**  <a name="data-bag-json-instance-id"></a>
인스턴스를 고유하게 식별하는 OpsWorks Stacks 생성 GUID인 인스턴스 ID(문자열).

**instance\$1type**  <a name="data-bag-json-instance-type"></a>
인스턴스 유형(문자열), 예: `"c1.medium"`.

**layer\$1ids**  <a name="data-bag-json-instance-layers"></a>
고유 ID(예: `307ut64c-c7e4-40cc-52f0-67d5k1f9992c`)로 식별되는 인스턴스 내 계층의 목록.

**os**  <a name="data-bag-json-instance-os"></a>
인스턴스의 운영 체제(문자열). 유효한 값으로는 다음이 포함됩니다.  
+ `"Amazon Linux 2"`
+ `"Amazon Linux 2018.03"`
+ `"Amazon Linux 2017.09"`
+ `"Amazon Linux 2017.03"`
+ `"Amazon Linux 2016.09"`
+ `"Custom"`
+ `"Microsoft Windows Server 2022 Base"`
+ `"Microsoft Windows Server 2022 with SQL Server Express"`
+ `"Microsoft Windows Server 2022 with SQL Server Standard"`
+ `"Microsoft Windows Server 2022 with SQL Server Web"`
+ `"Microsoft Windows Server 2019 Base"`
+ `"Microsoft Windows Server 2019 with SQL Server Express"`
+ `"Microsoft Windows Server 2019 with SQL Server Standard"`
+ `"Microsoft Windows Server 2019 with SQL Server Web"`
+ `"CentOS 7"`
+ `"Red Hat Enterprise Linux 7"`
+ `"Ubuntu 20.04 LTS"`
+ `"Ubuntu 18.04 LTS"`
+ `"Ubuntu 16.04 LTS"`
+ `"Ubuntu 14.04 LTS"`

**private\$1dns**  <a name="data-bag-json-instance-private-dns"></a>
프라이빗 DNS 이름(문자열).

**private\$1ip**  <a name="data-bag-json-instance-private-ip"></a>
프라이빗 IP 주소(문자열).

**public\$1dns**  <a name="data-bag-json-instance-public-dns"></a>
퍼블릭 DNS 이름(문자열).

**public\$1ip**  <a name="data-bag-json-instance-public-ip"></a>
퍼블릭 IP 주소(문자열).

**root\$1device\$1type**  <a name="data-bag-json-instance-root-device-type"></a>
루트 디바이스 유형(문자열). 유효한 값으로는 다음이 포함됩니다.  
+ `"ebs`
+ `"instance-store"`

**root\$1device\$1volume\$1id**  <a name="data-bag-json-instance-root-device-volume-id"></a>
루트 디바이스의 볼륨 ID(문자열).

**self**  <a name="data-bag-json-instance-self"></a>
이 데이터 백 항목에 레시피가 실행되는 인스턴스에 대한 정보가 포함되면 `true`, 그렇지 않으면 `false`(부울). 이 값은 OpsWorks Stacks API를 통하지 않고 레시피에만 사용할 수 있습니다.

**ssh\$1host\$1dsa\$1key\$1fingerprint**  <a name="data-bag-json-instance-ssh-host-dsa-key-fingerprint"></a>
더 긴 DSA 퍼블릭 키를 식별하는 더 짧은 바이트 시퀀스(문자열).

**ssh\$1host\$1dsa\$1key\$1private**  <a name="data-bag-json-instance-ssh-host-dsa-key-private"></a>
인스턴스에 대한 SSH 인증용 DSA 생성 프라이빗 키(문자열).

**ssh\$1host\$1dsa\$1key\$1public**  <a name="data-bag-json-instance-ssh-host-dsa-key-public"></a>
인스턴스에 대한 SSH 인증용 DSA 생성 퍼블릭 키(문자열).

**ssh\$1host\$1rsa\$1key\$1fingerprint**  <a name="data-bag-json-instance-ssh-host-rsa-key-fingerprint"></a>
더 긴 RSA 퍼블릭 키를 식별하는 더 짧은 바이트 시퀀스(문자열).

**ssh\$1host\$1rsa\$1key\$1private**  <a name="data-bag-json-instance-ssh-host-rsa-key-private"></a>
인스턴스에 대한 SSH 인증용 RSA 생성 프라이빗 키(문자열).

**ssh\$1host\$1rsa\$1key\$1public**  <a name="data-bag-json-instance-ssh-host-rsa-key-public"></a>
인스턴스에 대한 SSH 인증용 RSA 생성 퍼블릭 키(문자열).

**status**  <a name="data-bag-json-instance-status"></a>
인스턴스의 상태(문자열). 유효한 값으로는 다음이 포함됩니다.  
+ `"requested"`
+ `"booting"`
+ `"running_setup"`
+ `"online"`
+ `"setup_failed"`
+ `"start_failed"`
+ `"terminating"`
+ `"terminated"`
+ `"stopped"`
+ `"connection_lost"`

**subnet\$1id**  <a name="data-bag-json-instance-subnet-id"></a>
인스턴스의 서브넷 ID(문자열).

**virtualization\$1type**  <a name="data-bag-json-instance-virt-type"></a>
인스턴스의 가상화 유형(문자열).