API 管理

認証

POST メソッドを使用して認証を行うには、認証コマンド・ターゲット (auth) を使用します。このプロセスでは、ヘッダー・フィールド X-Auth-Username および X-Auth-Password にユーザー名とパスワードを指定します。セッションの先頭は、ユーザー名とパスワードの入力が必要な唯一のインスタンスです。ユーザー名とパスワードが正常に入力されると、認証トークンが表示されます。このトークンは 32 桁の 16 進コードで、X-Auth-Token ヘッダーを使用して将来のコマンドに組み込みます。X-Auth-Token ヘッダーと認証トークンを組み合わせて、各アクションに対するユーザー名とパスワードの代わりに使用することができます。このトークンは 1 つのセッションには適していますが、アクティブ状態が 2 時間、あるいは非アクティブ状態が 30 分間経過すると、そのセッションはタイムアウトになります。新たなトークンを使用するには、認証を繰り返してください。

システム認証について詳しくは、認証の概要を参照してください。