* $computeService = new Google_Service_Compute(...); * $instances = $computeService->instances; * */ class Google_Service_Compute_Resource_Instances extends Google_Service_Resource { /** * Adds an access config to an instance's network interface. * (instances.addAccessConfig) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param string $networkInterface The name of the network interface to add to * this instance. * @param Google_Service_Compute_AccessConfig $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function addAccessConfig($project, $zone, $instance, $networkInterface, Google_Service_Compute_AccessConfig $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'networkInterface' => $networkInterface, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('addAccessConfig', array($params), "Google_Service_Compute_Operation"); } /** * Adds existing resource policies to an instance. You can only add one policy * right now which will be applied to this instance for scheduling live * migrations. (instances.addResourcePolicies) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param Google_Service_Compute_InstancesAddResourcePoliciesRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function addResourcePolicies($project, $zone, $instance, Google_Service_Compute_InstancesAddResourcePoliciesRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('addResourcePolicies', array($params), "Google_Service_Compute_Operation"); } /** * Retrieves aggregated list of all of the instances in your project across all * regions and zones. (instances.aggregatedList) * * @param string $project Project ID for this request. * @param array $optParams Optional parameters. * * @opt_param string filter A filter expression that filters resources listed in * the response. The expression must specify the field name, a comparison * operator, and the value that you want to use for filtering. The value must be * a string, a number, or a boolean. The comparison operator must be either `=`, * `!=`, `>`, or `<`. * * For example, if you are filtering Compute Engine instances, you can exclude * instances named `example-instance` by specifying `name != example-instance`. * * You can also filter nested fields. For example, you could specify * `scheduling.automaticRestart = false` to include instances only if they are * not scheduled for automatic restarts. You can use filtering on nested fields * to filter based on resource labels. * * To filter on multiple expressions, provide each separate expression within * parentheses. For example: ``` (scheduling.automaticRestart = true) * (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` * expression. However, you can include `AND` and `OR` expressions explicitly. * For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel * Broadwell") AND (scheduling.automaticRestart = true) ``` * @opt_param bool includeAllScopes Indicates whether every visible scope for * each scope type (zone, region, global) should be included in the response. * For new resource types added after this field, the flag has no effect as new * resource types will always include every visible scope for each scope type in * response. For resource types which predate this field, if this flag is * omitted or false, only scopes of the scope types where the resource type is * expected to be found will be included. * @opt_param string maxResults The maximum number of results per page that * should be returned. If the number of available results is larger than * `maxResults`, Compute Engine returns a `nextPageToken` that can be used to * get the next page of results in subsequent list requests. Acceptable values * are `0` to `500`, inclusive. (Default: `500`) * @opt_param string orderBy Sorts list results by a certain order. By default, * results are returned in alphanumerical order based on the resource name. * * You can also sort results in descending order based on the creation timestamp * using `orderBy="creationTimestamp desc"`. This sorts results based on the * `creationTimestamp` field in reverse chronological order (newest result * first). Use this to sort resources like operations so that the newest * operation is returned first. * * Currently, only sorting by `name` or `creationTimestamp desc` is supported. * @opt_param string pageToken Specifies a page token to use. Set `pageToken` to * the `nextPageToken` returned by a previous list request to get the next page * of results. * @return Google_Service_Compute_InstanceAggregatedList */ public function aggregatedList($project, $optParams = array()) { $params = array('project' => $project); $params = array_merge($params, $optParams); return $this->call('aggregatedList', array($params), "Google_Service_Compute_InstanceAggregatedList"); } /** * Attaches an existing Disk resource to an instance. You must first create the * disk before you can attach it. It is not possible to create and attach a disk * at the same time. For more information, read Adding a persistent disk to your * instance. (instances.attachDisk) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param Google_Service_Compute_AttachedDisk $postBody * @param array $optParams Optional parameters. * * @opt_param bool forceAttach Whether to force attach the disk even if it's * currently attached to another instance. * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function attachDisk($project, $zone, $instance, Google_Service_Compute_AttachedDisk $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('attachDisk', array($params), "Google_Service_Compute_Operation"); } /** * Deletes the specified Instance resource. For more information, see Stopping * or Deleting an Instance. (instances.delete) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance resource to delete. * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function delete($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('delete', array($params), "Google_Service_Compute_Operation"); } /** * Deletes an access config from an instance's network interface. * (instances.deleteAccessConfig) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param string $accessConfig The name of the access config to delete. * @param string $networkInterface The name of the network interface. * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function deleteAccessConfig($project, $zone, $instance, $accessConfig, $networkInterface, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'accessConfig' => $accessConfig, 'networkInterface' => $networkInterface); $params = array_merge($params, $optParams); return $this->call('deleteAccessConfig', array($params), "Google_Service_Compute_Operation"); } /** * Detaches a disk from an instance. (instances.detachDisk) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Instance name for this request. * @param string $deviceName The device name of the disk to detach. Make a get() * request on the instance to view currently attached disks and device names. * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function detachDisk($project, $zone, $instance, $deviceName, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'deviceName' => $deviceName); $params = array_merge($params, $optParams); return $this->call('detachDisk', array($params), "Google_Service_Compute_Operation"); } /** * Returns the specified Instance resource. Gets a list of available instances * by making a list() request. (instances.get) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance resource to return. * @param array $optParams Optional parameters. * @return Google_Service_Compute_Instance */ public function get($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('get', array($params), "Google_Service_Compute_Instance"); } /** * Returns the specified guest attributes entry. (instances.getGuestAttributes) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param array $optParams Optional parameters. * * @opt_param string queryPath Specifies the guest attributes path to be * queried. * @opt_param string variableKey Specifies the key for the guest attributes * entry. * @return Google_Service_Compute_GuestAttributes */ public function getGuestAttributes($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('getGuestAttributes', array($params), "Google_Service_Compute_GuestAttributes"); } /** * Gets the access control policy for a resource. May be empty if no such policy * or resource exists. (instances.getIamPolicy) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $resource Name or id of the resource for this request. * @param array $optParams Optional parameters. * @return Google_Service_Compute_Policy */ public function getIamPolicy($project, $zone, $resource, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'resource' => $resource); $params = array_merge($params, $optParams); return $this->call('getIamPolicy', array($params), "Google_Service_Compute_Policy"); } /** * Returns the last 1 MB of serial port output from the specified instance. * (instances.getSerialPortOutput) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param array $optParams Optional parameters. * * @opt_param int port Specifies which COM or serial port to retrieve data from. * @opt_param string start Returns output starting from a specific byte * position. Use this to page through output when the output is too large to * return in a single request. For the initial request, leave this field * unspecified. For subsequent calls, this field should be set to the next value * returned in the previous call. * @return Google_Service_Compute_SerialPortOutput */ public function getSerialPortOutput($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('getSerialPortOutput', array($params), "Google_Service_Compute_SerialPortOutput"); } /** * Returns the Shielded Instance Identity of an instance * (instances.getShieldedInstanceIdentity) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name or id of the instance scoping this request. * @param array $optParams Optional parameters. * @return Google_Service_Compute_ShieldedInstanceIdentity */ public function getShieldedInstanceIdentity($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('getShieldedInstanceIdentity', array($params), "Google_Service_Compute_ShieldedInstanceIdentity"); } /** * Creates an instance resource in the specified project using the data included * in the request. (instances.insert) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param Google_Service_Compute_Instance $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @opt_param string sourceInstanceTemplate Specifies instance template to * create the instance. * * This field is optional. It can be a full or partial URL. For example, the * following are all valid URLs to an instance template: - https://www.googlea * pis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate * - projects/project/global/instanceTemplates/instanceTemplate - * global/instanceTemplates/instanceTemplate * @return Google_Service_Compute_Operation */ public function insert($project, $zone, Google_Service_Compute_Instance $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('insert', array($params), "Google_Service_Compute_Operation"); } /** * Retrieves the list of instances contained within the specified zone. * (instances.listInstances) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param array $optParams Optional parameters. * * @opt_param string filter A filter expression that filters resources listed in * the response. The expression must specify the field name, a comparison * operator, and the value that you want to use for filtering. The value must be * a string, a number, or a boolean. The comparison operator must be either `=`, * `!=`, `>`, or `<`. * * For example, if you are filtering Compute Engine instances, you can exclude * instances named `example-instance` by specifying `name != example-instance`. * * You can also filter nested fields. For example, you could specify * `scheduling.automaticRestart = false` to include instances only if they are * not scheduled for automatic restarts. You can use filtering on nested fields * to filter based on resource labels. * * To filter on multiple expressions, provide each separate expression within * parentheses. For example: ``` (scheduling.automaticRestart = true) * (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` * expression. However, you can include `AND` and `OR` expressions explicitly. * For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel * Broadwell") AND (scheduling.automaticRestart = true) ``` * @opt_param string maxResults The maximum number of results per page that * should be returned. If the number of available results is larger than * `maxResults`, Compute Engine returns a `nextPageToken` that can be used to * get the next page of results in subsequent list requests. Acceptable values * are `0` to `500`, inclusive. (Default: `500`) * @opt_param string orderBy Sorts list results by a certain order. By default, * results are returned in alphanumerical order based on the resource name. * * You can also sort results in descending order based on the creation timestamp * using `orderBy="creationTimestamp desc"`. This sorts results based on the * `creationTimestamp` field in reverse chronological order (newest result * first). Use this to sort resources like operations so that the newest * operation is returned first. * * Currently, only sorting by `name` or `creationTimestamp desc` is supported. * @opt_param string pageToken Specifies a page token to use. Set `pageToken` to * the `nextPageToken` returned by a previous list request to get the next page * of results. * @return Google_Service_Compute_InstanceList */ public function listInstances($project, $zone, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone); $params = array_merge($params, $optParams); return $this->call('list', array($params), "Google_Service_Compute_InstanceList"); } /** * Retrieves a list of resources that refer to the VM instance specified in the * request. For example, if the VM instance is part of a managed instance group, * the referrers list includes the managed instance group. For more information, * read Viewing Referrers to VM Instances. (instances.listReferrers) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the target instance scoping this request, or * '-' if the request should span over all instances in the container. * @param array $optParams Optional parameters. * * @opt_param string filter A filter expression that filters resources listed in * the response. The expression must specify the field name, a comparison * operator, and the value that you want to use for filtering. The value must be * a string, a number, or a boolean. The comparison operator must be either `=`, * `!=`, `>`, or `<`. * * For example, if you are filtering Compute Engine instances, you can exclude * instances named `example-instance` by specifying `name != example-instance`. * * You can also filter nested fields. For example, you could specify * `scheduling.automaticRestart = false` to include instances only if they are * not scheduled for automatic restarts. You can use filtering on nested fields * to filter based on resource labels. * * To filter on multiple expressions, provide each separate expression within * parentheses. For example: ``` (scheduling.automaticRestart = true) * (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` * expression. However, you can include `AND` and `OR` expressions explicitly. * For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel * Broadwell") AND (scheduling.automaticRestart = true) ``` * @opt_param string maxResults The maximum number of results per page that * should be returned. If the number of available results is larger than * `maxResults`, Compute Engine returns a `nextPageToken` that can be used to * get the next page of results in subsequent list requests. Acceptable values * are `0` to `500`, inclusive. (Default: `500`) * @opt_param string orderBy Sorts list results by a certain order. By default, * results are returned in alphanumerical order based on the resource name. * * You can also sort results in descending order based on the creation timestamp * using `orderBy="creationTimestamp desc"`. This sorts results based on the * `creationTimestamp` field in reverse chronological order (newest result * first). Use this to sort resources like operations so that the newest * operation is returned first. * * Currently, only sorting by `name` or `creationTimestamp desc` is supported. * @opt_param string pageToken Specifies a page token to use. Set `pageToken` to * the `nextPageToken` returned by a previous list request to get the next page * of results. * @return Google_Service_Compute_InstanceListReferrers */ public function listReferrers($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('listReferrers', array($params), "Google_Service_Compute_InstanceListReferrers"); } /** * Removes resource policies from an instance. * (instances.removeResourcePolicies) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param Google_Service_Compute_InstancesRemoveResourcePoliciesRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function removeResourcePolicies($project, $zone, $instance, Google_Service_Compute_InstancesRemoveResourcePoliciesRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('removeResourcePolicies', array($params), "Google_Service_Compute_Operation"); } /** * Performs a reset on the instance. This is a hard reset the VM does not do a * graceful shutdown. For more information, see Resetting an instance. * (instances.reset) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function reset($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('reset', array($params), "Google_Service_Compute_Operation"); } /** * Sets deletion protection on the instance. (instances.setDeletionProtection) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $resource Name or id of the resource for this request. * @param array $optParams Optional parameters. * * @opt_param bool deletionProtection Whether the resource should be protected * against deletion. * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setDeletionProtection($project, $zone, $resource, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'resource' => $resource); $params = array_merge($params, $optParams); return $this->call('setDeletionProtection', array($params), "Google_Service_Compute_Operation"); } /** * Sets the auto-delete flag for a disk attached to an instance. * (instances.setDiskAutoDelete) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param bool $autoDelete Whether to auto-delete the disk when the instance is * deleted. * @param string $deviceName The device name of the disk to modify. Make a get() * request on the instance to view currently attached disks and device names. * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setDiskAutoDelete($project, $zone, $instance, $autoDelete, $deviceName, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'autoDelete' => $autoDelete, 'deviceName' => $deviceName); $params = array_merge($params, $optParams); return $this->call('setDiskAutoDelete', array($params), "Google_Service_Compute_Operation"); } /** * Sets the access control policy on the specified resource. Replaces any * existing policy. (instances.setIamPolicy) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $resource Name or id of the resource for this request. * @param Google_Service_Compute_ZoneSetPolicyRequest $postBody * @param array $optParams Optional parameters. * @return Google_Service_Compute_Policy */ public function setIamPolicy($project, $zone, $resource, Google_Service_Compute_ZoneSetPolicyRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'resource' => $resource, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setIamPolicy', array($params), "Google_Service_Compute_Policy"); } /** * Sets labels on an instance. To learn more about labels, read the Labeling * Resources documentation. (instances.setLabels) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param Google_Service_Compute_InstancesSetLabelsRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setLabels($project, $zone, $instance, Google_Service_Compute_InstancesSetLabelsRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setLabels', array($params), "Google_Service_Compute_Operation"); } /** * Changes the number and/or type of accelerator for a stopped instance to the * values specified in the request. (instances.setMachineResources) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param Google_Service_Compute_InstancesSetMachineResourcesRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setMachineResources($project, $zone, $instance, Google_Service_Compute_InstancesSetMachineResourcesRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setMachineResources', array($params), "Google_Service_Compute_Operation"); } /** * Changes the machine type for a stopped instance to the machine type specified * in the request. (instances.setMachineType) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param Google_Service_Compute_InstancesSetMachineTypeRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setMachineType($project, $zone, $instance, Google_Service_Compute_InstancesSetMachineTypeRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setMachineType', array($params), "Google_Service_Compute_Operation"); } /** * Sets metadata for the specified instance to the data included in the request. * (instances.setMetadata) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param Google_Service_Compute_Metadata $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setMetadata($project, $zone, $instance, Google_Service_Compute_Metadata $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setMetadata', array($params), "Google_Service_Compute_Operation"); } /** * Changes the minimum CPU platform that this instance should use. This method * can only be called on a stopped instance. For more information, read * Specifying a Minimum CPU Platform. (instances.setMinCpuPlatform) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param Google_Service_Compute_InstancesSetMinCpuPlatformRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setMinCpuPlatform($project, $zone, $instance, Google_Service_Compute_InstancesSetMinCpuPlatformRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setMinCpuPlatform', array($params), "Google_Service_Compute_Operation"); } /** * Sets an instance's scheduling options. You can only call this method on a * stopped instance, that is, a VM instance that is in a `TERMINATED` state. See * Instance Life Cycle for more information on the possible instance states. * (instances.setScheduling) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Instance name for this request. * @param Google_Service_Compute_Scheduling $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setScheduling($project, $zone, $instance, Google_Service_Compute_Scheduling $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setScheduling', array($params), "Google_Service_Compute_Operation"); } /** * Sets the service account on the instance. For more information, read Changing * the service account and access scopes for an instance. * (instances.setServiceAccount) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance resource to start. * @param Google_Service_Compute_InstancesSetServiceAccountRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setServiceAccount($project, $zone, $instance, Google_Service_Compute_InstancesSetServiceAccountRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setServiceAccount', array($params), "Google_Service_Compute_Operation"); } /** * Sets the Shielded Instance integrity policy for an instance. You can only use * this method on a running instance. This method supports PATCH semantics and * uses the JSON merge patch format and processing rules. * (instances.setShieldedInstanceIntegrityPolicy) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name or id of the instance scoping this request. * @param Google_Service_Compute_ShieldedInstanceIntegrityPolicy $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setShieldedInstanceIntegrityPolicy($project, $zone, $instance, Google_Service_Compute_ShieldedInstanceIntegrityPolicy $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setShieldedInstanceIntegrityPolicy', array($params), "Google_Service_Compute_Operation"); } /** * Sets network tags for the specified instance to the data included in the * request. (instances.setTags) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param Google_Service_Compute_Tags $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function setTags($project, $zone, $instance, Google_Service_Compute_Tags $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('setTags', array($params), "Google_Service_Compute_Operation"); } /** * Simulates a maintenance event on the instance. * (instances.simulateMaintenanceEvent) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param array $optParams Optional parameters. * @return Google_Service_Compute_Operation */ public function simulateMaintenanceEvent($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('simulateMaintenanceEvent', array($params), "Google_Service_Compute_Operation"); } /** * Starts an instance that was stopped using the instances().stop method. For * more information, see Restart an instance. (instances.start) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance resource to start. * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function start($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('start', array($params), "Google_Service_Compute_Operation"); } /** * Starts an instance that was stopped using the instances().stop method. For * more information, see Restart an instance. (instances.startWithEncryptionKey) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance resource to start. * @param Google_Service_Compute_InstancesStartWithEncryptionKeyRequest $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function startWithEncryptionKey($project, $zone, $instance, Google_Service_Compute_InstancesStartWithEncryptionKeyRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('startWithEncryptionKey', array($params), "Google_Service_Compute_Operation"); } /** * Stops a running instance, shutting it down cleanly, and allows you to restart * the instance at a later time. Stopped instances do not incur VM usage charges * while they are stopped. However, resources that the VM is using, such as * persistent disks and static IP addresses, will continue to be charged until * they are deleted. For more information, see Stopping an instance. * (instances.stop) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance resource to stop. * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function stop($project, $zone, $instance, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance); $params = array_merge($params, $optParams); return $this->call('stop', array($params), "Google_Service_Compute_Operation"); } /** * Returns permissions that a caller has on the specified resource. * (instances.testIamPermissions) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $resource Name or id of the resource for this request. * @param Google_Service_Compute_TestPermissionsRequest $postBody * @param array $optParams Optional parameters. * @return Google_Service_Compute_TestPermissionsResponse */ public function testIamPermissions($project, $zone, $resource, Google_Service_Compute_TestPermissionsRequest $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'resource' => $resource, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('testIamPermissions', array($params), "Google_Service_Compute_TestPermissionsResponse"); } /** * Updates an instance only if the necessary resources are available. This * method can update only a specific set of instance properties. See Updating a * running instance for a list of updatable instance properties. * (instances.update) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance resource to update. * @param Google_Service_Compute_Instance $postBody * @param array $optParams Optional parameters. * * @opt_param string minimalAction Specifies the action to take when updating an * instance even if the updated properties do not require it. If not specified, * then Compute Engine acts based on the minimum action that the updated * properties require. * @opt_param string mostDisruptiveAllowedAction Specifies the most disruptive * action that can be taken on the instance as part of the update. Compute * Engine returns an error if the instance properties require a more disruptive * action as part of the instance update. Valid options from lowest to highest * are NO_EFFECT, REFRESH, and RESTART. * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function update($project, $zone, $instance, Google_Service_Compute_Instance $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('update', array($params), "Google_Service_Compute_Operation"); } /** * Updates the specified access config from an instance's network interface with * the data included in the request. This method supports PATCH semantics and * uses the JSON merge patch format and processing rules. * (instances.updateAccessConfig) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param string $networkInterface The name of the network interface where the * access config is attached. * @param Google_Service_Compute_AccessConfig $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function updateAccessConfig($project, $zone, $instance, $networkInterface, Google_Service_Compute_AccessConfig $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'networkInterface' => $networkInterface, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('updateAccessConfig', array($params), "Google_Service_Compute_Operation"); } /** * Updates the Display config for a VM instance. You can only use this method on * a stopped VM instance. This method supports PATCH semantics and uses the JSON * merge patch format and processing rules. (instances.updateDisplayDevice) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name of the instance scoping this request. * @param Google_Service_Compute_DisplayDevice $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function updateDisplayDevice($project, $zone, $instance, Google_Service_Compute_DisplayDevice $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('updateDisplayDevice', array($params), "Google_Service_Compute_Operation"); } /** * Updates an instance's network interface. This method follows PATCH semantics. * (instances.updateNetworkInterface) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param string $networkInterface The name of the network interface to update. * @param Google_Service_Compute_NetworkInterface $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function updateNetworkInterface($project, $zone, $instance, $networkInterface, Google_Service_Compute_NetworkInterface $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'networkInterface' => $networkInterface, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('updateNetworkInterface', array($params), "Google_Service_Compute_Operation"); } /** * Updates the Shielded Instance config for an instance. You can only use this * method on a stopped instance. This method supports PATCH semantics and uses * the JSON merge patch format and processing rules. * (instances.updateShieldedInstanceConfig) * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Name or id of the instance scoping this request. * @param Google_Service_Compute_ShieldedInstanceConfig $postBody * @param array $optParams Optional parameters. * * @opt_param string requestId An optional request ID to identify requests. * Specify a unique request ID so that if you must retry your request, the * server will know to ignore the request if it has already been completed. * * For example, consider a situation where you make an initial request and the * request times out. If you make the request again with the same request ID, * the server can check if original operation with the same request ID was * received, and if so, will ignore the second request. This prevents clients * from accidentally creating duplicate commitments. * * The request ID must be a valid UUID with the exception that zero UUID is not * supported (00000000-0000-0000-0000-000000000000). * @return Google_Service_Compute_Operation */ public function updateShieldedInstanceConfig($project, $zone, $instance, Google_Service_Compute_ShieldedInstanceConfig $postBody, $optParams = array()) { $params = array('project' => $project, 'zone' => $zone, 'instance' => $instance, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('updateShieldedInstanceConfig', array($params), "Google_Service_Compute_Operation"); } }