§8.26.

SUBSCRIBE_ANNOUNCES_ERROR

A publisher sends a SUBSCRIBE_ANNOUNCES_ERROR control message in response to a failed SUBSCRIBE_ANNOUNCES.

SUBSCRIBE_ANNOUNCES_ERROR Message {
  Type (i) = 0x13,
  Length (i),
  Request ID (i),
  Error Code (i),
  Error Reason (Reason Phrase)
}
Figure 28: MOQT SUBSCRIBE_ANNOUNCES_ERROR Message
  • Request ID: The Request ID of the SUBSCRIBE_ANNOUNCES this message is replying to Section 8.24.

  • Error Code: Identifies an integer error code for the namespace subscription failure.

  • Error Reason: Provides the reason for the namespace subscription error. See Section 1.3.3.

The application SHOULD use a relevant error code in SUBSCRIBE_ANNOUNCES_ERROR, as defined below:

Table 8
Code Reason
0x0 Internal Error
0x1 Unauthorized
0x2 Timeout
0x3 Not Supported
0x4 Namespace Prefix Unknown
0x5 Namespace Prefix Overlap
0x10 Malformed Auth Token
0x11 Unknown Auth Token Alias
0x12 Expired Auth Token
  • Internal Error - An implementation specific or generic error occurred.

  • Unauthorized - The subscriber is not authorized to subscribe to the given namespace prefix.

  • Timeout - The operation could not be completed before an implementation specific timeout.

  • Not Supported - The endpoint does not support the SUBSCRIBE_ANNOUNCES method.

  • Namespace Prefix Unknown - The namespace prefix is not available for subscription.

  • Namespace Prefix Overlap - The namespace prefix overlaps with another SUBSCRIBE_ANNOUNCES in the same session.

  • Malformed Auth Token - Invalid Auth Token serialization during registration (see Section 8.2.1.1).

  • Unknown Auth Token Alias - Authorization Token refers to an alias that is not registered (see Section 8.2.1.1).

  • Expired Auth Token - Authorization token has expired Section 8.2.1.1).

This is one section of the MoQT specification, rendered per-section for quick reference and citation. The authoritative text is draft-ietf-moq-transport-11 at the IETF.