Package : xds.core.v3

Top

resource_locator.proto

Table of Contents

ResourceLocator

Field Type Label Description
scheme xds.core.v3.ResourceLocator.Scheme URI scheme.
id string Opaque identifier for the resource. Any ‘/’ will not be escaped during URI encoding and will form part of the URI path. This may end with ‘*’ for glob collection references.
authority string Logical authority for resource (not necessarily transport network address). Authorities are opaque in the xDS API, data-plane load balancers will map them to concrete network transports such as an xDS management server, e.g. via envoy.config.core.v3.ConfigSource.
resourceType string Fully qualified resource type (as in type URL without types.googleapis.com/ prefix).
exactContext xds.core.v3.ContextParams Additional parameters that can be used to select resource variants. Matches must be exact, i.e. all context parameters must match exactly and there must be no additional context parameters set on the matched resource.
directives []xds.core.v3.ResourceLocator.Directive repeated A list of directives that appear in the xDS resource locator #fragment.
When encoding to URI form, directives are percent encoded with comma separation.

ResourceLocator.Directive

Field Type Label Description
alt xds.core.v3.ResourceLocator An alternative resource locator for fallback if the resource is unavailable. For example, take the resource locator:
xdstp://foo/some-type/some-route-table#alt=xdstp://bar/some-type/another-route-table
If the data-plane load balancer is unable to reach foo to fetch the resource, it will fallback to bar. Alternative resources do not need to have equivalent content, but they should be functional substitutes.
entry string List collections support inlining of resources via the entry field in Resource. These inlined Resource objects may have an optional name field specified. When specified, the entry directive allows ResourceLocator to directly reference these inlined resources, e.g. xdstp://…/foo#entry=bar.

ResourceLocator.Scheme

Name Number Description
XDSTP 0
HTTP 1
FILE 2