diff --git a/docs/dyn/admin_directory_v1.chromeosdevices.html b/docs/dyn/admin_directory_v1.chromeosdevices.html
index a24890002a6..8c71bab50b6 100644
--- a/docs/dyn/admin_directory_v1.chromeosdevices.html
+++ b/docs/dyn/admin_directory_v1.chromeosdevices.html
@@ -165,6 +165,7 @@
Method Details
},
],
"bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch).
+ "chromeOsType": "A String", # Output only. Chrome OS type of the device.
"cpuInfo": [ # Information regarding CPU specs in the device.
{ # CPU specs for a CPU.
"architecture": "A String", # The CPU architecture.
@@ -308,7 +309,7 @@ Method Details
Args:
customerId: string, The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](/admin-sdk/directory/v1/reference/users). (required)
includeChildOrgunits: boolean, Return devices from all child orgunits, as well as the specified org unit. If this is set to true, 'orgUnitPath' must be provided.
- maxResults: integer, Maximum number of results to return.
+ maxResults: integer, Maximum number of results to return, value should not exceed 300.
orderBy: string, Device property to use for sorting results.
Allowed values
annotatedLocation - Chrome device location as annotated by the administrator.
@@ -319,7 +320,7 @@ Method Details
status - Chrome device status. For more information, see the <a [chromeosdevices](/admin-sdk/directory/v1/reference/chromeosdevices.html).
orgUnitPath: string, The full path of the organizational unit (minus the leading `/`) or its unique ID.
pageToken: string, The `pageToken` query parameter is used to request the next page of query results. The follow-on request's `pageToken` query parameter is the `nextPageToken` from your previous response.
- projection: string, Restrict information returned to a set of selected fields.
+ projection: string, Determines whether the response contains the full list of properties or only a subset.
Allowed values
BASIC - Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user)
FULL - Includes all metadata fields
@@ -358,6 +359,7 @@ Method Details
},
],
"bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch).
+ "chromeOsType": "A String", # Output only. Chrome OS type of the device.
"cpuInfo": [ # Information regarding CPU specs in the device.
{ # CPU specs for a CPU.
"architecture": "A String", # The CPU architecture.
@@ -566,6 +568,7 @@ Method Details
},
],
"bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch).
+ "chromeOsType": "A String", # Output only. Chrome OS type of the device.
"cpuInfo": [ # Information regarding CPU specs in the device.
{ # CPU specs for a CPU.
"architecture": "A String", # The CPU architecture.
@@ -701,7 +704,7 @@ Method Details
"willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property.
}
- projection: string, Restrict information returned to a set of selected fields.
+ projection: string, Determines whether the response contains the full list of properties or only a subset.
Allowed values
BASIC - Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user)
FULL - Includes all metadata fields
@@ -733,6 +736,7 @@ Method Details
},
],
"bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch).
+ "chromeOsType": "A String", # Output only. Chrome OS type of the device.
"cpuInfo": [ # Information regarding CPU specs in the device.
{ # CPU specs for a CPU.
"architecture": "A String", # The CPU architecture.
@@ -899,6 +903,7 @@ Method Details
},
],
"bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch).
+ "chromeOsType": "A String", # Output only. Chrome OS type of the device.
"cpuInfo": [ # Information regarding CPU specs in the device.
{ # CPU specs for a CPU.
"architecture": "A String", # The CPU architecture.
@@ -1034,7 +1039,7 @@ Method Details
"willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property.
}
- projection: string, Restrict information returned to a set of selected fields.
+ projection: string, Determines whether the response contains the full list of properties or only a subset.
Allowed values
BASIC - Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user)
FULL - Includes all metadata fields
@@ -1066,6 +1071,7 @@ Method Details
},
],
"bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch).
+ "chromeOsType": "A String", # Output only. Chrome OS type of the device.
"cpuInfo": [ # Information regarding CPU specs in the device.
{ # CPU specs for a CPU.
"architecture": "A String", # The CPU architecture.
diff --git a/docs/dyn/analyticsdata_v1beta.properties.html b/docs/dyn/analyticsdata_v1beta.properties.html
index 9da71f318ff..9487998f54d 100644
--- a/docs/dyn/analyticsdata_v1beta.properties.html
+++ b/docs/dyn/analyticsdata_v1beta.properties.html
@@ -137,6 +137,56 @@ Method Details
"startOffset": 42, # `startOffset` specifies the start date of the extended reporting date range for a cohort report. `startOffset` is commonly set to 0 so that reports contain data from the acquisition of the cohort forward. If `granularity` is `DAILY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset` days. If `granularity` is `WEEKLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 7` days. If `granularity` is `MONTHLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 30` days.
},
},
+ "comparisons": [ # Optional. The configuration of comparisons requested and displayed. The request requires both a comparisons field and a comparisons dimension to receive a comparison column in the response.
+ { # Defines an individual comparison. Most requests will include multiple comparisons so that the report compares between the comparisons.
+ "comparison": "A String", # A saved comparison identified by the comparison's resource name. For example, 'comparisons/1234'.
+ "dimensionFilter": { # To express dimension or metric filters. The fields in the same FilterExpression need to be either all dimensions or all metrics. # A basic comparison.
+ "andGroup": { # A list of filter expressions. # The FilterExpressions in and_group have an AND relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ "filter": { # An expression to filter dimension or metric values. # A primitive filter. In the same FilterExpression, all of the filter's field names need to be either all dimensions or all metrics.
+ "betweenFilter": { # To express that the result needs to be between two numbers (inclusive). # A filter for two values.
+ "fromValue": { # To represent a number. # Begins with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ "toValue": { # To represent a number. # Ends with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "fieldName": "A String", # The dimension name or metric name. In most methods, dimensions & metrics can be used for the first time in this field. However in a RunPivotReportRequest, this field must be additionally specified by name in the RunPivotReportRequest's dimensions or metrics.
+ "inListFilter": { # The result needs to be in a list of string values. # A filter for in list values.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "values": [ # The list of string values. Must be non-empty.
+ "A String",
+ ],
+ },
+ "numericFilter": { # Filters for numeric or date values. # A filter for numeric or date values.
+ "operation": "A String", # The operation type for this filter.
+ "value": { # To represent a number. # A numeric value or a date value.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "stringFilter": { # The filter for string # Strings related filter.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "matchType": "A String", # The match type for this filter.
+ "value": "A String", # The string value used for the matching.
+ },
+ },
+ "notExpression": # Object with schema name: FilterExpression # The FilterExpression is NOT of not_expression.
+ "orGroup": { # A list of filter expressions. # The FilterExpressions in or_group have an OR relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ },
+ "name": "A String", # Each comparison produces separate rows in the response. In the response, this comparison is identified by this name. If name is unspecified, we will use the saved comparisons display name.
+ },
+ ],
"currencyCode": "A String", # A currency code in ISO4217 format, such as "AED", "USD", "JPY". If the field is empty, the report uses the property's default currency.
"dateRanges": [ # The date range to retrieve event data for the report. If multiple date ranges are specified, event data from each date range is used in the report. A special dimension with field name "dateRange" can be included in a Pivot's field names; if included, the report compares between date ranges. In a cohort request, this `dateRanges` must be unspecified.
{ # A contiguous set of days: `startDate`, `startDate + 1`, ..., `endDate`. Requests are allowed up to 4 date ranges.
@@ -452,6 +502,56 @@ Method Details
"startOffset": 42, # `startOffset` specifies the start date of the extended reporting date range for a cohort report. `startOffset` is commonly set to 0 so that reports contain data from the acquisition of the cohort forward. If `granularity` is `DAILY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset` days. If `granularity` is `WEEKLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 7` days. If `granularity` is `MONTHLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 30` days.
},
},
+ "comparisons": [ # Optional. The configuration of comparisons requested and displayed. The request only requires a comparisons field in order to receive a comparison column in the response.
+ { # Defines an individual comparison. Most requests will include multiple comparisons so that the report compares between the comparisons.
+ "comparison": "A String", # A saved comparison identified by the comparison's resource name. For example, 'comparisons/1234'.
+ "dimensionFilter": { # To express dimension or metric filters. The fields in the same FilterExpression need to be either all dimensions or all metrics. # A basic comparison.
+ "andGroup": { # A list of filter expressions. # The FilterExpressions in and_group have an AND relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ "filter": { # An expression to filter dimension or metric values. # A primitive filter. In the same FilterExpression, all of the filter's field names need to be either all dimensions or all metrics.
+ "betweenFilter": { # To express that the result needs to be between two numbers (inclusive). # A filter for two values.
+ "fromValue": { # To represent a number. # Begins with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ "toValue": { # To represent a number. # Ends with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "fieldName": "A String", # The dimension name or metric name. In most methods, dimensions & metrics can be used for the first time in this field. However in a RunPivotReportRequest, this field must be additionally specified by name in the RunPivotReportRequest's dimensions or metrics.
+ "inListFilter": { # The result needs to be in a list of string values. # A filter for in list values.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "values": [ # The list of string values. Must be non-empty.
+ "A String",
+ ],
+ },
+ "numericFilter": { # Filters for numeric or date values. # A filter for numeric or date values.
+ "operation": "A String", # The operation type for this filter.
+ "value": { # To represent a number. # A numeric value or a date value.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "stringFilter": { # The filter for string # Strings related filter.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "matchType": "A String", # The match type for this filter.
+ "value": "A String", # The string value used for the matching.
+ },
+ },
+ "notExpression": # Object with schema name: FilterExpression # The FilterExpression is NOT of not_expression.
+ "orGroup": { # A list of filter expressions. # The FilterExpressions in or_group have an OR relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ },
+ "name": "A String", # Each comparison produces separate rows in the response. In the response, this comparison is identified by this name. If name is unspecified, we will use the saved comparisons display name.
+ },
+ ],
"currencyCode": "A String", # A currency code in ISO4217 format, such as "AED", "USD", "JPY". If the field is empty, the report uses the property's default currency.
"dateRanges": [ # Date ranges of data to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the event data for the overlapping days is included in the response rows for both date ranges. In a cohort request, this `dateRanges` must be unspecified.
{ # A contiguous set of days: `startDate`, `startDate + 1`, ..., `endDate`. Requests are allowed up to 4 date ranges.
@@ -936,6 +1036,13 @@ Method Details
An object of the form:
{ # The dimensions, metrics and comparisons currently accepted in reporting methods.
+ "comparisons": [ # The comparison descriptions.
+ { # The metadata for a single comparison.
+ "apiName": "A String", # This comparison's resource name. Useable in [Comparison](#Comparison)'s `comparison` field. For example, 'comparisons/1234'.
+ "description": "A String", # This comparison's description.
+ "uiName": "A String", # This comparison's name within the Google Analytics user interface.
+ },
+ ],
"dimensions": [ # The dimension descriptions.
{ # Explains a dimension.
"apiName": "A String", # This dimension's name. Useable in [Dimension](#Dimension)'s `name`. For example, `eventName`.
@@ -1000,6 +1107,56 @@ Method Details
"startOffset": 42, # `startOffset` specifies the start date of the extended reporting date range for a cohort report. `startOffset` is commonly set to 0 so that reports contain data from the acquisition of the cohort forward. If `granularity` is `DAILY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset` days. If `granularity` is `WEEKLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 7` days. If `granularity` is `MONTHLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 30` days.
},
},
+ "comparisons": [ # Optional. The configuration of comparisons requested and displayed. The request requires both a comparisons field and a comparisons dimension to receive a comparison column in the response.
+ { # Defines an individual comparison. Most requests will include multiple comparisons so that the report compares between the comparisons.
+ "comparison": "A String", # A saved comparison identified by the comparison's resource name. For example, 'comparisons/1234'.
+ "dimensionFilter": { # To express dimension or metric filters. The fields in the same FilterExpression need to be either all dimensions or all metrics. # A basic comparison.
+ "andGroup": { # A list of filter expressions. # The FilterExpressions in and_group have an AND relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ "filter": { # An expression to filter dimension or metric values. # A primitive filter. In the same FilterExpression, all of the filter's field names need to be either all dimensions or all metrics.
+ "betweenFilter": { # To express that the result needs to be between two numbers (inclusive). # A filter for two values.
+ "fromValue": { # To represent a number. # Begins with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ "toValue": { # To represent a number. # Ends with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "fieldName": "A String", # The dimension name or metric name. In most methods, dimensions & metrics can be used for the first time in this field. However in a RunPivotReportRequest, this field must be additionally specified by name in the RunPivotReportRequest's dimensions or metrics.
+ "inListFilter": { # The result needs to be in a list of string values. # A filter for in list values.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "values": [ # The list of string values. Must be non-empty.
+ "A String",
+ ],
+ },
+ "numericFilter": { # Filters for numeric or date values. # A filter for numeric or date values.
+ "operation": "A String", # The operation type for this filter.
+ "value": { # To represent a number. # A numeric value or a date value.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "stringFilter": { # The filter for string # Strings related filter.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "matchType": "A String", # The match type for this filter.
+ "value": "A String", # The string value used for the matching.
+ },
+ },
+ "notExpression": # Object with schema name: FilterExpression # The FilterExpression is NOT of not_expression.
+ "orGroup": { # A list of filter expressions. # The FilterExpressions in or_group have an OR relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ },
+ "name": "A String", # Each comparison produces separate rows in the response. In the response, this comparison is identified by this name. If name is unspecified, we will use the saved comparisons display name.
+ },
+ ],
"currencyCode": "A String", # A currency code in ISO4217 format, such as "AED", "USD", "JPY". If the field is empty, the report uses the property's default currency.
"dateRanges": [ # The date range to retrieve event data for the report. If multiple date ranges are specified, event data from each date range is used in the report. A special dimension with field name "dateRange" can be included in a Pivot's field names; if included, the report compares between date ranges. In a cohort request, this `dateRanges` must be unspecified.
{ # A contiguous set of days: `startDate`, `startDate + 1`, ..., `endDate`. Requests are allowed up to 4 date ranges.
@@ -1572,6 +1729,56 @@ Method Details
"startOffset": 42, # `startOffset` specifies the start date of the extended reporting date range for a cohort report. `startOffset` is commonly set to 0 so that reports contain data from the acquisition of the cohort forward. If `granularity` is `DAILY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset` days. If `granularity` is `WEEKLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 7` days. If `granularity` is `MONTHLY`, the `startDate` of the extended reporting date range is `startDate` of the cohort plus `startOffset * 30` days.
},
},
+ "comparisons": [ # Optional. The configuration of comparisons requested and displayed. The request only requires a comparisons field in order to receive a comparison column in the response.
+ { # Defines an individual comparison. Most requests will include multiple comparisons so that the report compares between the comparisons.
+ "comparison": "A String", # A saved comparison identified by the comparison's resource name. For example, 'comparisons/1234'.
+ "dimensionFilter": { # To express dimension or metric filters. The fields in the same FilterExpression need to be either all dimensions or all metrics. # A basic comparison.
+ "andGroup": { # A list of filter expressions. # The FilterExpressions in and_group have an AND relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ "filter": { # An expression to filter dimension or metric values. # A primitive filter. In the same FilterExpression, all of the filter's field names need to be either all dimensions or all metrics.
+ "betweenFilter": { # To express that the result needs to be between two numbers (inclusive). # A filter for two values.
+ "fromValue": { # To represent a number. # Begins with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ "toValue": { # To represent a number. # Ends with this number.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "fieldName": "A String", # The dimension name or metric name. In most methods, dimensions & metrics can be used for the first time in this field. However in a RunPivotReportRequest, this field must be additionally specified by name in the RunPivotReportRequest's dimensions or metrics.
+ "inListFilter": { # The result needs to be in a list of string values. # A filter for in list values.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "values": [ # The list of string values. Must be non-empty.
+ "A String",
+ ],
+ },
+ "numericFilter": { # Filters for numeric or date values. # A filter for numeric or date values.
+ "operation": "A String", # The operation type for this filter.
+ "value": { # To represent a number. # A numeric value or a date value.
+ "doubleValue": 3.14, # Double value
+ "int64Value": "A String", # Integer value
+ },
+ },
+ "stringFilter": { # The filter for string # Strings related filter.
+ "caseSensitive": True or False, # If true, the string value is case sensitive.
+ "matchType": "A String", # The match type for this filter.
+ "value": "A String", # The string value used for the matching.
+ },
+ },
+ "notExpression": # Object with schema name: FilterExpression # The FilterExpression is NOT of not_expression.
+ "orGroup": { # A list of filter expressions. # The FilterExpressions in or_group have an OR relationship.
+ "expressions": [ # A list of filter expressions.
+ # Object with schema name: FilterExpression
+ ],
+ },
+ },
+ "name": "A String", # Each comparison produces separate rows in the response. In the response, this comparison is identified by this name. If name is unspecified, we will use the saved comparisons display name.
+ },
+ ],
"currencyCode": "A String", # A currency code in ISO4217 format, such as "AED", "USD", "JPY". If the field is empty, the report uses the property's default currency.
"dateRanges": [ # Date ranges of data to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the event data for the overlapping days is included in the response rows for both date ranges. In a cohort request, this `dateRanges` must be unspecified.
{ # A contiguous set of days: `startDate`, `startDate + 1`, ..., `endDate`. Requests are allowed up to 4 date ranges.
diff --git a/docs/dyn/chat_v1.spaces.html b/docs/dyn/chat_v1.spaces.html
index 5b7ed6da1a8..a2acc318455 100644
--- a/docs/dyn/chat_v1.spaces.html
+++ b/docs/dyn/chat_v1.spaces.html
@@ -147,7 +147,7 @@ Method Details
{ # Response message for completing the import process for a space.
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The import mode space.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -176,7 +176,7 @@ Method Details
The object takes the form of:
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -204,7 +204,7 @@ Method Details
An object of the form:
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -256,7 +256,7 @@ Method Details
An object of the form:
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -290,7 +290,7 @@ Method Details
An object of the form:
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -329,7 +329,7 @@ Method Details
"nextPageToken": "A String", # You can send a token as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.
"spaces": [ # List of spaces in the requested (or first) page.
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -374,7 +374,7 @@ Method Details
The object takes the form of:
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -402,7 +402,7 @@ Method Details
An object of the form:
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -451,7 +451,7 @@ Method Details
],
"requestId": "A String", # Optional. A unique identifier for this request. A random UUID is recommended. Specifying an existing request ID returns the space created with that ID instead of creating a new space. Specifying an existing request ID from the same Chat app with a different authenticated user returns an error.
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # Required. The `Space.spaceType` field is required. To create a space, set `Space.spaceType` to `SPACE` and set `Space.displayName`. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. To create a group chat, set `Space.spaceType` to `GROUP_CHAT`. Don't set `Space.displayName`. To create a 1:1 conversation between humans, set `Space.spaceType` to `DIRECT_MESSAGE` and set `Space.singleUserBotDm` to `false`. Don't set `Space.displayName` or `Space.spaceDetails`. To create an 1:1 conversation between a human and the calling Chat app, set `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`. Don't set `Space.displayName` or `Space.spaceDetails`. If a `DIRECT_MESSAGE` space already exists, that space is returned instead of creating a new space.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -479,7 +479,7 @@ Method Details
An object of the form:
{ # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
diff --git a/docs/dyn/chat_v1.spaces.messages.html b/docs/dyn/chat_v1.spaces.messages.html
index 249a4a50aa9..fe402023c3a 100644
--- a/docs/dyn/chat_v1.spaces.messages.html
+++ b/docs/dyn/chat_v1.spaces.messages.html
@@ -1851,7 +1851,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -3620,7 +3620,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -5407,7 +5407,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -7182,7 +7182,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -8962,7 +8962,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -10725,7 +10725,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -12488,7 +12488,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -14251,7 +14251,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
diff --git a/docs/dyn/chat_v1.spaces.spaceEvents.html b/docs/dyn/chat_v1.spaces.spaceEvents.html
index 6267717b660..680b6cf58d9 100644
--- a/docs/dyn/chat_v1.spaces.spaceEvents.html
+++ b/docs/dyn/chat_v1.spaces.spaceEvents.html
@@ -1966,7 +1966,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -3724,7 +3724,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -5482,7 +5482,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -7238,7 +7238,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -8992,7 +8992,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -10746,7 +10746,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -10856,7 +10856,7 @@ Method Details
"spaces": [ # A list of updated spaces.
{ # Event payload for an updated space. Event type: `google.workspace.chat.space.v1.updated`
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The updated space.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -10878,7 +10878,7 @@ Method Details
},
"spaceUpdatedEventData": { # Event payload for an updated space. Event type: `google.workspace.chat.space.v1.updated` # Event payload for a space update. Event type: `google.workspace.chat.space.v1.updated`
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The updated space.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -12779,7 +12779,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -14537,7 +14537,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -16295,7 +16295,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -18051,7 +18051,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -19805,7 +19805,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -21559,7 +21559,7 @@ Method Details
"commandId": "A String", # The ID of the slash command invoked.
},
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -21669,7 +21669,7 @@ Method Details
"spaces": [ # A list of updated spaces.
{ # Event payload for an updated space. Event type: `google.workspace.chat.space.v1.updated`
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The updated space.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
@@ -21691,7 +21691,7 @@ Method Details
},
"spaceUpdatedEventData": { # Event payload for an updated space. Event type: `google.workspace.chat.space.v1.updated` # Event payload for a space update. Event type: `google.workspace.chat.space.v1.updated`
"space": { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The updated space.
- "adminInstalled": True or False, # Output only. Whether the Chat app was installed by a Google Workspace administrator. Administrators can install a Chat app for their domain, organizational unit, or a group of users. Administrators can only install Chat apps for direct messaging between users and the app. To support admin install, your app must feature direct messaging.
+ "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
"createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
"displayName": "A String", # The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
"externalUserAllowed": True or False, # Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.
diff --git a/docs/dyn/cloudbuild_v1.projects.builds.html b/docs/dyn/cloudbuild_v1.projects.builds.html
index 820ac5238ac..2f8fba1b891 100644
--- a/docs/dyn/cloudbuild_v1.projects.builds.html
+++ b/docs/dyn/cloudbuild_v1.projects.builds.html
@@ -249,6 +249,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -299,7 +304,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -374,11 +379,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -386,32 +391,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -426,37 +431,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -619,6 +624,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -669,7 +679,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -744,11 +754,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -756,32 +766,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -796,37 +806,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1020,6 +1030,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1070,7 +1085,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -1145,11 +1160,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -1157,32 +1172,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -1197,37 +1212,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1396,6 +1411,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1446,7 +1466,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -1521,11 +1541,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -1533,32 +1553,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -1573,37 +1593,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
diff --git a/docs/dyn/cloudbuild_v1.projects.locations.builds.html b/docs/dyn/cloudbuild_v1.projects.locations.builds.html
index 1edafb250b0..37726179c66 100644
--- a/docs/dyn/cloudbuild_v1.projects.locations.builds.html
+++ b/docs/dyn/cloudbuild_v1.projects.locations.builds.html
@@ -248,6 +248,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -298,7 +303,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -373,11 +378,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -385,32 +390,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -425,37 +430,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -618,6 +623,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -668,7 +678,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -743,11 +753,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -755,32 +765,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -795,37 +805,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1019,6 +1029,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1069,7 +1084,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -1144,11 +1159,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -1156,32 +1171,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -1196,37 +1211,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1395,6 +1410,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1445,7 +1465,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -1520,11 +1540,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -1532,32 +1552,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -1572,37 +1592,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
diff --git a/docs/dyn/cloudbuild_v1.projects.locations.triggers.html b/docs/dyn/cloudbuild_v1.projects.locations.triggers.html
index cd1468444b1..15029229e9f 100644
--- a/docs/dyn/cloudbuild_v1.projects.locations.triggers.html
+++ b/docs/dyn/cloudbuild_v1.projects.locations.triggers.html
@@ -237,6 +237,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -287,7 +292,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -362,11 +367,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -374,32 +379,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -414,37 +419,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -631,11 +636,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -776,6 +781,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -826,7 +836,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -901,11 +911,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -913,32 +923,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -953,37 +963,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1170,11 +1180,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -1343,6 +1353,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1393,7 +1408,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -1468,11 +1483,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -1480,32 +1495,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -1520,37 +1535,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1737,11 +1752,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -1894,6 +1909,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1944,7 +1964,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -2019,11 +2039,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -2031,32 +2051,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -2071,37 +2091,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -2288,11 +2308,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -2450,6 +2470,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -2500,7 +2525,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -2575,11 +2600,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -2587,32 +2612,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -2627,37 +2652,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -2844,11 +2869,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -2991,6 +3016,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -3041,7 +3071,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -3116,11 +3146,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -3128,32 +3158,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -3168,37 +3198,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -3385,11 +3415,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -3415,11 +3445,11 @@ Method Details
"source": { # Location of the source in a Google Cloud Source Repository. # Source to build against this trigger. Branch and tag names cannot consist of regular expressions.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
diff --git a/docs/dyn/cloudbuild_v1.projects.triggers.html b/docs/dyn/cloudbuild_v1.projects.triggers.html
index 2473ae2222e..8caa344e6a1 100644
--- a/docs/dyn/cloudbuild_v1.projects.triggers.html
+++ b/docs/dyn/cloudbuild_v1.projects.triggers.html
@@ -237,6 +237,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -287,7 +292,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -362,11 +367,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -374,32 +379,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -414,37 +419,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -631,11 +636,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -776,6 +781,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -826,7 +836,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -901,11 +911,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -913,32 +923,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -953,37 +963,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1170,11 +1180,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -1343,6 +1353,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1393,7 +1408,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -1468,11 +1483,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -1480,32 +1495,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -1520,37 +1535,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -1737,11 +1752,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -1894,6 +1909,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -1944,7 +1964,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -2019,11 +2039,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -2031,32 +2051,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -2071,37 +2091,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -2288,11 +2308,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -2451,6 +2471,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -2501,7 +2526,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -2576,11 +2601,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -2588,32 +2613,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -2628,37 +2653,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -2845,11 +2870,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -2990,6 +3015,11 @@ Method Details
"gitConfig": { # GitConfig is a configuration for git operations. # Optional. Configuration for git operations.
"http": { # HttpConfig is a configuration for HTTP related git operations. # Configuration for HTTP related git operations.
"proxySecretVersionName": "A String", # SecretVersion resource of the HTTP proxy URL. The proxy URL should be in format protocol://@]proxyhost[:port].
+ "proxySslCaInfo": { # Represents a storage location in Cloud Storage # Optional. Cloud Storage object storing the certificate to use with the HTTP proxy.
+ "bucket": "A String", # Cloud Storage bucket. See https://cloud.google.com/storage/docs/naming#requirements
+ "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Cloud Storage object. See https://cloud.google.com/storage/docs/naming#objectnames
+ },
},
},
"id": "A String", # Output only. Unique identifier of the build.
@@ -3040,7 +3070,7 @@ Method Details
"buildStepImages": [ # List of build step digests, in the order corresponding to build step indices.
"A String",
],
- "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored.
+ "buildStepOutputs": [ # List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted.
"A String",
],
"images": [ # Container images that were built as a part of the build.
@@ -3115,11 +3145,11 @@ Method Details
},
],
"serviceAccount": "A String", # IAM service account whose credentials will be used at build runtime. Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. ACCOUNT can be email address or uniqueId of the service account.
- "source": { # Location of the source in a supported storage service. # The location of the source files to build.
+ "source": { # Location of the source in a supported storage service. # Optional. The location of the source files to build.
"connectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Optional. If provided, get the source from this 2nd-gen Google Cloud Build repository resource.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"developerConnectConfig": { # This config defines the location of a source through Developer Connect. # If provided, get the source from this Developer Connect config.
"dir": "A String", # Required. Directory, relative to the source root, in which to run the build.
@@ -3127,32 +3157,32 @@ Method Details
"revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"gitSource": { # Location of the source in any accessible Git repository. # If provided, get the source from this Git repository.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"storageSource": { # Location of the source in an archive file in Cloud Storage. # If provided, get the source from this location in Cloud Storage.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"storageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # If provided, get the source from this manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that some source was used for this build. # Output only. A permanent fixed identifier for source.
@@ -3167,37 +3197,37 @@ Method Details
},
},
"resolvedConnectedRepository": { # Location of the source in a 2nd-gen Google Cloud Build repository resource. # Output only. A copy of the build's `source.connected_repository`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build.
"repository": "A String", # Required. Name of the Google Cloud Build repository, formatted as `projects/*/locations/*/connections/*/repositories/*`.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
+ "revision": "A String", # Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.
},
"resolvedGitSource": { # Location of the source in any accessible Git repository. # Output only. A copy of the build's `source.git_source`, if exists, with any revisions resolved.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "revision": "A String", # The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
- "url": "A String", # Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "revision": "A String", # Optional. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref. Cloud Build uses `git fetch` to fetch the revision from the Git repository; therefore make sure that the string you provide for `revision` is parsable by the command. For information on string values accepted by `git fetch`, see https://git-scm.com/docs/gitrevisions#_specifying_revisions. For information on `git fetch`, see https://git-scm.com/docs/git-fetch.
+ "url": "A String", # Required. Location of the Git repo to build. This will be used as a `git remote`, see https://git-scm.com/docs/git-remote.
},
"resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any revisions resolved.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
},
"resolvedStorageSource": { # Location of the source in an archive file in Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any generations resolved.
"bucket": "A String", # Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
+ "generation": "A String", # Optional. Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
+ "object": "A String", # Required. Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.
"sourceFetcher": "A String", # Optional. Option to specify the tool to fetch the source file for the build.
},
"resolvedStorageSourceManifest": { # Location of the source manifest in Cloud Storage. This feature is in Preview; see description [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher). # A copy of the build's `source.storage_source_manifest`, if exists, with any revisions resolved. This feature is in Preview.
- "bucket": "A String", # Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ "bucket": "A String", # Required. Cloud Storage bucket containing the source manifest (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
"generation": "A String", # Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.
- "object": "A String", # Cloud Storage object containing the source manifest. This object must be a JSON file.
+ "object": "A String", # Required. Cloud Storage object containing the source manifest. This object must be a JSON file.
},
},
"startTime": "A String", # Output only. Time at which execution of the build was started.
@@ -3384,11 +3414,11 @@ Method Details
"triggerTemplate": { # Location of the source in a Google Cloud Source Repository. # Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with `github`.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
@@ -3413,11 +3443,11 @@ Method Details
{ # Location of the source in a Google Cloud Source Repository.
"branchName": "A String", # Regex matching branches to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
"commitSha": "A String", # Explicit commit SHA to build.
- "dir": "A String", # Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision regex.
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
- "repoName": "A String", # Name of the Cloud Source Repository.
- "substitutions": { # Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
+ "dir": "A String", # Optional. Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution.
+ "invertRegex": True or False, # Optional. Only trigger a build if the revision regex does NOT match the revision regex.
+ "projectId": "A String", # Optional. ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "substitutions": { # Optional. Substitutions to use in a triggered build. Should only be used with RunBuildTrigger
"a_key": "A String",
},
"tagName": "A String", # Regex matching tags to build. The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax
diff --git a/docs/dyn/cloudkms_v1.folders.html b/docs/dyn/cloudkms_v1.folders.html
index 8788274037b..01f04714530 100644
--- a/docs/dyn/cloudkms_v1.folders.html
+++ b/docs/dyn/cloudkms_v1.folders.html
@@ -82,7 +82,7 @@ Instance Methods
Returns the AutokeyConfig for a folder.
updateAutokeyConfig(name, body=None, updateMask=None, x__xgafv=None)
-Updates the AutokeyConfig for a folder. The caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. An empty key project may be provided to clear the configuration.
+Updates the AutokeyConfig for a folder. The caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A KeyHandle creation in the folder's descendant projects will use this configuration to determine where to create the resulting CryptoKey.
Method Details
close()
@@ -104,14 +104,14 @@
Method Details
An object of the form:
{ # Cloud KMS Autokey configuration for a folder.
- "keyProject": "A String", # Optional. Name of the key project, e.g. `projects/{PROJECT_ID}` or `projects/{PROJECT_NUMBER}`, where Cloud KMS Autokey will provision new CryptoKeys. On UpdateAutokeyConfig, the caller will require `cloudkms.cryptoKeys.setIamPolicy` permission on this key project. Once configured, for Cloud KMS Autokey to function properly, this key project must have the Cloud KMS API activated and the Cloud KMS Service Agent for this key project must be granted the `cloudkms.admin` role (or pertinent permissions).
+ "keyProject": "A String", # Optional. Name of the key project, e.g. `projects/{PROJECT_ID}` or `projects/{PROJECT_NUMBER}`, where Cloud KMS Autokey will provision a new CryptoKey when a KeyHandle is created. On UpdateAutokeyConfig, the caller will require `cloudkms.cryptoKeys.setIamPolicy` permission on this key project. Once configured, for Cloud KMS Autokey to function properly, this key project must have the Cloud KMS API activated and the Cloud KMS Service Agent for this key project must be granted the `cloudkms.admin` role (or pertinent permissions). A request with an empty key project field will clear the configuration.
"name": "A String", # Identifier. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`.
}
updateAutokeyConfig(name, body=None, updateMask=None, x__xgafv=None)
-
Updates the AutokeyConfig for a folder. The caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. An empty key project may be provided to clear the configuration.
+ Updates the AutokeyConfig for a folder. The caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A KeyHandle creation in the folder's descendant projects will use this configuration to determine where to create the resulting CryptoKey.
Args:
name: string, Identifier. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`. (required)
@@ -119,7 +119,7 @@ Method Details
The object takes the form of:
{ # Cloud KMS Autokey configuration for a folder.
- "keyProject": "A String", # Optional. Name of the key project, e.g. `projects/{PROJECT_ID}` or `projects/{PROJECT_NUMBER}`, where Cloud KMS Autokey will provision new CryptoKeys. On UpdateAutokeyConfig, the caller will require `cloudkms.cryptoKeys.setIamPolicy` permission on this key project. Once configured, for Cloud KMS Autokey to function properly, this key project must have the Cloud KMS API activated and the Cloud KMS Service Agent for this key project must be granted the `cloudkms.admin` role (or pertinent permissions).
+ "keyProject": "A String", # Optional. Name of the key project, e.g. `projects/{PROJECT_ID}` or `projects/{PROJECT_NUMBER}`, where Cloud KMS Autokey will provision a new CryptoKey when a KeyHandle is created. On UpdateAutokeyConfig, the caller will require `cloudkms.cryptoKeys.setIamPolicy` permission on this key project. Once configured, for Cloud KMS Autokey to function properly, this key project must have the Cloud KMS API activated and the Cloud KMS Service Agent for this key project must be granted the `cloudkms.admin` role (or pertinent permissions). A request with an empty key project field will clear the configuration.
"name": "A String", # Identifier. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`.
}
@@ -133,7 +133,7 @@ Method Details
An object of the form:
{ # Cloud KMS Autokey configuration for a folder.
- "keyProject": "A String", # Optional. Name of the key project, e.g. `projects/{PROJECT_ID}` or `projects/{PROJECT_NUMBER}`, where Cloud KMS Autokey will provision new CryptoKeys. On UpdateAutokeyConfig, the caller will require `cloudkms.cryptoKeys.setIamPolicy` permission on this key project. Once configured, for Cloud KMS Autokey to function properly, this key project must have the Cloud KMS API activated and the Cloud KMS Service Agent for this key project must be granted the `cloudkms.admin` role (or pertinent permissions).
+ "keyProject": "A String", # Optional. Name of the key project, e.g. `projects/{PROJECT_ID}` or `projects/{PROJECT_NUMBER}`, where Cloud KMS Autokey will provision a new CryptoKey when a KeyHandle is created. On UpdateAutokeyConfig, the caller will require `cloudkms.cryptoKeys.setIamPolicy` permission on this key project. Once configured, for Cloud KMS Autokey to function properly, this key project must have the Cloud KMS API activated and the Cloud KMS Service Agent for this key project must be granted the `cloudkms.admin` role (or pertinent permissions). A request with an empty key project field will clear the configuration.
"name": "A String", # Identifier. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`.
}
diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html b/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html
index e8ea3fa8307..4573184c05b 100644
--- a/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html
+++ b/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html
@@ -102,8 +102,8 @@ Method Details
The object takes the form of:
{ # Resource-oriented representation of a request to Cloud KMS Autokey and the resulting provisioning of a CryptoKey.
- "kmsKey": "A String", # Output only. Name of a CryptoKey that has been provisioned for Customer Managed Encryption Key (CMEK) use in the KeyHandle's project and location for the requested resource type.
- "name": "A String", # Output only. Identifier. Name of the [KeyHandle] resource, e.g. `projects/{PROJECT_ID}/locations/{LOCATION}/keyHandles/{KEY_HANDLE_ID}`.
+ "kmsKey": "A String", # Output only. Name of a CryptoKey that has been provisioned for Customer Managed Encryption Key (CMEK) use in the KeyHandle project and location for the requested resource type. The CryptoKey project will reflect the value configured in the AutokeyConfig on the resource project's ancestor folder at the time of the KeyHandle creation. If more than one ancestor folder has a configured AutokeyConfig, the nearest of these configurations is used.
+ "name": "A String", # Output only. Identifier. Name of the KeyHandle resource, e.g. `projects/{PROJECT_ID}/locations/{LOCATION}/keyHandles/{KEY_HANDLE_ID}`.
"resourceTypeSelector": "A String", # Required. Indicates the resource type that the resulting CryptoKey is meant to protect, e.g. `{SERVICE}.googleapis.com/{TYPE}`. See documentation for supported resource types.
}
@@ -152,8 +152,8 @@ Method Details
An object of the form:
{ # Resource-oriented representation of a request to Cloud KMS Autokey and the resulting provisioning of a CryptoKey.
- "kmsKey": "A String", # Output only. Name of a CryptoKey that has been provisioned for Customer Managed Encryption Key (CMEK) use in the KeyHandle's project and location for the requested resource type.
- "name": "A String", # Output only. Identifier. Name of the [KeyHandle] resource, e.g. `projects/{PROJECT_ID}/locations/{LOCATION}/keyHandles/{KEY_HANDLE_ID}`.
+ "kmsKey": "A String", # Output only. Name of a CryptoKey that has been provisioned for Customer Managed Encryption Key (CMEK) use in the KeyHandle project and location for the requested resource type. The CryptoKey project will reflect the value configured in the AutokeyConfig on the resource project's ancestor folder at the time of the KeyHandle creation. If more than one ancestor folder has a configured AutokeyConfig, the nearest of these configurations is used.
+ "name": "A String", # Output only. Identifier. Name of the KeyHandle resource, e.g. `projects/{PROJECT_ID}/locations/{LOCATION}/keyHandles/{KEY_HANDLE_ID}`.
"resourceTypeSelector": "A String", # Required. Indicates the resource type that the resulting CryptoKey is meant to protect, e.g. `{SERVICE}.googleapis.com/{TYPE}`. See documentation for supported resource types.
}
@@ -176,8 +176,8 @@ Method Details
{ # Response message for Autokey.ListKeyHandles.
"keyHandles": [ # Resulting KeyHandles.
{ # Resource-oriented representation of a request to Cloud KMS Autokey and the resulting provisioning of a CryptoKey.
- "kmsKey": "A String", # Output only. Name of a CryptoKey that has been provisioned for Customer Managed Encryption Key (CMEK) use in the KeyHandle's project and location for the requested resource type.
- "name": "A String", # Output only. Identifier. Name of the [KeyHandle] resource, e.g. `projects/{PROJECT_ID}/locations/{LOCATION}/keyHandles/{KEY_HANDLE_ID}`.
+ "kmsKey": "A String", # Output only. Name of a CryptoKey that has been provisioned for Customer Managed Encryption Key (CMEK) use in the KeyHandle project and location for the requested resource type. The CryptoKey project will reflect the value configured in the AutokeyConfig on the resource project's ancestor folder at the time of the KeyHandle creation. If more than one ancestor folder has a configured AutokeyConfig, the nearest of these configurations is used.
+ "name": "A String", # Output only. Identifier. Name of the KeyHandle resource, e.g. `projects/{PROJECT_ID}/locations/{LOCATION}/keyHandles/{KEY_HANDLE_ID}`.
"resourceTypeSelector": "A String", # Required. Indicates the resource type that the resulting CryptoKey is meant to protect, e.g. `{SERVICE}.googleapis.com/{TYPE}`. See documentation for supported resource types.
},
],
diff --git a/docs/dyn/connectors_v1.projects.locations.connections.html b/docs/dyn/connectors_v1.projects.locations.connections.html
index 10a11363c19..a2f1cc3d8b0 100644
--- a/docs/dyn/connectors_v1.projects.locations.connections.html
+++ b/docs/dyn/connectors_v1.projects.locations.connections.html
@@ -491,6 +491,7 @@ Method Details
},
"logConfig": { # Log configuration for the connection. # Optional. Log configuration for the connection.
"enabled": True or False, # Enabled represents whether logging is enabled or not for a connection.
+ "level": "A String", # Optional. Log configuration level.
},
"name": "A String", # Output only. Resource name of the Connection. Format: projects/{project}/locations/{location}/connections/{connection}
"nodeConfig": { # Node configuration for the connection. # Optional. Node configuration for the connection.
@@ -964,6 +965,7 @@ Method Details
},
"logConfig": { # Log configuration for the connection. # Optional. Log configuration for the connection.
"enabled": True or False, # Enabled represents whether logging is enabled or not for a connection.
+ "level": "A String", # Optional. Log configuration level.
},
"name": "A String", # Output only. Resource name of the Connection. Format: projects/{project}/locations/{location}/connections/{connection}
"nodeConfig": { # Node configuration for the connection. # Optional. Node configuration for the connection.
@@ -1456,6 +1458,7 @@ Method Details
},
"logConfig": { # Log configuration for the connection. # Optional. Log configuration for the connection.
"enabled": True or False, # Enabled represents whether logging is enabled or not for a connection.
+ "level": "A String", # Optional. Log configuration level.
},
"name": "A String", # Output only. Resource name of the Connection. Format: projects/{project}/locations/{location}/connections/{connection}
"nodeConfig": { # Node configuration for the connection. # Optional. Node configuration for the connection.
@@ -1902,6 +1905,7 @@ Method Details
},
"logConfig": { # Log configuration for the connection. # Optional. Log configuration for the connection.
"enabled": True or False, # Enabled represents whether logging is enabled or not for a connection.
+ "level": "A String", # Optional. Log configuration level.
},
"name": "A String", # Output only. Resource name of the Connection. Format: projects/{project}/locations/{location}/connections/{connection}
"nodeConfig": { # Node configuration for the connection. # Optional. Node configuration for the connection.
@@ -2479,6 +2483,7 @@ Method Details
},
"logConfig": { # Log configuration for the connection. # Optional. Log configuration for the connection.
"enabled": True or False, # Enabled represents whether logging is enabled or not for a connection.
+ "level": "A String", # Optional. Log configuration level.
},
"name": "A String", # Output only. Resource name of the Connection. Format: projects/{project}/locations/{location}/connections/{connection}
"nodeConfig": { # Node configuration for the connection. # Optional. Node configuration for the connection.
diff --git a/docs/dyn/connectors_v1.projects.locations.customConnectors.customConnectorVersions.html b/docs/dyn/connectors_v1.projects.locations.customConnectors.customConnectorVersions.html
index 11af68446d0..de2c14465cd 100644
--- a/docs/dyn/connectors_v1.projects.locations.customConnectors.customConnectorVersions.html
+++ b/docs/dyn/connectors_v1.projects.locations.customConnectors.customConnectorVersions.html
@@ -80,6 +80,9 @@ Instance Methods
delete(name, x__xgafv=None)
Deletes a single CustomConnectorVersion.
+
+ deprecate(name, body=None, x__xgafv=None)
+Deprecates a single CustomConnectorVersion.
Method Details
close()
@@ -121,4 +124,45 @@
Method Details
}
+
+
deprecate(name, body=None, x__xgafv=None)
+
Deprecates a single CustomConnectorVersion.
+
+Args:
+ name: string, Required. Resource name of the form: `projects/{project}/locations/{location}/customConnectors/{custom_connector}/customConnectorVersions/{custom_connector_version}` (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # Request message for ConnectorsService.DeprecateCustomConnectorVersion
+}
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a network API call.
+ "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+ "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+ "response": { # The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+}
+
+