HTTP 転送

「 https:// 」

Web Services Proxy では HTTP または HTTPS を使用できます。

組み込みの Web Services にはセキュリティ上の理由から HTTPS が必要です。

ベース URL とポート

webservices.name.com:8443`

各要求は、 Web Services のアクティブなインスタンスに正しくルーティングされる必要があります。インスタンスの完全修飾ドメイン名（ FQDN ）または IP アドレス、およびリスニングポートが必要です。デフォルトでは、 Web Services の通信にはポート 8080 （ HTTP ）とポート 8443 （ HTTPS ）が使用されます。

Web Services Proxy では、どちらのポートもインストール時または wsconfig.xml ファイルで変更可能です。さまざまな管理アプリケーションを実行するデータセンターホストでは、ポートの競合は珍しくありません。

組み込みの Web Services では、コントローラ上のポートは変更できず、デフォルトのポート 8443 を使用してセキュアな接続が確立されます。

API パス

「 devmgr/v2/storage-systems 」と入力します

Web Services API 内の特定の REST リソースまたはエンドポイントに対して要求が送信されます。ほとんどのエンドポイントは次の形式です。

「 devmgr/v2/<resource>/[id]. 」と入力します

API パスは次の 3 つの部分で構成されます。

200 OK

処理に成功したことを示します。

はい。

201 が作成されました

オブジェクトが作成されたことを示します。このコードは、ステータス 200 ではなく、ごくまれに使用されます。

はい。

202 受け付けました

要求は非同期要求としての処理を承認されましたが、実際の結果を取得するには以降の要求が必要です。

はい。

203 信頼できない情報

200 と同様ですが、 Web Services はデータが最新であることを保証できません（この時点でキャッシュされたデータのみが利用可能な場合など）。

はい。

204 コンテンツなし

処理は成功しましたが、応答の本文はありません。

いいえ

400 不正な要求です

要求の JSON 本文が無効です。

いいえ

401 認証なし

認証エラーが発生したことを示します。クレデンシャルが指定されていないか、ユーザ名またはパスワードが無効です。

いいえ

403 禁止

認証に失敗したことを示します。認証されたユーザに要求したエンドポイントにアクセスする権限がありません。

いいえ

404 が見つかりません

要求されたリソースが見つからなかったことを示します。このコードは、識別子で要求された API やリソースが存在しない場合に使用されます。

いいえ

422 加工不能エンティティ

要求の形式には問題はありませんが、入力パラメータが無効であるか、ストレージシステムの状態が原因で Web Services が要求を実行できません。

はい。

424 依存関係に失敗しました

Web Services Proxy では、要求されたストレージシステムに現在アクセスできないことを示すために使用されます。そのため、 Web Services は要求を満たすことができません。

いいえ

429 リクエストが多すぎます

要求の上限を超えたため、あとで再試行する必要があります。

いいえ