annotations

var Command = &cli.Command{
	Name:  "annotations",
	Usage: "Manipulate graph annotations",
	Description: `
    Manipulate graph annotations. Requests APIs under "/api/v0/graph-annotations".
    See https://mackerel.io/api-docs/entry/graph-annotations .
`,
	Commands: []*cli.Command{
		{
			Name:      "create",
			Usage:     "create a graph annotation",
			ArgsUsage: "--title <title> [--description <description>] [--description-file <file-path>] --from <from> --to <to> --service|-s <service> [--role|-r <role>]",
			Description: `
    Creates a graph annotation.
`,
			Action: doAnnotationsCreate,
			Flags: []cli.Flag{
				&cli.StringFlag{
					Name:  "title",
					Usage: "Title for annotation",
				},
				&cli.StringFlag{
					Name:  "description",
					Usage: "Description for annotation",
				},
				&cli.StringFlag{
					Name:  "description-file",
					Usage: `Read description text for annotation from file (use "-" to read from stdin)`,
				},
				&cli.Int64Flag{
					Name:  "from",
					Usage: "Starting time (epoch seconds)",
				},
				&cli.Int64Flag{
					Name:  "to",
					Usage: "Ending time (epoch seconds)",
				},
				&cli.StringFlag{
					Name:    "service",
					Aliases: []string{"s"},
					Usage:   "Service name for annotation",
				},
				&cli.StringSliceFlag{
					Name:    "role",
					Aliases: []string{"r"},
					Usage:   "Roles for annotation. Multiple choices are allowed",
				},
			},
		},
		{
			Name:      "list",
			Usage:     "list annotations",
			ArgsUsage: "--from <from> --to <to> --service|-s <service> [--jq <formula>]",
			Description: `
    Shows annotations by service name and duration (from and to)
`,
			Action: doAnnotationsList,
			Flags: []cli.Flag{
				&cli.StringFlag{
					Name:    "service",
					Aliases: []string{"s"},
					Usage:   "Service name for annotation",
				},
				&cli.Int64Flag{
					Name:  "from",
					Usage: "Starting time (epoch seconds)",
				},
				&cli.Int64Flag{
					Name:  "to",
					Usage: "Ending time (epoch seconds)",
				},
				jq.CommandLineFlag,
			},
		},
		{
			Name:      "update",
			Usage:     "update annotation",
			ArgsUsage: "--id <id> [--title <title>] [--description <description>] [--description-file <file-path>] --from <from> --to <to> --service|-s <service> [--role|-r <role>]",
			Description: `
    Updates an annotation
`,
			Action: doAnnotationsUpdate,
			Flags: []cli.Flag{
				&cli.StringFlag{
					Name:  "id",
					Usage: "Annotation ID.",
				},
				&cli.StringFlag{
					Name:    "service",
					Aliases: []string{"s"},
					Usage:   "Service name for annotation",
				},
				&cli.StringFlag{
					Name:  "title",
					Usage: "Title for annotation",
				},
				&cli.StringFlag{
					Name:  "description",
					Usage: "Description for annotation",
				},
				&cli.StringFlag{
					Name:  "description-file",
					Usage: `Read description text for annotation from file (use "-" to read from stdin)`,
				},
				&cli.Int64Flag{
					Name:  "from",
					Usage: "Starting time (epoch seconds)",
				},
				&cli.Int64Flag{
					Name:  "to",
					Usage: "Ending time (epoch seconds)",
				},
				&cli.StringSliceFlag{
					Name:    "role",
					Aliases: []string{"r"},
					Usage:   "Roles for annotation. Multiple choices are allowed",
				},
			},
		},
		{
			Name:      "delete",
			Usage:     "delete annotation",
			ArgsUsage: "--id <id>",
			Description: `
    Delete graph annotation by annotation id
`,
			Action: doAnnotationsDelete,
			Flags: []cli.Flag{
				&cli.StringFlag{
					Name:  "id",
					Usage: "Graph annotation ID",
				},
			},
		},
	},
}