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.