Compute V1 Client - Class FirewallPolicy (1.5.0)

Reference documentation and code samples for the Compute V1 Client class FirewallPolicy.

Represents a Firewall Policy resource.

Generated from protobuf message google.cloud.compute.v1.FirewallPolicy

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ associations`	`array<Google\Cloud\Compute\V1\FirewallPolicyAssociation>` A list of associations that belong to this firewall policy.
`↳ creation_timestamp`	`string` [Output Only] Creation timestamp in RFC3339 text format.
`↳ description`	`string` An optional description of this resource. Provide this property when you create the resource.
`↳ display_name`	`string` Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name 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.
`↳ fingerprint`	`string` Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy.
`↳ id`	`int\|string` [Output Only] The unique identifier for the resource. This identifier is defined by the server.
`↳ kind`	`string` [Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies
`↳ name`	`string` Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by GCP which uniquely identifies the Organization Firewall Policy.
`↳ parent`	`string` [Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies.
`↳ region`	`string` [Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
`↳ rule_tuple_count`	`int` [Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples.
`↳ rules`	`array<Google\Cloud\Compute\V1\FirewallPolicyRule>` A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match "*"). If no rules are provided when creating a firewall policy, a default rule with action "allow" will be added.
`↳ self_link`	`string` [Output Only] Server-defined URL for the resource.
`↳ self_link_with_id`	`string` [Output Only] Server-defined URL for this resource with the resource id.
`↳ short_name`	`string` User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name 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.

getAssociations

A list of associations that belong to this firewall policy.

Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyAssociation associations = 508736530;

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setAssociations

A list of associations that belong to this firewall policy.

Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyAssociation associations = 508736530;

Parameter
Name	Description
`var`	`array<Google\Cloud\Compute\V1\FirewallPolicyAssociation>`

Returns
Type	Description
`$this`

getCreationTimestamp

[Output Only] Creation timestamp in RFC3339 text format.

Generated from protobuf field optional string creation_timestamp = 30525366;

Returns
Type	Description
`string`

hasCreationTimestamp

clearCreationTimestamp

setCreationTimestamp

[Output Only] Creation timestamp in RFC3339 text format.

Generated from protobuf field optional string creation_timestamp = 30525366;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getDescription

An optional description of this resource. Provide this property when you create the resource.

Generated from protobuf field optional string description = 422937596;

Returns
Type	Description
`string`

hasDescription

clearDescription

setDescription

An optional description of this resource. Provide this property when you create the resource.

Generated from protobuf field optional string description = 422937596;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getDisplayName

Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name 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.

Generated from protobuf field optional string display_name = 4473832;

Returns
Type	Description
`string`

hasDisplayName

clearDisplayName

setDisplayName

Generated from protobuf field optional string display_name = 4473832;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getFingerprint

Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy.

Generated from protobuf field optional string fingerprint = 234678500;

Returns
Type	Description
`string`

hasFingerprint

clearFingerprint

setFingerprint

Generated from protobuf field optional string fingerprint = 234678500;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getId

[Output Only] The unique identifier for the resource. This identifier is defined by the server.

Generated from protobuf field optional uint64 id = 3355;

Returns
Type	Description
`int\|string`

hasId

clearId

setId

[Output Only] The unique identifier for the resource. This identifier is defined by the server.

Generated from protobuf field optional uint64 id = 3355;

Parameter
Name	Description
`var`	`int\|string`

Returns
Type	Description
`$this`

getKind

[Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies

Generated from protobuf field optional string kind = 3292052;

Returns
Type	Description
`string`

hasKind

clearKind

setKind

[Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies

Generated from protobuf field optional string kind = 3292052;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getName

Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by GCP which uniquely identifies the Organization Firewall Policy.

Generated from protobuf field optional string name = 3373707;

Returns
Type	Description
`string`

hasName

clearName

setName

Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by GCP which uniquely identifies the Organization Firewall Policy.

Generated from protobuf field optional string name = 3373707;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getParent

[Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies.

Generated from protobuf field optional string parent = 78317738;

Returns
Type	Description
`string`

hasParent

clearParent

setParent

[Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies.

Generated from protobuf field optional string parent = 78317738;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getRegion

[Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.

Generated from protobuf field optional string region = 138946292;

Returns
Type	Description
`string`

hasRegion

clearRegion

setRegion

Generated from protobuf field optional string region = 138946292;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getRuleTupleCount

[Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples.

Generated from protobuf field optional int32 rule_tuple_count = 388342037;

Returns
Type	Description
`int`

hasRuleTupleCount

clearRuleTupleCount

setRuleTupleCount

[Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples.

Generated from protobuf field optional int32 rule_tuple_count = 388342037;

Parameter
Name	Description
`var`	`int`

Returns
Type	Description
`$this`

getRules

A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match "*"). If no rules are provided when creating a firewall policy, a default rule with action "allow" will be added.

Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975;

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setRules

Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975;

Parameter
Name	Description
`var`	`array<Google\Cloud\Compute\V1\FirewallPolicyRule>`

Returns
Type	Description
`$this`

getSelfLink

[Output Only] Server-defined URL for the resource.

Generated from protobuf field optional string self_link = 456214797;

Returns
Type	Description
`string`

hasSelfLink

clearSelfLink

setSelfLink

[Output Only] Server-defined URL for the resource.

Generated from protobuf field optional string self_link = 456214797;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getSelfLinkWithId

[Output Only] Server-defined URL for this resource with the resource id.

Generated from protobuf field optional string self_link_with_id = 44520962;

Returns
Type	Description
`string`

hasSelfLinkWithId

clearSelfLinkWithId

setSelfLinkWithId

[Output Only] Server-defined URL for this resource with the resource id.

Generated from protobuf field optional string self_link_with_id = 44520962;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getShortName

User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name 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.

Generated from protobuf field optional string short_name = 492051566;

Returns
Type	Description
`string`

hasShortName

clearShortName

setShortName

Generated from protobuf field optional string short_name = 492051566;

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`