Network Security API

Service: networksecurity.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://networksecurity.googleapis.com

REST Resource: v1beta1.organizations.locations

Methods
get GET /v1beta1/{name=organizations/*/locations/*}
Gets information about a location.
list GET /v1beta1/{name=organizations/*}/locations
Lists information about the supported locations for this service.

REST Resource: v1beta1.organizations.locations.addressGroups

Methods
addItems POST /v1beta1/{addressGroup=organizations/*/locations/*/addressGroups/*}:addItems
Adds items to an address group.
cloneItems POST /v1beta1/{addressGroup=organizations/*/locations/*/addressGroups/*}:cloneItems
Clones items from one address group to another.
create POST /v1beta1/{parent=organizations/*/locations/*}/addressGroups
Creates a new address group in a given project and location.
delete DELETE /v1beta1/{name=organizations/*/locations/*/addressGroups/*}
Deletes an address group.
get GET /v1beta1/{name=organizations/*/locations/*/addressGroups/*}
Gets details of a single address group.
list GET /v1beta1/{parent=organizations/*/locations/*}/addressGroups
Lists address groups in a given project and location.
listReferences GET /v1beta1/{addressGroup=organizations/*/locations/*/addressGroups/*}:listReferences
Lists references of an address group.
patch PATCH /v1beta1/{addressGroup.name=organizations/*/locations/*/addressGroups/*}
Updates parameters of an address group.
removeItems POST /v1beta1/{addressGroup=organizations/*/locations/*/addressGroups/*}:removeItems
Removes items from an address group.
testIamPermissions POST /v1beta1/{resource=organizations/*/locations/*/addressGroups/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1beta1.organizations.locations.firewallEndpoints

Methods
create POST /v1beta1/{parent=organizations/*/locations/*}/firewallEndpoints
Creates a new firewall endpoint in a given organization and location.
delete DELETE /v1beta1/{name=organizations/*/locations/*/firewallEndpoints/*}
Deletes a single organization endpoint.
get GET /v1beta1/{name=organizations/*/locations/*/firewallEndpoints/*}
Gets details of a single organization endpoint.
list GET /v1beta1/{parent=organizations/*/locations/*}/firewallEndpoints
Lists firewall endpoints in a given organization and location.
patch PATCH /v1beta1/{firewallEndpoint.name=organizations/*/locations/*/firewallEndpoints/*}
Updates a single organization endpoint.

REST Resource: v1beta1.organizations.locations.firewallEndpoints.wildfireVerdictChangeRequests

Methods
create POST /v1beta1/{parent=organizations/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Creates an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.
get GET /v1beta1/{name=organizations/*/locations/*/firewallEndpoints/*/wildfireVerdictChangeRequests/*}
Gets an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.
list GET /v1beta1/{parent=organizations/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Lists the Advanced malware sandbox (WildFire) verdict change requests in a given firewall endpoint in an organization and location.

REST Resource: v1beta1.organizations.locations.operations

Methods
cancel POST /v1beta1/{name=organizations/*/locations/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1beta1/{name=organizations/*/locations/*/operations/*}
Deletes a long-running operation.
get GET /v1beta1/{name=organizations/*/locations/*/operations/*}
Gets the latest state of a long-running operation.
list GET /v1beta1/{name=organizations/*/locations/*}/operations
Lists operations that match the specified filter in the request.

REST Resource: v1beta1.organizations.locations.securityProfileGroups

Methods
create POST /v1beta1/{parent=organizations/*/locations/*}/securityProfileGroups
Creates a new security profile group in a given organization and location.
delete DELETE /v1beta1/{name=organizations/*/locations/*/securityProfileGroups/*}
Deletes a single security profile group.
get GET /v1beta1/{name=organizations/*/locations/*/securityProfileGroups/*}
Gets details of a single security profile group.
list GET /v1beta1/{parent=organizations/*/locations/*}/securityProfileGroups
Lists security profile group resources in a given organization and location.
patch PATCH /v1beta1/{securityProfileGroup.name=organizations/*/locations/*/securityProfileGroups/*}
Updates the parameters of a single security profile group.

REST Resource: v1beta1.organizations.locations.securityProfiles

Methods
create POST /v1beta1/{parent=organizations/*/locations/*}/securityProfiles
Creates a new security profile in a given organization and location.
delete DELETE /v1beta1/{name=organizations/*/locations/*/securityProfiles/*}
Deletes a single security profile.
get GET /v1beta1/{name=organizations/*/locations/*/securityProfiles/*}
Gets details of a single security profile.
list GET /v1beta1/{parent=organizations/*/locations/*}/securityProfiles
Lists security profile resources in a given organization and location.
patch PATCH /v1beta1/{securityProfile.name=organizations/*/locations/*/securityProfiles/*}
Updates the parameters of a single security profile.

REST Resource: v1beta1.projects.locations

Methods
get GET /v1beta1/{name=projects/*/locations/*}
Gets information about a location.
list GET /v1beta1/{name=projects/*}/locations
Lists information about the supported locations for this service.

REST Resource: v1beta1.projects.locations.addressGroups

Methods
addItems POST /v1beta1/{addressGroup=projects/*/locations/*/addressGroups/*}:addItems
Adds items to an address group.
cloneItems POST /v1beta1/{addressGroup=projects/*/locations/*/addressGroups/*}:cloneItems
Clones items from one address group to another.
create POST /v1beta1/{parent=projects/*/locations/*}/addressGroups
Creates a new address group in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/addressGroups/*}
Deletes a single address group.
get GET /v1beta1/{name=projects/*/locations/*/addressGroups/*}
Gets details of a single address group.
getIamPolicy GET /v1beta1/{resource=projects/*/locations/*/addressGroups/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1beta1/{parent=projects/*/locations/*}/addressGroups
Lists address groups in a given project and location.
listReferences GET /v1beta1/{addressGroup=projects/*/locations/*/addressGroups/*}:listReferences
Lists references of an address group.
patch PATCH /v1beta1/{addressGroup.name=projects/*/locations/*/addressGroups/*}
Updates the parameters of a single address group.
removeItems POST /v1beta1/{addressGroup=projects/*/locations/*/addressGroups/*}:removeItems
Removes items from an address group.
setIamPolicy POST /v1beta1/{resource=projects/*/locations/*/addressGroups/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1beta1/{resource=projects/*/locations/*/addressGroups/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1beta1.projects.locations.firewallEndpointAssociations

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/firewallEndpointAssociations
Creates a new firewall endpoint association in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/firewallEndpointAssociations/*}
Deletes a single firewall endpoint association.
get GET /v1beta1/{name=projects/*/locations/*/firewallEndpointAssociations/*}
Gets details of a single firewall endpoint association.
list GET /v1beta1/{parent=projects/*/locations/*}/firewallEndpointAssociations
Lists associations in a given project and location.
patch PATCH /v1beta1/{firewallEndpointAssociation.name=projects/*/locations/*/firewallEndpointAssociations/*}
Updates a single firewall endpoint association.

REST Resource: v1beta1.projects.locations.firewallEndpoints

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/firewallEndpoints
Creates a new firewall endpoint in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/firewallEndpoints/*}
Deletes a single project endpoint.
get GET /v1beta1/{name=projects/*/locations/*/firewallEndpoints/*}
Gets details of a single project endpoint.
list GET /v1beta1/{parent=projects/*/locations/*}/firewallEndpoints
Lists firewall endpoints in a given project and location.
patch PATCH /v1beta1/{firewallEndpoint.name=projects/*/locations/*/firewallEndpoints/*}
Updates a single project endpoint.

REST Resource: v1beta1.projects.locations.firewallEndpoints.wildfireVerdictChangeRequests

Methods
create POST /v1beta1/{parent=projects/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Creates an Advanced malware sandbox verdict change request in a given firewall endpoint in a project and location.
get GET /v1beta1/{name=projects/*/locations/*/firewallEndpoints/*/wildfireVerdictChangeRequests/*}
Gets an Advanced malware sandbox verdict change request in a given firewall endpoint in a project and location.
list GET /v1beta1/{parent=projects/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Lists the Advanced malware sandbox verdict change requests in a given firewall endpoint in a project and location.

REST Resource: v1beta1.projects.locations.operations

Methods
cancel POST /v1beta1/{name=projects/*/locations/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1beta1/{name=projects/*/locations/*/operations/*}
Deletes a long-running operation.
get GET /v1beta1/{name=projects/*/locations/*/operations/*}
Gets the latest state of a long-running operation.
list GET /v1beta1/{name=projects/*/locations/*}/operations
Lists operations that match the specified filter in the request.

REST Resource: v1beta1.projects.locations.securityProfileGroups

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/securityProfileGroups
Creates a new security profile group in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/securityProfileGroups/*}
Deletes a single security profile group.
get GET /v1beta1/{name=projects/*/locations/*/securityProfileGroups/*}
Gets details of a single security profile group.
list GET /v1beta1/{parent=projects/*/locations/*}/securityProfileGroups
Lists security profile group resources in a given project and location.
patch PATCH /v1beta1/{securityProfileGroup.name=projects/*/locations/*/securityProfileGroups/*}
Updates the parameters of a single security profile group.

REST Resource: v1beta1.projects.locations.securityProfiles

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/securityProfiles
Creates a new security profile in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/securityProfiles/*}
Deletes a single security profile.
get GET /v1beta1/{name=projects/*/locations/*/securityProfiles/*}
Gets details of a single security profile.
list GET /v1beta1/{parent=projects/*/locations/*}/securityProfiles
Lists security profiles in a given project and location.
patch PATCH /v1beta1/{securityProfile.name=projects/*/locations/*/securityProfiles/*}
Updates the parameters of a single security profile.

REST Resource: v1beta1.projects.locations.tlsInspectionPolicies

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/tlsInspectionPolicies
Creates a new TlsInspectionPolicy in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/tlsInspectionPolicies/*}
Deletes a single TlsInspectionPolicy.
get GET /v1beta1/{name=projects/*/locations/*/tlsInspectionPolicies/*}
Gets details of a single TlsInspectionPolicy.
list GET /v1beta1/{parent=projects/*/locations/*}/tlsInspectionPolicies
Lists TlsInspectionPolicies in a given project and location.
patch PATCH /v1beta1/{tlsInspectionPolicy.name=projects/*/locations/*/tlsInspectionPolicies/*}
Updates the parameters of a single TlsInspectionPolicy.

REST Resource: v1.organizations.locations

Methods
get GET /v1/{name=organizations/*/locations/*}
Gets information about a location.
list GET /v1/{name=organizations/*}/locations
Lists information about the supported locations for this service.

REST Resource: v1.organizations.locations.addressGroups

Methods
addItems POST /v1/{addressGroup=organizations/*/locations/*/addressGroups/*}:addItems
Adds items to an address group.
cloneItems POST /v1/{addressGroup=organizations/*/locations/*/addressGroups/*}:cloneItems
Clones items from one address group to another.
create POST /v1/{parent=organizations/*/locations/*}/addressGroups
Creates a new address group in a given project and location.
delete DELETE /v1/{name=organizations/*/locations/*/addressGroups/*}
Deletes an address group.
get GET /v1/{name=organizations/*/locations/*/addressGroups/*}
Gets details of a single address group.
list GET /v1/{parent=organizations/*/locations/*}/addressGroups
Lists address groups in a given project and location.
listReferences GET /v1/{addressGroup=organizations/*/locations/*/addressGroups/*}:listReferences
Lists references of an address group.
patch PATCH /v1/{addressGroup.name=organizations/*/locations/*/addressGroups/*}
Updates parameters of an address group.
removeItems POST /v1/{addressGroup=organizations/*/locations/*/addressGroups/*}:removeItems
Removes items from an address group.
testIamPermissions POST /v1/{resource=organizations/*/locations/*/addressGroups/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.organizations.locations.firewallEndpoints

Methods
create POST /v1/{parent=organizations/*/locations/*}/firewallEndpoints
Creates a new firewall endpoint in a given organization and location.
delete DELETE /v1/{name=organizations/*/locations/*/firewallEndpoints/*}
Deletes a single organization endpoint.
get GET /v1/{name=organizations/*/locations/*/firewallEndpoints/*}
Gets details of a single organization endpoint.
list GET /v1/{parent=organizations/*/locations/*}/firewallEndpoints
Lists firewall endpoints in a given organization and location.
patch PATCH /v1/{firewallEndpoint.name=organizations/*/locations/*/firewallEndpoints/*}
Updates a single organization endpoint.

REST Resource: v1.organizations.locations.firewallEndpoints.wildfireVerdictChangeRequests

Methods
create POST /v1/{parent=organizations/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Creates an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.
get GET /v1/{name=organizations/*/locations/*/firewallEndpoints/*/wildfireVerdictChangeRequests/*}
Gets an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.
list GET /v1/{parent=organizations/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Lists the Advanced malware sandbox (WildFire) verdict change requests in a given firewall endpoint in an organization and location.

REST Resource: v1.organizations.locations.operations

Methods
cancel POST /v1/{name=organizations/*/locations/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=organizations/*/locations/*/operations/*}
Deletes a long-running operation.
get GET /v1/{name=organizations/*/locations/*/operations/*}
Gets the latest state of a long-running operation.
list GET /v1/{name=organizations/*/locations/*}/operations
Lists operations that match the specified filter in the request.

REST Resource: v1.organizations.locations.securityProfileGroups

Methods
create POST /v1/{parent=organizations/*/locations/*}/securityProfileGroups
Creates a new security profile group in a given organization and location.
delete DELETE /v1/{name=organizations/*/locations/*/securityProfileGroups/*}
Deletes a single security profile group.
get GET /v1/{name=organizations/*/locations/*/securityProfileGroups/*}
Gets details of a single security profile group.
list GET /v1/{parent=organizations/*/locations/*}/securityProfileGroups
Lists security profile group resources in a given organization and location.
patch PATCH /v1/{securityProfileGroup.name=organizations/*/locations/*/securityProfileGroups/*}
Updates the parameters of a single security profile group.

REST Resource: v1.organizations.locations.securityProfiles

Methods
create POST /v1/{parent=organizations/*/locations/*}/securityProfiles
Creates a new security profile in a given organization and location.
delete DELETE /v1/{name=organizations/*/locations/*/securityProfiles/*}
Deletes a single security profile.
get GET /v1/{name=organizations/*/locations/*/securityProfiles/*}
Gets details of a single security profile.
list GET /v1/{parent=organizations/*/locations/*}/securityProfiles
Lists security profile resources in a given organization and location.
patch PATCH /v1/{securityProfile.name=organizations/*/locations/*/securityProfiles/*}
Updates the parameters of a single security profile.

REST Resource: v1.projects.locations

Methods
get GET /v1/{name=projects/*/locations/*}
Gets information about a location.
list GET /v1/{name=projects/*}/locations
Lists information about the supported locations for this service.

REST Resource: v1.projects.locations.addressGroups

Methods
addItems POST /v1/{addressGroup=projects/*/locations/*/addressGroups/*}:addItems
Adds items to an address group.
cloneItems POST /v1/{addressGroup=projects/*/locations/*/addressGroups/*}:cloneItems
Clones items from one address group to another.
create POST /v1/{parent=projects/*/locations/*}/addressGroups
Creates a new address group in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/addressGroups/*}
Deletes a single address group.
get GET /v1/{name=projects/*/locations/*/addressGroups/*}
Gets details of a single address group.
getIamPolicy GET /v1/{resource=projects/*/locations/*/addressGroups/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1/{parent=projects/*/locations/*}/addressGroups
Lists address groups in a given project and location.
listReferences GET /v1/{addressGroup=projects/*/locations/*/addressGroups/*}:listReferences
Lists references of an address group.
patch PATCH /v1/{addressGroup.name=projects/*/locations/*/addressGroups/*}
Updates the parameters of a single address group.
removeItems POST /v1/{addressGroup=projects/*/locations/*/addressGroups/*}:removeItems
Removes items from an address group.
setIamPolicy POST /v1/{resource=projects/*/locations/*/addressGroups/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/addressGroups/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.locations.firewallEndpointAssociations

Methods
create POST /v1/{parent=projects/*/locations/*}/firewallEndpointAssociations
Creates a new firewall endpoint association in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/firewallEndpointAssociations/*}
Deletes a single firewall endpoint association.
get GET /v1/{name=projects/*/locations/*/firewallEndpointAssociations/*}
Gets details of a single firewall endpoint association.
list GET /v1/{parent=projects/*/locations/*}/firewallEndpointAssociations
Lists associations in a given project and location.
patch PATCH /v1/{firewallEndpointAssociation.name=projects/*/locations/*/firewallEndpointAssociations/*}
Updates a single firewall endpoint association.

REST Resource: v1.projects.locations.firewallEndpoints

Methods
create POST /v1/{parent=projects/*/locations/*}/firewallEndpoints
Creates a new firewall endpoint in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/firewallEndpoints/*}
Deletes a single project endpoint.
get GET /v1/{name=projects/*/locations/*/firewallEndpoints/*}
Gets details of a single project endpoint.
list GET /v1/{parent=projects/*/locations/*}/firewallEndpoints
Lists firewall endpoints in a given project and location.
patch PATCH /v1/{firewallEndpoint.name=projects/*/locations/*/firewallEndpoints/*}
Updates a single project endpoint.

REST Resource: v1.projects.locations.firewallEndpoints.wildfireVerdictChangeRequests

Methods
create POST /v1/{parent=projects/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Creates an Advanced malware sandbox verdict change request in a given firewall endpoint in a project and location.
get GET /v1/{name=projects/*/locations/*/firewallEndpoints/*/wildfireVerdictChangeRequests/*}
Gets an Advanced malware sandbox verdict change request in a given firewall endpoint in a project and location.
list GET /v1/{parent=projects/*/locations/*/firewallEndpoints/*}/wildfireVerdictChangeRequests
Lists the Advanced malware sandbox verdict change requests in a given firewall endpoint in a project and location.

REST Resource: v1.projects.locations.operations

Methods
cancel POST /v1/{name=projects/*/locations/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=projects/*/locations/*/operations/*}
Deletes a long-running operation.
get GET /v1/{name=projects/*/locations/*/operations/*}
Gets the latest state of a long-running operation.
list GET /v1/{name=projects/*/locations/*}/operations
Lists operations that match the specified filter in the request.

REST Resource: v1.projects.locations.securityProfileGroups

Methods
create POST /v1/{parent=projects/*/locations/*}/securityProfileGroups
Creates a new security profile group in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/securityProfileGroups/*}
Deletes a single security profile group.
get GET /v1/{name=projects/*/locations/*/securityProfileGroups/*}
Gets details of a single security profile group.
list GET /v1/{parent=projects/*/locations/*}/securityProfileGroups
Lists security profile group resources in a given project and location.
patch PATCH /v1/{securityProfileGroup.name=projects/*/locations/*/securityProfileGroups/*}
Updates the parameters of a single security profile group.

REST Resource: v1.projects.locations.securityProfiles

Methods
create POST /v1/{parent=projects/*/locations/*}/securityProfiles
Creates a new security profile in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/securityProfiles/*}
Deletes a single security profile.
get GET /v1/{name=projects/*/locations/*/securityProfiles/*}
Gets details of a single security profile.
list GET /v1/{parent=projects/*/locations/*}/securityProfiles
Lists security profiles in a given project and location.
patch PATCH /v1/{securityProfile.name=projects/*/locations/*/securityProfiles/*}
Updates the parameters of a single security profile.

REST Resource: v1.projects.locations.tlsInspectionPolicies

Methods
create POST /v1/{parent=projects/*/locations/*}/tlsInspectionPolicies
Creates a new TlsInspectionPolicy in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/tlsInspectionPolicies/*}
Deletes a single TlsInspectionPolicy.
get GET /v1/{name=projects/*/locations/*/tlsInspectionPolicies/*}
Gets details of a single TlsInspectionPolicy.
list GET /v1/{parent=projects/*/locations/*}/tlsInspectionPolicies
Lists TlsInspectionPolicies in a given project and location.
patch PATCH /v1/{tlsInspectionPolicy.name=projects/*/locations/*/tlsInspectionPolicies/*}
Updates the parameters of a single TlsInspectionPolicy.