手动创建 OpsItems - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

手动创建 OpsItems

本节包括有关如 OpsItems 在Amazon Web Services Systems ManagerOpsCenter。

开始前的准备工作

如果您手动为受影响的Amazon资源，然后收集有关该资源的信息，以便您可以创建 Amazon 资源名称 (ARN)。如果您在创建 OpsIteM 时指定 ARN，则 OpsCenter 会自动创建一个指向有关此资源的详细信息的深层链接。例如，如果您指定受影响的 EC2 实例的 ARN，则 OpsCenter 会创建一个指向有关此实例的详细信息的深层链接。有关如何创建 ARN 的信息，请参阅Amazon 资源名称 (ARN) 和Amazon服务命名空间中的Amazon Web Services 一般参考。

注意

OpsCenter 不支持为所有 ARN 类型创建深层链接。要查看支持基于 ARN 的深层链接的资源列表，请参阅支持的资源参考。

本节包括以下过程。

手动创建 OOpsItem（控制台）

  1. 打开Amazon Web Services Systems Manager控制台https://console.aws.amazon.com/systems-manager/。

  2. 在导航窗格中，选择OpsCenter。

  3. 选择创建 OpsItem。如果您没有看到该按钮，则选择OpsItems选项卡，然后选择。创建 OpsItem。

  4. 适用于职务中，输入描述性名称以帮助您了解 OpsItem 用途。

  5. 适用于源中，输入受影响的Amazon资源或其他源信息，以帮助用户了解 OpsItem 的源。

    注意

    您无法编辑源字段，然后创建 OpsItem。

  6. （可选）Priority (优先级)中，选择优先级级别。

  7. （可选）严重性下，选择严重性级别。

  8. （可选）类别下，选择一个类别。

  9. 适用于说明中，输入有关此 OpsItem 的信息，包括（如果适用）再现此问题的步骤。

  10. 适用于重复删除字符串中，输入系统应用于检查重复 OpsItems 单词。有关重复数据删除字符串的更多信息，请参阅减少重复的 OpsItems。

  11. （可选）通知中，指定 Amazon SNS 主题 ARN，您希望在更新此 OpsItem 发送通知。您必须指定一 ARN 于同一Amazon Web Services 区域作为可用项目 M。

  12. （可选）在相关资源中，选择Add以指定受影响资源和任何相关资源的 ID 或 Amazon 资源名称 (ARN)。

  13. 选择创建 OpsItem。

如果成功，OpsItem 将打开。有关如何配置 OpsItM 中的选项的信息，请参阅。使用 OpsItems。

手动创建 OpsItem (AmazonCLI）

  1. 打开Amazon命令行界面 (AmazonCLI）并运行以下命令以创建 OOpsItem dentity.

    aws ssm create-ops-item --title "Descriptive_title" --description "Information_about_the_issue" --priority Number_between_1_and_5 --source Source_of_the_issue --operational-data Up_to_20_KB_of_data_or_path_to_JSON_file --notifications Arn="SNS_ARN_in_same_Region" --tags "Key=key_name,Value=a_value"

    下面是一些示例。

    Linux

    aws ssm create-ops-item --title "EC2 instance disk full" --description "Log clean up may have failed which caused the disk to be full" --priority 2 --source ec2 --operational-data '{"EC2":{"Value":"12345","Type":"SearchableString"}}' --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" --tags "Key=EC2,Value=ProductionServers"

    以下命令使用/aws/resources键创建具有 Amazon DynamoDB 相关资源的 OOpsItem OperationalData om。 

    aws ssm create-ops-item --title "EC2 instance disk full" --description "Log clean up may have failed which caused the disk to be full" --priority 2 --source ec2 --operational-data '{"/aws/resources":{"Value":"[{\"arn\": \"arn:aws:dynamodb:us-west-2:12345678:table/OpsItems\"}]","Type":"SearchableString"}}' --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"

    以下命令使用/aws/automations键创建 OpsIOperationalData，用于指定AWS-ASGEnterStandby文档作为关联的自动化运行手册。 

    aws ssm create-ops-item --title "EC2 instance disk full" --description "Log clean up may have failed which caused the disk to be full" --priority 2 --source ec2 --operational-data '{"/aws/automations":{"Value":"[{\"automationId\": \"AWS-ASGEnterStandby\", \"automationType\": \"AWS::SSM::Automation\"}]","Type":"SearchableString"}}' --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"

    Windows

    aws ssm create-ops-item --title "RDS instance not responding" --description "RDS instance not responding to ping" --priority 1 --source RDS --operational-data={\"RDS\":{\"Value\":\"abcd\",\"Type\":\"SearchableString\"}} --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" --tags "Key=RDS,Value=ProductionServers"

    以下命令使用/aws/resources键创建具有 EC2 实例相关资源的 OpsIOperationalData om。 

    aws ssm create-ops-item --title "EC2 instance disk full" --description "Log clean up may have failed which caused the disk to be full" --priority 2 --source ec2 --operational-data={\"/aws/resources\":{\"Value\":\"[{\\"""arn\\""":\\"""arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\\"""}]\",\"Type\":\"SearchableString\"}}

    以下命令使用/aws/automations键创建 OpsIOperationalData，用于指定Amazon -RestartEC2Instance文档作为关联的自动化运行手册。 

    aws ssm create-ops-item --title "EC2 instance disk full" --description "Log clean up may have failed which caused the disk to be full" --priority 2 --source ec2 --operational-data={\"/aws/automations\":{\"Value\":\"[{\\"""automationId\\""":\\"""AWS-RestartEC2Instance\\”"",\\"""automationType\\""":\\"""AWS::SSM::Automation\\"""}]\",\"Type\":\"SearchableString\"}}

    指定文件中的操作数据

    在创建 OpsItem 时，您可以指定文件中的操作数据。此文件必须是 JSON 文件，并且文件内容必须使用以下格式：

    {
  "key_name": {
    "Type": "SearchableString",
    "Value": "Up to 20 KB of data"
  }
}

    以下是示例。

    aws ssm create-ops-item --title "EC2 instance disk full" --description "Log clean up may have failed which caused the disk to be full" --priority 2 --source ec2 --operational-data file:///Users/TestUser1/Desktop/OpsItems/opsData.json --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" --tags "Key=EC2,Value=Production"
    注意

    有关如何在不同本地操作系统上的命令行中输入 JSON 格式参数的信息，请参阅将引号与字符串结合使用中的Amazon命令行界面用户指南。

    系统将返回类似于以下内容的信息：

    {
    "OpsItemId": "oi-1a2b3c4d5e6f"
}

  2. 运行以下命令以查看有关您创建 OpsItem 的详细信息。

    aws ssm get-ops-item --ops-item-id ID

    系统将返回类似于以下内容的信息：

    {
    "OpsItem": {
        "CreatedBy": "arn:aws:iam::12345678:user/TestUser",
        "CreatedTime": 1558386334.995,
        "Description": "Log clean up may have failed which caused the disk to be full",
        "LastModifiedBy": "arn:aws:iam::12345678:user/TestUser",
        "LastModifiedTime": 1558386334.995,
        "Notifications": [
            {
                "Arn": "arn:aws:sns:us-west-1:12345678:TestUser"
            }
        ],
        "Priority": 2,
        "RelatedOpsItems": [],
        "Status": "Open",
        "OpsItemId": "oi-1a2b3c4d5e6f",
        "Title": "EC2 instance disk full",
        "Source": "ec2",
        "OperationalData": {
            "EC2": {
                "Value": "12345",
                "Type": "SearchableString"
            }
        }
    }
}

  3. 运行以下命令以更新 OpsItem。此命令将状态从 Open（默认值）更改为 InProgress。 

    aws ssm update-ops-item --ops-item-id ID --status InProgress

    该命令没有输出。

  4. 再次运行以下命令以验证状态是否已更改为 InProgress

    aws ssm get-ops-item --ops-item-id ID