+
+ exit(0);
+}
+
+my $path_properties = {};
+
+my $api_path_property = {
+ description => "API path.",
+ type => 'string',
+ completion => sub {
+ my ($cmd, $pname, $cur, $args) = @_;
+ return PVE::APIClient::Helpers::complete_api_path($cur);
+ },
+};
+
+# dynamically update schema definition for direct API call
+# like: pveclient api <get|set|create|delete|help> <remote> <path>
+my $uri_param = {};
+if (my $info = PVE::APIClient::Helpers::extract_path_info($uri_param)) {
+ foreach my $key (keys %{$info->{parameters}->{properties}}) {
+ next if defined($uri_param->{$key});
+ $path_properties->{$key} = $info->{parameters}->{properties}->{$key};
+ }
+}
+
+$path_properties->{remote} = get_standard_option('pveclient-remote-name');
+$path_properties->{api_path} = $api_path_property;
+
+__PACKAGE__->register_method ({
+ name => 'pveclient_get',
+ path => 'pveclient_get',
+ method => 'GET',
+ description => "Call API GET on <api_path>.",
+ parameters => {
+ additionalProperties => 0,
+ properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+ },
+ returns => { type => 'null' },
+ code => sub {
+ my ($param) = @_;
+
+ call_api_method('GET', $param);
+
+ return undef;
+ }});
+
+__PACKAGE__->register_method ({
+ name => 'pveclient_set',
+ path => 'pveclient_set',
+ method => 'PUT',
+ description => "Call API PUT on <api_path>.",
+ parameters => {
+ additionalProperties => 0,
+ properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+ },
+ returns => { type => 'null' },
+ code => sub {
+ my ($param) = @_;
+
+ call_api_method('PUT', $param);
+
+ return undef;
+ }});
+
+__PACKAGE__->register_method ({
+ name => 'pveclient_create',
+ path => 'pveclient_create',
+ method => 'POST',
+ description => "Call API POST on <api_path>.",
+ parameters => {
+ additionalProperties => 0,
+ properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+ },
+ returns => { type => 'null' },
+ code => sub {
+ my ($param) = @_;
+
+ call_api_method('PUSH', $param);
+
+ return undef;
+ }});
+
+__PACKAGE__->register_method ({
+ name => 'pveclient_delete',
+ path => 'pveclient_delete',
+ method => 'DELETE',
+ description => "Call API DELETE on <api_path>.",
+ parameters => {
+ additionalProperties => 0,
+ properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+ },
+ returns => { type => 'null' },
+ code => sub {
+ my ($param) = @_;
+
+ call_api_method('DELETE', $param);
+
+ return undef;
+ }});
+
+__PACKAGE__->register_method ({
+ name => 'pveclient_usage',
+ path => 'pveclient_usage',
+ method => 'GET',
+ description => "print API usage information for <api_path>.",
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ api_path => $api_path_property,
+ verbose => {
+ description => "Verbose output format.",
+ type => 'boolean',
+ optional => 1,
+ },
+ returns => {
+ description => "Including schema for returned data.",
+ type => 'boolean',
+ optional => 1,
+ },
+ command => {
+ description => "API command.",
+ type => 'string',
+ enum => [ keys %$PVE::APIClient::Helpers::method_map ],
+ optional => 1,
+ },
+ },
+ },
+ returns => { type => 'null' },
+ code => sub {
+ my ($param) = @_;
+
+ my $path = $param->{api_path};
+
+ my $found = 0;
+ foreach my $cmd (qw(get set create delete)) {
+ next if $param->{command} && $cmd ne $param->{command};
+ my $method = $PVE::APIClient::Helpers::method_map->{$cmd};
+ my $uri_param = {};
+ my $info = PVE::APIClient::Helpers::find_method_info($path, $method, $uri_param, 1);
+ next if !$info;
+ $found = 1;
+
+ my $prefix = "pveclient api $cmd <remote> $path";
+ if ($param->{verbose}) {
+ print PVE::APIClient::RESTHandler::getopt_usage(
+ $info, $prefix, undef, $uri_param, 'full');
+
+ } else {
+ print "USAGE: " . PVE::APIClient::RESTHandler::getopt_usage(
+ $info, $prefix, undef, $uri_param, 'short');
+ }
+ if ($param-> {returns}) {
+ my $schema = to_json($info->{returns}, {utf8 => 1, canonical => 1, pretty => 1 });
+ print "RETURNS: $schema\n";
+ }
+ }
+
+ if (!$found) {
+ if ($param->{command}) {
+ die "no '$param->{command}' handler for '$path'\n";
+ } else {
+ die "no such resource '$path'\n"
+ }
+ }
+
+ return undef;
+ }});
+
+our $cmddef = {
+ config => $PVE::APIClient::Commands::config::cmddef,
+ list => $PVE::APIClient::Commands::list::cmddef,
+ lxc => $PVE::APIClient::Commands::lxc::cmddef,
+ remote => $PVE::APIClient::Commands::remote::cmddef,
+
+ resume => [ 'PVE::APIClient::Commands::GuestStatus', 'resume', ['remote', 'vmid']],
+ shutdown => [ 'PVE::APIClient::Commands::GuestStatus', 'shutdown', ['remote', 'vmid']],
+ spice => [ 'PVE::APIClient::Commands::GuestStatus', 'spice', ['remote', 'vmid']],
+ start => [ 'PVE::APIClient::Commands::GuestStatus', 'start', ['remote', 'vmid']],
+ stop => [ 'PVE::APIClient::Commands::GuestStatus', 'stop', ['remote', 'vmid']],
+ suspend => [ 'PVE::APIClient::Commands::GuestStatus', 'suspend', ['remote', 'vmid']],
+
+ api => {
+ usage => [ __PACKAGE__, 'pveclient_usage', ['api_path']],
+ get => [ __PACKAGE__, 'pveclient_get', ['remote', 'api_path']],
+ set => [ __PACKAGE__, 'pveclient_set', ['remote', 'api_path']],
+ create => [ __PACKAGE__, 'pveclient_create', ['remote', 'api_path']],
+ delete => [ __PACKAGE__, 'pveclient_delete', ['remote', 'api_path']],
+ },
+};
+
+
+if ($cmd && $cmd eq 'printsynopsis') {
+
+ print __PACKAGE__->generate_asciidoc_synopsis();
+
+ exit(0);