diff --git a/.changelog/7786.txt b/.changelog/7786.txt new file mode 100644 index 0000000000..8ec013c069 --- /dev/null +++ b/.changelog/7786.txt @@ -0,0 +1,3 @@ +```release-note:none + +``` diff --git a/google-beta/resource_certificate_manager_certificate_map_entry.go b/google-beta/resource_certificate_manager_certificate_map_entry.go index 212910605f..82ee1a0fa3 100644 --- a/google-beta/resource_certificate_manager_certificate_map_entry.go +++ b/google-beta/resource_certificate_manager_certificate_map_entry.go @@ -65,8 +65,8 @@ Each certificate must match pattern projects/*/locations/*/certificates/*.`, Type: schema.TypeString, Required: true, ForceNew: true, - Description: `A user-defined name of the Certificate Map Entry. Certificate Map Entry -names must be unique globally and match pattern + Description: `A user-defined name of the Certificate Map Entry. Certificate Map Entry +names must be unique globally and match pattern 'projects/*/locations/*/certificateMaps/*/certificateMapEntries/*'`, }, "description": { @@ -102,8 +102,8 @@ Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.`, "create_time": { Type: schema.TypeString, Computed: true, - Description: `Creation timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, -with nanosecond resolution and up to nine fractional digits. + Description: `Creation timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, +with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".`, }, "state": { @@ -114,8 +114,8 @@ Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".`, "update_time": { Type: schema.TypeString, Computed: true, - Description: `Update timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, -with nanosecond resolution and up to nine fractional digits. + Description: `Update timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, +with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".`, }, "project": { diff --git a/google-beta/resource_cloud_asset_folder_feed.go b/google-beta/resource_cloud_asset_folder_feed.go index ed3ac424bc..89974fa3c3 100644 --- a/google-beta/resource_cloud_asset_folder_feed.go +++ b/google-beta/resource_cloud_asset_folder_feed.go @@ -49,7 +49,7 @@ func ResourceCloudAssetFolderFeed() *schema.Resource { Required: true, ForceNew: true, Description: `The project whose identity will be used when sending messages to the -destination pubsub topic. It also specifies the project for API +destination pubsub topic. It also specifies the project for API enablement check, quota, and billing.`, }, "feed_id": { @@ -92,7 +92,7 @@ enablement check, quota, and billing.`, "asset_names": { Type: schema.TypeList, Optional: true, - Description: `A list of the full names of the assets to receive updates. You must specify either or both of + Description: `A list of the full names of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames and assetTypes are exported to the feed. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See https://cloud.google.com/apis/design/resourceNames#fullResourceName for more info.`, @@ -137,7 +137,7 @@ e.g. when hovered over it in a UI.`, "location": { Type: schema.TypeString, Optional: true, - Description: `String indicating the location of the expression for error reporting, e.g. a file + Description: `String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.`, }, "title": { diff --git a/google-beta/resource_cloud_asset_organization_feed.go b/google-beta/resource_cloud_asset_organization_feed.go index 4148d584ff..8e0a5d0068 100644 --- a/google-beta/resource_cloud_asset_organization_feed.go +++ b/google-beta/resource_cloud_asset_organization_feed.go @@ -49,7 +49,7 @@ func ResourceCloudAssetOrganizationFeed() *schema.Resource { Required: true, ForceNew: true, Description: `The project whose identity will be used when sending messages to the -destination pubsub topic. It also specifies the project for API +destination pubsub topic. It also specifies the project for API enablement check, quota, and billing.`, }, "feed_id": { @@ -92,7 +92,7 @@ enablement check, quota, and billing.`, "asset_names": { Type: schema.TypeList, Optional: true, - Description: `A list of the full names of the assets to receive updates. You must specify either or both of + Description: `A list of the full names of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames and assetTypes are exported to the feed. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See https://cloud.google.com/apis/design/resourceNames#fullResourceName for more info.`, @@ -137,7 +137,7 @@ e.g. when hovered over it in a UI.`, "location": { Type: schema.TypeString, Optional: true, - Description: `String indicating the location of the expression for error reporting, e.g. a file + Description: `String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.`, }, "title": { diff --git a/google-beta/resource_cloud_asset_project_feed.go b/google-beta/resource_cloud_asset_project_feed.go index 0ef60ee59c..fbca8afb67 100644 --- a/google-beta/resource_cloud_asset_project_feed.go +++ b/google-beta/resource_cloud_asset_project_feed.go @@ -77,7 +77,7 @@ func ResourceCloudAssetProjectFeed() *schema.Resource { "asset_names": { Type: schema.TypeList, Optional: true, - Description: `A list of the full names of the assets to receive updates. You must specify either or both of + Description: `A list of the full names of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames and assetTypes are exported to the feed. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See https://cloud.google.com/apis/design/resourceNames#fullResourceName for more info.`, @@ -102,7 +102,7 @@ supported asset types.`, Optional: true, ForceNew: true, Description: `The project whose identity will be used when sending messages to the -destination pubsub topic. It also specifies the project for API +destination pubsub topic. It also specifies the project for API enablement check, quota, and billing. If not specified, the resource's project will be used.`, }, @@ -131,7 +131,7 @@ e.g. when hovered over it in a UI.`, "location": { Type: schema.TypeString, Optional: true, - Description: `String indicating the location of the expression for error reporting, e.g. a file + Description: `String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.`, }, "title": { diff --git a/google-beta/resource_cloud_run_service.go b/google-beta/resource_cloud_run_service.go index 420f4837ed..f1a6efbefd 100644 --- a/google-beta/resource_cloud_run_service.go +++ b/google-beta/resource_cloud_run_service.go @@ -867,8 +867,8 @@ false when RevisionName is non-empty.`, "url": { Type: schema.TypeString, Computed: true, - Description: `URL displays the URL for accessing tagged traffic targets. URL is displayed in status, -and is disallowed on spec. URL must contain a scheme (e.g. http://) and a hostname, + Description: `URL displays the URL for accessing tagged traffic targets. URL is displayed in status, +and is disallowed on spec. URL must contain a scheme (e.g. http://) and a hostname, but may not contain anything else (e.g. basic auth, url path, etc.)`, }, }, @@ -1082,10 +1082,10 @@ version or an integer for a specific version.`, "name": { Type: schema.TypeString, Required: true, - Description: `The name of the secret in Cloud Secret Manager. By default, the secret is assumed to be in the same project. -If the secret is in another project, you must define an alias. -An alias definition has the form: :projects/{project-id|project-number}/secrets/. -If multiple alias definitions are needed, they must be separated by commas. + Description: `The name of the secret in Cloud Secret Manager. By default, the secret is assumed to be in the same project. +If the secret is in another project, you must define an alias. +An alias definition has the form: :projects/{project-id|project-number}/secrets/. +If multiple alias definitions are needed, they must be separated by commas. The alias definitions must be set on the run.googleapis.com/secrets annotation.`, }, }, diff --git a/google-beta/resource_cloud_scheduler_job.go b/google-beta/resource_cloud_scheduler_job.go index 0301d574b3..7b207859bd 100644 --- a/google-beta/resource_cloud_scheduler_job.go +++ b/google-beta/resource_cloud_scheduler_job.go @@ -125,7 +125,7 @@ func ResourceCloudSchedulerJob() *schema.Resource { Type: schema.TypeList, Optional: true, Description: `App Engine HTTP target. -If the job providers a App Engine HTTP target the cron will +If the job providers a App Engine HTTP target the cron will send a request to the service instance`, MaxItems: 1, Elem: &schema.Resource{ @@ -134,9 +134,9 @@ send a request to the service instance`, Type: schema.TypeString, Required: true, Description: `The relative URI. -The relative URL must begin with "/" and must be a valid HTTP relative URL. -It can contain a path, query string arguments, and \# fragments. -If the relative URL is empty, then the root path "/" will be used. +The relative URL must begin with "/" and must be a valid HTTP relative URL. +It can contain a path, query string arguments, and \# fragments. +If the relative URL is empty, then the root path "/" will be used. No spaces are allowed, and the maximum length allowed is 2083 characters`, }, "app_engine_routing": { @@ -174,8 +174,8 @@ By default, the job is sent to the version which is the default version when the Type: schema.TypeString, Optional: true, ValidateFunc: validateBase64String, - Description: `HTTP request body. -A request body is allowed only if the HTTP method is POST or PUT. + Description: `HTTP request body. +A request body is allowed only if the HTTP method is POST or PUT. It will result in invalid argument error to set a body on a job with an incompatible HttpMethod. A base64-encoded string.`, @@ -185,7 +185,7 @@ A base64-encoded string.`, Optional: true, ValidateFunc: validateHttpHeaders(), Description: `HTTP request headers. -This map contains the header field names and values. +This map contains the header field names and values. Headers can be set when the job is created.`, Elem: &schema.Schema{Type: schema.TypeString}, }, @@ -215,14 +215,14 @@ A duration in seconds with up to nine fractional digits, terminated by 's'. Exam "description": { Type: schema.TypeString, Optional: true, - Description: `A human-readable description for the job. + Description: `A human-readable description for the job. This string must not contain more than 500 characters.`, }, "http_target": { Type: schema.TypeList, Optional: true, Description: `HTTP target. -If the job providers a http_target the cron will +If the job providers a http_target the cron will send a request to the targeted url`, MaxItems: 1, Elem: &schema.Resource{ @@ -237,8 +237,8 @@ send a request to the targeted url`, Type: schema.TypeString, Optional: true, ValidateFunc: validateBase64String, - Description: `HTTP request body. -A request body is allowed only if the HTTP method is POST, PUT, or PATCH. + Description: `HTTP request body. +A request body is allowed only if the HTTP method is POST, PUT, or PATCH. It is an error to set body on a job with an incompatible HttpMethod. A base64-encoded string.`, @@ -247,7 +247,7 @@ A base64-encoded string.`, Type: schema.TypeMap, Optional: true, ValidateFunc: validateHttpHeaders(), - Description: `This map contains the header field names and values. + Description: `This map contains the header field names and values. Repeated headers are not supported, but a header value can contain commas.`, Elem: &schema.Schema{Type: schema.TypeString}, }, @@ -361,8 +361,8 @@ Pubsub message must contain either non-empty data, or at least one attribute. "retry_config": { Type: schema.TypeList, Optional: true, - Description: `By default, if a job does not complete successfully, -meaning that an acknowledgement is not received from the handler, + Description: `By default, if a job does not complete successfully, +meaning that an acknowledgement is not received from the handler, then it will be retried with exponential backoff according to the settings`, MaxItems: 1, Elem: &schema.Resource{ @@ -380,8 +380,8 @@ A duration in seconds with up to nine fractional digits, terminated by 's'.`, Computed: true, Optional: true, Description: `The time between retries will double maxDoublings times. -A job's retry interval starts at minBackoffDuration, -then doubles maxDoublings times, then increases linearly, +A job's retry interval starts at minBackoffDuration, +then doubles maxDoublings times, then increases linearly, and finally retries retries at intervals of maxBackoffDuration up to retryCount times.`, AtLeastOneOf: []string{"retry_config.0.retry_count", "retry_config.0.max_retry_duration", "retry_config.0.min_backoff_duration", "retry_config.0.max_backoff_duration", "retry_config.0.max_doublings"}, }, @@ -389,7 +389,7 @@ and finally retries retries at intervals of maxBackoffDuration up to retryCount Type: schema.TypeString, Computed: true, Optional: true, - Description: `The time limit for retrying a failed job, measured from time when an execution was first attempted. + Description: `The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with retryCount, the job will be retried until both limits are reached. A duration in seconds with up to nine fractional digits, terminated by 's'.`, AtLeastOneOf: []string{"retry_config.0.retry_count", "retry_config.0.max_retry_duration", "retry_config.0.min_backoff_duration", "retry_config.0.max_backoff_duration", "retry_config.0.max_doublings"}, @@ -406,7 +406,7 @@ A duration in seconds with up to nine fractional digits, terminated by 's'.`, Type: schema.TypeInt, Computed: true, Optional: true, - Description: `The number of attempts that the system will make to run a + Description: `The number of attempts that the system will make to run a job using the exponential backoff procedure described by maxDoublings. Values greater than 5 and negative values are not allowed.`, AtLeastOneOf: []string{"retry_config.0.retry_count", "retry_config.0.max_retry_duration", "retry_config.0.min_backoff_duration", "retry_config.0.max_backoff_duration", "retry_config.0.max_doublings"}, diff --git a/google-beta/resource_cloudbuild_bitbucket_server_config.go b/google-beta/resource_cloudbuild_bitbucket_server_config.go index 9de2532cb1..1025299631 100644 --- a/google-beta/resource_cloudbuild_bitbucket_server_config.go +++ b/google-beta/resource_cloudbuild_bitbucket_server_config.go @@ -110,9 +110,9 @@ Changing this field will result in deleting/ recreating the resource.`, "peered_network": { Type: schema.TypeString, Optional: true, - Description: `The network to be used when reaching out to the Bitbucket Server instance. The VPC network must be enabled for private service connection. -This should be set if the Bitbucket Server instance is hosted on-premises and not reachable by public internet. If this field is left empty, -no network peering will occur and calls to the Bitbucket Server instance will be made over the public internet. Must be in the format + Description: `The network to be used when reaching out to the Bitbucket Server instance. The VPC network must be enabled for private service connection. +This should be set if the Bitbucket Server instance is hosted on-premises and not reachable by public internet. If this field is left empty, +no network peering will occur and calls to the Bitbucket Server instance will be made over the public internet. Must be in the format projects/{project}/global/networks/{network}, where {project} is a project number or id and {network} is the name of a VPC network in the project.`, }, "ssl_ca": { diff --git a/google-beta/resource_cloudbuild_trigger.go b/google-beta/resource_cloudbuild_trigger.go index 6c9b0453d2..21db34af9a 100644 --- a/google-beta/resource_cloudbuild_trigger.go +++ b/google-beta/resource_cloudbuild_trigger.go @@ -101,8 +101,8 @@ func ResourceCloudBuildTrigger() *schema.Resource { Type: schema.TypeList, Computed: true, Optional: true, - Description: `Configuration for manual approval to start a build invocation of this BuildTrigger. -Builds created by this trigger will require approval before they execute. + Description: `Configuration for manual approval to start a build invocation of this BuildTrigger. +Builds created by this trigger will require approval before they execute. Any user with a Cloud Build Approver role for the project can approve a build.`, MaxItems: 1, Elem: &schema.Resource{ @@ -110,7 +110,7 @@ Any user with a Cloud Build Approver role for the project can approve a build.`, "approval_required": { Type: schema.TypeBool, Optional: true, - Description: `Whether or not approval is needed. If this is set on a build, it will become pending when run, + Description: `Whether or not approval is needed. If this is set on a build, it will become pending when run, and will need to be explicitly approved to start.`, Default: false, }, @@ -223,7 +223,7 @@ run directly. If not, the host will attempt to pull the image first, using the builder service account's credentials if necessary. The Docker daemon's cache will already have the latest versions of all of -the officially supported build steps (see https://github.com/GoogleCloudPlatform/cloud-builders +the officially supported build steps (see https://github.com/GoogleCloudPlatform/cloud-builders for images and examples). The Docker daemon will also have cached many of the layers for some popular images, like "ubuntu", "debian", but they will be refreshed at the time @@ -289,7 +289,7 @@ reference this build step as a dependency.`, "script": { Type: schema.TypeString, Optional: true, - Description: `A shell script to be executed in the step. + Description: `A shell script to be executed in the step. When script is provided, the user cannot specify the entrypoint or args.`, }, "secret_env": { @@ -492,7 +492,7 @@ If any of the images fail to be pushed, the build status is marked FAILURE.`, "logs_bucket": { Type: schema.TypeString, Optional: true, - Description: `Google Cloud Storage bucket where logs should be written. + Description: `Google Cloud Storage bucket where logs should be written. Logs file names will be of the format ${logsBucket}/log-${build_id}.txt.`, }, "options": { @@ -627,7 +627,7 @@ This field is experimental.`, "queue_ttl": { Type: schema.TypeString, Optional: true, - Description: `TTL in queue for this build. If provided and the build is enqueued longer than this value, + Description: `TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED. The TTL starts ticking from createTime. A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".`, @@ -647,8 +647,8 @@ A duration in seconds with up to nine fractional digits, terminated by 's'. Exam Type: schema.TypeMap, Optional: true, Description: `Map of environment variable name to its encrypted value. -Secret environment variables must be unique across all of a build's secrets, -and must be used by at least one build step. Values can be at most 64 KB in size. +Secret environment variables must be unique across all of a build's secrets, +and must be used by at least one build step. Values can be at most 64 KB in size. There can be at most 100 secret values across all of a build's secrets.`, Elem: &schema.Schema{Type: schema.TypeString}, }, @@ -680,7 +680,7 @@ One of 'storageSource' or 'repoSource' must be provided.`, Type: schema.TypeString, Optional: true, Description: `Regex matching branches to build. Exactly one a of branch name, tag, or commit SHA must be provided. -The syntax of the regular expressions accepted is the syntax accepted by RE2 and +The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax`, ExactlyOneOf: []string{"build.0.source.0.repo_source.0.branch_name", "build.0.source.0.repo_source.0.commit_sha", "build.0.source.0.repo_source.0.tag_name"}, }, @@ -694,7 +694,7 @@ described at https://github.com/google/re2/wiki/Syntax`, Type: schema.TypeString, Optional: true, Description: `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 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.`, }, "invert_regex": { @@ -705,7 +705,7 @@ this value is ignored for that step's execution.`, "project_id": { Type: schema.TypeString, Optional: true, - Description: `ID of the project that owns the Cloud Source Repository. + Description: `ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.`, }, "substitutions": { @@ -718,7 +718,7 @@ If omitted, the project ID requesting the build is assumed.`, Type: schema.TypeString, Optional: true, Description: `Regex matching tags to build. Exactly one a of branch name, tag, or commit SHA must be provided. -The syntax of the regular expressions accepted is the syntax accepted by RE2 and +The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax`, ExactlyOneOf: []string{"build.0.source.0.repo_source.0.branch_name", "build.0.source.0.repo_source.0.commit_sha", "build.0.source.0.repo_source.0.tag_name"}, }, @@ -746,7 +746,7 @@ This object must be a gzipped archive file (.tar.gz) containing source to build. "generation": { Type: schema.TypeString, Optional: true, - Description: `Google Cloud Storage generation for the object. + Description: `Google Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used`, }, }, @@ -796,7 +796,7 @@ Default time is ten minutes (600s).`, "filename": { Type: schema.TypeString, Optional: true, - Description: `Path, from the source root, to a file whose contents is used for the template. + Description: `Path, from the source root, to a file whose contents is used for the template. Either a filename or build template must be provided. Set this only when using trigger_template or github. When using Pub/Sub, Webhook or Manual set the file name using git_file_source instead.`, ExactlyOneOf: []string{"filename", "build", "git_file_source"}, @@ -822,7 +822,7 @@ When using Pub/Sub, Webhook or Manual set the file name using git_file_source in Type: schema.TypeString, Required: true, ValidateFunc: validateEnum([]string{"UNKNOWN", "CLOUD_SOURCE_REPOSITORIES", "GITHUB", "BITBUCKET_SERVER"}), - Description: `The type of the repo, since it may not be explicit from the repo field (e.g from a URL). + Description: `The type of the repo, since it may not be explicit from the repo field (e.g from a URL). Values can be UNKNOWN, CLOUD_SOURCE_REPOSITORIES, GITHUB, BITBUCKET_SERVER Possible values: ["UNKNOWN", "CLOUD_SOURCE_REPOSITORIES", "GITHUB", "BITBUCKET_SERVER"]`, }, "github_enterprise_config": { @@ -834,14 +834,14 @@ Format: projects/{project}/locations/{location}/githubEnterpriseConfigs/{id}. pr "revision": { Type: schema.TypeString, Optional: true, - Description: `The branch, tag, arbitrary ref, or SHA version of the repo to use when resolving the -filename (optional). This field respects the same syntax/resolution as described here: https://git-scm.com/docs/gitrevisions + Description: `The branch, tag, arbitrary ref, or SHA version of the repo to use when resolving the +filename (optional). This field respects the same syntax/resolution as described here: https://git-scm.com/docs/gitrevisions If unspecified, the revision from which the trigger invocation originated is assumed to be the revision from which to read the specified path.`, }, "uri": { Type: schema.TypeString, Optional: true, - Description: `The URI of the repo (optional). If unspecified, the repo from which the trigger + Description: `The URI of the repo (optional). If unspecified, the repo from which the trigger invocation originated is assumed to be the repo from which to read the specified path.`, }, }, @@ -993,7 +993,7 @@ If not specified, "global" is used.`, "pubsub_config": { Type: schema.TypeList, Optional: true, - Description: `PubsubConfig describes the configuration of a trigger that creates + Description: `PubsubConfig describes the configuration of a trigger that creates a build whenever a Pub/Sub message is published. One of 'trigger_template', 'github', 'pubsub_config' 'webhook_config' or 'source_to_build' must be provided.`, @@ -1120,9 +1120,9 @@ Format: projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT_ID_OR_EMAIL}`, "source_to_build": { Type: schema.TypeList, Optional: true, - Description: `The repo and ref of the repository from which to build. -This field is used only for those triggers that do not respond to SCM events. -Triggers that respond to such events build source at whatever commit caused the event. + Description: `The repo and ref of the repository from which to build. +This field is used only for those triggers that do not respond to SCM events. +Triggers that respond to such events build source at whatever commit caused the event. This field is currently only used by Webhook, Pub/Sub, Manual, and Cron triggers. One of 'trigger_template', 'github', 'pubsub_config' 'webhook_config' or 'source_to_build' must be provided.`, @@ -1237,7 +1237,7 @@ This field is a regular expression.`, "webhook_config": { Type: schema.TypeList, Optional: true, - Description: `WebhookConfig describes the configuration of a trigger that creates + Description: `WebhookConfig describes the configuration of a trigger that creates a build whenever a webhook is sent to a trigger's webhook URL. One of 'trigger_template', 'github', 'pubsub_config' 'webhook_config' or 'source_to_build' must be provided.`, diff --git a/google-beta/resource_cloudfunctions2_function.go b/google-beta/resource_cloudfunctions2_function.go index 00e6f306a6..fc24e58390 100644 --- a/google-beta/resource_cloudfunctions2_function.go +++ b/google-beta/resource_cloudfunctions2_function.go @@ -119,14 +119,14 @@ function, optional when updating an existing function.`, "invert_regex": { Type: schema.TypeBool, Optional: true, - Description: `Only trigger a build if the revision regex does + Description: `Only trigger a build if the revision regex does NOT match the revision regex.`, }, "project_id": { Type: schema.TypeString, Optional: true, ForceNew: true, - Description: `ID of the project that owns the Cloud Source Repository. If omitted, the + Description: `ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.`, }, "repo_name": { @@ -159,7 +159,7 @@ project ID requesting the build is assumed.`, "generation": { Type: schema.TypeInt, Optional: true, - Description: `Google Cloud Storage generation for the object. If the generation + Description: `Google Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.`, }, "object": { diff --git a/google-beta/resource_compute_disk.go b/google-beta/resource_compute_disk.go index 72fe4347a7..cf8b54ce75 100644 --- a/google-beta/resource_compute_disk.go +++ b/google-beta/resource_compute_disk.go @@ -377,8 +377,8 @@ RFC 4648 base64 to either encrypt or decrypt this resource.`, Type: schema.TypeString, Optional: true, ForceNew: true, - Description: `Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit -customer-supplied encryption key to either encrypt or decrypt + Description: `Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit +customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey.`, Sensitive: true, }, diff --git a/google-beta/resource_compute_network.go b/google-beta/resource_compute_network.go index 7168b3eec8..2cffdbf8ab 100644 --- a/google-beta/resource_compute_network.go +++ b/google-beta/resource_compute_network.go @@ -80,7 +80,7 @@ recreated to modify this field.`, Type: schema.TypeBool, Optional: true, ForceNew: true, - Description: `Enable ULA internal ipv6 on this network. Enabling this feature will assign + Description: `Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.`, }, "internal_ipv6_range": { @@ -88,10 +88,10 @@ a /48 from google defined ULA prefix fd20::/20.`, Computed: true, Optional: true, ForceNew: true, - Description: `When enabling ula internal ipv6, caller optionally can specify the /48 range -they want from the google defined ULA prefix fd20::/20. The input must be a -valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will -fail if the speficied /48 is already in used by another resource. + Description: `When enabling ula internal ipv6, caller optionally can specify the /48 range +they want from the google defined ULA prefix fd20::/20. The input must be a +valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will +fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.`, }, "mtu": { @@ -99,10 +99,10 @@ If the field is not speficied, then a /48 range will be randomly allocated from Computed: true, Optional: true, ForceNew: true, - Description: `Maximum Transmission Unit in bytes. The default value is 1460 bytes. + Description: `Maximum Transmission Unit in bytes. The default value is 1460 bytes. The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames). Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped -with an ICMP 'Fragmentation-Needed' message if the packets are routed to the Internet or other VPCs +with an ICMP 'Fragmentation-Needed' message if the packets are routed to the Internet or other VPCs with varying MTUs.`, }, "network_firewall_policy_enforcement_order": { diff --git a/google-beta/resource_compute_region_commitment.go b/google-beta/resource_compute_region_commitment.go index c73a96bce4..832f0256ad 100644 --- a/google-beta/resource_compute_region_commitment.go +++ b/google-beta/resource_compute_region_commitment.go @@ -64,9 +64,9 @@ The currently supported plans are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 Computed: true, Optional: true, ForceNew: true, - Description: `Specifies whether to enable automatic renewal for the commitment. -The default value is false if not specified. -If the field is set to true, the commitment will be automatically renewed for either + Description: `Specifies whether to enable automatic renewal for the commitment. +The default value is false if not specified. +If the field is set to true, the commitment will be automatically renewed for either one or three years according to the terms of the existing commitment.`, }, "category": { @@ -127,7 +127,7 @@ Note that only MACHINE commitments should have a Type specified. Possible values Type: schema.TypeList, Optional: true, ForceNew: true, - Description: `A list of commitment amounts for particular resources. + Description: `A list of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together.`, Elem: &schema.Resource{ Schema: map[string]*schema.Schema{ @@ -162,7 +162,7 @@ Possible values are VCPU, MEMORY, LOCAL_SSD, and ACCELERATOR.`, Optional: true, ForceNew: true, ValidateFunc: validateEnum([]string{"MEMORY_OPTIMIZED", "ACCELERATOR_OPTIMIZED", ""}), - Description: `The type of commitment, which affects the discount rate and the eligible resources. + Description: `The type of commitment, which affects the discount rate and the eligible resources. Type MEMORY_OPTIMIZED specifies a commitment that will only apply to memory optimized machines. Type ACCELERATOR_OPTIMIZED specifies a commitment that will only apply to accelerator optimized machines. Possible values: ["MEMORY_OPTIMIZED", "ACCELERATOR_OPTIMIZED"]`, diff --git a/google-beta/resource_compute_resource_policy.go b/google-beta/resource_compute_resource_policy.go index df5a3aa7fe..8afe1b0cd2 100644 --- a/google-beta/resource_compute_resource_policy.go +++ b/google-beta/resource_compute_resource_policy.go @@ -328,8 +328,8 @@ the source disk is deleted. Default value: "KEEP_AUTO_SNAPSHOTS" Possible values Type: schema.TypeString, Optional: true, ForceNew: true, - Description: `Creates the new snapshot in the snapshot chain labeled with the -specified name. The chain name must be 1-63 characters long and comply + Description: `Creates the new snapshot in the snapshot chain labeled with the +specified name. The chain name must be 1-63 characters long and comply with RFC1035.`, }, "guest_flush": { diff --git a/google-beta/resource_compute_snapshot.go b/google-beta/resource_compute_snapshot.go index 59b737774c..2e1785eeca 100644 --- a/google-beta/resource_compute_snapshot.go +++ b/google-beta/resource_compute_snapshot.go @@ -67,11 +67,11 @@ character, which cannot be a dash.`, Type: schema.TypeString, Optional: true, ForceNew: true, - Description: `Creates the new snapshot in the snapshot chain labeled with the -specified name. The chain name must be 1-63 characters long and -comply with RFC1035. This is an uncommon option only for advanced -service owners who needs to create separate snapshot chains, for -example, for chargeback tracking. When you describe your snapshot + Description: `Creates the new snapshot in the snapshot chain labeled with the +specified name. The chain name must be 1-63 characters long and +comply with RFC1035. This is an uncommon option only for advanced +service owners who needs to create separate snapshot chains, for +example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value.`, }, "description": { diff --git a/google-beta/resource_compute_target_https_proxy.go b/google-beta/resource_compute_target_https_proxy.go index d49c095f86..b830c723a8 100644 --- a/google-beta/resource_compute_target_https_proxy.go +++ b/google-beta/resource_compute_target_https_proxy.go @@ -64,7 +64,7 @@ to the BackendService.`, "certificate_map": { Type: schema.TypeString, Optional: true, - Description: `A reference to the CertificateMap resource uri that identifies a certificate map + Description: `A reference to the CertificateMap resource uri that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. Accepted format is '//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}'.`, }, diff --git a/google-beta/resource_data_fusion_instance.go b/google-beta/resource_data_fusion_instance.go index be49dd12f1..f53e144779 100644 --- a/google-beta/resource_data_fusion_instance.go +++ b/google-beta/resource_data_fusion_instance.go @@ -84,7 +84,7 @@ of concurrent pipelines, no support for streaming pipelines, etc. - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc. - DEVELOPER: Developer Data Fusion instance. In Developer type, the user will have all features available but -with restrictive capabilities. This is to help enterprises design and develop their data ingestion and integration +with restrictive capabilities. This is to help enterprises design and develop their data ingestion and integration pipelines at low cost. Possible values: ["BASIC", "ENTERPRISE", "DEVELOPER"]`, }, "accelerators": { @@ -92,7 +92,7 @@ pipelines at low cost. Possible values: ["BASIC", "ENTERPRISE", "DEVELOPER"]`, Optional: true, Description: `List of accelerators enabled for this CDF instance. -If accelerators are enabled it is possible a permadiff will be created with the Options field. +If accelerators are enabled it is possible a permadiff will be created with the Options field. Users will need to either manually update their state file to include these diffed options, or include the field in a [lifecycle ignore changes block](https://developer.hashicorp.com/terraform/language/meta-arguments/lifecycle#ignore_changes).`, Elem: &schema.Resource{ Schema: map[string]*schema.Schema{ diff --git a/google-beta/resource_data_loss_prevention_job_trigger.go b/google-beta/resource_data_loss_prevention_job_trigger.go index 24cbd7b5d7..a2515f63da 100644 --- a/google-beta/resource_data_loss_prevention_job_trigger.go +++ b/google-beta/resource_data_loss_prevention_job_trigger.go @@ -137,7 +137,7 @@ Form of: gs://bucket/folder/ or gs://bucket`, Optional: true, Description: `List of user-specified file type groups to transform. If specified, only the files with these filetypes will be transformed. -If empty, all supported files will be transformed. Supported types may be automatically added over time. +If empty, all supported files will be transformed. Supported types may be automatically added over time. If a file type is set in this field that isn't supported by the Deidentify action then the job will fail and will not be successfully created/started. Possible values: ["IMAGE", "TEXT_FILE", "CSV", "TSV"]`, Elem: &schema.Schema{ @@ -382,22 +382,22 @@ If not specified, no identifying fields will be returned for findings.`, "rows_limit": { Type: schema.TypeInt, Optional: true, - Description: `Max number of rows to scan. If the table has more rows than this value, the rest of the rows are omitted. -If not set, or if set to 0, all rows will be scanned. Only one of rowsLimit and rowsLimitPercent can be + Description: `Max number of rows to scan. If the table has more rows than this value, the rest of the rows are omitted. +If not set, or if set to 0, all rows will be scanned. Only one of rowsLimit and rowsLimitPercent can be specified. Cannot be used in conjunction with TimespanConfig.`, }, "rows_limit_percent": { Type: schema.TypeInt, Optional: true, - Description: `Max percentage of rows to scan. The rest are omitted. The number of rows scanned is rounded down. -Must be between 0 and 100, inclusively. Both 0 and 100 means no limit. Defaults to 0. Only one of + Description: `Max percentage of rows to scan. The rest are omitted. The number of rows scanned is rounded down. +Must be between 0 and 100, inclusively. Both 0 and 100 means no limit. Defaults to 0. Only one of rowsLimit and rowsLimitPercent can be specified. Cannot be used in conjunction with TimespanConfig.`, }, "sample_method": { Type: schema.TypeString, Optional: true, ValidateFunc: validateEnum([]string{"TOP", "RANDOM_START", ""}), - Description: `How to sample rows if not all rows are scanned. Meaningful only when used in conjunction with either + Description: `How to sample rows if not all rows are scanned. Meaningful only when used in conjunction with either rowsLimit or rowsLimitPercent. If not specified, rows are scanned in the order BigQuery reads them. Default value: "TOP" Possible values: ["TOP", "RANDOM_START"]`, Default: "TOP", }, diff --git a/google-beta/resource_dialogflow_agent.go b/google-beta/resource_dialogflow_agent.go index a0481ccbd9..baad915c8f 100644 --- a/google-beta/resource_dialogflow_agent.go +++ b/google-beta/resource_dialogflow_agent.go @@ -47,7 +47,7 @@ func ResourceDialogflowAgent() *schema.Resource { Type: schema.TypeString, Required: true, ForceNew: true, - Description: `The default language of the agent as a language tag. [See Language Support](https://cloud.google.com/dialogflow/docs/reference/language) + Description: `The default language of the agent as a language tag. [See Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. This field cannot be updated after creation.`, }, "display_name": { @@ -67,7 +67,7 @@ Europe/Paris.`, Optional: true, ValidateFunc: validateEnum([]string{"API_VERSION_V1", "API_VERSION_V2", "API_VERSION_V2_BETA_1", ""}), Description: `API version displayed in Dialogflow console. If not specified, V2 API is assumed. Clients are free to query -different service endpoints for different API versions. However, bots connectors and webhook calls will follow +different service endpoints for different API versions. However, bots connectors and webhook calls will follow the specified API version. * API_VERSION_V1: Legacy V1 API. * API_VERSION_V2: V2 API. @@ -85,8 +85,8 @@ from the API will be shown in the [avatarUriBackend] field.`, Optional: true, Description: `To filter out false positive results and still get variety in matched natural language inputs for your agent, you can tune the machine learning classification threshold. If the returned score value is less than the threshold -value, then a fallback intent will be triggered or, if there are no fallback intents defined, no intent will be -triggered. The score values range from 0.0 (completely uncertain) to 1.0 (completely certain). If set to 0.0, the +value, then a fallback intent will be triggered or, if there are no fallback intents defined, no intent will be +triggered. The score values range from 0.0 (completely uncertain) to 1.0 (completely certain). If set to 0.0, the default of 0.3 is used.`, }, "description": { @@ -127,7 +127,7 @@ using @sys.any or very large developer entities. Possible values: ["MATCH_MODE_H * TIER_STANDARD: Standard tier. * TIER_ENTERPRISE: Enterprise tier (Essentials). * TIER_ENTERPRISE_PLUS: Enterprise tier (Plus). -NOTE: Due to consistency issues, the provider will not read this field from the API. Drift is possible between +NOTE: Due to consistency issues, the provider will not read this field from the API. Drift is possible between the Terraform state and Dialogflow if the agent tier is changed outside of Terraform. Possible values: ["TIER_STANDARD", "TIER_ENTERPRISE", "TIER_ENTERPRISE_PLUS"]`, }, "avatar_uri_backend": { diff --git a/google-beta/resource_dialogflow_entity_type.go b/google-beta/resource_dialogflow_entity_type.go index dfe4de1dfd..e7d3e78eab 100644 --- a/google-beta/resource_dialogflow_entity_type.go +++ b/google-beta/resource_dialogflow_entity_type.go @@ -96,7 +96,7 @@ For KIND_LIST entity types: "name": { Type: schema.TypeString, Computed: true, - Description: `The unique identifier of the entity type. + Description: `The unique identifier of the entity type. Format: projects//agent/entityTypes/.`, }, "project": { diff --git a/google-beta/resource_dialogflow_fulfillment.go b/google-beta/resource_dialogflow_fulfillment.go index f846d2603e..4cae381fe0 100644 --- a/google-beta/resource_dialogflow_fulfillment.go +++ b/google-beta/resource_dialogflow_fulfillment.go @@ -103,7 +103,7 @@ func ResourceDialogflowFulfillment() *schema.Resource { "name": { Type: schema.TypeString, Computed: true, - Description: `The unique identifier of the fulfillment. + Description: `The unique identifier of the fulfillment. Format: projects//agent/fulfillment - projects//locations//agent/fulfillment`, }, "project": { diff --git a/google-beta/resource_dialogflow_intent.go b/google-beta/resource_dialogflow_intent.go index 643f939a45..a3e02d8935 100644 --- a/google-beta/resource_dialogflow_intent.go +++ b/google-beta/resource_dialogflow_intent.go @@ -69,7 +69,7 @@ Note: The action name must not contain whitespaces.`, Type: schema.TypeList, Optional: true, Description: `The collection of event names that trigger the intent. If the collection of input contexts is not empty, all of -the contexts must be present in the active user session for an event to trigger this intent. See the +the contexts must be present in the active user session for an event to trigger this intent. See the [events reference](https://cloud.google.com/dialogflow/docs/events-overview) for more details.`, Elem: &schema.Schema{ Type: schema.TypeString, @@ -156,7 +156,7 @@ Format: projects//agent/intents/.`, "name": { Type: schema.TypeString, Computed: true, - Description: `The unique identifier of this intent. + Description: `The unique identifier of this intent. Format: projects//agent/intents/.`, }, "root_followup_intent_name": { diff --git a/google-beta/resource_dns_managed_zone.go b/google-beta/resource_dns_managed_zone.go index 949f49e4f4..a4a6592472 100644 --- a/google-beta/resource_dns_managed_zone.go +++ b/google-beta/resource_dns_managed_zone.go @@ -260,8 +260,8 @@ blocks in an update and then apply another update adding all of them back simult "gke_cluster_name": { Type: schema.TypeString, Required: true, - Description: `The resource name of the cluster to bind this ManagedZone to. -This should be specified in the format like + Description: `The resource name of the cluster to bind this ManagedZone to. +This should be specified in the format like 'projects/*/locations/*/clusters/*'`, }, }, diff --git a/google-beta/resource_dns_response_policy.go b/google-beta/resource_dns_response_policy.go index 54ba4d32cc..5dec9cdbde 100644 --- a/google-beta/resource_dns_response_policy.go +++ b/google-beta/resource_dns_response_policy.go @@ -64,8 +64,8 @@ func ResourceDNSResponsePolicy() *schema.Resource { "gke_cluster_name": { Type: schema.TypeString, Required: true, - Description: `The resource name of the cluster to bind this ManagedZone to. -This should be specified in the format like + Description: `The resource name of the cluster to bind this ManagedZone to. +This should be specified in the format like 'projects/*/locations/*/clusters/*'`, }, }, diff --git a/website/docs/r/certificate_manager_certificate_map_entry.html.markdown b/website/docs/r/certificate_manager_certificate_map_entry.html.markdown index efd6294110..39d75152e9 100644 --- a/website/docs/r/certificate_manager_certificate_map_entry.html.markdown +++ b/website/docs/r/certificate_manager_certificate_map_entry.html.markdown @@ -15,13 +15,13 @@ subcategory: "Certificate manager" description: |- CertificateMapEntry is a list of certificate configurations, - that have been issued for a particular hostname + that have been issued for a particular hostname --- # google\_certificate\_manager\_certificate\_map\_entry CertificateMapEntry is a list of certificate configurations, -that have been issued for a particular hostname +that have been issued for a particular hostname @@ -98,8 +98,8 @@ The following arguments are supported: * `name` - (Required) - A user-defined name of the Certificate Map Entry. Certificate Map Entry - names must be unique globally and match pattern + A user-defined name of the Certificate Map Entry. Certificate Map Entry + names must be unique globally and match pattern 'projects/*/locations/*/certificateMaps/*/certificateMapEntries/*' * `map` - @@ -141,13 +141,13 @@ In addition to the arguments listed above, the following computed attributes are * `id` - an identifier for the resource with format `projects/{{project}}/locations/global/certificateMaps/{{map}}/certificateMapEntries/{{name}}` * `create_time` - - Creation timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, - with nanosecond resolution and up to nine fractional digits. + Creation timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, + with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z". * `update_time` - - Update timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, - with nanosecond resolution and up to nine fractional digits. + Update timestamp of a Certificate Map Entry. Timestamp in RFC3339 UTC "Zulu" format, + with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z". * `state` - diff --git a/website/docs/r/cloud_asset_folder_feed.html.markdown b/website/docs/r/cloud_asset_folder_feed.html.markdown index 521af67f69..3ff4218177 100644 --- a/website/docs/r/cloud_asset_folder_feed.html.markdown +++ b/website/docs/r/cloud_asset_folder_feed.html.markdown @@ -88,7 +88,7 @@ The following arguments are supported: * `billing_project` - (Required) The project whose identity will be used when sending messages to the - destination pubsub topic. It also specifies the project for API + destination pubsub topic. It also specifies the project for API enablement check, quota, and billing. * `feed_id` - @@ -124,7 +124,7 @@ The following arguments are supported: * `asset_names` - (Optional) - A list of the full names of the assets to receive updates. You must specify either or both of + A list of the full names of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames and assetTypes are exported to the feed. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See https://cloud.google.com/apis/design/resourceNames#fullResourceName for more info. @@ -170,7 +170,7 @@ The following arguments are supported: * `location` - (Optional) - String indicating the location of the expression for error reporting, e.g. a file + String indicating the location of the expression for error reporting, e.g. a file name and a position in the file. ## Attributes Reference diff --git a/website/docs/r/cloud_asset_organization_feed.html.markdown b/website/docs/r/cloud_asset_organization_feed.html.markdown index b691e50a66..a52cac481d 100644 --- a/website/docs/r/cloud_asset_organization_feed.html.markdown +++ b/website/docs/r/cloud_asset_organization_feed.html.markdown @@ -82,7 +82,7 @@ The following arguments are supported: * `billing_project` - (Required) The project whose identity will be used when sending messages to the - destination pubsub topic. It also specifies the project for API + destination pubsub topic. It also specifies the project for API enablement check, quota, and billing. * `feed_id` - @@ -118,7 +118,7 @@ The following arguments are supported: * `asset_names` - (Optional) - A list of the full names of the assets to receive updates. You must specify either or both of + A list of the full names of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames and assetTypes are exported to the feed. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See https://cloud.google.com/apis/design/resourceNames#fullResourceName for more info. @@ -164,7 +164,7 @@ The following arguments are supported: * `location` - (Optional) - String indicating the location of the expression for error reporting, e.g. a file + String indicating the location of the expression for error reporting, e.g. a file name and a position in the file. ## Attributes Reference diff --git a/website/docs/r/cloud_asset_project_feed.html.markdown b/website/docs/r/cloud_asset_project_feed.html.markdown index c9f254e50d..9d3336dc16 100644 --- a/website/docs/r/cloud_asset_project_feed.html.markdown +++ b/website/docs/r/cloud_asset_project_feed.html.markdown @@ -107,13 +107,13 @@ The following arguments are supported: * `billing_project` - (Optional) The project whose identity will be used when sending messages to the - destination pubsub topic. It also specifies the project for API + destination pubsub topic. It also specifies the project for API enablement check, quota, and billing. If not specified, the resource's project will be used. * `asset_names` - (Optional) - A list of the full names of the assets to receive updates. You must specify either or both of + A list of the full names of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames and assetTypes are exported to the feed. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See https://cloud.google.com/apis/design/resourceNames#fullResourceName for more info. @@ -162,7 +162,7 @@ The following arguments are supported: * `location` - (Optional) - String indicating the location of the expression for error reporting, e.g. a file + String indicating the location of the expression for error reporting, e.g. a file name and a position in the file. ## Attributes Reference diff --git a/website/docs/r/cloud_identity_group.html.markdown b/website/docs/r/cloud_identity_group.html.markdown index 212c66ee73..058b288f0d 100644 --- a/website/docs/r/cloud_identity_group.html.markdown +++ b/website/docs/r/cloud_identity_group.html.markdown @@ -29,9 +29,9 @@ To get more information about Group, see: * [Official Documentation](https://cloud.google.com/identity/docs/how-to/setup) ~> **Warning:** If you are using User ADCs (Application Default Credentials) with this resource, -you must specify a `billing_project` and set `user_project_override` to true -in the provider configuration. Otherwise the Cloud Identity API will return a 403 error. -Your account must have the `serviceusage.services.use` permission on the +you must specify a `billing_project` and set `user_project_override` to true +in the provider configuration. Otherwise the Cloud Identity API will return a 403 error. +Your account must have the `serviceusage.services.use` permission on the `billing_project` you defined. ## Example Usage - Cloud Identity Groups Basic diff --git a/website/docs/r/cloud_identity_group_membership.html.markdown b/website/docs/r/cloud_identity_group_membership.html.markdown index b662600162..0544e308a2 100644 --- a/website/docs/r/cloud_identity_group_membership.html.markdown +++ b/website/docs/r/cloud_identity_group_membership.html.markdown @@ -29,9 +29,9 @@ To get more information about GroupMembership, see: * [Official Documentation](https://cloud.google.com/identity/docs/how-to/memberships-google-groups) ~> **Warning:** If you are using User ADCs (Application Default Credentials) with this resource, -you must specify a `billing_project` and set `user_project_override` to true -in the provider configuration. Otherwise the Cloud Identity API will return a 403 error. -Your account must have the `serviceusage.services.use` permission on the +you must specify a `billing_project` and set `user_project_override` to true +in the provider configuration. Otherwise the Cloud Identity API will return a 403 error. +Your account must have the `serviceusage.services.use` permission on the `billing_project` you defined. ## Example Usage - Cloud Identity Group Membership diff --git a/website/docs/r/cloud_run_service.html.markdown b/website/docs/r/cloud_run_service.html.markdown index 5bf966d4cb..4ee725fd74 100644 --- a/website/docs/r/cloud_run_service.html.markdown +++ b/website/docs/r/cloud_run_service.html.markdown @@ -214,8 +214,8 @@ The following arguments are supported: * `url` - (Output) - URL displays the URL for accessing tagged traffic targets. URL is displayed in status, - and is disallowed on spec. URL must contain a scheme (e.g. http://) and a hostname, + URL displays the URL for accessing tagged traffic targets. URL is displayed in status, + and is disallowed on spec. URL must contain a scheme (e.g. http://) and a hostname, but may not contain anything else (e.g. basic auth, url path, etc.) The `template` block supports: @@ -511,10 +511,10 @@ The following arguments are supported: * `name` - (Required) - The name of the secret in Cloud Secret Manager. By default, the secret is assumed to be in the same project. - If the secret is in another project, you must define an alias. - An alias definition has the form: :projects/{project-id|project-number}/secrets/. - If multiple alias definitions are needed, they must be separated by commas. + The name of the secret in Cloud Secret Manager. By default, the secret is assumed to be in the same project. + If the secret is in another project, you must define an alias. + An alias definition has the form: :projects/{project-id|project-number}/secrets/. + If multiple alias definitions are needed, they must be separated by commas. The alias definitions must be set on the run.googleapis.com/secrets annotation. The `ports` block supports: diff --git a/website/docs/r/cloud_scheduler_job.html.markdown b/website/docs/r/cloud_scheduler_job.html.markdown index 04416a299d..c359fce158 100644 --- a/website/docs/r/cloud_scheduler_job.html.markdown +++ b/website/docs/r/cloud_scheduler_job.html.markdown @@ -215,7 +215,7 @@ The following arguments are supported: * `description` - (Optional) - A human-readable description for the job. + A human-readable description for the job. This string must not contain more than 500 characters. * `schedule` - @@ -244,8 +244,8 @@ The following arguments are supported: * `retry_config` - (Optional) - By default, if a job does not complete successfully, - meaning that an acknowledgement is not received from the handler, + By default, if a job does not complete successfully, + meaning that an acknowledgement is not received from the handler, then it will be retried with exponential backoff according to the settings Structure is [documented below](#nested_retry_config). @@ -259,14 +259,14 @@ The following arguments are supported: * `app_engine_http_target` - (Optional) App Engine HTTP target. - If the job providers a App Engine HTTP target the cron will + If the job providers a App Engine HTTP target the cron will send a request to the service instance Structure is [documented below](#nested_app_engine_http_target). * `http_target` - (Optional) HTTP target. - If the job providers a http_target the cron will + If the job providers a http_target the cron will send a request to the targeted url Structure is [documented below](#nested_http_target). @@ -282,13 +282,13 @@ The following arguments are supported: * `retry_count` - (Optional) - The number of attempts that the system will make to run a + The number of attempts that the system will make to run a job using the exponential backoff procedure described by maxDoublings. Values greater than 5 and negative values are not allowed. * `max_retry_duration` - (Optional) - The time limit for retrying a failed job, measured from time when an execution was first attempted. + The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with retryCount, the job will be retried until both limits are reached. A duration in seconds with up to nine fractional digits, terminated by 's'. @@ -305,8 +305,8 @@ The following arguments are supported: * `max_doublings` - (Optional) The time between retries will double maxDoublings times. - A job's retry interval starts at minBackoffDuration, - then doubles maxDoublings times, then increases linearly, + A job's retry interval starts at minBackoffDuration, + then doubles maxDoublings times, then increases linearly, and finally retries retries at intervals of maxBackoffDuration up to retryCount times. The `pubsub_target` block supports: @@ -343,22 +343,22 @@ The following arguments are supported: * `relative_uri` - (Required) The relative URI. - The relative URL must begin with "/" and must be a valid HTTP relative URL. - It can contain a path, query string arguments, and \# fragments. - If the relative URL is empty, then the root path "/" will be used. + The relative URL must begin with "/" and must be a valid HTTP relative URL. + It can contain a path, query string arguments, and \# fragments. + If the relative URL is empty, then the root path "/" will be used. No spaces are allowed, and the maximum length allowed is 2083 characters * `body` - (Optional) - HTTP request body. - A request body is allowed only if the HTTP method is POST or PUT. + HTTP request body. + A request body is allowed only if the HTTP method is POST or PUT. It will result in invalid argument error to set a body on a job with an incompatible HttpMethod. A base64-encoded string. * `headers` - (Optional) HTTP request headers. - This map contains the header field names and values. + This map contains the header field names and values. Headers can be set when the job is created. @@ -391,14 +391,14 @@ The following arguments are supported: * `body` - (Optional) - HTTP request body. - A request body is allowed only if the HTTP method is POST, PUT, or PATCH. + HTTP request body. + A request body is allowed only if the HTTP method is POST, PUT, or PATCH. It is an error to set body on a job with an incompatible HttpMethod. A base64-encoded string. * `headers` - (Optional) - This map contains the header field names and values. + This map contains the header field names and values. Repeated headers are not supported, but a header value can contain commas. * `oauth_token` - diff --git a/website/docs/r/cloudbuild_bitbucket_server_config.html.markdown b/website/docs/r/cloudbuild_bitbucket_server_config.html.markdown index 5a9f582104..1f567e5f68 100644 --- a/website/docs/r/cloudbuild_bitbucket_server_config.html.markdown +++ b/website/docs/r/cloudbuild_bitbucket_server_config.html.markdown @@ -187,9 +187,9 @@ The following arguments are supported: * `peered_network` - (Optional) - The network to be used when reaching out to the Bitbucket Server instance. The VPC network must be enabled for private service connection. - This should be set if the Bitbucket Server instance is hosted on-premises and not reachable by public internet. If this field is left empty, - no network peering will occur and calls to the Bitbucket Server instance will be made over the public internet. Must be in the format + The network to be used when reaching out to the Bitbucket Server instance. The VPC network must be enabled for private service connection. + This should be set if the Bitbucket Server instance is hosted on-premises and not reachable by public internet. If this field is left empty, + no network peering will occur and calls to the Bitbucket Server instance will be made over the public internet. Must be in the format projects/{project}/global/networks/{network}, where {project} is a project number or id and {network} is the name of a VPC network in the project. * `ssl_ca` - diff --git a/website/docs/r/cloudbuild_trigger.html.markdown b/website/docs/r/cloudbuild_trigger.html.markdown index 7a27ac1785..f6c93c82a2 100644 --- a/website/docs/r/cloudbuild_trigger.html.markdown +++ b/website/docs/r/cloudbuild_trigger.html.markdown @@ -531,7 +531,7 @@ The following arguments are supported: * `filename` - (Optional) - Path, from the source root, to a file whose contents is used for the template. + Path, from the source root, to a file whose contents is used for the template. Either a filename or build template must be provided. Set this only when using trigger_template or github. When using Pub/Sub, Webhook or Manual set the file name using git_file_source instead. @@ -551,9 +551,9 @@ The following arguments are supported: * `source_to_build` - (Optional) - The repo and ref of the repository from which to build. - This field is used only for those triggers that do not respond to SCM events. - Triggers that respond to such events build source at whatever commit caused the event. + The repo and ref of the repository from which to build. + This field is used only for those triggers that do not respond to SCM events. + Triggers that respond to such events build source at whatever commit caused the event. This field is currently only used by Webhook, Pub/Sub, Manual, and Cron triggers. One of `trigger_template`, `github`, `pubsub_config` `webhook_config` or `source_to_build` must be provided. Structure is [documented below](#nested_source_to_build). @@ -602,22 +602,22 @@ The following arguments are supported: * `pubsub_config` - (Optional) - PubsubConfig describes the configuration of a trigger that creates + PubsubConfig describes the configuration of a trigger that creates a build whenever a Pub/Sub message is published. One of `trigger_template`, `github`, `pubsub_config` `webhook_config` or `source_to_build` must be provided. Structure is [documented below](#nested_pubsub_config). * `webhook_config` - (Optional) - WebhookConfig describes the configuration of a trigger that creates + WebhookConfig describes the configuration of a trigger that creates a build whenever a webhook is sent to a trigger's webhook URL. One of `trigger_template`, `github`, `pubsub_config` `webhook_config` or `source_to_build` must be provided. Structure is [documented below](#nested_webhook_config). * `approval_config` - (Optional) - Configuration for manual approval to start a build invocation of this BuildTrigger. - Builds created by this trigger will require approval before they execute. + Configuration for manual approval to start a build invocation of this BuildTrigger. + Builds created by this trigger will require approval before they execute. Any user with a Cloud Build Approver role for the project can approve a build. Structure is [documented below](#nested_approval_config). @@ -643,19 +643,19 @@ The following arguments are supported: * `uri` - (Optional) - The URI of the repo (optional). If unspecified, the repo from which the trigger + The URI of the repo (optional). If unspecified, the repo from which the trigger invocation originated is assumed to be the repo from which to read the specified path. * `repo_type` - (Required) - The type of the repo, since it may not be explicit from the repo field (e.g from a URL). + The type of the repo, since it may not be explicit from the repo field (e.g from a URL). Values can be UNKNOWN, CLOUD_SOURCE_REPOSITORIES, GITHUB, BITBUCKET_SERVER Possible values are: `UNKNOWN`, `CLOUD_SOURCE_REPOSITORIES`, `GITHUB`, `BITBUCKET_SERVER`. * `revision` - (Optional) - The branch, tag, arbitrary ref, or SHA version of the repo to use when resolving the - filename (optional). This field respects the same syntax/resolution as described here: https://git-scm.com/docs/gitrevisions + The branch, tag, arbitrary ref, or SHA version of the repo to use when resolving the + filename (optional). This field respects the same syntax/resolution as described here: https://git-scm.com/docs/gitrevisions If unspecified, the revision from which the trigger invocation originated is assumed to be the revision from which to read the specified path. * `github_enterprise_config` - @@ -919,7 +919,7 @@ The following arguments are supported: * `approval_required` - (Optional) - Whether or not approval is needed. If this is set on a build, it will become pending when run, + Whether or not approval is needed. If this is set on a build, it will become pending when run, and will need to be explicitly approved to start. The `build` block supports: @@ -947,14 +947,14 @@ The following arguments are supported: * `queue_ttl` - (Optional) - TTL in queue for this build. If provided and the build is enqueued longer than this value, + TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED. The TTL starts ticking from createTime. A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s". * `logs_bucket` - (Optional) - Google Cloud Storage bucket where logs should be written. + Google Cloud Storage bucket where logs should be written. Logs file names will be of the format ${logsBucket}/log-${build_id}.txt. * `timeout` - @@ -1017,14 +1017,14 @@ The following arguments are supported: * `generation` - (Optional) - Google Cloud Storage generation for the object. + Google Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used The `repo_source` block supports: * `project_id` - (Optional) - ID of the project that owns the Cloud Source Repository. + ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed. * `repo_name` - @@ -1034,7 +1034,7 @@ The following arguments are supported: * `dir` - (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 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. * `invert_regex` - @@ -1048,13 +1048,13 @@ The following arguments are supported: * `branch_name` - (Optional) Regex matching branches to build. Exactly one a of branch name, tag, or commit SHA must be provided. - The syntax of the regular expressions accepted is the syntax accepted by RE2 and + The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax * `tag_name` - (Optional) Regex matching tags to build. Exactly one a of branch name, tag, or commit SHA must be provided. - The syntax of the regular expressions accepted is the syntax accepted by RE2 and + The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax * `commit_sha` - @@ -1070,8 +1070,8 @@ The following arguments are supported: * `secret_env` - (Optional) Map of environment variable name to its encrypted value. - Secret environment variables must be unique across all of a build's secrets, - and must be used by at least one build step. Values can be at most 64 KB in size. + Secret environment variables must be unique across all of a build's secrets, + and must be used by at least one build step. Values can be at most 64 KB in size. There can be at most 100 secret values across all of a build's secrets. The `available_secrets` block supports: @@ -1103,7 +1103,7 @@ The following arguments are supported: run directly. If not, the host will attempt to pull the image first, using the builder service account's credentials if necessary. The Docker daemon's cache will already have the latest versions of all of - the officially supported build steps (see https://github.com/GoogleCloudPlatform/cloud-builders + the officially supported build steps (see https://github.com/GoogleCloudPlatform/cloud-builders for images and examples). The Docker daemon will also have cached many of the layers for some popular images, like "ubuntu", "debian", but they will be refreshed at the time @@ -1189,7 +1189,7 @@ The following arguments are supported: * `script` - (Optional) - A shell script to be executed in the step. + A shell script to be executed in the step. When script is provided, the user cannot specify the entrypoint or args. diff --git a/website/docs/r/cloudfunctions2_function.html.markdown b/website/docs/r/cloudfunctions2_function.html.markdown index edb69bc84a..30c31e1acf 100644 --- a/website/docs/r/cloudfunctions2_function.html.markdown +++ b/website/docs/r/cloudfunctions2_function.html.markdown @@ -678,14 +678,14 @@ The following arguments are supported: * `generation` - (Optional) - Google Cloud Storage generation for the object. If the generation + Google Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used. The `repo_source` block supports: * `project_id` - (Optional) - ID of the project that owns the Cloud Source Repository. If omitted, the + ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed. * `repo_name` - @@ -710,7 +710,7 @@ The following arguments are supported: * `invert_regex` - (Optional) - Only trigger a build if the revision regex does + Only trigger a build if the revision regex does NOT match the revision regex. The `service_config` block supports: diff --git a/website/docs/r/compute_disk.html.markdown b/website/docs/r/compute_disk.html.markdown index cdad2b11cf..ab2001bb1d 100644 --- a/website/docs/r/compute_disk.html.markdown +++ b/website/docs/r/compute_disk.html.markdown @@ -291,8 +291,8 @@ The following arguments are supported: * `rsa_encrypted_key` - (Optional) - Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit - customer-supplied encryption key to either encrypt or decrypt + Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit + customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. **Note**: This property is sensitive and will not be displayed in the plan. diff --git a/website/docs/r/compute_network.html.markdown b/website/docs/r/compute_network.html.markdown index 64c7d45f4a..ccbfdf70e2 100644 --- a/website/docs/r/compute_network.html.markdown +++ b/website/docs/r/compute_network.html.markdown @@ -107,23 +107,23 @@ The following arguments are supported: * `mtu` - (Optional) - Maximum Transmission Unit in bytes. The default value is 1460 bytes. + Maximum Transmission Unit in bytes. The default value is 1460 bytes. The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames). Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped - with an ICMP `Fragmentation-Needed` message if the packets are routed to the Internet or other VPCs + with an ICMP `Fragmentation-Needed` message if the packets are routed to the Internet or other VPCs with varying MTUs. * `enable_ula_internal_ipv6` - (Optional) - Enable ULA internal ipv6 on this network. Enabling this feature will assign + Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20. * `internal_ipv6_range` - (Optional) - When enabling ula internal ipv6, caller optionally can specify the /48 range - they want from the google defined ULA prefix fd20::/20. The input must be a - valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will - fail if the speficied /48 is already in used by another resource. + When enabling ula internal ipv6, caller optionally can specify the /48 range + they want from the google defined ULA prefix fd20::/20. The input must be a + valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will + fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field. * `network_firewall_policy_enforcement_order` - diff --git a/website/docs/r/compute_region_commitment.html.markdown b/website/docs/r/compute_region_commitment.html.markdown index 78a1891a7d..9f33396cab 100644 --- a/website/docs/r/compute_region_commitment.html.markdown +++ b/website/docs/r/compute_region_commitment.html.markdown @@ -100,13 +100,13 @@ The following arguments are supported: * `resources` - (Optional) - A list of commitment amounts for particular resources. + A list of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together. Structure is [documented below](#nested_resources). * `type` - (Optional) - The type of commitment, which affects the discount rate and the eligible resources. + The type of commitment, which affects the discount rate and the eligible resources. Type MEMORY_OPTIMIZED specifies a commitment that will only apply to memory optimized machines. Type ACCELERATOR_OPTIMIZED specifies a commitment that will only apply to accelerator optimized machines. @@ -127,9 +127,9 @@ The following arguments are supported: * `auto_renew` - (Optional) - Specifies whether to enable automatic renewal for the commitment. - The default value is false if not specified. - If the field is set to true, the commitment will be automatically renewed for either + Specifies whether to enable automatic renewal for the commitment. + The default value is false if not specified. + If the field is set to true, the commitment will be automatically renewed for either one or three years according to the terms of the existing commitment. * `region` - diff --git a/website/docs/r/compute_resource_policy.html.markdown b/website/docs/r/compute_resource_policy.html.markdown index b6b9b1cef7..e489bd05e1 100644 --- a/website/docs/r/compute_resource_policy.html.markdown +++ b/website/docs/r/compute_resource_policy.html.markdown @@ -357,8 +357,8 @@ The following arguments are supported: * `chain_name` - (Optional) - Creates the new snapshot in the snapshot chain labeled with the - specified name. The chain name must be 1-63 characters long and comply + Creates the new snapshot in the snapshot chain labeled with the + specified name. The chain name must be 1-63 characters long and comply with RFC1035. The `group_placement_policy` block supports: diff --git a/website/docs/r/compute_snapshot.html.markdown b/website/docs/r/compute_snapshot.html.markdown index 7505bb7a75..4c9ac8c2a0 100644 --- a/website/docs/r/compute_snapshot.html.markdown +++ b/website/docs/r/compute_snapshot.html.markdown @@ -134,11 +134,11 @@ The following arguments are supported: * `chain_name` - (Optional) - Creates the new snapshot in the snapshot chain labeled with the - specified name. The chain name must be 1-63 characters long and - comply with RFC1035. This is an uncommon option only for advanced - service owners who needs to create separate snapshot chains, for - example, for chargeback tracking. When you describe your snapshot + Creates the new snapshot in the snapshot chain labeled with the + specified name. The chain name must be 1-63 characters long and + comply with RFC1035. This is an uncommon option only for advanced + service owners who needs to create separate snapshot chains, for + example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value. * `description` - diff --git a/website/docs/r/compute_target_https_proxy.html.markdown b/website/docs/r/compute_target_https_proxy.html.markdown index b8ff9cb3fb..603ff24aa1 100644 --- a/website/docs/r/compute_target_https_proxy.html.markdown +++ b/website/docs/r/compute_target_https_proxy.html.markdown @@ -135,7 +135,7 @@ The following arguments are supported: * `certificate_map` - (Optional) - A reference to the CertificateMap resource uri that identifies a certificate map + A reference to the CertificateMap resource uri that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. Accepted format is `//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}`. diff --git a/website/docs/r/data_fusion_instance.html.markdown b/website/docs/r/data_fusion_instance.html.markdown index ca885dd92d..fcf428eeed 100644 --- a/website/docs/r/data_fusion_instance.html.markdown +++ b/website/docs/r/data_fusion_instance.html.markdown @@ -214,7 +214,7 @@ The following arguments are supported: - ENTERPRISE: Enterprise Data Fusion instance. In Enterprise type, the user will have more features available, such as support for streaming pipelines, higher number of concurrent pipelines, etc. - DEVELOPER: Developer Data Fusion instance. In Developer type, the user will have all features available but - with restrictive capabilities. This is to help enterprises design and develop their data ingestion and integration + with restrictive capabilities. This is to help enterprises design and develop their data ingestion and integration pipelines at low cost. Possible values are: `BASIC`, `ENTERPRISE`, `DEVELOPER`. @@ -287,7 +287,7 @@ The following arguments are supported: * `accelerators` - (Optional) List of accelerators enabled for this CDF instance. - If accelerators are enabled it is possible a permadiff will be created with the Options field. + If accelerators are enabled it is possible a permadiff will be created with the Options field. Users will need to either manually update their state file to include these diffed options, or include the field in a [lifecycle ignore changes block](https://developer.hashicorp.com/terraform/language/meta-arguments/lifecycle#ignore_changes). Structure is [documented below](#nested_accelerators). diff --git a/website/docs/r/data_loss_prevention_job_trigger.html.markdown b/website/docs/r/data_loss_prevention_job_trigger.html.markdown index e1ef5f24bf..b93d0e4da6 100644 --- a/website/docs/r/data_loss_prevention_job_trigger.html.markdown +++ b/website/docs/r/data_loss_prevention_job_trigger.html.markdown @@ -1069,19 +1069,19 @@ The following arguments are supported: * `rows_limit` - (Optional) - Max number of rows to scan. If the table has more rows than this value, the rest of the rows are omitted. - If not set, or if set to 0, all rows will be scanned. Only one of rowsLimit and rowsLimitPercent can be + Max number of rows to scan. If the table has more rows than this value, the rest of the rows are omitted. + If not set, or if set to 0, all rows will be scanned. Only one of rowsLimit and rowsLimitPercent can be specified. Cannot be used in conjunction with TimespanConfig. * `rows_limit_percent` - (Optional) - Max percentage of rows to scan. The rest are omitted. The number of rows scanned is rounded down. - Must be between 0 and 100, inclusively. Both 0 and 100 means no limit. Defaults to 0. Only one of + Max percentage of rows to scan. The rest are omitted. The number of rows scanned is rounded down. + Must be between 0 and 100, inclusively. Both 0 and 100 means no limit. Defaults to 0. Only one of rowsLimit and rowsLimitPercent can be specified. Cannot be used in conjunction with TimespanConfig. * `sample_method` - (Optional) - How to sample rows if not all rows are scanned. Meaningful only when used in conjunction with either + How to sample rows if not all rows are scanned. Meaningful only when used in conjunction with either rowsLimit or rowsLimitPercent. If not specified, rows are scanned in the order BigQuery reads them. Default value is `TOP`. Possible values are: `TOP`, `RANDOM_START`. @@ -1249,7 +1249,7 @@ The following arguments are supported: * `file_types_to_transform` - (Optional) List of user-specified file type groups to transform. If specified, only the files with these filetypes will be transformed. - If empty, all supported files will be transformed. Supported types may be automatically added over time. + If empty, all supported files will be transformed. Supported types may be automatically added over time. If a file type is set in this field that isn't supported by the Deidentify action then the job will fail and will not be successfully created/started. Each value may be one of: `IMAGE`, `TEXT_FILE`, `CSV`, `TSV`. diff --git a/website/docs/r/dialogflow_agent.html.markdown b/website/docs/r/dialogflow_agent.html.markdown index 83db906b1b..777daec363 100644 --- a/website/docs/r/dialogflow_agent.html.markdown +++ b/website/docs/r/dialogflow_agent.html.markdown @@ -66,7 +66,7 @@ The following arguments are supported: * `default_language_code` - (Required) - The default language of the agent as a language tag. [See Language Support](https://cloud.google.com/dialogflow/docs/reference/language) + The default language of the agent as a language tag. [See Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. This field cannot be updated after creation. * `time_zone` - @@ -109,14 +109,14 @@ The following arguments are supported: (Optional) To filter out false positive results and still get variety in matched natural language inputs for your agent, you can tune the machine learning classification threshold. If the returned score value is less than the threshold - value, then a fallback intent will be triggered or, if there are no fallback intents defined, no intent will be - triggered. The score values range from 0.0 (completely uncertain) to 1.0 (completely certain). If set to 0.0, the + value, then a fallback intent will be triggered or, if there are no fallback intents defined, no intent will be + triggered. The score values range from 0.0 (completely uncertain) to 1.0 (completely certain). If set to 0.0, the default of 0.3 is used. * `api_version` - (Optional) API version displayed in Dialogflow console. If not specified, V2 API is assumed. Clients are free to query - different service endpoints for different API versions. However, bots connectors and webhook calls will follow + different service endpoints for different API versions. However, bots connectors and webhook calls will follow the specified API version. * API_VERSION_V1: Legacy V1 API. * API_VERSION_V2: V2 API. @@ -129,7 +129,7 @@ The following arguments are supported: * TIER_STANDARD: Standard tier. * TIER_ENTERPRISE: Enterprise tier (Essentials). * TIER_ENTERPRISE_PLUS: Enterprise tier (Plus). - NOTE: Due to consistency issues, the provider will not read this field from the API. Drift is possible between + NOTE: Due to consistency issues, the provider will not read this field from the API. Drift is possible between the Terraform state and Dialogflow if the agent tier is changed outside of Terraform. Possible values are: `TIER_STANDARD`, `TIER_ENTERPRISE`, `TIER_ENTERPRISE_PLUS`. diff --git a/website/docs/r/dialogflow_entity_type.html.markdown b/website/docs/r/dialogflow_entity_type.html.markdown index bdf25c7cf6..5df72e71ac 100644 --- a/website/docs/r/dialogflow_entity_type.html.markdown +++ b/website/docs/r/dialogflow_entity_type.html.markdown @@ -113,7 +113,7 @@ In addition to the arguments listed above, the following computed attributes are * `id` - an identifier for the resource with format `{{name}}` * `name` - - The unique identifier of the entity type. + The unique identifier of the entity type. Format: projects//agent/entityTypes/. diff --git a/website/docs/r/dialogflow_fulfillment.html.markdown b/website/docs/r/dialogflow_fulfillment.html.markdown index b26643de75..0af12274ed 100644 --- a/website/docs/r/dialogflow_fulfillment.html.markdown +++ b/website/docs/r/dialogflow_fulfillment.html.markdown @@ -117,7 +117,7 @@ In addition to the arguments listed above, the following computed attributes are * `id` - an identifier for the resource with format `{{name}}` * `name` - - The unique identifier of the fulfillment. + The unique identifier of the fulfillment. Format: projects//agent/fulfillment - projects//locations//agent/fulfillment diff --git a/website/docs/r/dialogflow_intent.html.markdown b/website/docs/r/dialogflow_intent.html.markdown index 3b607ffbe1..05a2a8a721 100644 --- a/website/docs/r/dialogflow_intent.html.markdown +++ b/website/docs/r/dialogflow_intent.html.markdown @@ -139,7 +139,7 @@ The following arguments are supported: * `events` - (Optional) The collection of event names that trigger the intent. If the collection of input contexts is not empty, all of - the contexts must be present in the active user session for an event to trigger this intent. See the + the contexts must be present in the active user session for an event to trigger this intent. See the [events reference](https://cloud.google.com/dialogflow/docs/events-overview) for more details. * `action` - @@ -173,7 +173,7 @@ In addition to the arguments listed above, the following computed attributes are * `id` - an identifier for the resource with format `{{name}}` * `name` - - The unique identifier of this intent. + The unique identifier of this intent. Format: projects//agent/intents/. * `root_followup_intent_name` - diff --git a/website/docs/r/dns_managed_zone.html.markdown b/website/docs/r/dns_managed_zone.html.markdown index a5bf28324c..33ad1abf3d 100644 --- a/website/docs/r/dns_managed_zone.html.markdown +++ b/website/docs/r/dns_managed_zone.html.markdown @@ -466,8 +466,8 @@ The following arguments are supported: * `gke_cluster_name` - (Required) - The resource name of the cluster to bind this ManagedZone to. - This should be specified in the format like + The resource name of the cluster to bind this ManagedZone to. + This should be specified in the format like `projects/*/locations/*/clusters/*` The `networks` block supports: diff --git a/website/docs/r/dns_response_policy.html.markdown b/website/docs/r/dns_response_policy.html.markdown index dc3392ed9c..562b5c306d 100644 --- a/website/docs/r/dns_response_policy.html.markdown +++ b/website/docs/r/dns_response_policy.html.markdown @@ -160,8 +160,8 @@ The following arguments are supported: * `gke_cluster_name` - (Required) - The resource name of the cluster to bind this ManagedZone to. - This should be specified in the format like + The resource name of the cluster to bind this ManagedZone to. + This should be specified in the format like `projects/*/locations/*/clusters/*` ## Attributes Reference