Google Cloud Native v0.28.0, Feb 2 23

google-native.networkservices/v1beta1.getEndpointPolicy

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>

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]

func LookupEndpointPolicy(ctx *Context, args *LookupEndpointPolicyArgs, opts ...InvokeOption) (*LookupEndpointPolicyResult, error)
func LookupEndpointPolicyOutput(ctx *Context, args *LookupEndpointPolicyOutputArgs, opts ...InvokeOption) LookupEndpointPolicyResultOutput

> 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)
}

public static CompletableFuture<GetEndpointPolicyResult> getEndpointPolicy(GetEndpointPolicyArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: google-native:networkservices/v1beta1:getEndpointPolicy
  arguments:
    # arguments dictionary

The following arguments are supported:

EndpointPolicyId string
Location string
Project string

EndpointPolicyId string
Location string
Project string

endpointPolicyId String
location String
project String

endpointPolicyId string
location string
project string

endpoint_policy_id str
location str
project str

endpointPolicyId String
location 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 Pulumi.GoogleNative.NetworkServices.V1Beta1.Inputs.MetadataLabelMatcherResponse: The matcher is based on node metadata presented by xDS clients.

MetadataLabelMatcher MetadataLabelMatcherResponse: The matcher is based on node metadata presented by xDS clients.

metadataLabelMatcher MetadataLabelMatcherResponse: The matcher is based on node metadata presented by xDS clients.

metadataLabelMatcher MetadataLabelMatcherResponse: The matcher is based on node metadata presented by xDS clients.

metadata_label_matcher MetadataLabelMatcherResponse: The matcher is based on node metadata presented by xDS clients.

metadataLabelMatcher Property Map: The matcher is based on node metadata presented by xDS clients.

MetadataLabelMatcherResponse

MetadataLabelMatchCriteria 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 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 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 []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 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 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 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 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 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 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 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 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 string: Label name presented as key in xDS Node Metadata.
LabelValue string: Label value presented as value corresponding to the above key, in xDS Node Metadata.

LabelName string: Label name presented as key in xDS Node Metadata.
LabelValue string: Label value presented as value corresponding to the above key, in xDS Node Metadata.

labelName String: Label name presented as key in xDS Node Metadata.
labelValue String: Label value presented as value corresponding to the above key, in xDS Node Metadata.

labelName string: Label name presented as key in xDS Node Metadata.
labelValue string: Label value presented as value corresponding to the above key, in xDS Node Metadata.

label_name str: Label name presented as key in xDS Node Metadata.
label_value str: Label value presented as value corresponding to the above key, in xDS Node Metadata.

labelName String: Label name presented as key in xDS Node Metadata.
labelValue String: Label value presented as value corresponding to the above key, in xDS Node Metadata.

TrafficPortSelectorResponse

Ports 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 []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 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 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 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 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