17.5　初期設定に必要なファイルをアップロードする

ストレージシステムとSyslog サーバ間でSSL通信を行う場合、このAPIを実行して、SSL通信で使用する証明書ファイルをストレージシステムにあらかじめアップロードしておきます。そのあと、監査ログの転送先を設定するAPIを実行すると、アップロードした証明書ファイルを通信時に使用するようストレージシステムに設定されます。

重要

• 1回のリクエストで1ファイルだけアップロードできます。
• すでに同じfileType属性のファイルがアップロードされている場合は、あとからアップロードしたファイルで上書きされます。

実行権限

監査ログ管理者（参照・編集）

リクエストヘッダ

このAPIでは、リクエストボディをmultipart/form-data形式で送信します。リクエストヘッダのContent-Typeにはmultipart/form-dataを指定してください。

リクエストライン

POST ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/actions/file-upload/invoke

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

なし。

ボディ

属性	型	説明
fileType	string	（必須）アップロードするファイルの種類 指定できる値を次に示します。 AuditSyslogPrimaryClientCertFile：監査ログ転送先syslog サーバのクライアント証明書ファイル（プライマリサーバ用） AuditSyslogPrimaryRootCertFile：監査ログ転送先syslog サーバのルート証明書ファイル（プライマリサーバ用） AuditSyslogSecondaryClientCertFile：監査ログ転送先syslog サーバのクライアント証明書ファイル（セカンダリサーバ用） AuditSyslogSecondaryRootCertFile：監査ログ転送先syslog サーバのルート証明書ファイル（セカンダリサーバ用）
file	file	（必須）アップロードするファイル 使用できる文字列は次のとおりです。 半角スペース 半角英数字 次の記号 ! " # $ % & ' ( ) * + , - . : ; < = > ? @ [ \ ] ^ _ ` { | } ~

レスポンスメッセージ

ボディ

なし。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

HTTPステータスコード502が返る場合、ファイルが正しく指定されていることを確認してから、再度実行してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type: multipart/form-data" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X POST -F "file=@C:\certfile.crt" -F "fileType=AuditSyslogPrimaryClientCertFile" https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/actions/file-upload/invoke

Content-Typeがmultipart/form-dataのリクエストを実行すると、クライアントソフトウェアの仕様によっては、自動的にExpect: 100-continueがヘッダに付与されることがあります。ストレージシステムがVSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合、Webサーバの仕様によってはこのヘッダを受け付けず、417エラーでリクエストが失敗することがあります。次のコード例では、このエラーを回避するために、自動的に付与されるヘッダを上書きするようにExceptヘッダに-H "Expect:"を指定しています。

curl -v -H "Accept:application/json" -H "Content-Type: multipart/form-data" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -H "Expect:" -X POST -F "file=@C:\certfile.crt" -F "fileType=AuditSyslogPrimaryClientCertFile" https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/actions/file-upload/invoke