Gunther Oracle APEX und Datenbank Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
=====curl / wget in der Powershell - Testen von ORDS Webservices in der Powershell über die Console=====

Unter Linux läßt sich eine Webseite mit [[https://ss64.com/bash/curl.html|curl]] oder [[https://www.gnu.org/software/wget/|wget]] sehr einfach abfragen.

In der Powershell können dafür zwei Aufruf für das Testen von REST Services aufgerufen werden:

  * Invoke-WebRequest (iwr/curl/wget) => Alle Details , gut zum Debug
  * Invoke-RestMethod (irm)           => Genau die Anwort des Service, gut für die Integration von REST Aufrufen in eigene Skripte


===Invoke-WebRequest===


curl/wget sind als Alias für das cmdlet "Invoke-WebRequest" hinterlegt.

Beispiel für einen sehr einfachen REST Aufruf mit GET um die Version der API abzufragen:
<code powershell>
Invoke-WebRequest -Uri http://127.0.0.1:9090/ords/gpi/api/version/


StatusCode        : 200
StatusDescription : OK
Content           : {"version":"1"}
RawContent        : HTTP/1.1 200 OK
                    Transfer-Encoding: chunked
                    Content-Type: application/json
                    Date: Sun, 21 Oct 2018 16:31:26 GMT
                    ETag: "Aj/F2I7I9tJv0HnVQVyQNka0ylNOD1DCJwMt77AHjZzC59+Udn0CKuCUb0NwiXOcT3nwWkl0nUj+Pyc...
Forms             : {}
Headers           : {[Transfer-Encoding, chunked], [Content-Type, application/json], [Date, Sun, 21 Oct 2018 16:31:26 GMT], [ETag,
                    "Aj/F2I7I9tJv0HnVQVyQNka0ylNOD1DCJwMt77AHjZzC59+Udn0CKuCUb0NwiXOcT3nwWkl0nUj+Pyc4zMU0Ow=="]}
Images            : {}
InputFields       : {}
Links             : {}
ParsedHtml        : mshtml.HTMLDocumentClass
RawContentLength  : 15

</code>


===Invoke-RestMethod===

In der Powershell steht einem dafür **"Invoke-RestMethod"** bzw als alias **"irm"** zur Verfügung.


Beispiel für einen sehr einfachen REST Aufruf mit GET um die Version der API abzufragen:
<code powershell>
Invoke-RestMethod -Uri http:\\localhost:9090  

version
-------
1

</code>

==== REST Service abfragen ====


Beim Abfragen eines Webservice, zum Beispiel vom ORDS => [[prog:ords_rest_service|Oracle ORDS 3.0 REST API nativ verwenden]] ist die Verwendung dieses Befehls sehr praktisch, ein Json Record wird gleich als Tabelle dargestellt.

<code powershell>

irm -Uri http://127.0.0.1:9090/ords/gpi/api/version/

version
-------
1

</code>

----

==== Optionen===

===Invoke-RestMethod bzw. irm===

<code powershell>
help irm

NAME
    Invoke-RestMethod

SYNTAX
    Invoke-RestMethod [-Uri] <uri> [-Method {Default | Get | Head | Post | Put | Delete | Trace | Options | Merge | Patch}] [-UseBasicParsing] [-WebSession <WebRequestSession>] [-SessionVariable <string>]
    [-Credential <pscredential>] [-UseDefaultCredentials] [-CertificateThumbprint <string>] [-Certificate <X509Certificate>] [-UserAgent <string>] [-DisableKeepAlive] [-TimeoutSec <int>] [-Headers <IDictionary>]
    [-MaximumRedirection <int>] [-Proxy <uri>] [-ProxyCredential <pscredential>] [-ProxyUseDefaultCredentials] [-Body <Object>] [-ContentType <string>] [-TransferEncoding {chunked | compress | deflate | gzip |
    identity}] [-InFile <string>] [-OutFile <string>] [-PassThru]  [<CommonParameters>]


ALIASES
    irm


REMARKS
    Get-Help cannot find the Help files for this cmdlet on this computer. It is displaying only partial help.
        -- To download and install Help files for the module that includes this cmdlet, use Update-Help.
        -- To view the Help topic for this cmdlet online, type: "Get-Help Invoke-RestMethod -Online" or
           go to https://go.microsoft.com/fwlink/?LinkID=217034.



</code>

===Invoke-WebRequest bzw. curl/wegt===

<code powershell>
help curl

NAME
    Invoke-WebRequest

SYNTAX
    Invoke-WebRequest [-Uri] <uri> [-UseBasicParsing] [-WebSession <WebRequestSession>] [-SessionVariable <string>] [-Credential <pscredential>] [-UseDefaultCredentials] [-CertificateThumbprint <string>]
    [-Certificate <X509Certificate>] [-UserAgent <string>] [-DisableKeepAlive] [-TimeoutSec <int>] [-Headers <IDictionary>] [-MaximumRedirection <int>] [-Method {Default | Get | Head | Post | Put | Delete | Trace |
    Options | Merge | Patch}] [-Proxy <uri>] [-ProxyCredential <pscredential>] [-ProxyUseDefaultCredentials] [-Body <Object>] [-ContentType <string>] [-TransferEncoding {chunked | compress | deflate | gzip |
    identity}] [-InFile <string>] [-OutFile <string>] [-PassThru]  [<CommonParameters>]


ALIASES
    iwr
    wget
    curl


REMARKS
    Get-Help cannot find the Help files for this cmdlet on this computer. It is displaying only partial help.
        -- To download and install Help files for the module that includes this cmdlet, use Update-Help.
        -- To view the Help topic for this cmdlet online, type: "Get-Help Invoke-WebRequest -Online" or
           go to https://go.microsoft.com/fwlink/?LinkID=217035.


</code>

----

==== Quellen ====

  * https://docs.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Utility/Invoke-RestMethod?view=powershell-3.0
  * https://docs.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Utility/invoke-webrequest?view=powershell-3.0