Network Security API (networksecurity:v1)

2026-05-24

11 new methods

Additions

    Methods
  • networksecurity.projects.locations.sacRealms.create

      Path : v1/{+parent}/sacRealms

      Parameters :

        requestId

          Location : query

          Type : string

          Description : Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

        parent

          Description : Required. The parent, in the form `projects/{project}/locations/global`.

          Required : Yes

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+$

        sacRealmId

          Location : query

          Type : string

          Description : Required. ID of the created realm. The ID must be 1-63 characters long, and comply with RFC1035. Specifically, it must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacRealms

      Description : Creates a new SACRealm in a given project.

      Parameter Order : parent

      HTTP Method : POST

      Scopes : https://www.googleapis.com/auth/cloud-platform

  • networksecurity.projects.locations.sacRealms.delete

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacRealms/{sacRealmsId}

      Description : Deletes the specified realm.

      Parameters :

        requestId

          Location : query

          Description : Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

          Type : string

        name

          Location : path

          Type : string

          Description : Required. Name of the resource, in the form `projects/{project}/locations/global/sacRealms/{sacRealm}`.

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/sacRealms/[^/]+$

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : DELETE

      Parameter Order : name

  • networksecurity.projects.locations.sacRealms.list

      Parameter Order : parent

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : GET

      Path : v1/{+parent}/sacRealms

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacRealms

      Description : Lists SACRealms in a given project.

      Parameters :

        parent

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Location : path

          Description : Required. The parent, in the form `projects/{project}/locations/global`.

          Required : Yes

          Type : string

        pageToken

          Location : query

          Description : Optional. A token identifying a page of results the server should return.

          Type : string

        orderBy

          Description : Optional. Sort the results by a certain order.

          Type : string

          Location : query

        pageSize

          Type : integer

          Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.

          Location : query

          Format : int32

        filter

          Description : Optional. An expression that filters the list of results.

          Type : string

          Location : query

  • networksecurity.projects.locations.sacRealms.get

      Parameter Order : name

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : GET

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacRealms/{sacRealmsId}

      Description : Returns the specified realm.

      Parameters :

        name

          Description : Required. Name of the resource, in the form `projects/{project}/locations/global/sacRealms/{sacRealm}`.

          Required : Yes

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/sacRealms/[^/]+$

  • networksecurity.projects.locations.sacAttachments.list

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : GET

      Parameter Order : parent

      Path : v1/{+parent}/sacAttachments

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacAttachments

      Description : Lists SACAttachments in a given project and location.

      Parameters :

        pageSize

          Location : query

          Format : int32

          Type : integer

          Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.

        filter

          Location : query

          Description : Optional. An expression that filters the list of results.

          Type : string

        parent

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Type : string

          Description : Required. The parent, in the form `projects/{project}/locations/{location}`.

          Required : Yes

          Location : path

        pageToken

          Type : string

          Description : Optional. A token identifying a page of results the server should return.

          Location : query

        orderBy

          Type : string

          Description : Optional. Sort the results by a certain order.

          Location : query

  • networksecurity.projects.locations.sacAttachments.get

      Parameter Order : name

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : GET

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacAttachments/{sacAttachmentsId}

      Description : Returns the specified attachment.

      Parameters :

        name

          Description : Required. Name of the resource, in the form `projects/{project}/locations/{location}/sacAttachments/{sac_attachment}`.

          Required : Yes

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/sacAttachments/[^/]+$

  • networksecurity.projects.locations.sacAttachments.create

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : POST

      Parameter Order : parent

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacAttachments

      Description : Creates a new SACAttachment in a given project and location.

      Parameters :

        parent

          Description : Required. The parent, in the form `projects/{project}/locations/{location}`.

          Required : Yes

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+$

        sacAttachmentId

          Type : string

          Description : Required. ID of the created attachment. The ID must be 1-63 characters long, and comply with RFC1035. Specifically, it must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

          Location : query

        requestId

          Location : query

          Description : Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

          Type : string

      Path : v1/{+parent}/sacAttachments

  • networksecurity.projects.locations.sacAttachments.delete

      HTTP Method : DELETE

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameter Order : name

      Path : v1/{+name}

      Parameters :

        name

          Description : Required. Name of the resource, in the form `projects/{project}/locations/{location}/sacAttachments/{sac_attachment}`.

          Required : Yes

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/sacAttachments/[^/]+$

        requestId

          Location : query

          Description : Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

          Type : string

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/sacAttachments/{sacAttachmentsId}

      Description : Deletes the specified attachment.

  • networksecurity.organizations.locations.addressGroups.testIamPermissions

      Parameter Order : resource

      HTTP Method : POST

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameters :

        resource

          Type : string

          Description : REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Required : Yes

          Location : path

          Pattern : ^organizations/[^/]+/locations/[^/]+/addressGroups/[^/]+$

      Flat Path : v1/organizations/{organizationsId}/locations/{locationsId}/addressGroups/{addressGroupsId}:testIamPermissions

      Description : Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

      Path : v1/{+resource}:testIamPermissions

  • networksecurity.organizations.locations.get

      Path : v1/{+name}

      Flat Path : v1/organizations/{organizationsId}/locations/{locationsId}

      Description : Gets information about a location.

      Parameters :

        name

          Type : string

          Description : Resource name for the location.

          Required : Yes

          Location : path

          Pattern : ^organizations/[^/]+/locations/[^/]+$

      Parameter Order : name

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : GET

  • networksecurity.organizations.locations.list

      Path : v1/{+name}/locations

      Parameters :

        filter

          Location : query

          Type : string

          Description : A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).

        pageSize

          Location : query

          Format : int32

          Type : integer

          Description : The maximum number of results to return. If not set, the service selects a default.

        name

          Pattern : ^organizations/[^/]+$

          Location : path

          Type : string

          Description : The resource that owns the locations collection, if applicable.

          Required : Yes

        pageToken

          Description : A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.

          Type : string

          Location : query

        extraLocationTypes

          Repeated : Yes

          Type : string

          Description : Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.

          Location : query

      Flat Path : v1/organizations/{organizationsId}/locations

      Description : Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

      Parameter Order : name

      HTTP Method : GET

      Scopes : https://www.googleapis.com/auth/cloud-platform