ca_pools

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

Overview

Name	ca_pools
Type	Resource
Id	google.privateca.ca_pools

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
name	string	Identifier. The resource name for this CaPool in the format projects/*/locations/*/caPools/*.
issuancePolicy	object	Optional. The IssuancePolicy to control how Certificates will be issued from this CaPool. (id: IssuancePolicy)
labels	object	Optional. Labels with user-defined metadata.
publishingOptions	object	Optional. The PublishingOptions to follow when issuing Certificates from any CertificateAuthority in this CaPool. (id: PublishingOptions)
tier	string	Required. Immutable. The Tier of this CaPool.

list

Successful response

Name	Datatype	Description
name	string	Identifier. The resource name for this CaPool in the format projects/*/locations/*/caPools/*.
issuancePolicy	object	Optional. The IssuancePolicy to control how Certificates will be issued from this CaPool. (id: IssuancePolicy)
labels	object	Optional. Labels with user-defined metadata.
publishingOptions	object	Optional. The PublishingOptions to follow when issuing Certificates from any CertificateAuthority in this CaPool. (id: PublishingOptions)
tier	string	Required. Immutable. The Tier of this CaPool.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, caPoolsId		Returns a CaPool.
list	select	projectsId, locationsId	pageSize, pageToken, filter, orderBy	Lists CaPools.
create	insert	projectsId, locationsId	caPoolId, requestId	Create a CaPool.
patch	update	projectsId, locationsId, caPoolsId	updateMask, requestId	Update a CaPool.
delete	delete	projectsId, locationsId, caPoolsId	requestId, ignoreDependentResources	Delete a CaPool.

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
caPoolsId	string
locationsId	string
projectsId	string
caPoolId	string
filter	string
ignoreDependentResources	boolean
orderBy	string
pageSize	integer (int32)
pageToken	string
requestId	string
updateMask	string (google-fieldmask)

SELECT examples

get

Returns a CaPool.

SELECT
name,
issuancePolicy,
labels,
publishingOptions,
tier
FROM google.privateca.ca_pools
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND caPoolsId = '{{ caPoolsId }}' -- required;

list

Lists CaPools.

SELECT
name,
issuancePolicy,
labels,
publishingOptions,
tier
FROM google.privateca.ca_pools
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}';

INSERT examples

create

Create a CaPool.

INSERT INTO google.privateca.ca_pools (
data__name,
data__tier,
data__issuancePolicy,
data__publishingOptions,
data__labels,
projectsId,
locationsId,
caPoolId,
requestId
)
SELECT 
'{{ name }}',
'{{ tier }}',
'{{ issuancePolicy }}',
'{{ publishingOptions }}',
'{{ labels }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ caPoolId }}',
'{{ requestId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: ca_pools
  props:
    - name: projectsId
      value: string
      description: Required parameter for the ca_pools resource.
    - name: locationsId
      value: string
      description: Required parameter for the ca_pools resource.
    - name: name
      value: string
      description: >
        Identifier. The resource name for this CaPool in the format `projects/*/locations/*/caPools/*`.
        
    - name: tier
      value: string
      description: >
        Required. Immutable. The Tier of this CaPool.
        
      valid_values: ['TIER_UNSPECIFIED', 'ENTERPRISE', 'DEVOPS']
    - name: issuancePolicy
      value: object
      description: >
        Optional. The IssuancePolicy to control how Certificates will be issued from this CaPool.
        
    - name: publishingOptions
      value: object
      description: >
        Optional. The PublishingOptions to follow when issuing Certificates from any CertificateAuthority in this CaPool.
        
    - name: labels
      value: object
      description: >
        Optional. Labels with user-defined metadata.
        
    - name: caPoolId
      value: string
    - name: requestId
      value: string

UPDATE examples

patch

Update a CaPool.

UPDATE google.privateca.ca_pools
SET 
data__name = '{{ name }}',
data__tier = '{{ tier }}',
data__issuancePolicy = '{{ issuancePolicy }}',
data__publishingOptions = '{{ publishingOptions }}',
data__labels = '{{ labels }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND caPoolsId = '{{ caPoolsId }}' --required
AND updateMask = '{{ updateMask}}'
AND requestId = '{{ requestId}}'
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

delete

Delete a CaPool.

DELETE FROM google.privateca.ca_pools
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND caPoolsId = '{{ caPoolsId }}' --required
AND requestId = '{{ requestId }}'
AND ignoreDependentResources = '{{ ignoreDependentResources }}';