Get (Metadata Exchange) HTTP 要求とメッセージ

  • [アーティクル]

Get メッセージは、メタデータの要求に使用されるWS-Transferメッセージです。 メッセージの取得の詳細については、 WS-Transfer 仕様のセクション 3.1 を参照してください。 メタデータ交換は HTTP 経由で行われるため、Get メッセージは HTTP 要求のペイロードです。

DPWS クライアントは Get メッセージを送信します。 関数探索クライアント、 WSDCreateDeviceProxy を呼び出す WSDAPI クライアント、および WSDCreateDeviceProxyAdvanced を呼び出す WSDAPI クライアントは、このメッセージを送信します。

Note

このトピックでは、WSDAPI クライアントとホストによって生成された DPWS メッセージの例を示します。 WSDAPI は、このサンプルに準拠していない他の DPWS 準拠メッセージを解析して受け入れます。 このサンプルを使用して DPWS の相互運用性を確認しないでください。代わりに WSDAPI 基本相互運用性ツール (WSDBIT) を使用してください。

 

次の例は、HTTP 要求の取得のサンプルを示しています。

POST /37f86d35-e6ac-4241-964f-1d9ae46fb366
HTTP/1.1
Content-Type: application/soap+xml
User-Agent: WSDAPI
Host: 192.168.0.2:5357
Content-Length: 658
Connection: Keep-Alive
Cache-Control: no-cache
Pragma: no-cache

Get HTTP 要求には、次のフォーカス ポイントがあります。

フォーカス ポイント ヘッダー行 説明
URL パス 
POST /37f86d35-e6ac-4241-964f-1d9ae46fb366
 HTTP 取得要求が投稿された URL パス。
ホストとポート 
Host: 192.168.0.2:5357
 HTTP の取得要求が送信されたホストとポート。

 

次の SOAP メッセージは、Get メッセージのサンプルを示しています。

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope
    xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
    xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing">
<soap:Header>
    <wsa:To>
        urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
    </wsa:To>
    <wsa:Action>
        https://schemas.xmlsoap.org/ws/2004/09/transfer/Get
    </wsa:Action>
    <wsa:MessageID>
        urn:uuid:027bec45-c37c-466c-936c-68f648abe2bb
    </wsa:MessageID>
    <wsa:ReplyTo>
        <wsa:Address>
            https://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous
        </wsa:Address>
    </wsa:ReplyTo>
    <wsa:From>
        <wsa:Address>
            urn:uuid:49e131df-351a-4ece-9a6f-6a862d31cffa
        </wsa:Address>
    </wsa:From>
</soap:Header>
<soap:Body>
</soap:Body>

Get メッセージには、次のフォーカス ポイントがあります。

フォーカス ポイント XML [説明]
終了 
<wsa:To>
    urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
</wsa:To>
 メタデータの要求を受けているデバイスの識別子。
取得 
<wsa:Action>
    https://schemas.xmlsoap.org/ws/2004/09/transfer/Get
GET SOAP アクションは、メッセージを Get メッセージとして識別します。
MessageID 
<wsa:MessageID>
    urn:uuid:027bec45-c37c-466c-936c-68f648abe2bb
GetResponse メッセージで参照されるメッセージ識別子を格納します。

 

検出およびメタデータ交換メッセージ

GetResponse メッセージ