--- title: "Get Data Store Access Entry" method: POST path: "/data-store-access/{id}/get-item" tags: ["Data Store Access Entry"] --- # Get Data Store Access Entry `POST /data-store-access/{id}/get-item` ## Request - Base URL: `https://oneuptime.com/api` - URL: `https://oneuptime.com/api/data-store-access/{id}/get-item` - Auth: API key in header `APIKey` - TypeScript: (a function with typed inputs; its response is checked against the schema) Endpoint to retrieve a single Data Store Access Entry by ID ## Path parameters - `id` string, uuid, required ## Request body - object - `select` DataStoreAccessSelectSchema: Select schema for DataStoreAccess. Set fields to true to include them in the response. - `_id` boolean - `createdAt` boolean - `updatedAt` boolean - `deletedAt` boolean - `projectId` boolean - `dataStoreId` boolean - `accessKey` boolean - `principal` boolean - `principalName` boolean - `principalType` boolean - `accessLevel` boolean - `grantedVia` boolean - `isExternal` boolean - `isPublic` boolean - `isSeenInTraces` boolean - `lastUsedAt` boolean - `isUnused` boolean - `firstSeenAt` boolean - `lastSeenAt` boolean ## Response `200` Successful response - object - `data` DataStoreAccess - `_id` string, uuid: ID of this object. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `createdAt` object: Date and Time when the object was created. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `version` number: Object version - `projectId` string, uuid, required: ID of the project this access entry belongs to. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `dataStoreId` string, uuid, required: The store that can be reached. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `accessKey` string, required: The principal, level and grant, which identify the entry within its store. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `principal` string, required: Who or what has access, as its cloud names it: *, an account id, an ARN, an email, a service account. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `principalName` string: The principal's name, for people. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `principalType` string: What the principal is: Public, Account, Role, User, Group, Service Principal, Service Account or Service. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `accessLevel` string: What it may do: Read, Write or Admin. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `grantedVia` string: What grants the access: a bucket policy, an ACL, a role assignment, an IAM binding, a snapshot share, or traffic seen in traces. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `isExternal` boolean, required: The principal is outside the project's connected accounts. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `isPublic` boolean, required: The principal is anyone on the internet. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `isSeenInTraces` boolean, required: OneUptime saw this principal use the store in traces. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `lastUsedAt` object: When the access was last used, where OneUptime can tell. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `isUnused` boolean, required: The principal has not been used in 90 days, as far as its cloud can say. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `firstSeenAt` object: When the access was first read. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] - `lastSeenAt` object: When the access was last read. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Security Admin, Security Member, Security Viewer, Read Data Store Access], Update: [No access - you don't have permission for this operation] ## Other responses - `400`: Bad request. This response indicates that the request was malformed or contained invalid data. - `401`: Unauthorized. This response indicates that the request requires user authentication. - `402`: Payment Required. This response indicates that the request requires payment or a valid subscription. - `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it. - `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each. - `405`: Project not found. This response indicates that the requested project does not exist or is not accessible. - `408`: Request Timeout. This response indicates that the server timed out waiting for the request. - `415`: Unable to reach server. This response indicates that the server is currently unreachable or down. - `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource. - `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. --- [API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)