google-native logo
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
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 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