Share via

2.2.1.2 Request Headers

  • Article

The following HTTP/1.1 headers are provided by clients in HTTP requests to the Network Controller, in addition to the existing set of standard HTTP headers.

Header

Section

Type

Description

Accept-Language

2.2.1.2.1

Optional

The language in which error messages are returned.

Content-Type

2.2.1.1

Required or Optional

The content type of the payload.
Mandatory for PUT, MUST be "application/json; charset=UTF-8". Optional for GET or DELETE.

if-match

2.2.1.2.2

Optional

An etag that can be obtained by executing a GET command on a resource or collection of resources, or an etag that is contained in the output of a PUT or PATCH command.

Referrer

2.2.1.2.3

Optional

Specifies the hostname of the computer of the end user.

x-ms-client-ip-address

2.2.1.2.4

Optional

IP address of the client. This is recorded in the tracing logs for every Network Controller Northbound operation for audit.

x-ms-client-request-id

2.2.1.2.5

Optional

A unique ID provided by the client that the service uses to identify the specific request.

x-ms-return-client-request-id

2.2.1.2.6

Optional

Determines whether the Network Controller will echo the x-ms-client-request-id.