Retrieve the SSH Key Description Using Query Parameters
/paas/api/v1.1/instancemgmt/{domainName}/services/SOA/credentials/crednames
- Use the
?credname
query parameter to retrieve results for a given credential name. - Use the
?serviceName
query parameter to retrieve results for a given Oracle SOA Cloud Service instance.
Note the following:
- By default, 50 keys are returned by a given query. Use the
?limitRowCount
query parameter to control the page size (number of results returned in a single request). - Use the
?offset
query parameter to fetch additional results, if available. By default,offset
is 0 (zero).
Request
-
domainName: string
Identity domain ID for the Oracle SOA Cloud Service account.
-
credname(optional): string
Unique credential name.
Note:
vmspublickey
is the only supported credential name. This is the default if a credential name is not supplied. -
serviceName(optional): string
Name of the Oracle SOA Cloud Service instance. If a service name is not supplied, the request will return all service instances for the given identity domain ID.
-
X-ID-TENANT-NAME: string
Identity domain ID for the Oracle SOA Cloud Service account.
Response
- application/json
200 Response
object
-
canonicalUrl:
string
URL to query the credential key value.
-
credName:
string
Credential name. Currently, the only supported credential name is
vmspublickey
. -
credType:
string
Credential type. Only supported value is
SSH
. -
description:
string
Credential description of the given credential name.
-
hasMore:
boolean
Flag that specifies whether the list returned by the query is full (
false
) or partial (true
).When the list is partial, use the
offset
query parameter to fetch additional results. By default,offset
is 0 (zero) andlimitRowCount
is 50. -
identityDomain:
string
Identity domain ID for the Oracle SOA Cloud Service account.
-
items:
string
Groups credential description details returned by the query.
-
serviceName:
string
Name of the Oracle SOA Cloud Service instance.
-
serviceType:
string
Cloud service type. Valid value is
jaas
for Oracle SOA Cloud Service. -
totalResults:
integer
Number of results returned by the query.
Examples
The following example shows how to retrieve SSH key descriptions by using query parameters in a GET request on the REST resource using cURL.
-
Currently, the only supported credential name is
vmspublickey
. -
The command in this example uses the URL structure
https://rest_server_url/resource-path
, whererest_server_url
is the REST server to contact for your identity domain (or Cloud account). See Send Requests.
cURL Command
curl -i -X GET -u username:Password! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" "https://rest_server_url/paas/api/v1.1/instancemgmt/{domainName}/services/SOA/credentials/crednames?credname=vmspublickey&serviceName=ExampleInstance"
Example of Response Header
The following example shows the response header.
HTTP/1.1 200 OK
Date: Tue, 30 Aug 2021 02:09:24 GMT
Transfer-Encoding: chunked
Content-Type: application/json
Example of Response Body
The following example shows the response returned in JSON format for a given credential name and service name.
{
"items":[
{
"identityDomain":"ExampleIdentityDomain",
"serviceType":"SOA",
"serviceName":"ExampleInstance",
"credName":"vmspublickey",
"credType":"SSH",
"description":"Service user ssh public key which can be used to access the service VM instances",
"canonicalUrl":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomain\/service\/SOA\/instances\/ExampleInstance\/credentials\/crednames\/vmspublickey"
}],
"hasMore":false,
"totalResults":1
}