# AWS CLI를 사용하는 Application Discovery Service 예제
다음 코드 예제에서는 Application Discovery Service와 함께 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `describe-agents`
다음 코드 예시는 `describe-agents`의 사용 방법을 보여줍니다.
**AWS CLI**
**지정된 collectionStatus 상태가 있는 에이전트 설명**
이 예제 명령은 수집 상태가 “STARTED” 또는 “STOPPED”인 수집 에이전트를 설명합니다.
명령:
```
aws discovery describe-agents --filters name="collectionStatus",values="STARTED","STOPPED",condition="EQUALS" --max-results 3
```
출력:
```
{
"Snapshots": [
{
"version": "1.0.40.0",
"agentType": "EC2",
"hostName": "ip-172-31-40-234",
"collectionStatus": "STOPPED",
"agentNetworkInfoList": [
{
"macAddress": "06:b5:97:14:fc:0d",
"ipAddress": "172.31.40.234"
}
],
"health": "UNKNOWN",
"agentId": "i-003305c02a776e883",
"registeredTime": "2016-12-09T19:05:06Z",
"lastHealthPingTime": "2016-12-09T19:05:10Z"
},
{
"version": "1.0.40.0",
"agentType": "EC2",
"hostName": "ip-172-31-39-64",
"collectionStatus": "STARTED",
"agentNetworkInfoList": [
{
"macAddress": "06:a1:0e:c7:b2:73",
"ipAddress": "172.31.39.64"
}
],
"health": "SHUTDOWN",
"agentId": "i-003a5e5e2b36cf8bd",
"registeredTime": "2016-11-16T16:36:25Z",
"lastHealthPingTime": "2016-11-16T16:47:37Z"
}
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeAgents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/discovery/describe-agents.html)를 참조하세요.
### `describe-configurations`
다음 코드 예시는 `describe-configurations`의 사용 방법을 보여줍니다.
**AWS CLI**
**선택한 자산 구성 설명**
이 예제 명령은 지정된 두 서버의 구성을 설명합니다. 이 작업은 구성 ID에서 자산 유형을 감지합니다. 명령당 한 가지 유형의 자산만 허용됩니다.
명령:
```
aws discovery describe-configurations --configuration-ids "d-server-099385097ef9fbcfb" "d-server-0c4f2dd1fee22c6c1"
```
출력:
```
{
"configurations": [
{
"server.performance.maxCpuUsagePct": "0.0",
"server.performance.maxDiskReadIOPS": "0.0",
"server.performance.avgCpuUsagePct": "0.0",
"server.type": "EC2",
"server.performance.maxNetworkReadsPerSecondInKB": "0.19140625",
"server.hostName": "ip-172-31-35-152",
"server.configurationId": "d-server-0c4f2dd1fee22c6c1",
"server.tags.hasMoreValues": "false",
"server.performance.minFreeRAMInKB": "1543496.0",
"server.osVersion": "3.14.48-33.39.amzn1.x86_64",
"server.performance.maxDiskReadsPerSecondInKB": "0.0",
"server.applications": "[]",
"server.performance.numDisks": "1",
"server.performance.numCpus": "1",
"server.performance.numCores": "1",
"server.performance.maxDiskWriteIOPS": "0.0",
"server.performance.maxNetworkWritesPerSecondInKB": "0.82421875",
"server.performance.avgDiskWritesPerSecondInKB": "0.0",
"server.networkInterfaceInfo": "[{\"name\":\"eth0\",\"macAddress\":\"06:A7:7D:3F:54:57\",\"ipAddress\":\"172.31.35.152\",\"netMask\":\"255.255.240.0\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"127.0.0.1\",\"netMask\":\"255.0.0.0\"},{\"name\":\"eth0\",\"macAddress\":\"06:A7:7D:3F:54:57\",\"ipAddress\":\"fe80::4a7:7dff:fe3f:5457\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"::1\"}]",
"server.performance.avgNetworkReadsPerSecondInKB": "0.04915364583333333",
"server.tags": "[]",
"server.applications.hasMoreValues": "false",
"server.timeOfCreation": "2016-10-28 23:44:00.0",
"server.agentId": "i-4447bc1b",
"server.performance.maxDiskWritesPerSecondInKB": "0.0",
"server.performance.avgDiskReadIOPS": "0.0",
"server.performance.avgFreeRAMInKB": "1547210.1333333333",
"server.performance.avgDiskReadsPerSecondInKB": "0.0",
"server.performance.avgDiskWriteIOPS": "0.0",
"server.performance.numNetworkCards": "2",
"server.hypervisor": "xen",
"server.networkInterfaceInfo.hasMoreValues": "false",
"server.performance.avgNetworkWritesPerSecondInKB": "0.1380859375",
"server.osName": "Linux - Amazon Linux AMI release 2015.03",
"server.performance.totalRAMInKB": "1694732.0",
"server.cpuType": "x64"
},
{
"server.performance.maxCpuUsagePct": "100.0",
"server.performance.maxDiskReadIOPS": "0.0",
"server.performance.avgCpuUsagePct": "14.733333333333338",
"server.type": "EC2",
"server.performance.maxNetworkReadsPerSecondInKB": "13.400390625",
"server.hostName": "ip-172-31-42-208",
"server.configurationId": "d-server-099385097ef9fbcfb",
"server.tags.hasMoreValues": "false",
"server.performance.minFreeRAMInKB": "1531104.0",
"server.osVersion": "3.14.48-33.39.amzn1.x86_64",
"server.performance.maxDiskReadsPerSecondInKB": "0.0",
"server.applications": "[]",
"server.performance.numDisks": "1",
"server.performance.numCpus": "1",
"server.performance.numCores": "1",
"server.performance.maxDiskWriteIOPS": "1.0",
"server.performance.maxNetworkWritesPerSecondInKB": "12.271484375",
"server.performance.avgDiskWritesPerSecondInKB": "0.5333333333333334",
"server.networkInterfaceInfo": "[{\"name\":\"eth0\",\"macAddress\":\"06:4A:79:60:75:61\",\"ipAddress\":\"172.31.42.208\",\"netMask\":\"255.255.240.0\"},{\"name\":\"eth0\",\"macAddress\":\"06:4A:79:60:75:61\",\"ipAddress\":\"fe80::44a:79ff:fe60:7561\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"::1\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"127.0.0.1\",\"netMask\":\"255.0.0.0\"}]",
"server.performance.avgNetworkReadsPerSecondInKB": "2.8720052083333334",
"server.tags": "[]",
"server.applications.hasMoreValues": "false",
"server.timeOfCreation": "2016-10-28 23:44:30.0",
"server.agentId": "i-c142b99e",
"server.performance.maxDiskWritesPerSecondInKB": "4.0",
"server.performance.avgDiskReadIOPS": "0.0",
"server.performance.avgFreeRAMInKB": "1534946.4",
"server.performance.avgDiskReadsPerSecondInKB": "0.0",
"server.performance.avgDiskWriteIOPS": "0.13333333333333336",
"server.performance.numNetworkCards": "2",
"server.hypervisor": "xen",
"server.networkInterfaceInfo.hasMoreValues": "false",
"server.performance.avgNetworkWritesPerSecondInKB": "1.7977864583333332",
"server.osName": "Linux - Amazon Linux AMI release 2015.03",
"server.performance.totalRAMInKB": "1694732.0",
"server.cpuType": "x64"
}
]
}
```
**선택한 자산 구성 설명**
이 예제 명령은 지정된 두 애플리케이션의 구성을 설명합니다. 이 작업은 구성 ID에서 자산 유형을 감지합니다. 명령당 한 가지 유형의 자산만 허용됩니다.
명령:
```
aws discovery describe-configurations --configuration-ids "d-application-0ac39bc0e4fad0e42" "d-application-02444a45288013764q"
```
출력:
```
{
"configurations": [
{
"application.serverCount": "0",
"application.name": "Application-12345",
"application.lastModifiedTime": "2016-12-13 23:53:27.0",
"application.description": "",
"application.timeOfCreation": "2016-12-13 23:53:27.0",
"application.configurationId": "d-application-0ac39bc0e4fad0e42"
},
{
"application.serverCount": "0",
"application.name": "Application-67890",
"application.lastModifiedTime": "2016-12-13 23:53:33.0",
"application.description": "",
"application.timeOfCreation": "2016-12-13 23:53:33.0",
"application.configurationId": "d-application-02444a45288013764"
}
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/discovery/describe-configurations.html)를 참조하세요.
### `list-configurations`
다음 코드 예시는 `list-configurations`의 사용 방법을 보여줍니다.
**AWS CLI**
**필터 조건 집합을 충족하는 검색된 모든 서버를 나열하는 방법**
이 예제 명령은 두 호스트 이름 패턴 중 하나와 일치하고 Ubuntu를 실행하지 않는 검색된 서버를 나열합니다.
명령:
```
aws discovery list-configurations --configuration-type SERVER --filters name="server.hostName",values="172-31-35","172-31-42",condition="CONTAINS" name="server.osName",values="Ubuntu",condition="NOT_CONTAINS"
```
출력:
```
{
"configurations": [
{
"server.osVersion": "3.14.48-33.39.amzn1.x86_64",
"server.type": "EC2",
"server.hostName": "ip-172-31-42-208",
"server.timeOfCreation": "2016-10-28 23:44:30.0",
"server.configurationId": "d-server-099385097ef9fbcfb",
"server.osName": "Linux - Amazon Linux AMI release 2015.03",
"server.agentId": "i-c142b99e"
},
{
"server.osVersion": "3.14.48-33.39.amzn1.x86_64",
"server.type": "EC2",
"server.hostName": "ip-172-31-35-152",
"server.timeOfCreation": "2016-10-28 23:44:00.0",
"server.configurationId": "d-server-0c4f2dd1fee22c6c1",
"server.osName": "Linux - Amazon Linux AMI release 2015.03",
"server.agentId": "i-4447bc1b"
}
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/discovery/list-configurations.html)를 참조하세요.