1. Packages
  2. Google Cloud Native
  3. API Docs
  4. networkservices
  5. networkservices/v1beta1
  6. getEndpointPolicy

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

google-native.networkservices/v1beta1.getEndpointPolicy

Explore with Pulumi AI

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

Gets details of a single EndpointPolicy.

Using getEndpointPolicy

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getEndpointPolicy(args: GetEndpointPolicyArgs, opts?: InvokeOptions): Promise<GetEndpointPolicyResult>
function getEndpointPolicyOutput(args: GetEndpointPolicyOutputArgs, opts?: InvokeOptions): Output<GetEndpointPolicyResult>
Copy
def get_endpoint_policy(endpoint_policy_id: Optional[str] = None,
                        location: Optional[str] = None,
                        project: Optional[str] = None,
                        opts: Optional[InvokeOptions] = None) -> GetEndpointPolicyResult
def get_endpoint_policy_output(endpoint_policy_id: Optional[pulumi.Input[str]] = None,
                        location: Optional[pulumi.Input[str]] = None,
                        project: Optional[pulumi.Input[str]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetEndpointPolicyResult]
Copy
func LookupEndpointPolicy(ctx *Context, args *LookupEndpointPolicyArgs, opts ...InvokeOption) (*LookupEndpointPolicyResult, error)
func LookupEndpointPolicyOutput(ctx *Context, args *LookupEndpointPolicyOutputArgs, opts ...InvokeOption) LookupEndpointPolicyResultOutput
Copy

> Note: This function is named LookupEndpointPolicy in the Go SDK.

public static class GetEndpointPolicy 
{
    public static Task<GetEndpointPolicyResult> InvokeAsync(GetEndpointPolicyArgs args, InvokeOptions? opts = null)
    public static Output<GetEndpointPolicyResult> Invoke(GetEndpointPolicyInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetEndpointPolicyResult> getEndpointPolicy(GetEndpointPolicyArgs args, InvokeOptions options)
public static Output<GetEndpointPolicyResult> getEndpointPolicy(GetEndpointPolicyArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: google-native:networkservices/v1beta1:getEndpointPolicy
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

EndpointPolicyId This property is required. string
Location This property is required. string
Project string
EndpointPolicyId This property is required. string
Location This property is required. string
Project string
endpointPolicyId This property is required. String
location This property is required. String
project String
endpointPolicyId This property is required. string
location This property is required. string
project string
endpoint_policy_id This property is required. str
location This property is required. str
project str
endpointPolicyId This property is required. String
location This property is required. String
project String

getEndpointPolicy Result

The following output properties are available:

AuthorizationPolicy string
Optional. This field specifies the URL of AuthorizationPolicy resource that applies authorization policies to the inbound traffic at the matched endpoints. Refer to Authorization. If this field is not specified, authorization is disabled(no authz checks) for this endpoint.
ClientTlsPolicy string
Optional. A URL referring to a ClientTlsPolicy resource. ClientTlsPolicy can be set to specify the authentication for traffic from the proxy to the actual endpoints. More specifically, it is applied to the outgoing traffic from the proxy to the endpoint. This is typically used for sidecar model where the proxy identifies itself as endpoint to the control plane, with the connection between sidecar and endpoint requiring authentication. If this field is not set, authentication is disabled(open). Applicable only when EndpointPolicyType is SIDECAR_PROXY.
CreateTime string
The timestamp when the resource was created.
Description string
Optional. A free-text description of the resource. Max length 1024 characters.
EndpointMatcher Pulumi.GoogleNative.NetworkServices.V1Beta1.Outputs.EndpointMatcherResponse
A matcher that selects endpoints to which the policies should be applied.
Labels Dictionary<string, string>
Optional. Set of label tags associated with the EndpointPolicy resource.
Name string
Name of the EndpointPolicy resource. It matches pattern projects/{project}/locations/global/endpointPolicies/{endpoint_policy}.
ServerTlsPolicy string
Optional. A URL referring to ServerTlsPolicy resource. ServerTlsPolicy is used to determine the authentication policy to be applied to terminate the inbound traffic at the identified backends. If this field is not set, authentication is disabled(open) for this endpoint.
TrafficPortSelector Pulumi.GoogleNative.NetworkServices.V1Beta1.Outputs.TrafficPortSelectorResponse
Optional. Port selector for the (matched) endpoints. If no port selector is provided, the matched config is applied to all ports.
Type string
The type of endpoint policy. This is primarily used to validate the configuration.
UpdateTime string
The timestamp when the resource was updated.
AuthorizationPolicy string
Optional. This field specifies the URL of AuthorizationPolicy resource that applies authorization policies to the inbound traffic at the matched endpoints. Refer to Authorization. If this field is not specified, authorization is disabled(no authz checks) for this endpoint.
ClientTlsPolicy string
Optional. A URL referring to a ClientTlsPolicy resource. ClientTlsPolicy can be set to specify the authentication for traffic from the proxy to the actual endpoints. More specifically, it is applied to the outgoing traffic from the proxy to the endpoint. This is typically used for sidecar model where the proxy identifies itself as endpoint to the control plane, with the connection between sidecar and endpoint requiring authentication. If this field is not set, authentication is disabled(open). Applicable only when EndpointPolicyType is SIDECAR_PROXY.
CreateTime string
The timestamp when the resource was created.
Description string
Optional. A free-text description of the resource. Max length 1024 characters.
EndpointMatcher EndpointMatcherResponse
A matcher that selects endpoints to which the policies should be applied.
Labels map[string]string
Optional. Set of label tags associated with the EndpointPolicy resource.
Name string
Name of the EndpointPolicy resource. It matches pattern projects/{project}/locations/global/endpointPolicies/{endpoint_policy}.
ServerTlsPolicy string
Optional. A URL referring to ServerTlsPolicy resource. ServerTlsPolicy is used to determine the authentication policy to be applied to terminate the inbound traffic at the identified backends. If this field is not set, authentication is disabled(open) for this endpoint.
TrafficPortSelector TrafficPortSelectorResponse
Optional. Port selector for the (matched) endpoints. If no port selector is provided, the matched config is applied to all ports.
Type string
The type of endpoint policy. This is primarily used to validate the configuration.
UpdateTime string
The timestamp when the resource was updated.
authorizationPolicy String
Optional. This field specifies the URL of AuthorizationPolicy resource that applies authorization policies to the inbound traffic at the matched endpoints. Refer to Authorization. If this field is not specified, authorization is disabled(no authz checks) for this endpoint.
clientTlsPolicy String
Optional. A URL referring to a ClientTlsPolicy resource. ClientTlsPolicy can be set to specify the authentication for traffic from the proxy to the actual endpoints. More specifically, it is applied to the outgoing traffic from the proxy to the endpoint. This is typically used for sidecar model where the proxy identifies itself as endpoint to the control plane, with the connection between sidecar and endpoint requiring authentication. If this field is not set, authentication is disabled(open). Applicable only when EndpointPolicyType is SIDECAR_PROXY.
createTime String
The timestamp when the resource was created.
description String
Optional. A free-text description of the resource. Max length 1024 characters.
endpointMatcher EndpointMatcherResponse
A matcher that selects endpoints to which the policies should be applied.
labels Map<String,String>
Optional. Set of label tags associated with the EndpointPolicy resource.
name String
Name of the EndpointPolicy resource. It matches pattern projects/{project}/locations/global/endpointPolicies/{endpoint_policy}.
serverTlsPolicy String
Optional. A URL referring to ServerTlsPolicy resource. ServerTlsPolicy is used to determine the authentication policy to be applied to terminate the inbound traffic at the identified backends. If this field is not set, authentication is disabled(open) for this endpoint.
trafficPortSelector TrafficPortSelectorResponse
Optional. Port selector for the (matched) endpoints. If no port selector is provided, the matched config is applied to all ports.
type String
The type of endpoint policy. This is primarily used to validate the configuration.
updateTime String
The timestamp when the resource was updated.
authorizationPolicy string
Optional. This field specifies the URL of AuthorizationPolicy resource that applies authorization policies to the inbound traffic at the matched endpoints. Refer to Authorization. If this field is not specified, authorization is disabled(no authz checks) for this endpoint.
clientTlsPolicy string
Optional. A URL referring to a ClientTlsPolicy resource. ClientTlsPolicy can be set to specify the authentication for traffic from the proxy to the actual endpoints. More specifically, it is applied to the outgoing traffic from the proxy to the endpoint. This is typically used for sidecar model where the proxy identifies itself as endpoint to the control plane, with the connection between sidecar and endpoint requiring authentication. If this field is not set, authentication is disabled(open). Applicable only when EndpointPolicyType is SIDECAR_PROXY.
createTime string
The timestamp when the resource was created.
description string
Optional. A free-text description of the resource. Max length 1024 characters.
endpointMatcher EndpointMatcherResponse
A matcher that selects endpoints to which the policies should be applied.
labels {[key: string]: string}
Optional. Set of label tags associated with the EndpointPolicy resource.
name string
Name of the EndpointPolicy resource. It matches pattern projects/{project}/locations/global/endpointPolicies/{endpoint_policy}.
serverTlsPolicy string
Optional. A URL referring to ServerTlsPolicy resource. ServerTlsPolicy is used to determine the authentication policy to be applied to terminate the inbound traffic at the identified backends. If this field is not set, authentication is disabled(open) for this endpoint.
trafficPortSelector TrafficPortSelectorResponse
Optional. Port selector for the (matched) endpoints. If no port selector is provided, the matched config is applied to all ports.
type string
The type of endpoint policy. This is primarily used to validate the configuration.
updateTime string
The timestamp when the resource was updated.
authorization_policy str
Optional. This field specifies the URL of AuthorizationPolicy resource that applies authorization policies to the inbound traffic at the matched endpoints. Refer to Authorization. If this field is not specified, authorization is disabled(no authz checks) for this endpoint.
client_tls_policy str
Optional. A URL referring to a ClientTlsPolicy resource. ClientTlsPolicy can be set to specify the authentication for traffic from the proxy to the actual endpoints. More specifically, it is applied to the outgoing traffic from the proxy to the endpoint. This is typically used for sidecar model where the proxy identifies itself as endpoint to the control plane, with the connection between sidecar and endpoint requiring authentication. If this field is not set, authentication is disabled(open). Applicable only when EndpointPolicyType is SIDECAR_PROXY.
create_time str
The timestamp when the resource was created.
description str
Optional. A free-text description of the resource. Max length 1024 characters.
endpoint_matcher EndpointMatcherResponse
A matcher that selects endpoints to which the policies should be applied.
labels Mapping[str, str]
Optional. Set of label tags associated with the EndpointPolicy resource.
name str
Name of the EndpointPolicy resource. It matches pattern projects/{project}/locations/global/endpointPolicies/{endpoint_policy}.
server_tls_policy str
Optional. A URL referring to ServerTlsPolicy resource. ServerTlsPolicy is used to determine the authentication policy to be applied to terminate the inbound traffic at the identified backends. If this field is not set, authentication is disabled(open) for this endpoint.
traffic_port_selector TrafficPortSelectorResponse
Optional. Port selector for the (matched) endpoints. If no port selector is provided, the matched config is applied to all ports.
type str
The type of endpoint policy. This is primarily used to validate the configuration.
update_time str
The timestamp when the resource was updated.
authorizationPolicy String
Optional. This field specifies the URL of AuthorizationPolicy resource that applies authorization policies to the inbound traffic at the matched endpoints. Refer to Authorization. If this field is not specified, authorization is disabled(no authz checks) for this endpoint.
clientTlsPolicy String
Optional. A URL referring to a ClientTlsPolicy resource. ClientTlsPolicy can be set to specify the authentication for traffic from the proxy to the actual endpoints. More specifically, it is applied to the outgoing traffic from the proxy to the endpoint. This is typically used for sidecar model where the proxy identifies itself as endpoint to the control plane, with the connection between sidecar and endpoint requiring authentication. If this field is not set, authentication is disabled(open). Applicable only when EndpointPolicyType is SIDECAR_PROXY.
createTime String
The timestamp when the resource was created.
description String
Optional. A free-text description of the resource. Max length 1024 characters.
endpointMatcher Property Map
A matcher that selects endpoints to which the policies should be applied.
labels Map<String>
Optional. Set of label tags associated with the EndpointPolicy resource.
name String
Name of the EndpointPolicy resource. It matches pattern projects/{project}/locations/global/endpointPolicies/{endpoint_policy}.
serverTlsPolicy String
Optional. A URL referring to ServerTlsPolicy resource. ServerTlsPolicy is used to determine the authentication policy to be applied to terminate the inbound traffic at the identified backends. If this field is not set, authentication is disabled(open) for this endpoint.
trafficPortSelector Property Map
Optional. Port selector for the (matched) endpoints. If no port selector is provided, the matched config is applied to all ports.
type String
The type of endpoint policy. This is primarily used to validate the configuration.
updateTime String
The timestamp when the resource was updated.

Supporting Types

EndpointMatcherResponse

MetadataLabelMatcher This property is required. Pulumi.GoogleNative.NetworkServices.V1Beta1.Inputs.MetadataLabelMatcherResponse
The matcher is based on node metadata presented by xDS clients.
MetadataLabelMatcher This property is required. MetadataLabelMatcherResponse
The matcher is based on node metadata presented by xDS clients.
metadataLabelMatcher This property is required. MetadataLabelMatcherResponse
The matcher is based on node metadata presented by xDS clients.
metadataLabelMatcher This property is required. MetadataLabelMatcherResponse
The matcher is based on node metadata presented by xDS clients.
metadata_label_matcher This property is required. MetadataLabelMatcherResponse
The matcher is based on node metadata presented by xDS clients.
metadataLabelMatcher This property is required. Property Map
The matcher is based on node metadata presented by xDS clients.

MetadataLabelMatcherResponse

MetadataLabelMatchCriteria This property is required. string
Specifies how matching should be done. Supported values are: MATCH_ANY: At least one of the Labels specified in the matcher should match the metadata presented by xDS client. MATCH_ALL: The metadata presented by the xDS client should contain all of the labels specified here. The selection is determined based on the best match. For example, suppose there are three EndpointPolicy resources P1, P2 and P3 and if P1 has a the matcher as MATCH_ANY , P2 has MATCH_ALL , and P3 has MATCH_ALL . If a client with label connects, the config from P1 will be selected. If a client with label connects, the config from P2 will be selected. If a client with label connects, the config from P3 will be selected. If there is more than one best match, (for example, if a config P4 with selector exists and if a client with label connects), an error will be thrown.
MetadataLabels This property is required. List<Pulumi.GoogleNative.NetworkServices.V1Beta1.Inputs.MetadataLabelsResponse>
The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list can have at most 64 entries. The list can be empty if the match criteria is MATCH_ANY, to specify a wildcard match (i.e this matches any client).
MetadataLabelMatchCriteria This property is required. string
Specifies how matching should be done. Supported values are: MATCH_ANY: At least one of the Labels specified in the matcher should match the metadata presented by xDS client. MATCH_ALL: The metadata presented by the xDS client should contain all of the labels specified here. The selection is determined based on the best match. For example, suppose there are three EndpointPolicy resources P1, P2 and P3 and if P1 has a the matcher as MATCH_ANY , P2 has MATCH_ALL , and P3 has MATCH_ALL . If a client with label connects, the config from P1 will be selected. If a client with label connects, the config from P2 will be selected. If a client with label connects, the config from P3 will be selected. If there is more than one best match, (for example, if a config P4 with selector exists and if a client with label connects), an error will be thrown.
MetadataLabels This property is required. []MetadataLabelsResponse
The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list can have at most 64 entries. The list can be empty if the match criteria is MATCH_ANY, to specify a wildcard match (i.e this matches any client).
metadataLabelMatchCriteria This property is required. String
Specifies how matching should be done. Supported values are: MATCH_ANY: At least one of the Labels specified in the matcher should match the metadata presented by xDS client. MATCH_ALL: The metadata presented by the xDS client should contain all of the labels specified here. The selection is determined based on the best match. For example, suppose there are three EndpointPolicy resources P1, P2 and P3 and if P1 has a the matcher as MATCH_ANY , P2 has MATCH_ALL , and P3 has MATCH_ALL . If a client with label connects, the config from P1 will be selected. If a client with label connects, the config from P2 will be selected. If a client with label connects, the config from P3 will be selected. If there is more than one best match, (for example, if a config P4 with selector exists and if a client with label connects), an error will be thrown.
metadataLabels This property is required. List<MetadataLabelsResponse>
The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list can have at most 64 entries. The list can be empty if the match criteria is MATCH_ANY, to specify a wildcard match (i.e this matches any client).
metadataLabelMatchCriteria This property is required. string
Specifies how matching should be done. Supported values are: MATCH_ANY: At least one of the Labels specified in the matcher should match the metadata presented by xDS client. MATCH_ALL: The metadata presented by the xDS client should contain all of the labels specified here. The selection is determined based on the best match. For example, suppose there are three EndpointPolicy resources P1, P2 and P3 and if P1 has a the matcher as MATCH_ANY , P2 has MATCH_ALL , and P3 has MATCH_ALL . If a client with label connects, the config from P1 will be selected. If a client with label connects, the config from P2 will be selected. If a client with label connects, the config from P3 will be selected. If there is more than one best match, (for example, if a config P4 with selector exists and if a client with label connects), an error will be thrown.
metadataLabels This property is required. MetadataLabelsResponse[]
The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list can have at most 64 entries. The list can be empty if the match criteria is MATCH_ANY, to specify a wildcard match (i.e this matches any client).
metadata_label_match_criteria This property is required. str
Specifies how matching should be done. Supported values are: MATCH_ANY: At least one of the Labels specified in the matcher should match the metadata presented by xDS client. MATCH_ALL: The metadata presented by the xDS client should contain all of the labels specified here. The selection is determined based on the best match. For example, suppose there are three EndpointPolicy resources P1, P2 and P3 and if P1 has a the matcher as MATCH_ANY , P2 has MATCH_ALL , and P3 has MATCH_ALL . If a client with label connects, the config from P1 will be selected. If a client with label connects, the config from P2 will be selected. If a client with label connects, the config from P3 will be selected. If there is more than one best match, (for example, if a config P4 with selector exists and if a client with label connects), an error will be thrown.
metadata_labels This property is required. Sequence[MetadataLabelsResponse]
The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list can have at most 64 entries. The list can be empty if the match criteria is MATCH_ANY, to specify a wildcard match (i.e this matches any client).
metadataLabelMatchCriteria This property is required. String
Specifies how matching should be done. Supported values are: MATCH_ANY: At least one of the Labels specified in the matcher should match the metadata presented by xDS client. MATCH_ALL: The metadata presented by the xDS client should contain all of the labels specified here. The selection is determined based on the best match. For example, suppose there are three EndpointPolicy resources P1, P2 and P3 and if P1 has a the matcher as MATCH_ANY , P2 has MATCH_ALL , and P3 has MATCH_ALL . If a client with label connects, the config from P1 will be selected. If a client with label connects, the config from P2 will be selected. If a client with label connects, the config from P3 will be selected. If there is more than one best match, (for example, if a config P4 with selector exists and if a client with label connects), an error will be thrown.
metadataLabels This property is required. List<Property Map>
The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list can have at most 64 entries. The list can be empty if the match criteria is MATCH_ANY, to specify a wildcard match (i.e this matches any client).

MetadataLabelsResponse

LabelName This property is required. string
Label name presented as key in xDS Node Metadata.
LabelValue This property is required. string
Label value presented as value corresponding to the above key, in xDS Node Metadata.
LabelName This property is required. string
Label name presented as key in xDS Node Metadata.
LabelValue This property is required. string
Label value presented as value corresponding to the above key, in xDS Node Metadata.
labelName This property is required. String
Label name presented as key in xDS Node Metadata.
labelValue This property is required. String
Label value presented as value corresponding to the above key, in xDS Node Metadata.
labelName This property is required. string
Label name presented as key in xDS Node Metadata.
labelValue This property is required. string
Label value presented as value corresponding to the above key, in xDS Node Metadata.
label_name This property is required. str
Label name presented as key in xDS Node Metadata.
label_value This property is required. str
Label value presented as value corresponding to the above key, in xDS Node Metadata.
labelName This property is required. String
Label name presented as key in xDS Node Metadata.
labelValue This property is required. String
Label value presented as value corresponding to the above key, in xDS Node Metadata.

TrafficPortSelectorResponse

Ports This property is required. List<string>
Optional. A list of ports. Can be port numbers or port range (example, [80-90] specifies all ports from 80 to 90, including 80 and 90) or named ports or * to specify all ports. If the list is empty, all ports are selected.
Ports This property is required. []string
Optional. A list of ports. Can be port numbers or port range (example, [80-90] specifies all ports from 80 to 90, including 80 and 90) or named ports or * to specify all ports. If the list is empty, all ports are selected.
ports This property is required. List<String>
Optional. A list of ports. Can be port numbers or port range (example, [80-90] specifies all ports from 80 to 90, including 80 and 90) or named ports or * to specify all ports. If the list is empty, all ports are selected.
ports This property is required. string[]
Optional. A list of ports. Can be port numbers or port range (example, [80-90] specifies all ports from 80 to 90, including 80 and 90) or named ports or * to specify all ports. If the list is empty, all ports are selected.
ports This property is required. Sequence[str]
Optional. A list of ports. Can be port numbers or port range (example, [80-90] specifies all ports from 80 to 90, including 80 and 90) or named ports or * to specify all ports. If the list is empty, all ports are selected.
ports This property is required. List<String>
Optional. A list of ports. Can be port numbers or port range (example, [80-90] specifies all ports from 80 to 90, including 80 and 90) or named ports or * to specify all ports. If the list is empty, all ports are selected.

Package Details

Repository
Google Cloud Native pulumi/pulumi-google-native
License
Apache-2.0

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi