Oracle Java Cloud Service REST API

新しいSSH公開鍵の追加

post

/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/credentials/crednames/{credentialName}

指定の資格証明名に新しいSSH公開鍵を追加します。

注意: サポートされている資格証明名はvmspublickeyのみです。

リクエスト

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

application/json

パス・パラメータ

credentialName: 型: string

必須: true

SSH公開鍵を追加する資格証明名。現在使用できる資格証明名はvmspublickeyのみです。
identityDomainId: 型: string

必須: true

Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。
Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
serviceId: 型: string

必須: true

Oracle Java Cloud Serviceインスタンスの名前。

ヘッダー・パラメータ

X-ID-TENANT-NAME: 型: string

必須: true

Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。
Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。

本文パラメータ

リクエスト本文は、SSH公開鍵の名前と値の詳細を定義します。

ルート・スキーマ: addsshkey-postrequest

リクエスト本文は、追加するSSH公開鍵の名前と値を定義します。

プロパティ

public-key: 型: string

必須: true

SSH公開鍵の値と名前。この鍵は、SSHクライアントを使用したOracle Java Cloud Serviceインスタンスへの接続時の認証に使用されます。

レスポンス

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

application/json

202 Response

Accepted. その他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

本文

レスポンス本文には、SSH鍵の追加操作に関する情報が含まれます。

ルート・スキーマ: addsshkey-response

レスポンス本文には、SSH鍵の追加操作に関する情報が含まれます。

プロパティ

status: 型: string

ステータスの説明。たとえば、submitted jobなどです。

例

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行して、指定した資格証明名に対してSSH公開鍵を追加する方法を示しています。

注意:

現在サポートされている資格証明名はvmspublickeyのみです。
この例のコマンドでは、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインまたはテナント名を問い合せるためのOracle Public CloudまたはOracle Cloud MachineのRESTサーバーです。 Oracle Public CloudまたはOracle Cloud Machineに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。

cURLコマンド

curl -i -X POST -u username:userPassword1! -d @addsshkeyjson.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/credentials/crednames/vmspublickey

リクエスト本文の例

次の例に、JSON形式のリクエスト本文のコンテンツを示します。

{
  "public-key":"ZYZYBZ3NzaC1yc2EAAAABJQAAAQEAix3Pt+tXlziLKWLyfY2tQUfsuHNvuL9SVeIJSmyqevv4n4AKxZ1wkgXdQmaN7iV2VlTJTf\/rpNAwXGwnSQr7GyGZv4udkyKqyBummnAnVNMPirCBr8scQPCfGB2rjVmfwgNK6TVtAD1t+uDhVIHEf9Jb05v940Abt9\/u5MFkxxoldQy6rRxgky3ZYstU72NOpiwmptYL5CDu3aPljZsx\/raKQACsU0qi3sCzLD76tK4sp+8BTkGBQIIJxa1zqdFHQzQmr2tcf8D6E4sauMqCpXGzLoxgrLMPtHfwkDsAaOc2VPVKafqHgKssbEFRrUclJHy3z9loYV6RzPABQpEEee== rsa-key-20166666"
}

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

次にレスポンス・ヘッダーの例を示します。 Locationヘッダーは、ジョブのステータスにアクセスする際に使用できるRESTリソースを返します。

HTTP/1.1 202 Accepted
Date: Tue, 19 Apr 2016 22:00:41 GMT
Transfer-Encoding: chunked
Location: https://rest_server_url/paas/api/v1.1/activitylog/ExampleIdentityDomain/job/8722
Content-Type: application/json

レスポンス本文の例

次の例では、JSON形式で返されるレスポンスを示しています。

{
   "status":"submitted job"
}