authorized_certificates

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

Overview

Name	authorized_certificates
Type	Resource
Id	google.appengine.authorized_certificates

Fields

Name	Datatype	Description
id	string	Relative name of the certificate. This is a unique value autogenerated on AuthorizedCertificate resource creation. Example: 12345.@OutputOnly
name	string	Full path to the AuthorizedCertificate resource in the API. Example: apps/myapp/authorizedCertificates/12345.@OutputOnly
certificateRawData	object	An SSL certificate obtained from a certificate authority.
displayName	string	The user-specified display name of the certificate. This is not guaranteed to be unique. Example: My Certificate.
domainMappingsCount	integer	Aggregate count of the domain mappings with this certificate mapped. This count includes domain mappings on applications for which the user does not have VIEWER permissions.Only returned by GET or LIST requests when specifically requested by the view=FULL_CERTIFICATE option.@OutputOnly
domainNames	array	Topmost applicable domains of this certificate. This certificate applies to these domains and their subdomains. Example: example.com.@OutputOnly
expireTime	string	The time when this certificate expires. To update the renewal time on this certificate, upload an SSL certificate with a different expiration time using AuthorizedCertificates.UpdateAuthorizedCertificate.@OutputOnly
managedCertificate	object	A certificate managed by App Engine.
visibleDomainMappings	array	The full paths to user visible Domain Mapping resources that have this certificate mapped. Example: apps/myapp/domainMappings/example.com.This may not represent the full list of mapped domain mappings if the user does not have VIEWER permissions on all of the applications that have this certificate mapped. See domain_mappings_count for a complete count.Only returned by GET or LIST requests when specifically requested by the view=FULL_CERTIFICATE option.@OutputOnly

Methods

Name	Accessible by	Required Params	Description
get	SELECT	appsId, authorizedCertificatesId	Gets the specified SSL certificate.
list	SELECT	appsId	Lists all SSL certificates the user is authorized to administer.
create	INSERT	appsId	Uploads the specified SSL certificate.
delete	DELETE	appsId, authorizedCertificatesId	Deletes the specified SSL certificate.
patch	UPDATE	appsId, authorizedCertificatesId	Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.

SELECT examples

Lists all SSL certificates the user is authorized to administer.

SELECT
id,
name,
certificateRawData,
displayName,
domainMappingsCount,
domainNames,
expireTime,
managedCertificate,
visibleDomainMappings
FROM google.appengine.authorized_certificates
WHERE appsId = '{{ appsId }}';

INSERT example

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

All Properties

/*+ create */
INSERT INTO google.appengine.authorized_certificates (
appsId,
name,
displayName,
domainNames,
expireTime,
certificateRawData,
managedCertificate,
visibleDomainMappings,
domainMappingsCount
)
SELECT 
'{{ appsId }}',
'{{ name }}',
'{{ displayName }}',
'{{ domainNames }}',
'{{ expireTime }}',
'{{ certificateRawData }}',
'{{ managedCertificate }}',
'{{ visibleDomainMappings }}',
'{{ domainMappingsCount }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: name
      value: string
    - name: id
      value: string
    - name: displayName
      value: string
    - name: domainNames
      value:
        - string
    - name: expireTime
      value: string
    - name: certificateRawData
      value:
        - name: publicCertificate
          value: string
        - name: privateKey
          value: string
    - name: managedCertificate
      value:
        - name: lastRenewalTime
          value: string
        - name: status
          value: string
    - name: visibleDomainMappings
      value:
        - string
    - name: domainMappingsCount
      value: integer

UPDATE example

Updates a authorized_certificates resource.

/*+ update */
UPDATE google.appengine.authorized_certificates
SET 
name = '{{ name }}',
displayName = '{{ displayName }}',
domainNames = '{{ domainNames }}',
expireTime = '{{ expireTime }}',
certificateRawData = '{{ certificateRawData }}',
managedCertificate = '{{ managedCertificate }}',
visibleDomainMappings = '{{ visibleDomainMappings }}',
domainMappingsCount = '{{ domainMappingsCount }}'
WHERE 
appsId = '{{ appsId }}'
AND authorizedCertificatesId = '{{ authorizedCertificatesId }}';

DELETE example

Deletes the specified authorized_certificates resource.

/*+ delete */
DELETE FROM google.appengine.authorized_certificates
WHERE appsId = '{{ appsId }}'
AND authorizedCertificatesId = '{{ authorizedCertificatesId }}';