新しいSSH公開鍵の追加
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/credentials/crednames/{credentialName}
注意: サポートされている資格証明名は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 ResponseAccepted. その他の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" }