Skip to main content

references

Creates, updates, deletes, gets or lists a references resource.

Overview

Namereferences
TypeResource
Idgoogle.apigee.references

Fields

NameDatatypeDescription
namestringRequired. The resource id of this reference. Values must match the regular expression [\w\s-.]+.
descriptionstringOptional. A human-readable description of this reference.
refersstringRequired. The id of the resource to which this reference refers. Must be the id of a resource that exists in the parent environment and is of the given resource_type.
resourceTypestringThe type of resource referred to by this reference. Valid values are 'KeyStore' or 'TrustStore'.

Methods

NameAccessible byRequired ParamsDescription
organizations_environments_references_getSELECTenvironmentsId, organizationsId, referencesIdGets a Reference resource.
organizations_environments_references_createINSERTenvironmentsId, organizationsIdCreates a Reference in the specified environment.
organizations_environments_references_deleteDELETEenvironmentsId, organizationsId, referencesIdDeletes a Reference from an environment. Returns the deleted Reference resource.
organizations_environments_references_updateREPLACEenvironmentsId, organizationsId, referencesIdUpdates an existing Reference. Note that this operation has PUT semantics; it will replace the entirety of the existing Reference with the resource in the request body.

SELECT examples

Gets a Reference resource.

SELECT
name,
description,
refers,
resourceType
FROM google.apigee.references
WHERE environmentsId = '{{ environmentsId }}'
AND organizationsId = '{{ organizationsId }}'
AND referencesId = '{{ referencesId }}';

INSERT example

Use the following StackQL query and manifest file to create a new references resource.

/*+ create */
INSERT INTO google.apigee.references (
environmentsId,
organizationsId,
description,
name,
resourceType,
refers
)
SELECT
'{{ environmentsId }}',
'{{ organizationsId }}',
'{{ description }}',
'{{ name }}',
'{{ resourceType }}',
'{{ refers }}'
;

REPLACE example

Replaces all fields in the specified references resource.

/*+ update */
REPLACE google.apigee.references
SET
description = '{{ description }}',
name = '{{ name }}',
resourceType = '{{ resourceType }}',
refers = '{{ refers }}'
WHERE
environmentsId = '{{ environmentsId }}'
AND organizationsId = '{{ organizationsId }}'
AND referencesId = '{{ referencesId }}';

DELETE example

Deletes the specified references resource.

/*+ delete */
DELETE FROM google.apigee.references
WHERE environmentsId = '{{ environmentsId }}'
AND organizationsId = '{{ organizationsId }}'
AND referencesId = '{{ referencesId }}';