3.6.5.2 GET
The URL specified by the client in the HTTP request line of the GET request identifies a "configuration point" targeted for the client. The server can have multiple configuration points and different configuration points can have different access permissions associated with them. For example, some configuration points require HTTP access authentication (as specified in [RFC2616] section 11). Or, a configuration point could allow only clients that connect from a specific IP address.
The syntax of the GetConfiguration request is defined as follows.
-
DSC-GetConfiguration-Request = DSC-GetConfiguration-Req-Line DSC-GetConfigurationSetReq-Headers DSC-GetConfiguration-Req-Line = "GET" SP Request-URI SP HTTP-Version CRLF Request-URI = Request-URI-Start DSC-GetConfigurationRequest-URI-End DSC-GetConfigurationSetReq-Headers = *( DSC-GetConfigurationSetReq-Header-REQ / DSC-GetConfigurationSetReq-Header-OPT ) DSC-GetConfigurationSetReq-Header-REQ = Host ; section 14.23 of [RFC2616] DSC-GetConfigurationSetReq-Header-OPT = Connection ; section 14.10 of [RFC2616] / ConfigurationName ; section 2.2.2.4 DSC-GetConfigurationRequest-URI-End = "Nodes(AgentId=" SQUOTE AGENTID SQUOTE RBRACKET FSLASH (ConfigurationName=" SQUOTE CONFIGURATIONNAME SQUOTE RBRACKET FSLASH "ConfigurationContent" SQUOTE = %x27 ; ' (Single Quote) RBRACKET = %x29 ; ) (Closing Bracket) FSLASH = %x2F ; / (Forward Slash) AGENTID = UUID ; as specified in [RFC4122] CONFIGURATIONNAME as defined in section 2.2.2.4
The syntax of the GetConfiguration response is defined as follows:
-
DSC-GetConfiguration-Response = Status-Line DSC-GetConfigurationResp-Headers DSC-GetConfigurationResp-Body DSC-GetConfigurationResp-Headers = *( DSC-GetConfigurationResp-Header-REQ / DSC-GetConfigurationResp-Header-OPT / DSC-GetConfigurationResp-Body) DSC-GetConfigurationResp-Header-REQ = Content-Length ; section 14.13 of [RFC2616] / Content-Type ; section 2.2.2.1.1 / Checksum ; section 2.2.2.2 / ChecksumAlgorithm ; section 2.2.2.3 DSC-GetConfigurationResp-Header-OPT = Server ; section 14.38 of [RFC2616] DSC-GetConfigurationResp-Body = Configuration ; section 3.6.5.2.2
The response message for this operation contains the following HTTP headers.
|
Response header |
Usage |
Value |
|---|---|---|
|
Checksum |
Required |
See section 2.2.2.2. |
|
ChecksumAlgorithm |
Required |
See section 2.2.2.3. |
|
ProtocolVersion |
Required |
See section 2.2.2.5 |
The response message for this method can result in the following status codes.
|
Status code |
Description |
|---|---|
|
200 |
Request completed. |
|
400 |
Bad request. |
|
401 |
Not authorized. |
|
404 |
The resource is not found. |