// Copyright 2020 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. // Code generated file. DO NOT EDIT. // Package osconfig provides access to the Cloud OS Config API. // // For product documentation, see: https://cloud.google.com/ // // Creating a client // // Usage example: // // import "google.golang.org/api/osconfig/v1" // ... // ctx := context.Background() // osconfigService, err := osconfig.NewService(ctx) // // In this example, Google Application Default Credentials are used for authentication. // // For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. // // Other authentication options // // To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey: // // osconfigService, err := osconfig.NewService(ctx, option.WithAPIKey("AIza...")) // // To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource: // // config := &oauth2.Config{...} // // ... // token, err := config.Exchange(ctx, ...) // osconfigService, err := osconfig.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) // // See https://godoc.org/google.golang.org/api/option/ for details on options. package osconfig // import "google.golang.org/api/osconfig/v1" import ( "bytes" "context" "encoding/json" "errors" "fmt" "io" "net/http" "net/url" "strconv" "strings" googleapi "google.golang.org/api/googleapi" gensupport "google.golang.org/api/internal/gensupport" option "google.golang.org/api/option" internaloption "google.golang.org/api/option/internaloption" htransport "google.golang.org/api/transport/http" ) // Always reference these packages, just in case the auto-generated code // below doesn't. var _ = bytes.NewBuffer var _ = strconv.Itoa var _ = fmt.Sprintf var _ = json.NewDecoder var _ = io.Copy var _ = url.Parse var _ = gensupport.MarshalJSON var _ = googleapi.Version var _ = errors.New var _ = strings.Replace var _ = context.Canceled var _ = internaloption.WithDefaultEndpoint const apiId = "osconfig:v1" const apiName = "osconfig" const apiVersion = "v1" const basePath = "https://osconfig.googleapis.com/" // OAuth2 scopes used by this API. const ( // View and manage your data across Google Cloud Platform services CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" ) // NewService creates a new Service. func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { scopesOption := option.WithScopes( "https://www.googleapis.com/auth/cloud-platform", ) // NOTE: prepend, so we don't override user-specified scopes. opts = append([]option.ClientOption{scopesOption}, opts...) opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) client, endpoint, err := htransport.NewClient(ctx, opts...) if err != nil { return nil, err } s, err := New(client) if err != nil { return nil, err } if endpoint != "" { s.BasePath = endpoint } return s, nil } // New creates a new Service. It uses the provided http.Client for requests. // // Deprecated: please use NewService instead. // To provide a custom HTTP client, use option.WithHTTPClient. // If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. func New(client *http.Client) (*Service, error) { if client == nil { return nil, errors.New("client is nil") } s := &Service{client: client, BasePath: basePath} s.Projects = NewProjectsService(s) return s, nil } type Service struct { client *http.Client BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment Projects *ProjectsService } func (s *Service) userAgent() string { if s.UserAgent == "" { return googleapi.UserAgent } return googleapi.UserAgent + " " + s.UserAgent } func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.PatchDeployments = NewProjectsPatchDeploymentsService(s) rs.PatchJobs = NewProjectsPatchJobsService(s) return rs } type ProjectsService struct { s *Service PatchDeployments *ProjectsPatchDeploymentsService PatchJobs *ProjectsPatchJobsService } func NewProjectsPatchDeploymentsService(s *Service) *ProjectsPatchDeploymentsService { rs := &ProjectsPatchDeploymentsService{s: s} return rs } type ProjectsPatchDeploymentsService struct { s *Service } func NewProjectsPatchJobsService(s *Service) *ProjectsPatchJobsService { rs := &ProjectsPatchJobsService{s: s} rs.InstanceDetails = NewProjectsPatchJobsInstanceDetailsService(s) return rs } type ProjectsPatchJobsService struct { s *Service InstanceDetails *ProjectsPatchJobsInstanceDetailsService } func NewProjectsPatchJobsInstanceDetailsService(s *Service) *ProjectsPatchJobsInstanceDetailsService { rs := &ProjectsPatchJobsInstanceDetailsService{s: s} return rs } type ProjectsPatchJobsInstanceDetailsService struct { s *Service } // AptSettings: Apt patching is completed by executing `apt-get update // && apt-get // upgrade`. Additional options can be set to control how this is // executed. type AptSettings struct { // Excludes: List of packages to exclude from update. These packages // will be excluded Excludes []string `json:"excludes,omitempty"` // ExclusivePackages: An exclusive list of packages to be updated. These // are the only packages // that will be updated. If these packages are not installed, they will // be // ignored. This field cannot be specified with any other patch // configuration // fields. ExclusivePackages []string `json:"exclusivePackages,omitempty"` // Type: By changing the type to DIST, the patching is performed // using `apt-get dist-upgrade` instead. // // Possible values: // "TYPE_UNSPECIFIED" - By default, upgrade will be performed. // "DIST" - Runs `apt-get dist-upgrade`. // "UPGRADE" - Runs `apt-get upgrade`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Excludes") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Excludes") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *AptSettings) MarshalJSON() ([]byte, error) { type NoMethod AptSettings raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // CancelPatchJobRequest: Message for canceling a patch job. type CancelPatchJobRequest struct { } // Empty: A generic empty message that you can re-use to avoid defining // duplicated // empty messages in your APIs. A typical example is to use it as the // request // or the response type of an API method. For instance: // // service Foo { // rpc Bar(google.protobuf.Empty) returns // (google.protobuf.Empty); // } // // The JSON representation for `Empty` is empty JSON object `{}`. type Empty struct { // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` } // ExecStep: A step that runs an executable for a PatchJob. type ExecStep struct { // LinuxExecStepConfig: The ExecStepConfig for all Linux VMs targeted by // the PatchJob. LinuxExecStepConfig *ExecStepConfig `json:"linuxExecStepConfig,omitempty"` // WindowsExecStepConfig: The ExecStepConfig for all Windows VMs // targeted by the PatchJob. WindowsExecStepConfig *ExecStepConfig `json:"windowsExecStepConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "LinuxExecStepConfig") // to unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "LinuxExecStepConfig") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` } func (s *ExecStep) MarshalJSON() ([]byte, error) { type NoMethod ExecStep raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // ExecStepConfig: Common configurations for an ExecStep. type ExecStepConfig struct { // AllowedSuccessCodes: Defaults to [0]. A list of possible return // values that the // execution can return to indicate a success. AllowedSuccessCodes []int64 `json:"allowedSuccessCodes,omitempty"` // GcsObject: A Cloud Storage object containing the executable. GcsObject *GcsObject `json:"gcsObject,omitempty"` // Interpreter: The script interpreter to use to run the script. If no // interpreter is // specified the script will be executed directly, which will // likely // only succeed for scripts with [shebang // lines] // (https://en.wikipedia.org/wiki/Shebang_\(Unix\)). // // Possible values: // "INTERPRETER_UNSPECIFIED" - Invalid for a Windows ExecStepConfig. // For a Linux ExecStepConfig, the // interpreter will be parsed from the shebang line of the script // if // unspecified. // "SHELL" - Indicates that the script is run with `/bin/sh` on Linux // and `cmd` // on Windows. // "POWERSHELL" - Indicates that the file is run with PowerShell // flags // `-NonInteractive`, `-NoProfile`, and `-ExecutionPolicy Bypass`. Interpreter string `json:"interpreter,omitempty"` // LocalPath: An absolute path to the executable on the VM. LocalPath string `json:"localPath,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowedSuccessCodes") // to unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "AllowedSuccessCodes") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` } func (s *ExecStepConfig) MarshalJSON() ([]byte, error) { type NoMethod ExecStepConfig raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // ExecutePatchJobRequest: A request message to initiate patching across // Compute Engine // instances. type ExecutePatchJobRequest struct { // Description: Description of the patch job. Length of the description // is limited // to 1024 characters. Description string `json:"description,omitempty"` // DisplayName: Display name for this patch job. This does not have to // be unique. DisplayName string `json:"displayName,omitempty"` // DryRun: If this patch is a dry-run only, instances are contacted // but // will do nothing. DryRun bool `json:"dryRun,omitempty"` // Duration: Duration of the patch job. After the duration ends, the // patch job // times out. Duration string `json:"duration,omitempty"` // InstanceFilter: Required. Instances to patch, either explicitly or // filtered by some criteria such // as zone or labels. InstanceFilter *PatchInstanceFilter `json:"instanceFilter,omitempty"` // PatchConfig: Patch configuration being applied. If omitted, instances // are // patched using the default configurations. PatchConfig *PatchConfig `json:"patchConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Description") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *ExecutePatchJobRequest) MarshalJSON() ([]byte, error) { type NoMethod ExecutePatchJobRequest raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // GcsObject: Cloud Storage object representation. type GcsObject struct { // Bucket: Required. Bucket of the Cloud Storage object. Bucket string `json:"bucket,omitempty"` // GenerationNumber: Required. Generation number of the Cloud Storage // object. This is used to // ensure that the ExecStep specified by this PatchJob does not change. GenerationNumber int64 `json:"generationNumber,omitempty,string"` // Object: Required. Name of the Cloud Storage object. Object string `json:"object,omitempty"` // ForceSendFields is a list of field names (e.g. "Bucket") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Bucket") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *GcsObject) MarshalJSON() ([]byte, error) { type NoMethod GcsObject raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // GooSettings: Googet patching is performed by running `googet update`. type GooSettings struct { } // ListPatchDeploymentsResponse: A response message for listing patch // deployments. type ListPatchDeploymentsResponse struct { // NextPageToken: A pagination token that can be used to get the next // page of patch // deployments. NextPageToken string `json:"nextPageToken,omitempty"` // PatchDeployments: The list of patch deployments. PatchDeployments []*PatchDeployment `json:"patchDeployments,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "NextPageToken") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *ListPatchDeploymentsResponse) MarshalJSON() ([]byte, error) { type NoMethod ListPatchDeploymentsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // ListPatchJobInstanceDetailsResponse: A response message for listing // the instances details for a patch job. type ListPatchJobInstanceDetailsResponse struct { // NextPageToken: A pagination token that can be used to get the next // page of results. NextPageToken string `json:"nextPageToken,omitempty"` // PatchJobInstanceDetails: A list of instance status. PatchJobInstanceDetails []*PatchJobInstanceDetails `json:"patchJobInstanceDetails,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "NextPageToken") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *ListPatchJobInstanceDetailsResponse) MarshalJSON() ([]byte, error) { type NoMethod ListPatchJobInstanceDetailsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // ListPatchJobsResponse: A response message for listing patch jobs. type ListPatchJobsResponse struct { // NextPageToken: A pagination token that can be used to get the next // page of results. NextPageToken string `json:"nextPageToken,omitempty"` // PatchJobs: The list of patch jobs. PatchJobs []*PatchJob `json:"patchJobs,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "NextPageToken") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *ListPatchJobsResponse) MarshalJSON() ([]byte, error) { type NoMethod ListPatchJobsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // MonthlySchedule: Represents a monthly schedule. An example of a valid // monthly schedule is // "on the third Tuesday of the month" or "on the 15th of the month". type MonthlySchedule struct { // MonthDay: Required. One day of the month. 1-31 indicates the 1st to // the 31st day. -1 // indicates the last day of the month. // Months without the target day will be skipped. For example, a // schedule to // run "every month on the 31st" will not run in February, April, June, // etc. MonthDay int64 `json:"monthDay,omitempty"` // WeekDayOfMonth: Required. Week day in a month. WeekDayOfMonth *WeekDayOfMonth `json:"weekDayOfMonth,omitempty"` // ForceSendFields is a list of field names (e.g. "MonthDay") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "MonthDay") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *MonthlySchedule) MarshalJSON() ([]byte, error) { type NoMethod MonthlySchedule raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // OneTimeSchedule: Sets the time for a one time patch deployment. // Timestamp is in // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. type OneTimeSchedule struct { // ExecuteTime: Required. The desired patch job execution time. ExecuteTime string `json:"executeTime,omitempty"` // ForceSendFields is a list of field names (e.g. "ExecuteTime") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ExecuteTime") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *OneTimeSchedule) MarshalJSON() ([]byte, error) { type NoMethod OneTimeSchedule raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // PatchConfig: Patch configuration specifications. Contains details on // how to apply the // patch(es) to a VM instance. type PatchConfig struct { // Apt: Apt update settings. Use this setting to override the default // `apt` patch // rules. Apt *AptSettings `json:"apt,omitempty"` // Goo: Goo update settings. Use this setting to override the default // `goo` patch // rules. Goo *GooSettings `json:"goo,omitempty"` // PostStep: The `ExecStep` to run after the patch update. PostStep *ExecStep `json:"postStep,omitempty"` // PreStep: The `ExecStep` to run before the patch update. PreStep *ExecStep `json:"preStep,omitempty"` // RebootConfig: Post-patch reboot settings. // // Possible values: // "REBOOT_CONFIG_UNSPECIFIED" - The default behavior is DEFAULT. // "DEFAULT" - The agent decides if a reboot is necessary by checking // signals such as // registry keys on Windows or `/var/run/reboot-required` on APT // based // systems. On RPM based systems, a set of core system package install // times // are compared with system boot time. // "ALWAYS" - Always reboot the machine after the update completes. // "NEVER" - Never reboot the machine after the update completes. RebootConfig string `json:"rebootConfig,omitempty"` // WindowsUpdate: Windows update settings. Use this override the default // windows patch rules. WindowsUpdate *WindowsUpdateSettings `json:"windowsUpdate,omitempty"` // Yum: Yum update settings. Use this setting to override the default // `yum` patch // rules. Yum *YumSettings `json:"yum,omitempty"` // Zypper: Zypper update settings. Use this setting to override the // default `zypper` // patch rules. Zypper *ZypperSettings `json:"zypper,omitempty"` // ForceSendFields is a list of field names (e.g. "Apt") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Apt") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *PatchConfig) MarshalJSON() ([]byte, error) { type NoMethod PatchConfig raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // PatchDeployment: Patch deployments are configurations that individual // patch jobs use to // complete a patch. These configurations include instance filter, // package // repository settings, and a schedule. For more information about // creating and // managing patch deployments, see [Scheduling // patch // jobs](https://cloud.google.com/compute/docs/os-patch-management/ // schedule-patch-jobs). type PatchDeployment struct { // CreateTime: Output only. Time the patch deployment was created. // Timestamp is in // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. CreateTime string `json:"createTime,omitempty"` // Description: Optional. Description of the patch deployment. Length of // the description is limited // to 1024 characters. Description string `json:"description,omitempty"` // Duration: Optional. Duration of the patch. After the duration ends, // the patch times out. Duration string `json:"duration,omitempty"` // InstanceFilter: Required. VM instances to patch. InstanceFilter *PatchInstanceFilter `json:"instanceFilter,omitempty"` // LastExecuteTime: Output only. The last time a patch job was started // by this deployment. // Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) // text // format. LastExecuteTime string `json:"lastExecuteTime,omitempty"` // Name: Unique name for the patch deployment resource in a project. The // patch // deployment name is in the // form: // `projects/{project_id}/patchDeployments/{patch_deployment_id}`. // // This field is ignored when you create a new patch deployment. Name string `json:"name,omitempty"` // OneTimeSchedule: Required. Schedule a one-time execution. OneTimeSchedule *OneTimeSchedule `json:"oneTimeSchedule,omitempty"` // PatchConfig: Optional. Patch configuration that is applied. PatchConfig *PatchConfig `json:"patchConfig,omitempty"` // RecurringSchedule: Required. Schedule recurring executions. RecurringSchedule *RecurringSchedule `json:"recurringSchedule,omitempty"` // UpdateTime: Output only. Time the patch deployment was last updated. // Timestamp is in // [RFC3339]("https://www.ietf.org/rfc/rfc3339.txt) text format. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "CreateTime") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CreateTime") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *PatchDeployment) MarshalJSON() ([]byte, error) { type NoMethod PatchDeployment raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // PatchInstanceFilter: A filter to target VM instances for patching. // The targeted // VMs must meet all criteria specified. So if both labels and zones // are // specified, the patch job targets only VMs with those labels and in // those // zones. type PatchInstanceFilter struct { // All: Target all VM instances in the project. If true, no other // criteria is // permitted. All bool `json:"all,omitempty"` // GroupLabels: Targets VM instances matching ANY of these GroupLabels. // This allows // targeting of disparate groups of VM instances. GroupLabels []*PatchInstanceFilterGroupLabel `json:"groupLabels,omitempty"` // InstanceNamePrefixes: Targets VMs whose name starts with one of these // prefixes. Similar to // labels, this is another way to group VMs when targeting configs, // for // example prefix="prod-". InstanceNamePrefixes []string `json:"instanceNamePrefixes,omitempty"` // Instances: Targets any of the VM instances specified. Instances are // specified by their // URI in the form // `zones/[ZONE]/instances/[INSTANCE_NAME], // `projects/[PROJECT_ID]/zones/ // [ZONE]/instances/[INSTANCE_NAME]`, // or // `https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/ // [ZONE]/instances/[INSTANCE_NAME]` Instances []string `json:"instances,omitempty"` // Zones: Targets VM instances in ANY of these zones. Leave empty to // target VM // instances in any zone. Zones []string `json:"zones,omitempty"` // ForceSendFields is a list of field names (e.g. "All") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "All") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *PatchInstanceFilter) MarshalJSON() ([]byte, error) { type NoMethod PatchInstanceFilter raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // PatchInstanceFilterGroupLabel: Targets a group of VM instances by // using their // [assigned // labels](https://cloud.google.com/compute/docs/labeling-resou // rces). Labels // are key-value pairs. A `GroupLabel` is a combination of labels // that is used to target VMs for a patch job. // // For example, a patch job can target VMs that have the // following // `GroupLabel`: `{"env":"test", "app":"web"}`. This means that the // patch job // is applied to VMs that have both the labels `env=test` and `app=web`. type PatchInstanceFilterGroupLabel struct { // Labels: Compute Engine instance labels that must be present for a // VM // instance to be targeted by this filter. Labels map[string]string `json:"labels,omitempty"` // ForceSendFields is a list of field names (e.g. "Labels") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Labels") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *PatchInstanceFilterGroupLabel) MarshalJSON() ([]byte, error) { type NoMethod PatchInstanceFilterGroupLabel raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // PatchJob: A high level representation of a patch job that is either // in progress // or has completed. // // Instances details are not included in the job. To paginate through // instance // details, use ListPatchJobInstanceDetails. // // For more information about patch jobs, see // [Creating // patch // jobs](https://cloud.google.com/compute/docs/os-patch-management/ // create-patch-job). type PatchJob struct { // CreateTime: Time this patch job was created. CreateTime string `json:"createTime,omitempty"` // Description: Description of the patch job. Length of the description // is limited // to 1024 characters. Description string `json:"description,omitempty"` // DisplayName: Display name for this patch job. This is not a unique // identifier. DisplayName string `json:"displayName,omitempty"` // DryRun: If this patch job is a dry run, the agent reports that it // has // finished without running any updates on the VM instance. DryRun bool `json:"dryRun,omitempty"` // Duration: Duration of the patch job. After the duration ends, // the // patch job times out. Duration string `json:"duration,omitempty"` // ErrorMessage: If this patch job failed, this message provides // information about the // failure. ErrorMessage string `json:"errorMessage,omitempty"` // InstanceDetailsSummary: Summary of instance details. InstanceDetailsSummary *PatchJobInstanceDetailsSummary `json:"instanceDetailsSummary,omitempty"` // InstanceFilter: Instances to patch. InstanceFilter *PatchInstanceFilter `json:"instanceFilter,omitempty"` // Name: Unique identifier for this patch job in the // form // `projects/*/patchJobs/*` Name string `json:"name,omitempty"` // PatchConfig: Patch configuration being applied. PatchConfig *PatchConfig `json:"patchConfig,omitempty"` // PatchDeployment: Output only. Name of the patch deployment that // created this patch job. PatchDeployment string `json:"patchDeployment,omitempty"` // PercentComplete: Reflects the overall progress of the patch job in // the range of // 0.0 being no progress to 100.0 being complete. PercentComplete float64 `json:"percentComplete,omitempty"` // State: The current state of the PatchJob . // // Possible values: // "STATE_UNSPECIFIED" - State must be specified. // "STARTED" - The patch job was successfully initiated. // "INSTANCE_LOOKUP" - The patch job is looking up instances to run // the patch on. // "PATCHING" - Instances are being patched. // "SUCCEEDED" - Patch job completed successfully. // "COMPLETED_WITH_ERRORS" - Patch job completed but there were // errors. // "CANCELED" - The patch job was canceled. // "TIMED_OUT" - The patch job timed out. State string `json:"state,omitempty"` // UpdateTime: Last time this patch job was updated. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "CreateTime") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CreateTime") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *PatchJob) MarshalJSON() ([]byte, error) { type NoMethod PatchJob raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } func (s *PatchJob) UnmarshalJSON(data []byte) error { type NoMethod PatchJob var s1 struct { PercentComplete gensupport.JSONFloat64 `json:"percentComplete"` *NoMethod } s1.NoMethod = (*NoMethod)(s) if err := json.Unmarshal(data, &s1); err != nil { return err } s.PercentComplete = float64(s1.PercentComplete) return nil } // PatchJobInstanceDetails: Patch details for a VM instance. For more // information about reviewing VM // instance details, see // [Listing all VM instance details for a specific // patch // job](https://cloud.google.com/compute/docs/os-patch-management/m // anage-patch-jobs#list-instance-details). type PatchJobInstanceDetails struct { // AttemptCount: The number of times the agent that the agent attempts // to apply the patch. AttemptCount int64 `json:"attemptCount,omitempty,string"` // FailureReason: If the patch fails, this field provides the reason. FailureReason string `json:"failureReason,omitempty"` // InstanceSystemId: The unique identifier for the instance. This // identifier is // defined by the server. InstanceSystemId string `json:"instanceSystemId,omitempty"` // Name: The instance name in the form `projects/*/zones/*/instances/*` Name string `json:"name,omitempty"` // State: Current state of instance patch. // // Possible values: // "PATCH_STATE_UNSPECIFIED" - Unspecified. // "PENDING" - The instance is not yet notified. // "INACTIVE" - Instance is inactive and cannot be patched. // "NOTIFIED" - The instance is notified that it should be patched. // "STARTED" - The instance has started the patching process. // "DOWNLOADING_PATCHES" - The instance is downloading patches. // "APPLYING_PATCHES" - The instance is applying patches. // "REBOOTING" - The instance is rebooting. // "SUCCEEDED" - The instance has completed applying patches. // "SUCCEEDED_REBOOT_REQUIRED" - The instance has completed applying // patches but a reboot is required. // "FAILED" - The instance has failed to apply the patch. // "ACKED" - The instance acked the notification and will start // shortly. // "TIMED_OUT" - The instance exceeded the time out while applying the // patch. // "RUNNING_PRE_PATCH_STEP" - The instance is running the pre-patch // step. // "RUNNING_POST_PATCH_STEP" - The instance is running the post-patch // step. // "NO_AGENT_DETECTED" - The service could not detect the presence of // the agent. Check to ensure // that the agent is installed, running, and able to communicate with // the // service. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "AttemptCount") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "AttemptCount") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *PatchJobInstanceDetails) MarshalJSON() ([]byte, error) { type NoMethod PatchJobInstanceDetails raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // PatchJobInstanceDetailsSummary: A summary of the current patch state // across all instances that this patch // job affects. Contains counts of instances in different states. These // states // map to `InstancePatchState`. List patch job instance details to see // the // specific states of each instance. type PatchJobInstanceDetailsSummary struct { // AckedInstanceCount: Number of instances that have acked and will // start shortly. AckedInstanceCount int64 `json:"ackedInstanceCount,omitempty,string"` // ApplyingPatchesInstanceCount: Number of instances that are applying // patches. ApplyingPatchesInstanceCount int64 `json:"applyingPatchesInstanceCount,omitempty,string"` // DownloadingPatchesInstanceCount: Number of instances that are // downloading patches. DownloadingPatchesInstanceCount int64 `json:"downloadingPatchesInstanceCount,omitempty,string"` // FailedInstanceCount: Number of instances that failed. FailedInstanceCount int64 `json:"failedInstanceCount,omitempty,string"` // InactiveInstanceCount: Number of instances that are inactive. InactiveInstanceCount int64 `json:"inactiveInstanceCount,omitempty,string"` // NoAgentDetectedInstanceCount: Number of instances that do not appear // to be running the agent. Check to // ensure that the agent is installed, running, and able to communicate // with // the service. NoAgentDetectedInstanceCount int64 `json:"noAgentDetectedInstanceCount,omitempty,string"` // NotifiedInstanceCount: Number of instances notified about patch job. NotifiedInstanceCount int64 `json:"notifiedInstanceCount,omitempty,string"` // PendingInstanceCount: Number of instances pending patch job. PendingInstanceCount int64 `json:"pendingInstanceCount,omitempty,string"` // PostPatchStepInstanceCount: Number of instances that are running the // post-patch step. PostPatchStepInstanceCount int64 `json:"postPatchStepInstanceCount,omitempty,string"` // PrePatchStepInstanceCount: Number of instances that are running the // pre-patch step. PrePatchStepInstanceCount int64 `json:"prePatchStepInstanceCount,omitempty,string"` // RebootingInstanceCount: Number of instances rebooting. RebootingInstanceCount int64 `json:"rebootingInstanceCount,omitempty,string"` // StartedInstanceCount: Number of instances that have started. StartedInstanceCount int64 `json:"startedInstanceCount,omitempty,string"` // SucceededInstanceCount: Number of instances that have completed // successfully. SucceededInstanceCount int64 `json:"succeededInstanceCount,omitempty,string"` // SucceededRebootRequiredInstanceCount: Number of instances that // require reboot. SucceededRebootRequiredInstanceCount int64 `json:"succeededRebootRequiredInstanceCount,omitempty,string"` // TimedOutInstanceCount: Number of instances that exceeded the time out // while applying the patch. TimedOutInstanceCount int64 `json:"timedOutInstanceCount,omitempty,string"` // ForceSendFields is a list of field names (e.g. "AckedInstanceCount") // to unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "AckedInstanceCount") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` } func (s *PatchJobInstanceDetailsSummary) MarshalJSON() ([]byte, error) { type NoMethod PatchJobInstanceDetailsSummary raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // RecurringSchedule: Sets the time for recurring patch deployments. type RecurringSchedule struct { // EndTime: Optional. The end time at which a recurring patch deployment // schedule is no longer // active. EndTime string `json:"endTime,omitempty"` // Frequency: Required. The frequency unit of this recurring schedule. // // Possible values: // "FREQUENCY_UNSPECIFIED" - Invalid. A frequency must be specified. // "WEEKLY" - Indicates that the frequency should be expressed in // terms of // weeks. // "MONTHLY" - Indicates that the frequency should be expressed in // terms of // months. Frequency string `json:"frequency,omitempty"` // LastExecuteTime: Output only. The time the last patch job ran // successfully. LastExecuteTime string `json:"lastExecuteTime,omitempty"` // Monthly: Required. Schedule with monthly executions. Monthly *MonthlySchedule `json:"monthly,omitempty"` // NextExecuteTime: Output only. The time the next patch job is // scheduled to run. NextExecuteTime string `json:"nextExecuteTime,omitempty"` // StartTime: Optional. The time that the recurring schedule becomes // effective. // Defaults to `create_time` of the patch deployment. StartTime string `json:"startTime,omitempty"` // TimeOfDay: Required. Time of the day to run a recurring deployment. TimeOfDay *TimeOfDay `json:"timeOfDay,omitempty"` // TimeZone: Required. Defines the time zone that `time_of_day` is // relative to. // The rules for daylight saving time are determined by the chosen time // zone. TimeZone *TimeZone `json:"timeZone,omitempty"` // Weekly: Required. Schedule with weekly executions. Weekly *WeeklySchedule `json:"weekly,omitempty"` // ForceSendFields is a list of field names (e.g. "EndTime") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "EndTime") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *RecurringSchedule) MarshalJSON() ([]byte, error) { type NoMethod RecurringSchedule raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // TimeOfDay: Represents a time of day. The date and time zone are // either not significant // or are specified elsewhere. An API may choose to allow leap seconds. // Related // types are google.type.Date and `google.protobuf.Timestamp`. type TimeOfDay struct { // Hours: Hours of day in 24 hour format. Should be from 0 to 23. An API // may choose // to allow the value "24:00:00" for scenarios like business closing // time. Hours int64 `json:"hours,omitempty"` // Minutes: Minutes of hour of day. Must be from 0 to 59. Minutes int64 `json:"minutes,omitempty"` // Nanos: Fractions of seconds in nanoseconds. Must be from 0 to // 999,999,999. Nanos int64 `json:"nanos,omitempty"` // Seconds: Seconds of minutes of the time. Must normally be from 0 to // 59. An API may // allow the value 60 if it allows leap-seconds. Seconds int64 `json:"seconds,omitempty"` // ForceSendFields is a list of field names (e.g. "Hours") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Hours") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *TimeOfDay) MarshalJSON() ([]byte, error) { type NoMethod TimeOfDay raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // TimeZone: Represents a time zone from the // [IANA Time Zone Database](https://www.iana.org/time-zones). type TimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` // Version: Optional. IANA Time Zone Database version number, e.g. // "2019a". Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Id") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Id") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *TimeZone) MarshalJSON() ([]byte, error) { type NoMethod TimeZone raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // WeekDayOfMonth: Represents one week day in a month. An example is // "the 4th Sunday". type WeekDayOfMonth struct { // DayOfWeek: Required. A day of the week. // // Possible values: // "DAY_OF_WEEK_UNSPECIFIED" - The day of the week is unspecified. // "MONDAY" - Monday // "TUESDAY" - Tuesday // "WEDNESDAY" - Wednesday // "THURSDAY" - Thursday // "FRIDAY" - Friday // "SATURDAY" - Saturday // "SUNDAY" - Sunday DayOfWeek string `json:"dayOfWeek,omitempty"` // WeekOrdinal: Required. Week number in a month. 1-4 indicates the 1st // to 4th week of the month. -1 // indicates the last week of the month. WeekOrdinal int64 `json:"weekOrdinal,omitempty"` // ForceSendFields is a list of field names (e.g. "DayOfWeek") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "DayOfWeek") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *WeekDayOfMonth) MarshalJSON() ([]byte, error) { type NoMethod WeekDayOfMonth raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // WeeklySchedule: Represents a weekly schedule. type WeeklySchedule struct { // DayOfWeek: Required. Day of the week. // // Possible values: // "DAY_OF_WEEK_UNSPECIFIED" - The day of the week is unspecified. // "MONDAY" - Monday // "TUESDAY" - Tuesday // "WEDNESDAY" - Wednesday // "THURSDAY" - Thursday // "FRIDAY" - Friday // "SATURDAY" - Saturday // "SUNDAY" - Sunday DayOfWeek string `json:"dayOfWeek,omitempty"` // ForceSendFields is a list of field names (e.g. "DayOfWeek") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "DayOfWeek") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *WeeklySchedule) MarshalJSON() ([]byte, error) { type NoMethod WeeklySchedule raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // WindowsUpdateSettings: Windows patching is performed using the // Windows Update Agent. type WindowsUpdateSettings struct { // Classifications: Only apply updates of these windows update // classifications. If empty, all // updates are applied. // // Possible values: // "CLASSIFICATION_UNSPECIFIED" - Invalid. If classifications are // included, they must be specified. // "CRITICAL" - "A widely released fix for a specific problem that // addresses a critical, // non-security-related bug." [1] // "SECURITY" - "A widely released fix for a product-specific, // security-related // vulnerability. Security vulnerabilities are rated by their severity. // The // severity rating is indicated in the Microsoft security bulletin // as // critical, important, moderate, or low." [1] // "DEFINITION" - "A widely released and frequent software update that // contains additions // to a product's definition database. Definition databases are often // used // to detect objects that have specific attributes, such as malicious // code, // phishing websites, or junk mail." [1] // "DRIVER" - "Software that controls the input and output of a // device." [1] // "FEATURE_PACK" - "New product functionality that is first // distributed outside the context // of a product release and that is typically included in the next // full // product release." [1] // "SERVICE_PACK" - "A tested, cumulative set of all hotfixes, // security updates, critical // updates, and updates. Additionally, service packs may contain // additional // fixes for problems that are found internally since the release of // the // product. Service packs my also contain a limited number // of // customer-requested design changes or features." [1] // "TOOL" - "A utility or feature that helps complete a task or set of // tasks." [1] // "UPDATE_ROLLUP" - "A tested, cumulative set of hotfixes, security // updates, critical // updates, and updates that are packaged together for easy deployment. // A // rollup generally targets a specific area, such as security, or // a // component of a product, such as Internet Information Services (IIS)." // [1] // "UPDATE" - "A widely released fix for a specific problem. An update // addresses a // noncritical, non-security-related bug." [1] Classifications []string `json:"classifications,omitempty"` // Excludes: List of KBs to exclude from update. Excludes []string `json:"excludes,omitempty"` // ExclusivePatches: An exclusive list of kbs to be updated. These are // the only patches // that will be updated. This field must not be used with other // patch configurations. ExclusivePatches []string `json:"exclusivePatches,omitempty"` // ForceSendFields is a list of field names (e.g. "Classifications") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Classifications") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` } func (s *WindowsUpdateSettings) MarshalJSON() ([]byte, error) { type NoMethod WindowsUpdateSettings raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // YumSettings: Yum patching is performed by executing `yum update`. // Additional options // can be set to control how this is executed. // // Note that not all settings are supported on all platforms. type YumSettings struct { // Excludes: List of packages to exclude from update. These packages are // excluded by // using the yum `--exclude` flag. Excludes []string `json:"excludes,omitempty"` // ExclusivePackages: An exclusive list of packages to be updated. These // are the only packages // that will be updated. If these packages are not installed, they will // be // ignored. This field must not be specified with any other // patch // configuration fields. ExclusivePackages []string `json:"exclusivePackages,omitempty"` // Minimal: Will cause patch to run `yum update-minimal` instead. Minimal bool `json:"minimal,omitempty"` // Security: Adds the `--security` flag to `yum update`. Not supported // on // all platforms. Security bool `json:"security,omitempty"` // ForceSendFields is a list of field names (e.g. "Excludes") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Excludes") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *YumSettings) MarshalJSON() ([]byte, error) { type NoMethod YumSettings raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // ZypperSettings: Zypper patching is performed by running `zypper // patch`. // See also https://en.opensuse.org/SDB:Zypper_manual. type ZypperSettings struct { // Categories: Install only patches with these categories. // Common categories include security, recommended, and feature. Categories []string `json:"categories,omitempty"` // Excludes: List of patches to exclude from update. Excludes []string `json:"excludes,omitempty"` // ExclusivePatches: An exclusive list of patches to be updated. These // are the only patches // that will be installed using 'zypper patch patch:' // command. // This field must not be used with any other patch configuration // fields. ExclusivePatches []string `json:"exclusivePatches,omitempty"` // Severities: Install only patches with these severities. // Common severities include critical, important, moderate, and low. Severities []string `json:"severities,omitempty"` // WithOptional: Adds the `--with-optional` flag to `zypper patch`. WithOptional bool `json:"withOptional,omitempty"` // WithUpdate: Adds the `--with-update` flag, to `zypper patch`. WithUpdate bool `json:"withUpdate,omitempty"` // ForceSendFields is a list of field names (e.g. "Categories") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Categories") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } func (s *ZypperSettings) MarshalJSON() ([]byte, error) { type NoMethod ZypperSettings raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // method id "osconfig.projects.patchDeployments.create": type ProjectsPatchDeploymentsCreateCall struct { s *Service parent string patchdeployment *PatchDeployment urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Create: Create an OS Config patch deployment. func (r *ProjectsPatchDeploymentsService) Create(parent string, patchdeployment *PatchDeployment) *ProjectsPatchDeploymentsCreateCall { c := &ProjectsPatchDeploymentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent c.patchdeployment = patchdeployment return c } // PatchDeploymentId sets the optional parameter "patchDeploymentId": // Required. A name for the patch deployment in the project. When // creating a name // the following rules apply: // * Must contain only lowercase letters, numbers, and hyphens. // * Must start with a letter. // * Must be between 1-63 characters. // * Must end with a number or a letter. // * Must be unique within the project. func (c *ProjectsPatchDeploymentsCreateCall) PatchDeploymentId(patchDeploymentId string) *ProjectsPatchDeploymentsCreateCall { c.urlParams_.Set("patchDeploymentId", patchDeploymentId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchDeploymentsCreateCall) Fields(s ...googleapi.Field) *ProjectsPatchDeploymentsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchDeploymentsCreateCall) Context(ctx context.Context) *ProjectsPatchDeploymentsCreateCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchDeploymentsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchDeploymentsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.patchdeployment) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/patchDeployments") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchDeployments.create" call. // Exactly one of *PatchDeployment or error will be non-nil. Any non-2xx // status code is an error. Response headers are in either // *PatchDeployment.ServerResponse.Header or (if a response was returned // at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was // because http.StatusNotModified was returned. func (c *ProjectsPatchDeploymentsCreateCall) Do(opts ...googleapi.CallOption) (*PatchDeployment, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &PatchDeployment{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Create an OS Config patch deployment.", // "flatPath": "v1/projects/{projectsId}/patchDeployments", // "httpMethod": "POST", // "id": "osconfig.projects.patchDeployments.create", // "parameterOrder": [ // "parent" // ], // "parameters": { // "parent": { // "description": "Required. The project to apply this patch deployment to in the form `projects/*`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, // "type": "string" // }, // "patchDeploymentId": { // "description": "Required. A name for the patch deployment in the project. When creating a name\nthe following rules apply:\n* Must contain only lowercase letters, numbers, and hyphens.\n* Must start with a letter.\n* Must be between 1-63 characters.\n* Must end with a number or a letter.\n* Must be unique within the project.", // "location": "query", // "type": "string" // } // }, // "path": "v1/{+parent}/patchDeployments", // "request": { // "$ref": "PatchDeployment" // }, // "response": { // "$ref": "PatchDeployment" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // method id "osconfig.projects.patchDeployments.delete": type ProjectsPatchDeploymentsDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Delete: Delete an OS Config patch deployment. func (r *ProjectsPatchDeploymentsService) Delete(name string) *ProjectsPatchDeploymentsDeleteCall { c := &ProjectsPatchDeploymentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchDeploymentsDeleteCall) Fields(s ...googleapi.Field) *ProjectsPatchDeploymentsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchDeploymentsDeleteCall) Context(ctx context.Context) *ProjectsPatchDeploymentsDeleteCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchDeploymentsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchDeploymentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchDeployments.delete" call. // Exactly one of *Empty or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *Empty.ServerResponse.Header or (if a response was returned at all) // in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to // check whether the returned error was because http.StatusNotModified // was returned. func (c *ProjectsPatchDeploymentsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Delete an OS Config patch deployment.", // "flatPath": "v1/projects/{projectsId}/patchDeployments/{patchDeploymentsId}", // "httpMethod": "DELETE", // "id": "osconfig.projects.patchDeployments.delete", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { // "description": "Required. The resource name of the patch deployment in the form\n`projects/*/patchDeployments/*`.", // "location": "path", // "pattern": "^projects/[^/]+/patchDeployments/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+name}", // "response": { // "$ref": "Empty" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // method id "osconfig.projects.patchDeployments.get": type ProjectsPatchDeploymentsGetCall struct { s *Service name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // Get: Get an OS Config patch deployment. func (r *ProjectsPatchDeploymentsService) Get(name string) *ProjectsPatchDeploymentsGetCall { c := &ProjectsPatchDeploymentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchDeploymentsGetCall) Fields(s ...googleapi.Field) *ProjectsPatchDeploymentsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets the optional parameter which makes the operation // fail if the object's ETag matches the given value. This is useful for // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. func (c *ProjectsPatchDeploymentsGetCall) IfNoneMatch(entityTag string) *ProjectsPatchDeploymentsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchDeploymentsGetCall) Context(ctx context.Context) *ProjectsPatchDeploymentsGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchDeploymentsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchDeploymentsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchDeployments.get" call. // Exactly one of *PatchDeployment or error will be non-nil. Any non-2xx // status code is an error. Response headers are in either // *PatchDeployment.ServerResponse.Header or (if a response was returned // at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was // because http.StatusNotModified was returned. func (c *ProjectsPatchDeploymentsGetCall) Do(opts ...googleapi.CallOption) (*PatchDeployment, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &PatchDeployment{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Get an OS Config patch deployment.", // "flatPath": "v1/projects/{projectsId}/patchDeployments/{patchDeploymentsId}", // "httpMethod": "GET", // "id": "osconfig.projects.patchDeployments.get", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { // "description": "Required. The resource name of the patch deployment in the form\n`projects/*/patchDeployments/*`.", // "location": "path", // "pattern": "^projects/[^/]+/patchDeployments/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+name}", // "response": { // "$ref": "PatchDeployment" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // method id "osconfig.projects.patchDeployments.list": type ProjectsPatchDeploymentsListCall struct { s *Service parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // List: Get a page of OS Config patch deployments. func (r *ProjectsPatchDeploymentsService) List(parent string) *ProjectsPatchDeploymentsListCall { c := &ProjectsPatchDeploymentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } // PageSize sets the optional parameter "pageSize": The maximum number // of patch deployments to return. Default is 100. func (c *ProjectsPatchDeploymentsListCall) PageSize(pageSize int64) *ProjectsPatchDeploymentsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A pagination token // returned from a previous call to ListPatchDeployments // that indicates where this listing should continue from. func (c *ProjectsPatchDeploymentsListCall) PageToken(pageToken string) *ProjectsPatchDeploymentsListCall { c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchDeploymentsListCall) Fields(s ...googleapi.Field) *ProjectsPatchDeploymentsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets the optional parameter which makes the operation // fail if the object's ETag matches the given value. This is useful for // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. func (c *ProjectsPatchDeploymentsListCall) IfNoneMatch(entityTag string) *ProjectsPatchDeploymentsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchDeploymentsListCall) Context(ctx context.Context) *ProjectsPatchDeploymentsListCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchDeploymentsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchDeploymentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/patchDeployments") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchDeployments.list" call. // Exactly one of *ListPatchDeploymentsResponse or error will be // non-nil. Any non-2xx status code is an error. Response headers are in // either *ListPatchDeploymentsResponse.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was // because http.StatusNotModified was returned. func (c *ProjectsPatchDeploymentsListCall) Do(opts ...googleapi.CallOption) (*ListPatchDeploymentsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &ListPatchDeploymentsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Get a page of OS Config patch deployments.", // "flatPath": "v1/projects/{projectsId}/patchDeployments", // "httpMethod": "GET", // "id": "osconfig.projects.patchDeployments.list", // "parameterOrder": [ // "parent" // ], // "parameters": { // "pageSize": { // "description": "Optional. The maximum number of patch deployments to return. Default is 100.", // "format": "int32", // "location": "query", // "type": "integer" // }, // "pageToken": { // "description": "Optional. A pagination token returned from a previous call to ListPatchDeployments\nthat indicates where this listing should continue from.", // "location": "query", // "type": "string" // }, // "parent": { // "description": "Required. The resource name of the parent in the form `projects/*`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+parent}/patchDeployments", // "response": { // "$ref": "ListPatchDeploymentsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. func (c *ProjectsPatchDeploymentsListCall) Pages(ctx context.Context, f func(*ListPatchDeploymentsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point for { x, err := c.Do() if err != nil { return err } if err := f(x); err != nil { return err } if x.NextPageToken == "" { return nil } c.PageToken(x.NextPageToken) } } // method id "osconfig.projects.patchJobs.cancel": type ProjectsPatchJobsCancelCall struct { s *Service name string cancelpatchjobrequest *CancelPatchJobRequest urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Cancel: Cancel a patch job. The patch job must be active. Canceled // patch jobs // cannot be restarted. func (r *ProjectsPatchJobsService) Cancel(name string, cancelpatchjobrequest *CancelPatchJobRequest) *ProjectsPatchJobsCancelCall { c := &ProjectsPatchJobsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name c.cancelpatchjobrequest = cancelpatchjobrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchJobsCancelCall) Fields(s ...googleapi.Field) *ProjectsPatchJobsCancelCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchJobsCancelCall) Context(ctx context.Context) *ProjectsPatchJobsCancelCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchJobsCancelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchJobsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.cancelpatchjobrequest) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchJobs.cancel" call. // Exactly one of *PatchJob or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *PatchJob.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified // to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsPatchJobsCancelCall) Do(opts ...googleapi.CallOption) (*PatchJob, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &PatchJob{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Cancel a patch job. The patch job must be active. Canceled patch jobs\ncannot be restarted.", // "flatPath": "v1/projects/{projectsId}/patchJobs/{patchJobsId}:cancel", // "httpMethod": "POST", // "id": "osconfig.projects.patchJobs.cancel", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { // "description": "Required. Name of the patch in the form `projects/*/patchJobs/*`", // "location": "path", // "pattern": "^projects/[^/]+/patchJobs/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+name}:cancel", // "request": { // "$ref": "CancelPatchJobRequest" // }, // "response": { // "$ref": "PatchJob" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // method id "osconfig.projects.patchJobs.execute": type ProjectsPatchJobsExecuteCall struct { s *Service parent string executepatchjobrequest *ExecutePatchJobRequest urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Execute: Patch VM instances by creating and running a patch job. func (r *ProjectsPatchJobsService) Execute(parent string, executepatchjobrequest *ExecutePatchJobRequest) *ProjectsPatchJobsExecuteCall { c := &ProjectsPatchJobsExecuteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent c.executepatchjobrequest = executepatchjobrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchJobsExecuteCall) Fields(s ...googleapi.Field) *ProjectsPatchJobsExecuteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchJobsExecuteCall) Context(ctx context.Context) *ProjectsPatchJobsExecuteCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchJobsExecuteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchJobsExecuteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.executepatchjobrequest) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/patchJobs:execute") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchJobs.execute" call. // Exactly one of *PatchJob or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *PatchJob.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified // to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsPatchJobsExecuteCall) Do(opts ...googleapi.CallOption) (*PatchJob, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &PatchJob{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Patch VM instances by creating and running a patch job.", // "flatPath": "v1/projects/{projectsId}/patchJobs:execute", // "httpMethod": "POST", // "id": "osconfig.projects.patchJobs.execute", // "parameterOrder": [ // "parent" // ], // "parameters": { // "parent": { // "description": "Required. The project in which to run this patch in the form `projects/*`", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+parent}/patchJobs:execute", // "request": { // "$ref": "ExecutePatchJobRequest" // }, // "response": { // "$ref": "PatchJob" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // method id "osconfig.projects.patchJobs.get": type ProjectsPatchJobsGetCall struct { s *Service name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // Get: Get the patch job. This can be used to track the progress of // an // ongoing patch job or review the details of completed jobs. func (r *ProjectsPatchJobsService) Get(name string) *ProjectsPatchJobsGetCall { c := &ProjectsPatchJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchJobsGetCall) Fields(s ...googleapi.Field) *ProjectsPatchJobsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets the optional parameter which makes the operation // fail if the object's ETag matches the given value. This is useful for // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. func (c *ProjectsPatchJobsGetCall) IfNoneMatch(entityTag string) *ProjectsPatchJobsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchJobsGetCall) Context(ctx context.Context) *ProjectsPatchJobsGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchJobsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchJobsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchJobs.get" call. // Exactly one of *PatchJob or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *PatchJob.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified // to check whether the returned error was because // http.StatusNotModified was returned. func (c *ProjectsPatchJobsGetCall) Do(opts ...googleapi.CallOption) (*PatchJob, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &PatchJob{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Get the patch job. This can be used to track the progress of an\nongoing patch job or review the details of completed jobs.", // "flatPath": "v1/projects/{projectsId}/patchJobs/{patchJobsId}", // "httpMethod": "GET", // "id": "osconfig.projects.patchJobs.get", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { // "description": "Required. Name of the patch in the form `projects/*/patchJobs/*`", // "location": "path", // "pattern": "^projects/[^/]+/patchJobs/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+name}", // "response": { // "$ref": "PatchJob" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // method id "osconfig.projects.patchJobs.list": type ProjectsPatchJobsListCall struct { s *Service parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // List: Get a list of patch jobs. func (r *ProjectsPatchJobsService) List(parent string) *ProjectsPatchJobsListCall { c := &ProjectsPatchJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } // Filter sets the optional parameter "filter": If provided, this field // specifies the criteria that must be met by patch // jobs to be included in the response. // Currently, filtering is only available on the patch_deployment field. func (c *ProjectsPatchJobsListCall) Filter(filter string) *ProjectsPatchJobsListCall { c.urlParams_.Set("filter", filter) return c } // PageSize sets the optional parameter "pageSize": The maximum number // of instance status to return. func (c *ProjectsPatchJobsListCall) PageSize(pageSize int64) *ProjectsPatchJobsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A pagination token // returned from a previous call // that indicates where this listing should continue from. func (c *ProjectsPatchJobsListCall) PageToken(pageToken string) *ProjectsPatchJobsListCall { c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchJobsListCall) Fields(s ...googleapi.Field) *ProjectsPatchJobsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets the optional parameter which makes the operation // fail if the object's ETag matches the given value. This is useful for // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. func (c *ProjectsPatchJobsListCall) IfNoneMatch(entityTag string) *ProjectsPatchJobsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchJobsListCall) Context(ctx context.Context) *ProjectsPatchJobsListCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchJobsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchJobsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/patchJobs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchJobs.list" call. // Exactly one of *ListPatchJobsResponse or error will be non-nil. Any // non-2xx status code is an error. Response headers are in either // *ListPatchJobsResponse.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was // because http.StatusNotModified was returned. func (c *ProjectsPatchJobsListCall) Do(opts ...googleapi.CallOption) (*ListPatchJobsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &ListPatchJobsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Get a list of patch jobs.", // "flatPath": "v1/projects/{projectsId}/patchJobs", // "httpMethod": "GET", // "id": "osconfig.projects.patchJobs.list", // "parameterOrder": [ // "parent" // ], // "parameters": { // "filter": { // "description": "If provided, this field specifies the criteria that must be met by patch\njobs to be included in the response.\nCurrently, filtering is only available on the patch_deployment field.", // "location": "query", // "type": "string" // }, // "pageSize": { // "description": "The maximum number of instance status to return.", // "format": "int32", // "location": "query", // "type": "integer" // }, // "pageToken": { // "description": "A pagination token returned from a previous call\nthat indicates where this listing should continue from.", // "location": "query", // "type": "string" // }, // "parent": { // "description": "Required. In the form of `projects/*`", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+parent}/patchJobs", // "response": { // "$ref": "ListPatchJobsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. func (c *ProjectsPatchJobsListCall) Pages(ctx context.Context, f func(*ListPatchJobsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point for { x, err := c.Do() if err != nil { return err } if err := f(x); err != nil { return err } if x.NextPageToken == "" { return nil } c.PageToken(x.NextPageToken) } } // method id "osconfig.projects.patchJobs.instanceDetails.list": type ProjectsPatchJobsInstanceDetailsListCall struct { s *Service parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // List: Get a list of instance details for a given patch job. func (r *ProjectsPatchJobsInstanceDetailsService) List(parent string) *ProjectsPatchJobsInstanceDetailsListCall { c := &ProjectsPatchJobsInstanceDetailsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } // Filter sets the optional parameter "filter": A filter expression that // filters results listed in the response. This // field supports filtering results by instance zone, name, state, // or // `failure_reason`. func (c *ProjectsPatchJobsInstanceDetailsListCall) Filter(filter string) *ProjectsPatchJobsInstanceDetailsListCall { c.urlParams_.Set("filter", filter) return c } // PageSize sets the optional parameter "pageSize": The maximum number // of instance details records to return. Default is 100. func (c *ProjectsPatchJobsInstanceDetailsListCall) PageSize(pageSize int64) *ProjectsPatchJobsInstanceDetailsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A pagination token // returned from a previous call // that indicates where this listing should continue from. func (c *ProjectsPatchJobsInstanceDetailsListCall) PageToken(pageToken string) *ProjectsPatchJobsInstanceDetailsListCall { c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. func (c *ProjectsPatchJobsInstanceDetailsListCall) Fields(s ...googleapi.Field) *ProjectsPatchJobsInstanceDetailsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // IfNoneMatch sets the optional parameter which makes the operation // fail if the object's ETag matches the given value. This is useful for // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. func (c *ProjectsPatchJobsInstanceDetailsListCall) IfNoneMatch(entityTag string) *ProjectsPatchJobsInstanceDetailsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. func (c *ProjectsPatchJobsInstanceDetailsListCall) Context(ctx context.Context) *ProjectsPatchJobsInstanceDetailsListCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. func (c *ProjectsPatchJobsInstanceDetailsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *ProjectsPatchJobsInstanceDetailsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20200518") for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/instanceDetails") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "osconfig.projects.patchJobs.instanceDetails.list" call. // Exactly one of *ListPatchJobInstanceDetailsResponse or error will be // non-nil. Any non-2xx status code is an error. Response headers are in // either *ListPatchJobInstanceDetailsResponse.ServerResponse.Header or // (if a response was returned at all) in // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check // whether the returned error was because http.StatusNotModified was // returned. func (c *ProjectsPatchJobsInstanceDetailsListCall) Do(opts ...googleapi.CallOption) (*ListPatchJobInstanceDetailsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { if res.Body != nil { res.Body.Close() } return nil, &googleapi.Error{ Code: res.StatusCode, Header: res.Header, } } if err != nil { return nil, err } defer googleapi.CloseBody(res) if err := googleapi.CheckResponse(res); err != nil { return nil, err } ret := &ListPatchJobInstanceDetailsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, }, } target := &ret if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } return ret, nil // { // "description": "Get a list of instance details for a given patch job.", // "flatPath": "v1/projects/{projectsId}/patchJobs/{patchJobsId}/instanceDetails", // "httpMethod": "GET", // "id": "osconfig.projects.patchJobs.instanceDetails.list", // "parameterOrder": [ // "parent" // ], // "parameters": { // "filter": { // "description": "A filter expression that filters results listed in the response. This\nfield supports filtering results by instance zone, name, state, or\n`failure_reason`.", // "location": "query", // "type": "string" // }, // "pageSize": { // "description": "The maximum number of instance details records to return. Default is 100.", // "format": "int32", // "location": "query", // "type": "integer" // }, // "pageToken": { // "description": "A pagination token returned from a previous call\nthat indicates where this listing should continue from.", // "location": "query", // "type": "string" // }, // "parent": { // "description": "Required. The parent for the instances are in the form of `projects/*/patchJobs/*`.", // "location": "path", // "pattern": "^projects/[^/]+/patchJobs/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+parent}/instanceDetails", // "response": { // "$ref": "ListPatchJobInstanceDetailsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" // ] // } } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. func (c *ProjectsPatchJobsInstanceDetailsListCall) Pages(ctx context.Context, f func(*ListPatchJobInstanceDetailsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point for { x, err := c.Do() if err != nil { return err } if err := f(x); err != nil { return err } if x.NextPageToken == "" { return nil } c.PageToken(x.NextPageToken) } }