issues
Creates, updates, deletes, gets or lists an issues
resource.
Overview
Name | issues |
Type | Resource |
Id | google.securesourcemanager.issues |
Fields
The following fields are returned by SELECT
queries:
- get
- list
Successful response
Name | Datatype | Description |
---|---|---|
name | string | Identifier. Unique identifier for an issue. The issue id is generated by the server. Format: projects/{project}/locations/{location}/repositories/{repository}/issues/{issue_id} |
body | string | Optional. Issue body. Provides a detailed description of the issue. |
closeTime | string (google-datetime) | Output only. Close timestamp (if closed). Cleared when is re-opened. |
createTime | string (google-datetime) | Output only. Creation timestamp. |
etag | string | Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. |
state | string | Output only. State of the issue. |
title | string | Required. Issue title. |
updateTime | string (google-datetime) | Output only. Last updated timestamp. |
Successful response
Name | Datatype | Description |
---|---|---|
name | string | Identifier. Unique identifier for an issue. The issue id is generated by the server. Format: projects/{project}/locations/{location}/repositories/{repository}/issues/{issue_id} |
body | string | Optional. Issue body. Provides a detailed description of the issue. |
closeTime | string (google-datetime) | Output only. Close timestamp (if closed). Cleared when is re-opened. |
createTime | string (google-datetime) | Output only. Creation timestamp. |
etag | string | Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. |
state | string | Output only. State of the issue. |
title | string | Required. Issue title. |
updateTime | string (google-datetime) | Output only. Last updated timestamp. |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get | select | projectsId , locationsId , repositoriesId , issuesId | Gets an issue. | |
list | select | projectsId , locationsId , repositoriesId | pageSize , pageToken , filter | Lists issues in a repository. |
create | insert | projectsId , locationsId , repositoriesId | Creates an issue. | |
patch | update | projectsId , locationsId , repositoriesId , issuesId | updateMask | Updates a issue. |
delete | delete | projectsId , locationsId , repositoriesId , issuesId | etag | Deletes an issue. |
open | exec | projectsId , locationsId , repositoriesId , issuesId | Opens an issue. | |
close | exec | projectsId , locationsId , repositoriesId , issuesId | Closes an issue. |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
issuesId | string | |
locationsId | string | |
projectsId | string | |
repositoriesId | string | |
etag | string | |
filter | string | |
pageSize | integer (int32) | |
pageToken | string | |
updateMask | string (google-fieldmask) |
SELECT
examples
- get
- list
Gets an issue.
SELECT
name,
body,
closeTime,
createTime,
etag,
state,
title,
updateTime
FROM google.securesourcemanager.issues
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND repositoriesId = '{{ repositoriesId }}' -- required
AND issuesId = '{{ issuesId }}' -- required;
Lists issues in a repository.
SELECT
name,
body,
closeTime,
createTime,
etag,
state,
title,
updateTime
FROM google.securesourcemanager.issues
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND repositoriesId = '{{ repositoriesId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';
INSERT
examples
- create
- Manifest
Creates an issue.
INSERT INTO google.securesourcemanager.issues (
data__name,
data__title,
data__body,
data__etag,
projectsId,
locationsId,
repositoriesId
)
SELECT
'{{ name }}',
'{{ title }}',
'{{ body }}',
'{{ etag }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ repositoriesId }}'
RETURNING
name,
done,
error,
metadata,
response
;
# Description fields are for documentation purposes
- name: issues
props:
- name: projectsId
value: string
description: Required parameter for the issues resource.
- name: locationsId
value: string
description: Required parameter for the issues resource.
- name: repositoriesId
value: string
description: Required parameter for the issues resource.
- name: name
value: string
description: >
Identifier. Unique identifier for an issue. The issue id is generated by the server. Format: `projects/{project}/locations/{location}/repositories/{repository}/issues/{issue_id}`
- name: title
value: string
description: >
Required. Issue title.
- name: body
value: string
description: >
Optional. Issue body. Provides a detailed description of the issue.
- name: etag
value: string
description: >
Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
UPDATE
examples
- patch
Updates a issue.
UPDATE google.securesourcemanager.issues
SET
data__name = '{{ name }}',
data__title = '{{ title }}',
data__body = '{{ body }}',
data__etag = '{{ etag }}'
WHERE
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND repositoriesId = '{{ repositoriesId }}' --required
AND issuesId = '{{ issuesId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
done,
error,
metadata,
response;
DELETE
examples
- delete
Deletes an issue.
DELETE FROM google.securesourcemanager.issues
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND repositoriesId = '{{ repositoriesId }}' --required
AND issuesId = '{{ issuesId }}' --required
AND etag = '{{ etag }}';
Lifecycle Methods
- open
- close
Opens an issue.
EXEC google.securesourcemanager.issues.open
@projectsId='{{ projectsId }}' --required,
@locationsId='{{ locationsId }}' --required,
@repositoriesId='{{ repositoriesId }}' --required,
@issuesId='{{ issuesId }}' --required
@@json=
'{
"etag": "{{ etag }}"
}';
Closes an issue.
EXEC google.securesourcemanager.issues.close
@projectsId='{{ projectsId }}' --required,
@locationsId='{{ locationsId }}' --required,
@repositoriesId='{{ repositoriesId }}' --required,
@issuesId='{{ issuesId }}' --required
@@json=
'{
"etag": "{{ etag }}"
}';