Edge for Private Cloud Version 4.16.09
Verwenden Sie apigee-adminapi.sh um dieselben Edge-Konfigurationsaufgaben auszuführen, die Sie durch Aufrufen an den Edge- Management API Der Vorteil des Dienstprogramms apigee-adminapi.sh besteht darin, dass es:
- Einfache Befehlszeile verwenden
- Implementiert tabellarische Befehlsvervollständigung
- Bietet Hilfe und Informationen zur Nutzung
- Kann den entsprechenden API-Aufruf anzeigen, wenn Sie die API ausprobieren möchten
Das Dienstprogramm apigee-adminapi.sh ist kein Ersatz für das Dienstprogramm apigee-provision. Das Dienstprogramm apigee-provision verwendet tatsächlich die apigee-adminapi.sh um ihre Aufgaben auszuführen.
Die Hauptunterschiede zwischen den beiden sind folgende:
- Das Dienstprogramm apigee-adminapi.sh führt atomare Funktionen aus, die einzelne Edge API-Aufrufe ersetzen. Um beispielsweise eine Organisation, Umgebung und virtueller Host erfordern drei separate apigee-adminapi.sh-Befehle drei API-Aufrufen entspricht.
- Die apigee-provision ist darauf ausgelegt, einen vollständigen übergeordneten Vorgang in einem einzigen Befehl auszuführen. Für Sie können eine Organisation, Umgebung und einen virtuellen Host mit einem einzigen apigee-provision-Befehl durch und übergeben eine Konfigurationsdatei mit allen notwendigen Informationen.
Die Edge-Dokumentation verwendet gegebenenfalls beide Dienstprogramme.
apigee-adminapi.sh installieren
Das Dienstprogramm apigee-adminapi.sh ist automatisch installiert, wenn Sie das Dienstprogramm apigee-provision oder apigee-validate installieren.
Das Dienstprogramm wird unter folgendem Pfad installiert:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh
Syntax von apigee-adminapi.sh
Das Dienstprogramm apigee-adminapi.sh eine einfache Befehlszeilensyntax verwendet. Sie können jederzeit die Tabulatortaste drücken, um eine Aufforderung anzuzeigen, in der die verfügbaren Befehlsoptionen.
Um alle möglichen Befehle anzuzeigen, rufen Sie das Dienstprogramm ohne Optionen auf:
> apigee-adminapi.sh
Wenn Sie nach der Eingabe von apigee-adminapi.sh die Tabulatortaste drücken, wird die Liste der möglichen Optionen:
analytics classification logsessions regions securityprofile userroles buildinfo GET orgs runtime servers users
Mit der Tabulatortaste werden Optionen basierend auf dem Kontext des Befehls angezeigt. Wenn Sie die Tabulatortaste nach der Eingabe:
> apigee-adminapi.sh orgs
Sie sehen dann die möglichen Optionen zum Ausführen des Befehls orgs:
add apis apps delete envs list pods userroles
Mit der Option -h können Sie Hilfe bei jedem Befehl. Wenn Sie beispielsweise die Option -h verwenden, wie unten gezeigt:
> apigee-adminapi.sh orgs -h
Das Dienstprogramm zeigt vollständige Hilfeinformationen zu allen möglichen Optionen für den Befehl orgs an. Das erste Element in der Ausgabe zeigt die Hilfe zu orgs add an. Befehl:
+++++++++++++++++++++++++++++++++++++++++++ orgs add Required: -o ORG Organization name Optional: -H HEADER add http header in request --admin ADMIN_EMAIL admin email address --pwd ADMIN_PASSWORD admin password --host EDGE_SERVER edge server to make request to --port EDGE_PORT port to use for the http request --ssl set EDGE_PROTO to https, defaults to http --debug ( set in debug mode, turns on verbose in curl ) -h Displays Help
Parameter festlegen mit Befehlszeilen-Switches und Umgebungsvariablen verwenden,
Sie müssen alle Parameter in einen Befehl eingeben, indem Sie entweder Befehlszeilen-Switches oder Umgebungsvariablen. Stellen Sie den Befehlszeilenschaltern einen einfachen Bindestrich (-) oder einen doppelten Bindestrich voran (--) nach Bedarf.
In der Hilfe oben für „orgs add“ finden Sie können Sie den Parameter Name der Organisation entweder
- -o-Befehlszeile verwenden
Schalter:
> Apigee-adminapi.sh Organisationen -o testOrg - So legen Sie eine Umgebungsvariable namens ORG fest:
> ORG=testOrg
exportieren > Apigee-adminapi.sh-Organisationen
Wenn Sie erforderliche Parameter für den Befehl weglassen, zeigt das Dienstprogramm eine Fehlermeldung an. und beschreiben die fehlenden Parameter. Wenn Sie beispielsweise die Umgebungsvariable --host oder EDGE_SERVER weglassen, wenn Sie eine Organisation erstellen, wird die folgende Fehlermeldung angezeigt:
Error with required variable or parameter ADMIN_PASSWORD....OK ADMIN_EMAIL....OK EDGE_SERVER....null
Zwei häufige Parameter, die Sie häufig als Umgebungsvariablen festlegen, sind die E-Mail-Adresse des Systemadministrators. und IP-Adresse des Verwaltungsservers:
> export ADMIN_EMAIL=foo@bar.com > export EDGE_SERVER=192.168.56.101
Datei an apigee-adminapi.sh übergeben Dienstprogramm
Einige Befehle des Dienstprogramms apigee-adminapi.sh PUT- und POST API-Aufrufen entsprechen, die einen Anfragetext annehmen. Wenn Sie zum Beispiel ein virtuelles Host entspricht einem POST API-Aufruf, der Informationen über den virtuellen Host im Anfragetext.
Wenn Sie das Dienstprogramm apigee-adminapi.sh für oder einen Befehl erstellen, der einen Anfragetext annimmt, können Sie alle die erforderlichen Informationen in die Befehlszeile ein, wie unten gezeigt:
> apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -v myVHostUtil -p 9005 -a 192.168.56.101:9005
Alternativ können Sie eine Datei übergeben, die dieselben Informationen enthält wie in der Anfrage enthalten wäre. Textkörper der POST-Anfrage. Der folgende Befehl verwendet beispielsweise eine Datei, die den virtuellen Host definiert:
> apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -f vhostcreate
wobei die Datei vhostcreate enthält den POST-Hauptteil des Aufrufs. In diesem Beispiel ist es ein XML-formatierter Anfragetext:
<VirtualHost name="myVHostUtil">
<HostAliases>
<HostAlias>192.168.56.101:9005</HostAlias>
</HostAliases>
<Interfaces/>
<Port>9005</Port>
</VirtualHost>
Debug- und API-Informationen anzeigen
Verwenden Sie die Option --debug, um das Dienstprogramm apigee-adminapi.sh um detaillierte Informationen zum Befehl anzuzeigen. Zu diesen Informationen gehört auch der cURL-Befehl, die vom Dienstprogramm apigee-adminapi.sh generiert werden, um den Vorgang auszuführen.
Im folgenden Befehl wird beispielsweise die Option --debug verwendet:
> apigee-adminapi.sh orgs add -o testOrg2 --admin foo@bar.com --host localhost --debug
Außerdem wird die folgende Ausgabe angezeigt, einschließlich des generierten cURL-Befehls:
curl -H Content-Type: application/xml -v -X POST -s -k -w \n==> %{http_code} -u ***oo@bar.com:***** http://localhost:8080/v1/o -d <Organization name="testOrg2" type="paid"/> * About to connect() to localhost port 8080 (#0) * Trying ::1... connected * Connected to localhost (::1) port 8080 (#0) * Server auth using Basic with user 'foo@bar.com' > POST /v1/o HTTP/1.1 > Authorization: Basic c2dp234234NvbkBhcGlnZ2342342342342341Q5 > User-Agent: curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.19.1 Basic ECC zlib/1.2.3 libidn/1.18 libssh2/1.4.2 > Host: localhost:8080 > Accept: */* > Content-Type: application/xml > Content-Length: 43 > } [data not shown] < HTTP/1.1 201 Created < Content-Type: application/json < Date: Tue, 03 May 2016 02:08:32 GMT < Content-Length: 291 < { [data not shown] * Connection #0 to host localhost left intact * Closing connection #0