Interface AllocationPolicy.LocationPolicyOrBuilder (0.95.0)

0.95.0 (latest) 0.94.0 0.93.0 0.91.0 0.88.0 0.87.0 0.85.0 0.83.0 0.82.0 0.81.0 0.80.0 0.78.0 0.76.0 0.75.0 0.74.0 0.73.0 0.72.0 0.70.0 0.68.0 0.67.0 0.64.0 0.63.0 0.62.0 0.60.0 0.59.0 0.58.0 0.57.0 0.56.0 0.55.0 0.54.0 0.53.0 0.52.0 0.51.0 0.49.0 0.48.0 0.47.0 0.46.0 0.45.0 0.44.0 0.43.0 0.42.0 0.41.0 0.40.0 0.39.0 0.37.0 0.36.0 0.35.0 0.34.0 0.33.0 0.32.0 0.31.0 0.30.0 0.29.0 0.28.0 0.27.0 0.24.0 0.23.0 0.22.0 0.21.0 0.20.0 0.19.0 0.18.0 0.17.0 0.16.0 0.15.0 0.14.0 0.13.0 0.12.0 0.11.0 0.10.0 0.9.0 0.8.0 0.7.0 0.6.0 0.5.0 0.4.0 0.3.2 0.2.2 0.1.1

public static interface AllocationPolicy.LocationPolicyOrBuilder extends MessageOrBuilder

Implements

MessageOrBuilder

Methods

getAllowedLocations(int index)

public abstract String getAllowedLocations(int index)

A list of location names that are allowed for the job's VMs formatted as URLs. Each location can be a region or a zone, but you can only specify one region or multiple zones in one region per job. For example, ["regions/us-central1"] allow VMs in any zones in region us-central1, and ["zones/us-central1-a", "zones/us-central1-c"] only allow VMs in zones us-central1-a and us-central1-c. However, ["regions/us-central1", "zones/us-central1-a", "zones/us-central1-b", "zones/us-west1-a"] causes an error because it contains multiple regions (us-central1 and us-west1).

The specified region or zones must be in the same region in which the job is created starting on the following dates:

• For projects that have successfully submitted before July 31, 2026 at least one job that uses the allowedLocations[] field with any region or zones outside of the job's location, the changes are starting on June 30, 2027.

• For all other projects, the changes are starting on July 31, 2026.

  For example, for job projects/123/locations/us-central1/jobs/jobid, the specified region or zones must be in us-central1. Using a different region (e.g. regions/us-west1) or a zone not in us-central1 (e.g. zones/us-west1-a) causes an error.

repeated string allowed_locations = 1;

Parameter
Name	Description
index	int The index of the element to return.

Returns
Type	Description
String	The allowedLocations at the given index.

getAllowedLocationsBytes(int index)

public abstract ByteString getAllowedLocationsBytes(int index)

A list of location names that are allowed for the job's VMs formatted as URLs. Each location can be a region or a zone, but you can only specify one region or multiple zones in one region per job. For example, ["regions/us-central1"] allow VMs in any zones in region us-central1, and ["zones/us-central1-a", "zones/us-central1-c"] only allow VMs in zones us-central1-a and us-central1-c. However, ["regions/us-central1", "zones/us-central1-a", "zones/us-central1-b", "zones/us-west1-a"] causes an error because it contains multiple regions (us-central1 and us-west1).

The specified region or zones must be in the same region in which the job is created starting on the following dates:

• For projects that have successfully submitted before July 31, 2026 at least one job that uses the allowedLocations[] field with any region or zones outside of the job's location, the changes are starting on June 30, 2027.

• For all other projects, the changes are starting on July 31, 2026.

  For example, for job projects/123/locations/us-central1/jobs/jobid, the specified region or zones must be in us-central1. Using a different region (e.g. regions/us-west1) or a zone not in us-central1 (e.g. zones/us-west1-a) causes an error.

repeated string allowed_locations = 1;

Parameter
Name	Description
index	int The index of the value to return.

Returns
Type	Description
ByteString	The bytes of the allowedLocations at the given index.

getAllowedLocationsCount()

public abstract int getAllowedLocationsCount()

A list of location names that are allowed for the job's VMs formatted as URLs. Each location can be a region or a zone, but you can only specify one region or multiple zones in one region per job. For example, ["regions/us-central1"] allow VMs in any zones in region us-central1, and ["zones/us-central1-a", "zones/us-central1-c"] only allow VMs in zones us-central1-a and us-central1-c. However, ["regions/us-central1", "zones/us-central1-a", "zones/us-central1-b", "zones/us-west1-a"] causes an error because it contains multiple regions (us-central1 and us-west1).

The specified region or zones must be in the same region in which the job is created starting on the following dates:

• For projects that have successfully submitted before July 31, 2026 at least one job that uses the allowedLocations[] field with any region or zones outside of the job's location, the changes are starting on June 30, 2027.

• For all other projects, the changes are starting on July 31, 2026.

  For example, for job projects/123/locations/us-central1/jobs/jobid, the specified region or zones must be in us-central1. Using a different region (e.g. regions/us-west1) or a zone not in us-central1 (e.g. zones/us-west1-a) causes an error.

repeated string allowed_locations = 1;

Returns
Type	Description
int	The count of allowedLocations.

getAllowedLocationsList()

public abstract List<String> getAllowedLocationsList()

A list of location names that are allowed for the job's VMs formatted as URLs. Each location can be a region or a zone, but you can only specify one region or multiple zones in one region per job. For example, ["regions/us-central1"] allow VMs in any zones in region us-central1, and ["zones/us-central1-a", "zones/us-central1-c"] only allow VMs in zones us-central1-a and us-central1-c. However, ["regions/us-central1", "zones/us-central1-a", "zones/us-central1-b", "zones/us-west1-a"] causes an error because it contains multiple regions (us-central1 and us-west1).

The specified region or zones must be in the same region in which the job is created starting on the following dates:

• For projects that have successfully submitted before July 31, 2026 at least one job that uses the allowedLocations[] field with any region or zones outside of the job's location, the changes are starting on June 30, 2027.

• For all other projects, the changes are starting on July 31, 2026.

  For example, for job projects/123/locations/us-central1/jobs/jobid, the specified region or zones must be in us-central1. Using a different region (e.g. regions/us-west1) or a zone not in us-central1 (e.g. zones/us-west1-a) causes an error.

repeated string allowed_locations = 1;

Returns
Type	Description
List<String>	A list containing the allowedLocations.

getDeniedLocations(int index)

public abstract String getDeniedLocations(int index)

A list of denied location names.

Not yet implemented.

repeated string denied_locations = 2;

Parameter
Name	Description
index	int The index of the element to return.

Returns
Type	Description
String	The deniedLocations at the given index.

getDeniedLocationsBytes(int index)

public abstract ByteString getDeniedLocationsBytes(int index)

A list of denied location names.

Not yet implemented.

repeated string denied_locations = 2;

Parameter
Name	Description
index	int The index of the value to return.

Returns
Type	Description
ByteString	The bytes of the deniedLocations at the given index.

getDeniedLocationsCount()

public abstract int getDeniedLocationsCount()

A list of denied location names.

Not yet implemented.

repeated string denied_locations = 2;

Returns
Type	Description
int	The count of deniedLocations.

getDeniedLocationsList()

public abstract List<String> getDeniedLocationsList()

A list of denied location names.

Not yet implemented.

repeated string denied_locations = 2;

Returns
Type	Description
List<String>	A list containing the deniedLocations.