# Replica Pool API . replicas

## Instance Methods

Deletes a replica from the pool.

Gets information about a specific replica.

Lists all replicas in a pool.

Retrieves the next page of results.

Restarts a replica in a pool.

### Method Details

`delete(projectName, zone, poolName, replicaName, body)`

    Deletes a replica from the pool.

    Args:
      projectName: string, The project ID for this request. (required)
      zone: string, The zone where the replica lives. (required)
      poolName: string, The replica pool name for this request. (required)
      replicaName: string, The name of the replica for this request. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "abandonInstance": True or False, # Whether the instance resource represented by this replica should be deleted or abandoned. If abandoned, the replica will be deleted but the virtual machine instance will remain. By default, this is set to false and the instance will be deleted along with the replica.
      }

    Returns:
      An object of the form:

        { # An individual Replica within a Pool. Replicas are automatically created by the replica pool, using the template provided by the user. You cannot directly create replicas.
        "status": { # The current status of a Replica. # [Output Only] Last known status of the Replica.
          "vmStartTime": "A String", # [Output Only] The time that this Replica got to the RUNNING state, in RFC 3339 format. If the start time is unknown, UNKNOWN is returned.
          "state": "A String", # [Output Only] The state of the Replica.
          "vmLink": "A String", # [Output Only] Link to the virtual machine that this Replica represents.
          "details": "A String", # [Output Only] Human-readable details about the current state of the replica
          "templateVersion": "A String", # [Output Only] The template used to build the replica.
        },
        "name": "A String", # [Output Only] The name of the Replica object.
        "selfLink": "A String", # [Output Only] The self-link of the Replica.
      }

`get(projectName, zone, poolName, replicaName)`

    Gets information about a specific replica.

    Args:
      projectName: string, The project ID for this request. (required)
      zone: string, The zone where the replica lives. (required)
      poolName: string, The replica pool name for this request. (required)
      replicaName: string, The name of the replica for this request. (required)

    Returns:
      An object of the form:

        { # An individual Replica within a Pool. Replicas are automatically created by the replica pool, using the template provided by the user. You cannot directly create replicas.
        "status": { # The current status of a Replica. # [Output Only] Last known status of the Replica.
          "vmStartTime": "A String", # [Output Only] The time that this Replica got to the RUNNING state, in RFC 3339 format. If the start time is unknown, UNKNOWN is returned.
          "state": "A String", # [Output Only] The state of the Replica.
          "vmLink": "A String", # [Output Only] Link to the virtual machine that this Replica represents.
          "details": "A String", # [Output Only] Human-readable details about the current state of the replica
          "templateVersion": "A String", # [Output Only] The template used to build the replica.
        },
        "name": "A String", # [Output Only] The name of the Replica object.
        "selfLink": "A String", # [Output Only] The self-link of the Replica.
      }

`list(projectName, zone, poolName, maxResults=None, pageToken=None)`

    Lists all replicas in a pool.

    Args:
      projectName: string, The project ID for this request. (required)
      zone: string, The zone where the replica pool lives. (required)
      poolName: string, The replica pool name for this request. (required)
      maxResults: integer, Maximum count of results to be returned. Acceptable values are 0 to 100, inclusive. (Default: 50)
      pageToken: string, Set this to the nextPageToken value returned by a previous list request to obtain the next page of results from the previous list request.

    Returns:
      An object of the form:

        {
        "nextPageToken": "A String",
        "resources": [
          { # An individual Replica within a Pool. Replicas are automatically created by the replica pool, using the template provided by the user. You cannot directly create replicas.
            "status": { # The current status of a Replica. # [Output Only] Last known status of the Replica.
              "vmStartTime": "A String", # [Output Only] The time that this Replica got to the RUNNING state, in RFC 3339 format. If the start time is unknown, UNKNOWN is returned.
              "state": "A String", # [Output Only] The state of the Replica.
              "vmLink": "A String", # [Output Only] Link to the virtual machine that this Replica represents.
              "details": "A String", # [Output Only] Human-readable details about the current state of the replica
              "templateVersion": "A String", # [Output Only] The template used to build the replica.
            },
            "name": "A String", # [Output Only] The name of the Replica object.
            "selfLink": "A String", # [Output Only] The self-link of the Replica.
          },
        ],
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`restart(projectName, zone, poolName, replicaName)`

    Restarts a replica in a pool.

    Args:
      projectName: string, The project ID for this request. (required)
      zone: string, The zone where the replica lives. (required)
      poolName: string, The replica pool name for this request. (required)
      replicaName: string, The name of the replica for this request. (required)

    Returns:
      An object of the form:

        { # An individual Replica within a Pool. Replicas are automatically created by the replica pool, using the template provided by the user. You cannot directly create replicas.
        "status": { # The current status of a Replica. # [Output Only] Last known status of the Replica.
          "vmStartTime": "A String", # [Output Only] The time that this Replica got to the RUNNING state, in RFC 3339 format. If the start time is unknown, UNKNOWN is returned.
          "state": "A String", # [Output Only] The state of the Replica.
          "vmLink": "A String", # [Output Only] Link to the virtual machine that this Replica represents.
          "details": "A String", # [Output Only] Human-readable details about the current state of the replica
          "templateVersion": "A String", # [Output Only] The template used to build the replica.
        },
        "name": "A String", # [Output Only] The name of the Replica object.
        "selfLink": "A String", # [Output Only] The self-link of the Replica.
      }