AWS 문서 AWS SDK SDK 예제
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeInstanceInformation
OR와 함께 사용 AWS SDK CLI
다음 코드 예제는 DescribeInstanceInformation
의 사용 방법을 보여 줍니다.
- CLI
-
- AWS CLI
-
예제 1: 관리형 인스턴스 정보를 설명하는 방법
다음
describe-instance-information
예제에서는 각 관리형 인스턴스의 세부 정보를 검색합니다.aws ssm describe-instance-information
예제 2: 특정 관리형 인스턴스에 대한 정보를 설명하는 방법
다음
describe-instance-information
예제에서는 관리형 인스턴스i-028ea792daEXAMPLE
의 세부 정보를 보여줍니다.aws ssm describe-instance-information \ --filters
"Key=InstanceIds,Values=i-028ea792daEXAMPLE"
예제 3: 특정 태그 키를 사용하는 관리형 인스턴스에 대한 정보를 설명하는 방법
다음
describe-instance-information
예제에서는 태그 키DEV
가 있는 관리형 인스턴스의 세부 정보를 보여줍니다.aws ssm describe-instance-information \ --filters
"Key=tag-key,Values=DEV"
출력:
{ "InstanceInformationList": [ { "InstanceId": "i-028ea792daEXAMPLE", "PingStatus": "Online", "LastPingDateTime": 1582221233.421, "AgentVersion": "2.3.842.0", "IsLatestVersion": true, "PlatformType": "Linux", "PlatformName": "SLES", "PlatformVersion": "15.1", "ResourceType": "EC2Instance", "IPAddress": "192.0.2.0", "ComputerName": "ip-198.51.100.0.us-east-2.compute.internal", "AssociationStatus": "Success", "LastAssociationExecutionDate": 1582220806.0, "LastSuccessfulAssociationExecutionDate": 1582220806.0, "AssociationOverview": { "DetailedStatus": "Success", "InstanceAssociationStatusAggregatedCount": { "Success": 2 } } } ] }
자세한 내용은 AWS Systems Manager 사용 설명서의 관리형 인스턴스를 참조하세요.
-
자세한 API 내용은 AWS CLI 명령 DescribeInstanceInformation
참조를 참조하십시오.
-
- PowerShell
-
- 도구: PowerShell
-
예제 1: 이 예제에서는 각 인스턴스의 세부 정보를 보여줍니다.
Get-SSMInstanceInformation
출력:
ActivationId : AgentVersion : 2.0.672.0 AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview AssociationStatus : Success ComputerName : ip-172-31-44-222.us-west-2.compute.internal IamRole : InstanceId : i-0cb2b964d3e14fd9f IPAddress : 172.31.44.222 IsLatestVersion : True LastAssociationExecutionDate : 2/24/2017 3:18:09 AM LastPingDateTime : 2/24/2017 3:35:03 AM LastSuccessfulAssociationExecutionDate : 2/24/2017 3:18:09 AM Name : PingStatus : ConnectionLost PlatformName : Amazon Linux AMI PlatformType : Linux PlatformVersion : 2016.09 RegistrationDate : 1/1/0001 12:00:00 AM ResourceType : EC2Instance
예 2: 이 예제에서는 -Filter 매개 변수를 사용하여 a가
us-east-1
있는 지역의 AWS Systems Manager 인스턴스로만 결과를 필터링하는 방법을 보여줍니다.AgentVersion
2.2.800.0
유효한 -Filter 키 값 목록은 InstanceInformation API 참조 항목 (https://docs.aws.amazon.com/systems-manager/최신/APIReference/API_ InstanceInformation .html #systemsmanager -Type- -) 에서 찾을 수 있습니다. InstanceInformation ActivationId$Filters = @{ Key="AgentVersion" Values="2.2.800.0" } Get-SSMInstanceInformation -Region us-east-1 -Filter $Filters
출력:
ActivationId : AgentVersion : 2.2.800.0 AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview AssociationStatus : Success ComputerName : EXAMPLE-EXAMPLE.WORKGROUP IamRole : InstanceId : i-EXAMPLEb0792d98ce IPAddress : 10.0.0.01 IsLatestVersion : False LastAssociationExecutionDate : 8/16/2018 12:02:50 AM LastPingDateTime : 8/16/2018 7:40:27 PM LastSuccessfulAssociationExecutionDate : 8/16/2018 12:02:50 AM Name : PingStatus : Online PlatformName : Microsoft Windows Server 2016 Datacenter PlatformType : Windows PlatformVersion : 10.0.14393 RegistrationDate : 1/1/0001 12:00:00 AM ResourceType : EC2Instance ActivationId : AgentVersion : 2.2.800.0 AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview AssociationStatus : Success ComputerName : EXAMPLE-EXAMPLE.WORKGROUP IamRole : InstanceId : i-EXAMPLEac7501d023 IPAddress : 10.0.0.02 IsLatestVersion : False LastAssociationExecutionDate : 8/16/2018 12:00:20 AM LastPingDateTime : 8/16/2018 7:40:35 PM LastSuccessfulAssociationExecutionDate : 8/16/2018 12:00:20 AM Name : PingStatus : Online PlatformName : Microsoft Windows Server 2016 Datacenter PlatformType : Windows PlatformVersion : 10.0.14393 RegistrationDate : 1/1/0001 12:00:00 AM ResourceType : EC2Instance
예 3: 이 예에서는 - InstanceInformationFilterList 매개변수를 사용하여
Windows
또는 가 있는 지역의 AWSus-east-1
Systems Manager 인스턴스로만 결과를 필터링하는 방법을 보여줍니다Linux
.PlatformTypes
InstanceInformationFilter API참조 항목 (https://docs.aws.amazon.com/systems-manager/최신/APIReference/API_ InstanceInformationFilter .html) 에서 유효한 - InstanceInformationFilterList 키 값 목록을 찾을 수 있습니다.$Filters = @{ Key="PlatformTypes" ValueSet=("Windows","Linux") } Get-SSMInstanceInformation -Region us-east-1 -InstanceInformationFilterList $Filters
출력:
ActivationId : AgentVersion : 2.2.800.0 AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview AssociationStatus : Success ComputerName : EXAMPLE-EXAMPLE.WORKGROUP IamRole : InstanceId : i-EXAMPLEb0792d98ce IPAddress : 10.0.0.27 IsLatestVersion : False LastAssociationExecutionDate : 8/16/2018 12:02:50 AM LastPingDateTime : 8/16/2018 7:40:27 PM LastSuccessfulAssociationExecutionDate : 8/16/2018 12:02:50 AM Name : PingStatus : Online PlatformName : Ubuntu Server 18.04 LTS PlatformType : Linux PlatformVersion : 18.04 RegistrationDate : 1/1/0001 12:00:00 AM ResourceType : EC2Instance ActivationId : AgentVersion : 2.2.800.0 AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview AssociationStatus : Success ComputerName : EXAMPLE-EXAMPLE.WORKGROUP IamRole : InstanceId : i-EXAMPLEac7501d023 IPAddress : 10.0.0.100 IsLatestVersion : False LastAssociationExecutionDate : 8/16/2018 12:00:20 AM LastPingDateTime : 8/16/2018 7:40:35 PM LastSuccessfulAssociationExecutionDate : 8/16/2018 12:00:20 AM Name : PingStatus : Online PlatformName : Microsoft Windows Server 2016 Datacenter PlatformType : Windows PlatformVersion : 10.0.14393 RegistrationDate : 1/1/0001 12:00:00 AM ResourceType : EC2Instance
예 4: 이 예제에서는 ssm 관리형 인스턴스 및 내보내기와 csv 파일에 대한 InstanceId PlatformName 내보내기를 나열합니다. PingStatus LastPingDateTime
Get-SSMInstanceInformation | Select-Object InstanceId, PingStatus, LastPingDateTime, PlatformName | Export-Csv Instance-details.csv -NoTypeInformation
-
자세한 API 내용은 AWS Tools for PowerShell Cmdlet DescribeInstanceInformation참조를 참조하십시오.
-