Oracle Cloud Infrastructure Compute ClassicのREST API

ユーザーの認証

post

/authenticate/

注意: このリクエストは、Set-Cookieレスポンス・ヘッダーに認証トークンを返します。トークンは30分後に失効します。サービスへのすべてのリクエストで、有効(つまり、有効期限が切れていない)認証トークンがCookie:レスポンスのヘッダーに含まれている必要があります。 APIコールを発行するクライアントで、cookieの有効期限の時間を確認し、cookieの有効期限が切れている場合は破棄される必要があります。有効期限が切れたcookieを使用してリクエストを送信すると、レスポンスに「Unauthorized」エラーが表示されます。

リクエスト

サポートされるメディア・タイプ

application/oracle-compute-v3+json

リクエスト本文には、ユーザー認証リクエストの詳細が含まれます

ルート・スキーマ : Authenticate

型: object

リクエスト本文には、ユーザー認証リクエストの詳細が含まれます

ソースの表示

password: string(password)

ユーザーのパスワード。
user: string

/Compute-identity_domain/userの形式の、2つの部分からなるユーザーの名前(例: /Compute-acme/joe.jonathan@example.com)

{
    "required":[
        "user",
        "password"
    ],
    "description":"The request body contains details of authenticate user request",
    "properties":{
        "password":{
            "type":"string",
            "description":"The password for the user.",
            "format":"password"
        },
        "user":{
            "type":"string",
            "description":"Two-part name of the user in the format, <code>/Compute-<em>identity_domain</em>/<em>user</em></code> (example: <code>/Compute-acme/joe.jonathan@example.com</code>)"
        }
    }
}

トップに戻る

レスポンス

サポートされるメディア・タイプ

application/oracle-compute-v3+json

204レスポンス

No Content 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

ヘッダー

set-cookie: string

セッションが拡張された場合、Cookie値が返されます。

トップに戻る

例

cURLコマンド

次の例は、cURLを使用してRESTリソースにPOSTリクエストを送信することによって、Compute Classicから認証Cookieを取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを1行で入力します。この例では、読みやすくするために改行が使用されています。

curl -i -X POST
     -H "Content-Type: application/oracle-compute-v3+json"
     -d "@requestbody.json"
        https://api-z999.compute.us0.oraclecloud.com/authenticate/

api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。サイトのRESTエンドポイントURLを見つける方法については、「リクエストの送信」を参照してください。

リクエスト本文の例

Oracleからのアカウント作成メールには、Compute Classicインスタンスのユーザー名とパスワードが含まれています。

この情報がない場合は、サービス管理者に連絡してください。

REST APIを呼び出すときは、あらかじめ定義された形式で2つの部分からなるユーザー名を渡す必要があります。「認証」を参照してください。

注意:

このドキュメントのすべての例では、2つの部分からなるユーザー名として/Compute-acme/jack.jones@example.comを使用しています。 IDCSのクラウド・アカウントを使用している場合は、2部構成のユーザー名のacmeをサービス・インスタンスIDに置き換えます。

次は、requestbody.jsonファイルのリクエスト本文のコンテンツの例です。

{
 "password": "acme2passwrd123",
 "user": "/Compute-acme/jack.jones@example.com"
}

レスポンス・ヘッダーの例

次の例は、レスポンス本文をJSON形式で示しています。

いくつかの行は、読みやすくするために省略記号(...)で切り捨てられます。

HTTP/1.1 204 No Content
Date: Tue, 12 Apr 2016 15:34:52 GMT
Server: nginx
Content-Type: text/plain; charset=UTF-8
X-Oracle-Compute-Call-Id: 16041248df2d44217683a6a67f76a517a59df3
Expires: Tue, 12 Apr 2016 15:34:52 GMT
Cache-Control: no-cache
Vary: Accept
Content-Length: 0
Set-Cookie: nimbula=eyJpZGVudGl0eSI6ICJ7XC...fSJ9; Path=/; Max-Age=1800
Content-Language: en

トップに戻る