Class UsageRule (2.10.0)

public sealed class UsageRule : IMessage<UsageRule>, IEquatable<UsageRule>, IDeepCloneable<UsageRule>, IBufferMessage, IMessage

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

Implements

IMessage UsageRule, IEquatable UsageRule, IDeepCloneable UsageRule, IBufferMessage, IMessage

Inherited Members

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetType()

Namespace

Google.Api

Assembly

Google.Api.CommonProtos.dll

Constructors

UsageRule()

public UsageRule()

UsageRule(UsageRule)

public UsageRule(UsageRule other)

Parameter
Name	Description
`other`	`UsageRule`

Fields

AllowUnregisteredCallsFieldNumber

public const int AllowUnregisteredCallsFieldNumber = 2

Field number for the "allow_unregistered_calls" field.

Field Value
Type	Description
`int`

SelectorFieldNumber

public const int SelectorFieldNumber = 1

Field number for the "selector" field.

Field Value
Type	Description
`int`

SkipServiceControlFieldNumber

public const int SkipServiceControlFieldNumber = 3

Field number for the "skip_service_control" field.

Field Value
Type	Description
`int`

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
Type	Description
`bool`

Descriptor

public static MessageDescriptor Descriptor { get; }

Property Value
Type	Description
`MessageDescriptor`

Parser

public static MessageParser<UsageRule> Parser { get; }

Property Value
Type	Description
`MessageParserUsageRule`

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
Type	Description
`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
Type	Description
`bool`

Methods

CalculateSize()

public int CalculateSize()

Returns
Type	Description
`int`

Clone()

public UsageRule Clone()

Returns
Type	Description
`UsageRule`

Equals(UsageRule)

public bool Equals(UsageRule other)

Parameter
Name	Description
`other`	`UsageRule`

Returns
Type	Description
`bool`

Equals(object)

public override bool Equals(object other)

Parameter
Name	Description
`other`	`object`

Returns
Type	Description
`bool`

Overrides

object.Equals(object)

GetHashCode()

public override int GetHashCode()

Returns
Type	Description
`int`

Overrides

object.GetHashCode()

MergeFrom(UsageRule)

public void MergeFrom(UsageRule other)

Parameter
Name	Description
`other`	`UsageRule`

MergeFrom(CodedInputStream)

public void MergeFrom(CodedInputStream input)

Parameter
Name	Description
`input`	`CodedInputStream`

ToString()

public override string ToString()

Returns
Type	Description
`string`

Overrides

object.ToString()

WriteTo(CodedOutputStream)

public void WriteTo(CodedOutputStream output)

Parameter
Name	Description
`output`	`CodedOutputStream`