사용자 지정 재고 작업 - AWS 시스템 관리자

문서의 영문과 번역 사이에 충돌이 있는 경우에는 영문 버전을 따릅니다. 번역 버전은 기계 번역을 사용하여 제공합니다.

사용자 지정 재고 작업

다음을 작성하여 인스턴스에 원하는 메타데이터를 할당할 수 있습니다. 사용자 지정 재고. 예를 들어, 이러한 서버는 다음과 같이 구성되었습니다. 시스템 관리자 관리됨 인스턴스. 현재는 서버 랙 위치에 대한 정보를 스프레드시트에 저장합니다. 사용자 지정 인벤토리를 사용하면 각 인스턴스의 랙 위치를 메타데이터로 지정할 수 있습니다. 인스턴스. 다음을 사용하여 재고를 수집할 때 시스템 관리자, 메타데이터는 기타 인벤토리 메타데이터. 그런 다음 모든 인벤토리 메타데이터를 중앙 Amazon S3 버켓 사용 자원 데이터 동기화 데이터를 쿼리합니다.

참고

시스템 관리자 는 AWS 계정당 최대 20개의 사용자 지정 인벤토리 유형을 지원합니다.

사용자 지정 인벤토리를 인스턴스에 할당하려면 시스템 관리자 재고 저장 API 작업, 에 설명되어 있습니다. 시찰: 사용자 지정 재고 할당 인스턴스에 대한 메타데이터. 또는 사용자 지정 인벤토리 JSON 파일을 인스턴스 에 업로드합니다. 이 섹션에서는 JSON 파일.

사용자 지정 인벤토리가 있는 다음 예제 JSON 파일은 온프레미스 서버입니다. 이 예는 한 가지 유형의 사용자 지정 재고 데이터를 지정합니다. ("TypeName": "Custom:RackInformation"), 여러 항목 포함 Content 데이터 를 설명합니다.

{ "SchemaVersion": "1.0", "TypeName": "Custom:RackInformation", "Content": { "Location": "US-EAST-02.CMH.RACK1", "InstalledTime": "2016-01-01T01:01:01Z", "vendor": "DELL", "Zone" : "BJS12", "TimeZone": "UTC-8" } }

또한 Content 섹션, 참조: 다음 예제를 참조하십시오.

{ "SchemaVersion": "1.0", "TypeName": "Custom:PuppetModuleInfo", "Content": [{ "Name": "puppetlabs/aws", "Version": "1.0" }, { "Name": "puppetlabs/dsc", "Version": "2.0" } ] }

사용자 지정 인벤토리에 대한 JSON 스키마에는 스키마 버전, 유형 이름 및 콘텐츠가 필요합니다. 섹션을 사용하지만 해당 섹션에서 정보를 정의할 수 있습니다.

{ "SchemaVersion": "user_defined", "TypeName": "Custom:user_defined", "Content": { "user_defined_attribute1": "user_defined_value1", "user_defined_attribute2": "user_defined_value2", "user_defined_attribute3": "user_defined_value3", "user_defined_attribute4": "user_defined_value4" } }

유형 이름은 100자로 제한됩니다. 또한 TypeName 섹션은 다음으로 시작해야 합니다. 사용자 지정. 예를 들어, 사용자 지정:인기 모듈 정보. 사용자 지정 및 Data 대문자로 시작해야 합니다. 더 다음과 같은 경우 예외가 발생할 수 있습니다. "CUSTOM:Rack정보", "사용자 지정:랙 정보".

Content(내용) 섹션에는 속성과 data. 이 항목은 대/소문자를 구분하지 않습니다. 그러나 애트리뷰트를 정의할 경우(예: "벤더": "DELL")의 경우 사용자 지정 인벤토리 파일. "벤더"를 지정하는 경우: "DELL"(벤더의 자본 "V" 사용) "벤더"를 지정합니다. "DELL"(벤더의 소문자 "v" 사용)을 다른 시스템에서 오류를 반환합니다.

참고

파일을.json 확장자로 저장하고 정의한 인벤토리를 저장해야 합니다. 문자열 값으로만 구성됩니다.

파일을 생성한 후 인스턴스 에 저장해야 합니다. 다음 표는 사용자 지정 인벤토리 JSON 파일이 인스턴스에 저장되어야 하는 위치:

운영 체제 경로

창문

%시스템 드라이브%\프로그램 데이터\Amazon\SSM\인스턴스데이터\<인스턴스-id>\인벤토리\사용자 지정

리눅스

/var/lib/amazon/ssm/<인스턴스-id>/인벤토리/커스텀

사용자 지정 인벤토리를 사용하는 방법에 대한 예제는 를 참조하십시오. EC2 시스템 관리자 맞춤형 인벤토리를 사용하여 차량 디스크 활용 유형.

사용자 지정 인벤토리 삭제

다음을 사용할 수 있습니다. 인벤토리삭제 사용자 지정 인벤토리 유형 및 해당 유형 와 연결된 데이터. 를 사용하여 inventory 삭제 명령을 호출합니다. AWS CLI 인벤토리 유형에 대한 모든 데이터를 삭제합니다. 삭제-재고 명령과 SchemaDeleteOption 사용자 지정 인벤토리를 삭제하려면 유형.

참고

인벤토리 유형은 인벤토리 스키마라고도 합니다.

SchemaDeleteOption 파라미터는 다음을 포함합니다. 옵션:

  • 스키마 삭제: 이 옵션은 지정된 사용자 지정 유형 및 해당 유형과 연결된 모든 데이터. 다음을 재생성할 수 있습니다. 나중에 스키마를 사용할 수 있습니다.

  • 스키마 비활성화: 이 옵션을 선택하면 시스템이 현재 버전을 비활성화하고, 현재 버전에 대한 모든 데이터를 삭제하고, 버전이 비활성화된 버전보다 작거나 같은 경우 모든 새 데이터 무시 버전. 이 인벤토리 유형을 다시 활성화하려면 재고 저장 작업 비활성화된 버전보다 큰 버전.

다음을 사용하여 사용자 지정 인벤토리를 삭제 또는 비활성화하려면 AWS CLI

  1. 아직 하지 않은 경우 AWS CLI를 설치하고 구성합니다.

    자세한 정보는 AWS 명령줄 도구 설치 또는 업그레이드 단원을 참조하십시오.

  2. 다음 명령을 실행하여 dry-run 보기 옵션 어떤 데이터가 시스템에서 삭제될 것인지에 대한 정보입니다. 이 명령은 데이터.

    aws ssm delete-inventory --type-name "Custom:custom_type_name" --dry-run

    시스템은 다음과 같은 정보를 반환합니다.

    {
       "DeletionSummary":{
          "RemainingCount":3,
          "SummaryItems":[
             {
                "Count":2,
                "RemainingCount":2,
                "Version":"1.0"
             },
             {
                "Count":1,
                "RemainingCount":1,
                "Version":"2.0"
             }
          ],
          "TotalCount":3
       },
       "TypeName":"Custom:custom_type_name"
    }

    인벤토리 삭제 요약을 이해하는 방법에 대한 자세한 내용은 를 참조하십시오. 삭제 이해 재고 요약.

  3. 사용자 지정 인벤토리에 대한 모든 데이터를 삭제하려면 다음 명령을 실행하십시오. 유형.

    aws ssm delete-inventory --type-name "Custom:custom_type_name"
    참고

    이 명령의 출력에 삭제 진행률이 표시되지 않습니다. 대상 이 이유 때문에 TotalCount(총 카운트)와 Remaining Count(남은 카운트)는 항상 동일합니다. 시스템이 아직 아무것도 삭제하지 않았습니다. 다음을 사용할 수 있습니다. 다음과 같이 삭제 진행률을 표시하는 inventory-삭제 명령 설명 이 항목의 뒷부분에서 설명합니다.

    시스템은 다음과 같은 정보를 반환합니다.

    {
       "DeletionId":"system_generated_deletion_ID",
       "DeletionSummary":{
          "RemainingCount":3,
          "SummaryItems":[
             {
                "Count":2,
                "RemainingCount":2,
                "Version":"1.0"
             },
             {
                "Count":1,
                "RemainingCount":1,
                "Version":"2.0"
             }
          ],
          "TotalCount":3
       },
       "TypeName":"custom_type_name"
    }

    시스템이 지정된 사용자 지정 인벤토리 유형에 대한 모든 데이터를 다음에서 삭제합니다. 을 시스템 관리자 재고 서비스.

  4. 다음 명령을 실행합니다. 이 명령은 다음 작업을 수행합니다. 인벤토리 유형의 현재 버전: 현재 버전을 비활성화합니다. 모든 데이터가 삭제되고 버전이 더 작을 경우 모든 새 데이터가 무시됩니다. 이(가) 비활성화된 버전과 같거나 더 높습니다.

    aws ssm delete-inventory --type-name "Custom:custom_type_name" --schema-delete-option "DisableSchema"

    시스템은 다음과 같은 정보를 반환합니다.

    {
       "DeletionId":"system_generated_deletion_ID",
       "DeletionSummary":{
          "RemainingCount":3,
          "SummaryItems":[
             {
                "Count":2,
                "RemainingCount":2,
                "Version":"1.0"
             },
             {
                "Count":1,
                "RemainingCount":1,
                "Version":"2.0"
             }
          ],
          "TotalCount":3
       },
       "TypeName":"Custom:custom_type_name"
    }

    다음을 사용하여 비활성화된 재고 유형을 볼 수 있습니다. 명령.

    aws ssm get-inventory-schema --type-name Custom:custom_type_name
  5. 다음 명령을 실행하여 인벤토리 유형을 삭제합니다.

    aws ssm delete-inventory --type-name "Custom:custom_type_name" --schema-delete-option "DeleteSchema"

    시스템이 지정된 사용자 정의 유형.

    시스템은 다음과 같은 정보를 반환합니다.

    {
       "DeletionId":"system_generated_deletion_ID",
       "DeletionSummary":{
          "RemainingCount":3,
          "SummaryItems":[
             {
                "Count":2,
                "RemainingCount":2,
                "Version":"1.0"
             },
             {
                "Count":1,
                "RemainingCount":1,
                "Version":"2.0"
             }
          ],
          "TotalCount":3
       },
       "TypeName":"Custom:custom_type_name"
    }

삭제 보기 상태

삭제 작업의 상태를 확인하려면 설명-재고-삭제 AWS CLI 명령. 삭제 ID를 지정할 수 있습니다. 특정 삭제 작업의 상태를 봅니다. 또는 삭제 ID를 생략할 수 있습니다. 를 클릭하여 지난 30일 동안 실행된 모든 삭제 목록을 봅니다.

  1. 다음 명령을 실행하여 삭제 작업의 상태를 확인합니다. 시스템이 삭제 인벤토리에서 삭제 ID를 반환했습니다. 요약.

    aws ssm describe-inventory-deletions --deletion-id system_generated_deletion_ID

    시스템이 최신 상태 을(를) 반환합니다. 삭제 작업이 아직 끝나지 않았습니다. 시스템이 다음과 같은 정보를 반환합니다. 다음.

    {"InventoryDeletions": 
      [
        {"DeletionId": "system_generated_deletion_ID", 
         "DeletionStartTime": 1521744844, 
         "DeletionSummary": 
          {"RemainingCount": 1, 
           "SummaryItems": 
            [
              {"Count": 1, 
               "RemainingCount": 1, 
               "Version": "1.0"}
            ], 
           "TotalCount": 1}, 
         "LastStatus": "InProgress", 
         "LastStatusMessage": "The Delete is in progress", 
         "LastStatusUpdateTime": 1521744844, 
         "TypeName": "Custom:custom_type_name"}
      ]
    }

    삭제 작업이 성공하면 LastStatusMessage 상태: 삭제는 성공적으로 되었습니다.

    {"InventoryDeletions": 
      [
        {"DeletionId": "system_generated_deletion_ID", 
         "DeletionStartTime": 1521744844, 
         "DeletionSummary": 
          {"RemainingCount": 0, 
           "SummaryItems": 
            [
              {"Count": 1, 
               "RemainingCount": 0, 
               "Version": "1.0"}
            ], 
           "TotalCount": 1}, 
         "LastStatus": "Complete", 
         "LastStatusMessage": "Deletion is successful", 
         "LastStatusUpdateTime": 1521745253, 
         "TypeName": "Custom:custom_type_name"}
      ]
    }
  2. 다음 명령을 실행하여 지난 30일.

    aws ssm describe-inventory-deletions --max-results a number
    {"InventoryDeletions": 
      [
        {"DeletionId": "system_generated_deletion_ID", 
         "DeletionStartTime": 1521682552, 
         "DeletionSummary": 
          {"RemainingCount": 0, 
           "SummaryItems": 
            [
              {"Count": 1, 
               "RemainingCount": 0, 
               "Version": "1.0"}
            ], 
           "TotalCount": 1}, 
         "LastStatus": "Complete", 
         "LastStatusMessage": "Deletion is successful", 
         "LastStatusUpdateTime": 1521682852, 
         "TypeName": "Custom:custom_type_name"}, 
        {"DeletionId": "system_generated_deletion_ID", 
         "DeletionStartTime": 1521744844, 
         "DeletionSummary": 
          {"RemainingCount": 0, 
           "SummaryItems": 
            [
              {"Count": 1, 
               "RemainingCount": 0, 
               "Version": "1.0"}
            ], 
           "TotalCount": 1}, 
         "LastStatus": "Complete", 
         "LastStatusMessage": "Deletion is successful", 
         "LastStatusUpdateTime": 1521745253, 
         "TypeName": "Custom:custom_type_name"}, 
        {"DeletionId": "system_generated_deletion_ID", 
         "DeletionStartTime": 1521680145, 
         "DeletionSummary": 
          {"RemainingCount": 0, 
           "SummaryItems": 
            [
              {"Count": 1, 
               "RemainingCount": 0, 
               "Version": "1.0"}
            ], 
           "TotalCount": 1}, 
         "LastStatus": "Complete", 
         "LastStatusMessage": "Deletion is successful", 
         "LastStatusUpdateTime": 1521680471, 
         "TypeName": "Custom:custom_type_name"}
      ], 
     "NextToken": "next-token"

삭제 이해 재고 요약

삭제 재고 요약의 내용을 이해하는 데 도움이 되도록 다음을 고려하십시오. 다음 예제를 참조하십시오. 사용자 지정:RackSpace 인벤토리를 인스턴스. 인벤토리 항목 1 및 2는 사용자 지정 유형 버전 1.0을 사용합니다. ("Schema버전":"1.0"). 인벤토리 항목 3은 사용자 지정 유형 버전 2.0을 사용합니다. ("Schema버전":"2.0").

RackSpace 사용자 지정 인벤토리 1

{ "CaptureTime":"2018-02-19T10:48:55Z", "TypeName":"CustomType:RackSpace", "InstanceId":"i-1234567890", "SchemaVersion":"1.0" "Content":[ { content of custom type omitted } ] }

RackSpace 사용자 지정 인벤토리 2

{ "CaptureTime":"2018-02-19T10:48:55Z", "TypeName":"CustomType:RackSpace", "InstanceId":"i-1234567891", "SchemaVersion":"1.0" "Content":[ { content of custom type omitted } ] }

RackSpace 사용자 지정 인벤토리 3

{ "CaptureTime":"2018-02-19T10:48:55Z", "TypeName":"CustomType:RackSpace", "InstanceId":"i-1234567892", "SchemaVersion":"2.0" "Content":[ { content of custom type omitted } ] }

사용자는 다음 명령을 실행하여 을(를) 삭제했습니다.

aws ssm delete-inventory --type-name "Custom:RackSpace" --dry-run

시스템은 다음과 같은 정보를 반환합니다.

{
   "DeletionId":"1111-2222-333-444-66666",
   "DeletionSummary":{
      "RemainingCount":3,           
      "TotalCount":3,             
                TotalCount and RemainingCount are the number of items that would be deleted if this was not a dry run. These numbers are the same because the system didn't delete anything.
      "SummaryItems":[
         {
            "Count":2,             The system found two items that use SchemaVersion 1.0. Neither item was deleted.           
            "RemainingCount":2,
            "Version":"1.0"
         },
         {
            "Count":1,             The system found one item that uses SchemaVersion 1.0. This item was not deleted.
            "RemainingCount":1,
            "Version":"2.0"
         }
      ],

   },
   "TypeName":"Custom:RackSpace"
}

사용자는 다음 명령을 실행하여 Custom:RackSpace 인벤토리를 삭제합니다.

참고

이 명령의 출력에 삭제 진행률이 표시되지 않습니다. 이를 위해 이유, 총 카운트 및 남은 카운트는 항상 동일합니다. 시스템에서 아직 을(를) 삭제하지 않았습니다. 다음을 사용할 수 있습니다. inventory-삭제 명령을 사용하여 삭제 진행률을 보여 줍니다.

aws ssm delete-inventory --type-name "Custom:RackSpace"

시스템은 다음과 같은 정보를 반환합니다.

{
   "DeletionId":"1111-2222-333-444-7777777",
   "DeletionSummary":{
      "RemainingCount":3,           There are three items to delete
      "SummaryItems":[
         {
            "Count":2,              The system found two items that use SchemaVersion 1.0.
            "RemainingCount":2,     
            "Version":"1.0"
         },
         {
            "Count":1,              The system found one item that uses SchemaVersion 2.0.
            "RemainingCount":1,     
            "Version":"2.0"
         }
      ],
      "TotalCount":3                
   },
   "TypeName":"RackSpace"
}

재고 삭제 작업 보기 에서 CloudWatch 이벤트

다음을 구성할 수 있습니다. Amazon CloudWatch Events 사용자가 사용자 지정 재고. CloudWatch 이벤트 사용자 지정 인벤토리 삭제를 위한 세 가지 유형의 이벤트를 제공합니다. 운영:

  • 인스턴스에 대한 동작 삭제: 만약 특정 관리되는 인스턴스에 대한 사용자 지정 인벤토리가 성공적으로 수행되었습니다. 을(를) 삭제했거나 삭제하지 않았습니다.

  • 작업 요약 삭제: 요약 삭제 작업.

  • 비활성화된 사용자 지정 인벤토리 경고 유형: 사용자가 재고 저장 주성분 사용자 지정 재고 유형 버전에 대한 작업입니다. 이전에 비활성화된.

다음은 각 이벤트의 예입니다.

인스턴스에 대한 동작 삭제

{
   "version":"0",
   "id":"998c9cde-56c0-b38b-707f-0411b3ff9d11",
   "detail-type":"Inventory Resource State Change",
   "source":"aws.ssm",
   "account":"478678815555",
   "time":"2018-05-24T22:24:34Z",
   "region":"us-east-1",
   "resources":[
      "arn:aws:ssm:us-east-1:478678815555:managed-instance/i-0a5feb270fc3f0b97"
   ],
   "detail":{
      "action-status":"succeeded",
      "action":"delete",
      "resource-type":"managed-instance",
      "resource-id":"i-0a5feb270fc3f0b97",
      "action-reason":"",
      "type-name":"Custom:MyInfo"
   }
}

작업 요약 삭제

{
   "version":"0",
   "id":"83898300-f576-5181-7a67-fb3e45e4fad4",
   "detail-type":"Inventory Resource State Change",
   "source":"aws.ssm",
   "account":"478678815555",
   "time":"2018-05-24T22:28:25Z",
   "region":"us-east-1",
   "resources":[

   ],
   "detail":{
      "action-status":"succeeded",
      "action":"delete-summary",
      "resource-type":"managed-instance",
      "resource-id":"",
      "action-reason":"The delete for type name Custom:MyInfo was completed. The deletion summary is: {\"totalCount\":2,\"remainingCount\":0,\"summaryItems\":[{\"version\":\"1.0\",\"count\":2,\"remainingCount\":0}]}",
      "type-name":"Custom:MyInfo"
   }
}

비활성화된 사용자 지정 인벤토리 경고 유형

{
   "version":"0",
   "id":"49c1855c-9c57-b5d7-8518-b64aeeef5e4a",
   "detail-type":"Inventory Resource State Change",
   "source":"aws.ssm",
   "account":"478678815555",
   "time":"2018-05-24T22:46:58Z",
   "region":"us-east-1",
   "resources":[
      "arn:aws:ssm:us-east-1:478678815555:managed-instance/i-0ee2d86a2cfc371f6"
   ],
   "detail":{
      "action-status":"failed",
      "action":"put",
      "resource-type":"managed-instance",
      "resource-id":"i-0ee2d86a2cfc371f6",
      "action-reason":"The inventory item with type name Custom:MyInfo was sent with a disabled schema version 1.0. You must send a version greater than 1.0",
      "type-name":"Custom:MyInfo"
   }
}

다음 절차에 따라 CloudWatch 이벤트 사용자 지정 인벤토리 삭제 규칙 작업. 이 절차에서는 사용자 지정 인벤토리 삭제 작업에 대한 알림 Amazon SNS 주제. 이전 시작할 때, Amazon SNS 항목을 선택하거나 새 항목을 만드십시오. 추가 정보 정보, 참조 받기 시작됨 에서 Amazon Simple Notification Service 개발자 안내서.

구성하려면 CloudWatch 이벤트 인벤토리 작업 삭제

  1. AWS Management 콘솔에 로그인한 다음 https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 이벤트, 및 그런 다음 규칙 생성.

  3. 미만 이벤트 소스, 다음을 확인합니다. 이벤트 패턴 이(가) 선택되었습니다.

  4. 에서 서비스 이름 필드, 선택 EC2(유럽 약전 2) 단순함 시스템 관리자 (SSM).

  5. 에서 이벤트 유형 필드, 선택 재고.

  6. 다음을 확인합니다. 모든 세부 유형 선택한 다음 선택 대상 추가.

  7. 에서 대상 유형 선택 목록, 선택 SNS 주제에서 주제를 선택하십시오. 목록.

  8. 에서 입력 구성 목록에서 일치하는 이벤트 이(가) 선택되었습니다.

  9. 선택 세부 정보 구성.

  10. 이름과 설명을 지정한 다음 생성 규칙.