GetDataSetDetails
Gets the details of a specific data set.
Request Syntax
GET /applications/applicationId/datasets/dataSetName HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- applicationId
-
The unique identifier of the application that this data set is associated with.
Pattern:
^\S{1,80}$Required: Yes
- dataSetName
-
The name of the data set.
Pattern:
^\S{1,200}$Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"blocksize": number,
"creationTime": number,
"dataSetName": "string",
"dataSetOrg": { ... },
"fileSize": number,
"lastReferencedTime": number,
"lastUpdatedTime": number,
"location": "string",
"recordLength": number
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- blocksize
-
The size of the block on disk.
Type: Integer
- creationTime
-
The timestamp when the data set was created.
Type: Timestamp
- dataSetName
-
The name of the data set.
Type: String
Pattern:
^\S{1,200}$ - dataSetOrg
-
The type of data set. The only supported value is VSAM.
Type: DatasetDetailOrgAttributes object
Note: This object is a Union. Only one member of this object can be specified or returned.
- fileSize
-
File size of the dataset.
Type: Long
- lastReferencedTime
-
The last time the data set was referenced.
Type: Timestamp
- lastUpdatedTime
-
The last time the data set was updated.
Type: Timestamp
- location
-
The location where the data set is stored.
Type: String
Pattern:
^\S{1,2000}$ - recordLength
-
The length of records in the data set.
Type: Integer
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
The account or role doesn't have the right permissions to make the request.
HTTP Status Code: 403
- ConflictException
-
The parameters provided in the request conflict with existing resources.
HTTP Status Code: 409
- ExecutionTimeoutException
-
Failed to connect to server, or didn’t receive response within expected time period.
HTTP Status Code: 504
- InternalServerException
-
An unexpected error occurred during the processing of the request.
HTTP Status Code: 500
- ResourceNotFoundException
-
The specified resource was not found.
HTTP Status Code: 404
- ServiceUnavailableException
-
Server cannot process the request at the moment.
HTTP Status Code: 503
- ThrottlingException
-
The number of requests made exceeds the limit.
HTTP Status Code: 429
- ValidationException
-
One or more parameters provided in the request is not valid.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
