Class UsageRule (2.2.0)

public sealed class UsageRule : Protobuf.IMessage<UsageRule>, Protobuf.IBufferMessage

Usage configuration rules for the service.

NOTE: Under development.

Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity. Use this rule to allow/disallow unregistered calls.

Example of an API that wants to allow unregistered calls for entire service.

usage: rules:

  • selector: "*" allow_unregistered_calls: true

Example of a method that wants to allow unregistered calls.

usage: rules:

  • selector: "google.example.library.v1.LibraryService.CreateBook" allow_unregistered_calls: true

Inheritance

Object > UsageRule

Namespace

Google.Api

Assembly

Google.Api.CommonProtos.dll

Constructors

UsageRule()

public UsageRule()

UsageRule(UsageRule)

public UsageRule(UsageRule other)
Parameter
NameDescription
otherUsageRule

Fields

AllowUnregisteredCallsFieldNumber

public const int AllowUnregisteredCallsFieldNumber = 2

Field number for the "allow_unregistered_calls" field.

Field Value
TypeDescription
Int32

SelectorFieldNumber

public const int SelectorFieldNumber = 1

Field number for the "selector" field.

Field Value
TypeDescription
Int32

SkipServiceControlFieldNumber

public const int SkipServiceControlFieldNumber = 3

Field number for the "skip_service_control" field.

Field Value
TypeDescription
Int32

Properties

AllowUnregisteredCalls

public bool AllowUnregisteredCalls { get; set; }

If true, the selected method allows unregistered calls, e.g. calls that don't identify any user or application.

Property Value
TypeDescription
Boolean

Descriptor

public static Protobuf.Reflection.MessageDescriptor Descriptor { get; }
Property Value
TypeDescription
Protobuf.Reflection.MessageDescriptor

Parser

public static Protobuf.MessageParser<UsageRule> Parser { get; }
Property Value
TypeDescription
Protobuf.MessageParser<UsageRule>

Selector

public string Selector { get; set; }

Selects the methods to which this rule applies. Use '*' to indicate all methods in all APIs.

Refer to [selector][google.api.DocumentationRule.selector] for syntax details.

Property Value
TypeDescription
String

SkipServiceControl

public bool SkipServiceControl { get; set; }

If true, the selected method should skip service control and the control plane features, such as quota and billing, will not be available. This flag is used by Google Cloud Endpoints to bypass checks for internal methods, such as service health check methods.

Property Value
TypeDescription
Boolean

Methods

CalculateSize()

public int CalculateSize()
Returns
TypeDescription
Int32

Clone()

public UsageRule Clone()
Returns
TypeDescription
UsageRule

Equals(UsageRule)

public bool Equals(UsageRule other)
Parameter
NameDescription
otherUsageRule
Returns
TypeDescription
Boolean

Equals(Object)

public override bool Equals(object other)
Parameter
NameDescription
otherObject
Returns
TypeDescription
Boolean

GetHashCode()

public override int GetHashCode()
Returns
TypeDescription
Int32

MergeFrom(UsageRule)

public void MergeFrom(UsageRule other)
Parameter
NameDescription
otherUsageRule

MergeFrom(Protobuf.CodedInputStream)

public void MergeFrom(Protobuf.CodedInputStream input)
Parameter
NameDescription
inputProtobuf.CodedInputStream

ToString()

public override string ToString()
Returns
TypeDescription
String

WriteTo(Protobuf.CodedOutputStream)

public void WriteTo(Protobuf.CodedOutputStream output)
Parameter
NameDescription
outputProtobuf.CodedOutputStream