gcloud beyondcorp security-gateways update - update securityGateways

gcloud beyondcorp security-gateways update(SECURITY_GATEWAY :--location=LOCATION)[--async][--display-name=DISPLAY_NAME][--request-id=REQUEST_ID][--clear-proxy-protocol-config--[no-]proxy-protocol-config-client-ip--proxy-protocol-config-gateway-identity=PROXY_PROTOCOL_CONFIG_GATEWAY_IDENTITY--contextual-headers-output-type=CONTEXTUAL_HEADERS_OUTPUT_TYPE--device-info-output-type=DEVICE_INFO_OUTPUT_TYPE--group-info-output-type=GROUP_INFO_OUTPUT_TYPE--user-info-output-type=USER_INFO_OUTPUT_TYPE--proxy-protocol-config-allowed-client-headers=[PROXY_PROTOCOL_CONFIG_ALLOWED_CLIENT_HEADERS,…]    |--add-proxy-protocol-config-allowed-client-headers=[ADD_PROXY_PROTOCOL_CONFIG_ALLOWED_CLIENT_HEADERS,…]--clear-proxy-protocol-config-allowed-client-headers    |--remove-proxy-protocol-config-allowed-client-headers=[REMOVE_PROXY_PROTOCOL_CONFIG_ALLOWED_CLIENT_HEADERS,…]--proxy-protocol-config-metadata-headers=[PROXY_PROTOCOL_CONFIG_METADATA_HEADERS,…]    |--update-proxy-protocol-config-metadata-headers=[UPDATE_PROXY_PROTOCOL_CONFIG_METADATA_HEADERS,…]--clear-proxy-protocol-config-metadata-headers    |--remove-proxy-protocol-config-metadata-headers=REMOVE_PROXY_PROTOCOL_CONFIG_METADATA_HEADERS][--clear-service-discovery--resource-override-path=RESOURCE_OVERRIDE_PATH][--hubs=[HUBS,…]    |--update-hubs=[UPDATE_HUBS,…]--clear-hubs    |--remove-hubs=REMOVE_HUBS][GCLOUD_WIDE_FLAG …]

SecurityGateway resource - Identifier. Name of the resource. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

• provide the argumentsecurity_gateway on the command line with afully specified name;
• provide the argument--project on the command line;
• set the propertycore/project.

This must be specified.

SECURITY_GATEWAY

ID of the securityGateway or fully qualified identifier for the securityGateway.

To set thesecurity_gateway attribute:

• provide the argumentsecurity_gateway on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--location=LOCATION

The location id of the securityGateway resource. We support only globallocation.

To set thelocation attribute:

• provide the argumentsecurity_gateway on the command line with afully specified name;
• provide the argument--location on the command line.

--async

Return immediately, without waiting for the operation in progress to complete.

--display-name=DISPLAY_NAME

An arbitrary user-provided name for the SecurityGateway. Cannot exceed 64characters.

--request-id=REQUEST_ID

An optional request ID to identify requests. Specify a unique request ID so thatif you must retry your request, the server will know to ignore the request if ithas already been completed. The server will guarantee that for at least 60minutes after the first request.

For example, consider a situation where you make an initial request and therequest timed out. If you make the request again with the same request ID, theserver can check if original operation with the same request ID was received,and if so, will ignore the second request. This prevents clients fromaccidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is notsupported (00000000-0000-0000-0000-000000000000).

The configuration for the proxy.

--clear-proxy-protocol-config

Set googleCloudBeyondcorpSecuritygatewaysV1SecurityGateway.proxyProtocolConfigback to default value.

--[no-]proxy-protocol-config-client-ip

Client IP configuration. The client IP address is included if true. Use--proxy-protocol-config-client-ip to enable and--no-proxy-protocol-config-client-ip to disable.

--proxy-protocol-config-gateway-identity=PROXY_PROTOCOL_CONFIG_GATEWAY_IDENTITY

The security gateway identity configuration.PROXY_PROTOCOL_CONFIG_GATEWAY_IDENTITY must be (only onevalue is supported):

resource-name

Resource name for gateway identity, in the format:projects/{project_id}/locations/{location_id}/securityGateways/{security_gateway_id}

Contextual headers configuration.

--contextual-headers-output-type=CONTEXTUAL_HEADERS_OUTPUT_TYPE

Default output type for all enabled headers.CONTEXTUAL_HEADERS_OUTPUT_TYPE must be one of:

json

JSON output type.

none

Explicitly disable header output.

protobuf

Protobuf output type.

The delegated device information configuration.

--device-info-output-type=DEVICE_INFO_OUTPUT_TYPE

The output type details for the delegated device.DEVICE_INFO_OUTPUT_TYPE must be one of:

json

JSON output type.

none

Explicitly disable header output.

protobuf

Protobuf output type.

The delegated group configuration details.

--group-info-output-type=GROUP_INFO_OUTPUT_TYPE

The output type of the delegated group information.GROUP_INFO_OUTPUT_TYPE must be one of:

json

JSON output type.

none

Explicitly disable header output.

protobuf

Protobuf output type.

The configuration information for the delegated user.

--user-info-output-type=USER_INFO_OUTPUT_TYPE

The delegated user's information.USER_INFO_OUTPUT_TYPEmust be one of:

json

JSON output type.

none

Explicitly disable header output.

protobuf

Protobuf output type.

Update proxy_protocol_config_allowed_client_headers.

At most one of these can be specified:

--proxy-protocol-config-allowed-client-headers=[PROXY_PROTOCOL_CONFIG_ALLOWED_CLIENT_HEADERS,…]

Set proxy_protocol_config_allowed_client_headers to new value.

--add-proxy-protocol-config-allowed-client-headers=[ADD_PROXY_PROTOCOL_CONFIG_ALLOWED_CLIENT_HEADERS,…]

Add new value to proxy_protocol_config_allowed_client_headers list.

At most one of these can be specified:

--clear-proxy-protocol-config-allowed-client-headers

Clear proxy_protocol_config_allowed_client_headers value and set to empty list.

--remove-proxy-protocol-config-allowed-client-headers=[REMOVE_PROXY_PROTOCOL_CONFIG_ALLOWED_CLIENT_HEADERS,…]

Remove existing value from proxy_protocol_config_allowed_client_headers list.

Update proxy_protocol_config_metadata_headers.

At most one of these can be specified:

--proxy-protocol-config-metadata-headers=[PROXY_PROTOCOL_CONFIG_METADATA_HEADERS,…]

Set proxy_protocol_config_metadata_headers to new value. Custom resourcespecific headers along with the values. The names should conform to RFC 9110:>Field names can contain alphanumeric characters, hyphens, and periods, cancontain only ASCII-printable characters and tabs, and must start with a letter.

KEY

SetsKEY value.

VALUE

SetsVALUE value.

Shorthand Example:

--proxy-protocol-config-metadata-headers=string=string

JSON Example:

--proxy-protocol-config-metadata-headers='{"string": "string"}'

File Example:

--proxy-protocol-config-metadata-headers=path_to_file.(yaml|json)

--update-proxy-protocol-config-metadata-headers=[UPDATE_PROXY_PROTOCOL_CONFIG_METADATA_HEADERS,…]

Update proxy_protocol_config_metadata_headers value or add key value pair.Custom resource specific headers along with the values. The names should conformto RFC 9110: >Field names can contain alphanumeric characters, hyphens, andperiods, can contain only ASCII-printable characters and tabs, and must startwith a letter.

KEY

SetsKEY value.

VALUE

SetsVALUE value.

Shorthand Example:

--update-proxy-protocol-config-metadata-headers=string=string

JSON Example:

--update-proxy-protocol-config-metadata-headers='{"string": "string"}'

File Example:

--update-proxy-protocol-config-metadata-headers=path_to_file.(yaml|json)

At most one of these can be specified:

--clear-proxy-protocol-config-metadata-headers

Clear proxy_protocol_config_metadata_headers value and set to empty map.

--remove-proxy-protocol-config-metadata-headers=REMOVE_PROXY_PROTOCOL_CONFIG_METADATA_HEADERS

Remove existing value from map proxy_protocol_config_metadata_headers. Setsremove_proxy_protocol_config_metadata_headers value.Shorthand Example:

--remove-proxy-protocol-config-metadata-headers=string,string

JSON Example:

--remove-proxy-protocol-config-metadata-headers=["string"]

File Example:

--remove-proxy-protocol-config-metadata-headers=path_to_file.(yaml|json)

Settings related to the Service Discovery.

--clear-service-discovery

Set googleCloudBeyondcorpSecuritygatewaysV1SecurityGateway.serviceDiscovery backto default value.

If Service Discovery is done through API, defines its settings.

API operation descriptor.

--resource-override-path=RESOURCE_OVERRIDE_PATH

Contains the URI path fragment where HTTP request is sent.

Update hubs.

At most one of these can be specified:

--hubs=[HUBS,…]

Set hubs to new value. Map of Hubs that represents regional data path deploymentwith Google Cloud Platform region as a key.

KEY

SetsKEY value.

VALUE

SetsVALUE value.

Shorthand Example:

--hubs=string

JSON Example:

--hubs='{"string": {}}'

File Example:

--hubs=path_to_file.(yaml|json)

--update-hubs=[UPDATE_HUBS,…]

Update hubs value or add key value pair. Map of Hubs that represents regionaldata path deployment with Google Cloud Platform region as a key.

KEY

SetsKEY value.

VALUE

SetsVALUE value.

Shorthand Example:

--update-hubs=string

JSON Example:

--update-hubs='{"string": {}}'

File Example:

--update-hubs=path_to_file.(yaml|json)

At most one of these can be specified:

--clear-hubs

Clear hubs value and set to empty map.

--remove-hubs=REMOVE_HUBS

Remove existing value from map hubs. Setsremove_hubs value.Shorthand Example:

--remove-hubs=string,string

JSON Example:

--remove-hubs=["string"]

File Example:

--remove-hubs=path_to_file.(yaml|json)

Run$gcloud help for details.