Skip to Content
kosemdocs
ReferenceAPIAccess profiles

Look up access profile in project

Finds an access profile by its alias.

GET
/v1/projects/{project}/accessProfiles/lookup

Finds an access profile by its alias.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Path Parameters

project*string

The project's ID.

Match^prj_[0-7][0-9a-hjkmnp-tv-z]{25}$

Query Parameters

alias*string

The access profile's alias.

Match^[a-z][a-z0-9_]*(/[a-z0-9_]+)*$
Lengthlength <= 128

Response Body

OK

application/json
  1. response
alias*string

Short name unique within its organization or project, such as github/kosem or gcp/preview_viewer.

availability*

For an organization's access profile: projects it is shared with. Shared profiles materialize read-only project copies automatically.

config*

Provider-specific ceiling scope for issued credentials.

connection*string

Resource name of the backing connection.

createTime*string

When the access profile was created.

Formatdate-time
description*string

What this access profile is for.

etag*string

Opaque revision tag for optimistic concurrency on updates.

name*string

Resource name: organizations/{organization_id}/accessProfiles/{profile_id} or projects/{project_id}/accessProfiles/{profile_id}.

provider*string

Provider type, such as providers/github, providers/google-cloud or providers/aws.

source?string

For a shared project copy: resource name of the organization access profile it mirrors.

state*string

Whether credentials can be issued through this profile.

Value in"ACTIVE""NEEDS_ATTENTION"
stateReason*string

Why the profile needs attention.

updateTime*string

When the access profile was last updated.

Formatdate-time
Example Request
curl -X GET 'https://api.kosem.ai/v1/projects/string/accessProfiles/lookup?alias=string'
Example Response
{
  "alias": "string",
  "availability": {
    "allProjects": true,
    "projects": [
      "string"
    ]
  },
  "config": {
    "property1": null,
    "property2": null
  },
  "connection": "string",
  "createTime": "2019-08-24T14:15:22Z",
  "description": "string",
  "etag": "string",
  "name": "string",
  "provider": "string",
  "source": "string",
  "state": "ACTIVE",
  "stateReason": "string",
  "updateTime": "2019-08-24T14:15:22Z"
}