ECS：API curlコマンドの使用方法

このナレッジベース記事では、ECS APIの使用にcurlコマンドを使用する方法について説明します。

『ECS管理ガイド』や『データ アクセス ガイド』などのユーザー ガイドには、curlコマンドを使用したAPIの使用例が記載されています

curlコマンドを使用してAPIでGETおよびPUTを実行する方法が表示されます。この例では、KB ECSごとのLDAPS証明書APIは 次のようになります。ECSでLDAPSを介してすべての証明書をセットアップして受け入れる方法。

Curlの例 - LDAPS証明書APIの例:
LDAPS証明書APIは管理IPを使用し、emcmonitorアクセスは許可せず、代わりにrootユーザーを許可します。これはECS APIの使用例で、LDAPS証明書APIは "/vdc/truststore"の詳細を確認してください。お使いの API は異なり、場所も異なる場合があります

LDAPS証明書の設定に関するECS設定を確認するには、まず使用するノード管理IPを取得します。UI管理にネットワーク分離がある場合は、getrackinfo -n" には "mgmt" 値があります。次の手順では、ノードのpublic.mgmt IPアドレスを使用します。レプリケーションとデータ ネットワークの分離は必要ありません。

# getrackinfo -n
Named networks
==============
Node ID       Network          Ip Address        Netmask            Gateway            VLAN               Interface
1            repl              10.xxx.xxx.11     255.255.254.0      xxx.xxx.xxx.xxx    14                 public
1            mgmt              10.xxx.xxx.21     255.255.254.0      xxx.xxx.xxx.xxx    13                 public
1            data              10.xxx.xxx.31     255.255.254.0      xxx.xxx.xxx.xxx    15                 public
2            repl              10.xxx.xxx.12     255.255.254.0      xxx.xxx.xxx.xxx    14                 public
2            mgmt              10.xxx.xxx.22     255.255.254.0      xxx.xxx.xxx.xxx    13                 public
2            data              10.xxx.xxx.32     255.255.254.0      xxx.xxx.xxx.xxx    15                 public
3            repl              10.xxx.xxx.13     255.255.254.0      xxx.xxx.xxx.xxx    14                 public
3            mgmt              10.xxx.xxx.23     255.255.254.0      xxx.xxx.xxx.xxx    13                 public
3            data              10.xxx.xxx.33     255.255.254.0      xxx.xxx.xxx.xxx    15                 public
4            repl              10.xxx.xxx.14     255.255.254.0      xxx.xxx.xxx.xxx    14                 public
4            mgmt              10.xxx.xxx.24     255.255.254.0      xxx.xxx.xxx.xxx    13                 public
4            data              10.xxx.xxx.34     255.255.254.0      xxx.xxx.xxx.xxx    15                 public

VDCにネットワークpublic.mgmtの分離がない場合は、代わりにノードのパブリックIPアドレスを使用します。public.mgmtネットワーク分離アドレスが設定されている場合は、優先されることに注意してください。

# getrackinfo
Node private      Node              Public                                  BMC
Ip Address        Id       Status   Mac                 Ip Address          Mac                 Ip Address          Node Name
===============   ======   ======   =================   =================   =================   =================   =========
192.1XX.2XX.1     1        MA       a4:bf:xx:xx:xx:74   10.xx.xx.1          a4:bf:xx:xx:xx      192.1XX.2XX.101     provo-red
192.1XX.2XX.2     2        SA       a4:bf:xx:xx:xx:c8   10.xx.xx.2          a4:bf:xx:xx:xx      192.1XX.2XX.102     sandy-red
192.1XX.2XX.3     3        SA       a4:bf:xx:xx:xx:e0   10.xx.xx.3          a4:bf:xx:xx:xx      192.1XX.2XX.103     orem-red
192.1XX.2XX.4     4        SA       a4:bf:xx:xx:xx:56   10.xx.xx.4          a4:bf:xx:xx:xx      192.168.219.104     ogden-red

取得した管理IPアドレスを使用してrootユーザー トークンを取得します。rootユーザーのパスワードが必要です。

# curl -s -k -v -u root https://<NodeManagementIP>:4443/login 2>&1

Example:

# curl -s -k -v -u root https://10.xxx.xxx.21:4443/login 2>&1
Enter host password for user 'root':
......

< HTTP/1.1 200 OK
< Date: Thu, 14 Jan 2021 13:51:24 GMT
< Content-Type: application/xml
< Content-Length: 93
< Connection: keep-alive
< X-SDS-AUTH-TOKEN: BAAcdWhGbnVRVjd1WlpmR0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAgAC0A8=
< X-SDS-AUTH-USERNAME: root
< X-SDS-AUTH-MAX-AGE: 28800
<
* Connection #0 to host 10.xxx.xxx.21 left intact
root

出力が「HTTP/1.1 200 OK」でない場合は、パスワードとIPアドレスを確認し、コマンド「getrackinfo -n」。rootユーザー トークンを使用してトークン変数を作成し、新しいCLIセッションで次の場合に有効なトークンを更新する必要があります。

# export TOKEN='X-SDS-AUTH-TOKEN: BAAcdWhGbnVRVjd1WlpmR0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAgAC0A8='

トークンが有効であることをテストするには、curlコマンドを実行できます。

# curl -k -X GET -H "$TOKEN"  https://10.xxx.xxx.21:4443/object/capacity  | xmllint --format -        
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                               Dload  Upload   Total   Spent    Left  Speed
100   176  100   176    0     0    249      0 --:--:-- --:--:-- --:--:--   250

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<cluster_capacity>
  <totalFree_gb>100657</totalFree_gb>
  <totalProvisioned_gb>447005</totalProvisioned_gb>
</cluster_capacity>

上記の手順の目的は、rootユーザー トークンを使用してECS UIトラストストアへのcurlアクセスを取得することです。「カスタムLDAP証明書の追加」の詳細については、『ECS管理者ガイド』を参照してください。このECS APIの使用例では、LDAPS証明書APIは "/vdc/truststore"の詳細を確認してください。API は別の場所にある可能性があります。

Curl GETの例:

curl GETコマンドを使用してトラストストア設定を取得します。

# curl -s -k -X GET -H Content-Type:application/json -H "$TOKEN" -H ACCEPT:application/json https://<NodeManagementIP>:4443/vdc/truststore/settings

Example:

# curl -s -k -X GET -H Content-Type:application/json -H "$TOKEN" -H ACCEPT:application/json https://10.xxx.xxx.21:4443/vdc/truststore/settings
{"accept_all_certificates":false}

上記の例では、トラストストア "accept_all_certificates" は false に設定されています。つまり、アップロードされたLDAPS証明書のうちAD/LDAPサーバー証明書と一致するもののみが、ECSによって信頼されることが許可されます。ユーザーは、必要に応じてこれをtrueまたはfalseに設定できます。LDAPS接続をテストするには、trueに設定し、ユーザー ログインをテストすることで、LDAPS接続を検証できます

jsonファイルを作成して、jsonペイロードを使用したcurlコマンドでトラストストア設定を変更します。

# sudo vi truststoresettings.json
# sudo cat truststoresettings.json
{"accept_all_certificates": "true"}

Python の json.tool モジュールでは、json ファイル形式を検証できます。エラーが発生した場合、ファイルはjsonファイルではない可能性があります。この例では、エラーが発生せず、ファイルが出力されるため、これはフォーマットされたjsonファイルです。

# python -m json.tool truststoresettings.json
{
    "accept_all_certificates": "true"
}

Curl PUTの例:

curl PUTコマンドを使用して、ペイロードとしてjsonファイルを含むcurlコマンドを実行します。

# curl -s -k -X PUT -H Content-Type:application/json -H "$TOKEN" -H ACCEPT:application/json https://:4443/vdc/truststore/settings -d @truststoresettings.json

アップデートされていることを確認するには、curl GETコマンドを実行します。

# curl -s -k -X GET -H Content-Type:application/json -H "$TOKEN" -H ACCEPT:application/json https://10.xxx.xxx.21:4443/vdc/truststore/settings
{"accept_all_certificates":true}